@kodax-ai/kodax 0.7.46 → 0.7.48

package/dist/types-chunks/{types.d-D2RNa5Y7.d.ts → types.d-BCnbYG_A.d.ts}

@@ -1816,6 +1816,72 @@ declare function runToolBeforeGuardrails(call: RunnerToolCall, guardrails: reado
  */
 declare function runToolAfterGuardrails(call: RunnerToolCall, result: RunnerToolResult, guardrails: readonly ToolGuardrail[], ctx: GuardrailContext, agentSpan: Span | null): Promise<RunnerToolResult>;
 
+/**
+ * FEATURE_222 — user-interaction primitive (agent layer).
+ *
+ * "Ask the user a question" is needed at BOTH layers: the coding `ask_user_*`
+ * tools (LLM-initiated) AND the MCP elicitation reverse capability
+ * (server-initiated). The capability historically lived only in
+ * `@kodax-ai/coding`, but the MCP runtime lives one layer below in
+ * `@kodax-ai/agent` and cannot reach up to it. So the primitive is owned here,
+ * at the agent layer, and the host injects ONE implementation that both layers
+ * share — coding re-exports these types for backward compatibility.
+ *
+ * The agent layer is UI-less by design: these are the contract the host
+ * (REPL / ACP / SDK) fulfils with its real interaction surface. A headless host
+ * leaves them undefined and consumers degrade gracefully (cancel / decline).
+ */
+/** A single question item used in multi-question mode. */
+interface AskUserQuestionItem {
+    question: string;
+    header?: string;
+    options: Array<{
+        label: string;
+        description?: string;
+        value: string;
+    }>;
+    multiSelect?: boolean;
+}
+/** Options for multi-question mode — multiple independent questions in one call. */
+interface AskUserMultiOptions {
+    questions: AskUserQuestionItem[];
+}
+/** Options for a single question (select or free-text input). */
+interface AskUserQuestionOptions {
+    question: string;
+    kind?: 'select' | 'input';
+    /** Required for kind="select", ignored for kind="input". */
+    options?: Array<{
+        label: string;
+        description?: string;
+        value: string;
+    }>;
+    multiSelect?: boolean;
+    default?: string;
+}
+/**
+ * The host-provided user-interaction surface. Each method is optional — a
+ * headless host omits them and callers degrade gracefully. This is the single
+ * primitive shared by the coding `ask_user_*` tools and the agent's MCP
+ * elicitation reverse capability.
+ */
+interface UserInteraction {
+    /** Ask one question (select mode by default). Resolves the chosen value. */
+    askUser?: (options: AskUserQuestionOptions) => Promise<string>;
+    /** Ask several independent questions sequentially. Resolves a value map, or
+     *  undefined when the user cancels. */
+    askUserMulti?: (options: AskUserMultiOptions) => Promise<Record<string, string> | undefined>;
+    /** Ask for free-text input. Resolves the text, or undefined when cancelled. */
+    askUserInput?: (options: {
+        question: string;
+        default?: string;
+    }) => Promise<string | undefined>;
+}
+/** Register the live user-interaction surface (host calls this when interactive). */
+declare function setActiveUserInteraction(interaction: UserInteraction | undefined): void;
+/** The live user-interaction surface, or undefined when none is active. */
+declare function getActiveUserInteraction(): UserInteraction | undefined;
+
 /**
  * Child task registry primitive — generic fan-out tracking.
  *
@@ -2273,5 +2339,5 @@ interface FileOperations {
     modifiedFiles: string[];
 }
 
-export { DEFAULT_SYSTEM_CAP as D, InvariantSession as O, MAX_TOOL_LOOP_ITERATIONS as P, getAdmittedAgentBindings as a$, Runner as a6, Tracer as aI, _resetAdmittedAgentBindings as aK, _resetPresetDispatchers as aL, buildAssistantMessageFromLlmResult as aM, buildSystemPrompt as aN, buildToolResultMessage as aO, collectGuardrails as aP, createAgent as aQ, createHandoff as aR, createInMemorySession as aS, createInvariantSessionForAgent as aT, createStateWriter as aU, createTrace as aV, defaultTracer as aW, detectInstructionsInjection as aX, discoverInstances as aY, executeRunnerToolCall as aZ, extractAssistantTextFromMessage as a_, SpanImpl as ao, isRunnableTool as b0, isRunnerLlmResult as b1, registerChildTask as b2, registerPresetDispatcher as b3, requestTaskStop as b4, runAdmissionAudit as b5, runInputGuardrails as b6, runOutputGuardrails as b7, runToolAfterGuardrails as b8, runToolBeforeGuardrails as b9, setAdmittedAgentBindings as ba, GuardrailBlockedError as w, GuardrailEscalateError as y };
-export type { RecentlyModifiedFile as $, AdmissionAuditOptions as A, GuardrailVerdict as B, ChildTaskRegistry as C, EvidenceSpanData as E, FanoutSpanData as F, GenerationSpanData as G, Handoff as H, HandoffSpanData as I, InMemorySessionOptions as J, InputGuardrail as K, InstanceDiscoveryFs as L, InvariantId as M, InvariantResult as N, ManifestPatch as Q, MessageEntry as R, ObserveCtx as S, OutputGuardrail as T, PersistedSessionState as U, PresetDispatcher as V, PresetTracingContext as W, QualityInvariant as X, ReadonlyMutationTracker as Y, ReadonlyRecorder as Z, ReasoningDepth as _, AdmissionCtx as a, RequestTaskStopOptions as a0, RequestTaskStopResult as a1, RunEvent as a2, RunOptions as a3, RunResult as a4, RunnableTool as a5, RunnerEvent as a7, RunnerLlmResult as a8, RunnerLlmReturn as a9, TerminalCtx as aA, ToolBeforeOutcome as aB, ToolCallSpanData as aC, ToolCapability as aD, ToolGuardrail as aE, ToolPermission as aF, Trace as aG, TraceOptions as aH, TracerOptions as aJ, RunnerToolCall as aa, RunnerToolContext as ab, RunnerToolObserver as ac, RunnerToolResult as ad, Session as ae, SessionDispatchResult as af, SessionEntry as ag, SessionExtension as ah, SessionForkOptions as ai, SessionMeta as aj, SessionStateSnapshot as ak, Span as al, SpanData as am, SpanError as an, SpanImplOptions as ap, StartTraceOptions as aq, StateWriter as ar, StateWriterFs as as, StateWriterOptions as at, StopHookContext as au, StopHookFn as av, StopHookResult as aw, StopHookSpanData as ax, SystemCap as ay, TaskAbortRegistry as az, AdmissionVerdict as b, AdmittedHandle as c, Agent as d, AgentManifest as e, AgentMessage as f, AgentMiddlewareDeclaration as g, AgentReasoningProfile as h, AgentSpanData as i, AgentTool as j, CompactionAnchor as k, CompactionConfig as l, CompactionDetails as m, CompactionResult as n, CompactionSpanData as o, CompactionUpdate as p, CurrentTodoSummary as q, Deliverable as r, DiscoveredInstance as s, DiscoveryOptions as t, FileOperations as u, Guardrail as v, GuardrailContext as x, GuardrailSpanData as z };
+export { DEFAULT_SYSTEM_CAP as D, GuardrailEscalateError as H, InvariantSession as R, MAX_TOOL_LOOP_ITERATIONS as S, detectInstructionsInjection as a$, Runner as a9, Tracer as aL, _resetAdmittedAgentBindings as aO, _resetPresetDispatchers as aP, buildAssistantMessageFromLlmResult as aQ, buildSystemPrompt as aR, buildToolResultMessage as aS, collectGuardrails as aT, createAgent as aU, createHandoff as aV, createInMemorySession as aW, createInvariantSessionForAgent as aX, createStateWriter as aY, createTrace as aZ, defaultTracer as a_, SpanImpl as ar, discoverInstances as b0, executeRunnerToolCall as b1, extractAssistantTextFromMessage as b2, getActiveUserInteraction as b3, getAdmittedAgentBindings as b4, isRunnableTool as b5, isRunnerLlmResult as b6, registerChildTask as b7, registerPresetDispatcher as b8, requestTaskStop as b9, runAdmissionAudit as ba, runInputGuardrails as bb, runOutputGuardrails as bc, runToolAfterGuardrails as bd, runToolBeforeGuardrails as be, setActiveUserInteraction as bf, setAdmittedAgentBindings as bg, GuardrailBlockedError as z };
+export type { ReadonlyMutationTracker as $, AdmissionAuditOptions as A, GuardrailContext as B, ChildTaskRegistry as C, EvidenceSpanData as E, FanoutSpanData as F, GenerationSpanData as G, GuardrailSpanData as I, GuardrailVerdict as J, Handoff as K, HandoffSpanData as L, InMemorySessionOptions as M, InputGuardrail as N, InstanceDiscoveryFs as O, InvariantId as P, InvariantResult as Q, ManifestPatch as T, MessageEntry as U, ObserveCtx as V, OutputGuardrail as W, PersistedSessionState as X, PresetDispatcher as Y, PresetTracingContext as Z, QualityInvariant as _, AdmissionCtx as a, ReadonlyRecorder as a0, ReasoningDepth as a1, RecentlyModifiedFile as a2, RequestTaskStopOptions as a3, RequestTaskStopResult as a4, RunEvent as a5, RunOptions as a6, RunResult as a7, RunnableTool as a8, StopHookSpanData as aA, SystemCap as aB, TaskAbortRegistry as aC, TerminalCtx as aD, ToolBeforeOutcome as aE, ToolCallSpanData as aF, ToolCapability as aG, ToolGuardrail as aH, ToolPermission as aI, Trace as aJ, TraceOptions as aK, TracerOptions as aM, UserInteraction as aN, RunnerEvent as aa, RunnerLlmResult as ab, RunnerLlmReturn as ac, RunnerToolCall as ad, RunnerToolContext as ae, RunnerToolObserver as af, RunnerToolResult as ag, Session as ah, SessionDispatchResult as ai, SessionEntry as aj, SessionExtension as ak, SessionForkOptions as al, SessionMeta as am, SessionStateSnapshot as an, Span as ao, SpanData as ap, SpanError as aq, SpanImplOptions as as, StartTraceOptions as at, StateWriter as au, StateWriterFs as av, StateWriterOptions as aw, StopHookContext as ax, StopHookFn as ay, StopHookResult as az, AdmissionVerdict as b, AdmittedHandle as c, Agent as d, AgentManifest as e, AgentMessage as f, AgentMiddlewareDeclaration as g, AgentReasoningProfile as h, AgentSpanData as i, AgentTool as j, AskUserMultiOptions as k, AskUserQuestionItem as l, AskUserQuestionOptions as m, CompactionAnchor as n, CompactionConfig as o, CompactionDetails as p, CompactionResult as q, CompactionSpanData as r, CompactionUpdate as s, CurrentTodoSummary as t, Deliverable as u, DiscoveredInstance as v, DiscoveryOptions as w, FileOperations as x, Guardrail as y };

package/dist/types-chunks/{utils.d-pzHPkrb8.d.ts → utils.d-Dgy5SVrq.d.ts}

@@ -1,4 +1,4 @@
-import { l as BashPrefixExtractor, a1 as KodaXOptions, L as KodaXContextTokenSnapshot, K as KodaXAgentMode, a6 as KodaXRepoIntelligenceMode, A as AgentsFile, i as AutoModeStats, ah as KodaXSkillInvocationContext, _ as KodaXMcpServersConfig } from './bash-prefix-extractor.d-BICYx8pt.js';
+import { i as BashPrefixExtractor, a1 as KodaXOptions, I as KodaXContextTokenSnapshot, K as KodaXAgentMode, a6 as KodaXRepoIntelligenceMode, A as AgentsFile, f as AutoModeStats, ai as KodaXSkillInvocationContext, _ as KodaXMcpServersConfig } from './bash-prefix-extractor.d-DNO2-ycp.js';
 import { a as SessionStorage$1 } from './storage.d-B1Jk6ryM.js';
 import { y as KodaXSessionStorage, n as KodaXSessionData, A as KodaXSessionUiHistoryItem, s as KodaXSessionLineage, k as KodaXSessionArtifactLedgerEntry, w as KodaXSessionRuntimeInfo } from './types.d-B_MIIApc.js';
 import { n as KodaXMessage, E as KodaXReasoningMode, r as KodaXProviderCapabilityProfile, F as KodaXReasoningOverride, h as KodaXCustomProviderConfig } from './types.d-Cf-GCzac.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kodax-ai/kodax",
-  "version": "0.7.46",
+  "version": "0.7.48",
   "description": "极致轻量化 Coding Agent - TypeScript 实现，支持 12 个 LLM 提供商，可发布为免 Node 单文件二进制",
   "type": "module",
   "private": false,
@@ -122,6 +122,7 @@
     "terminal-size": "^4.0.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
+    "vscode-languageserver-protocol": "^3.17.5",
     "widest-line": "^6.0.0",
     "wrap-ansi": "^8.1.0",
     "ws": "^8.18.0",