@kodax-ai/kodax 0.7.89 → 0.7.91

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (86) hide show
  1. package/CHANGELOG.md +103 -0
  2. package/README.md +33 -0
  3. package/README_CN.md +15 -0
  4. package/dist/chunks/{agent-AKCXT573.js → agent-YLYM2UIQ.js} +1 -1
  5. package/dist/chunks/argument-completer-4WND7KNM.js +2 -0
  6. package/dist/chunks/{chunk-SOIIBADK.js → chunk-3SVR6PC4.js} +2 -2
  7. package/dist/chunks/{chunk-72H6JNPN.js → chunk-4R4QTBO6.js} +131 -131
  8. package/dist/chunks/chunk-4S5ZAR6N.js +383 -0
  9. package/dist/chunks/{chunk-W5RPVR3O.js → chunk-7RF2XYFK.js} +1 -1
  10. package/dist/chunks/{chunk-BOMSVUJS.js → chunk-7YQT4RAW.js} +2 -2
  11. package/dist/chunks/chunk-FBL7IVMK.js +123 -0
  12. package/dist/chunks/{chunk-4Y6OSDZE.js → chunk-G5XXC7ON.js} +1 -1
  13. package/dist/chunks/{chunk-IFD6TUQU.js → chunk-HXORFXTH.js} +1 -1
  14. package/dist/chunks/{chunk-CQHLFQSU.js → chunk-MGM5SUKU.js} +2 -2
  15. package/dist/chunks/chunk-P7AW3CQW.js +415 -0
  16. package/dist/chunks/{chunk-5247AKGN.js → chunk-QFV6YCIH.js} +2 -2
  17. package/dist/chunks/{chunk-5UBP47VJ.js → chunk-UNTT2ZKN.js} +88 -88
  18. package/dist/chunks/{chunk-O2ZV775M.js → chunk-X75UGXP3.js} +1 -1
  19. package/dist/chunks/chunk-XC2GKTSX.js +519 -0
  20. package/dist/chunks/chunk-XQWPHL6U.js +408 -0
  21. package/dist/chunks/chunk-YQSQEF6J.js +320 -0
  22. package/dist/chunks/{chunk-PROPMIT4.js → chunk-ZNH2MKN5.js} +1 -1
  23. package/dist/chunks/{client-ZXBSEDS4.js → client-SKLNEU3G.js} +1 -1
  24. package/dist/chunks/compaction-config-UEGW2ZBT.js +2 -0
  25. package/dist/chunks/{construction-bootstrap-WF6KQ7XV.js → construction-bootstrap-OUKXVNUQ.js} +1 -1
  26. package/dist/chunks/dist-7EWVACPM.js +2 -0
  27. package/dist/chunks/{dist-WILA35IA.js → dist-WNMK42WE.js} +1 -1
  28. package/dist/chunks/host-GDDQKQKH.js +2 -0
  29. package/dist/chunks/run-manager-J4WO55J2.js +2 -0
  30. package/dist/chunks/{utils-BEWYGEMB.js → utils-NZXGH43M.js} +1 -1
  31. package/dist/index.d.ts +17 -17
  32. package/dist/index.js +5 -5
  33. package/dist/kodax_bootstrap.js +1 -1
  34. package/dist/kodax_cli.js +1539 -1542
  35. package/dist/runtime-worker.js +1407 -1410
  36. package/dist/sandbox-workspace-session.js +213 -213
  37. package/dist/sdk-a2a.d.ts +12 -12
  38. package/dist/sdk-a2a.js +1 -1
  39. package/dist/sdk-agent.d.ts +15 -13
  40. package/dist/sdk-agent.js +1 -1
  41. package/dist/sdk-coding.d.ts +14 -14
  42. package/dist/sdk-coding.js +1 -1
  43. package/dist/sdk-experimental-memory.d.ts +3 -3
  44. package/dist/sdk-experimental-memory.js +1 -1
  45. package/dist/sdk-llm.d.ts +1 -1
  46. package/dist/sdk-llm.js +1 -1
  47. package/dist/sdk-mcp.js +1 -1
  48. package/dist/sdk-media.js +1 -1
  49. package/dist/sdk-repl.d.ts +9 -9
  50. package/dist/sdk-repl.js +2 -2
  51. package/dist/sdk-runtime.d.ts +108 -8
  52. package/dist/sdk-runtime.js +1 -1
  53. package/dist/sdk-sandbox.js +1 -1
  54. package/dist/sdk-session.d.ts +5 -5
  55. package/dist/sdk-session.js +1 -1
  56. package/dist/sdk-skills.js +1 -1
  57. package/dist/semantic-worker.js +59 -59
  58. package/dist/types-chunks/{bash-prefix-extractor.d-BLlhCRI-.d.ts → bash-prefix-extractor.d-BMi_TJIY.d.ts} +54 -7
  59. package/dist/types-chunks/{capsule.d-Cw4UlPTC.d.ts → capsule.d-nYbM4MNL.d.ts} +2 -2
  60. package/dist/types-chunks/{controller.d-1tydJm7c.d.ts → controller.d-Bm1i9RVj.d.ts} +14 -6
  61. package/dist/types-chunks/{controller.d-BvwWz6yP.d.ts → controller.d-CTvvOy_V.d.ts} +1 -1
  62. package/dist/types-chunks/{guardrail.d-DqWHIgt6.d.ts → guardrail.d-CKkoea7y.d.ts} +2 -2
  63. package/dist/types-chunks/{history-retrieval.d-ia-4iJpw.d.ts → history-retrieval.d-D0LNyBED.d.ts} +1 -1
  64. package/dist/types-chunks/{public-api.d-CMZa4JPa.d.ts → public-api.d-ItHKrP7K.d.ts} +4 -4
  65. package/dist/types-chunks/{repl.d-Byu2osV-.d.ts → repl.d-Beg6tiSz.d.ts} +11 -6
  66. package/dist/types-chunks/{resolver.d-bKttRr1V.d.ts → resolver.d-DparsV6Y.d.ts} +6 -4
  67. package/dist/types-chunks/{review-inbox.d-D3T-RxRs.d.ts → review-inbox.d-dAtGH3g2.d.ts} +1 -1
  68. package/dist/types-chunks/{run-manager.d-D0aKe12e.d.ts → run-manager.d-BeSEc2OL.d.ts} +1 -1
  69. package/dist/types-chunks/{sdk-session-BEM7yvJB.d.ts → sdk-session-C7aoqrIR.d.ts} +2 -2
  70. package/dist/types-chunks/{shell-command-sets.d-_SHjU3KP.d.ts → shell-command-sets.d-C2cc9Hwi.d.ts} +1 -1
  71. package/dist/types-chunks/{types.d-B_IFJlti.d.ts → types.d-Dc3kwcjC.d.ts} +1 -1
  72. package/dist/types-chunks/{types.d-BqK7eZ5u.d.ts → types.d-DrtP1ceI.d.ts} +2 -2
  73. package/dist/types-chunks/{types.d-DeokRBs7.d.ts → types.d-EjZTEEVu.d.ts} +2 -1
  74. package/dist/types-chunks/{utils.d-0h1NTEsX.d.ts → utils.d-Qa_Z1w2Q.d.ts} +5 -5
  75. package/package.json +4 -2
  76. package/dist/chunks/argument-completer-BJGY57H2.js +0 -2
  77. package/dist/chunks/chunk-A63MGLH6.js +0 -415
  78. package/dist/chunks/chunk-GL6GVYF4.js +0 -320
  79. package/dist/chunks/chunk-QQBFQCMF.js +0 -519
  80. package/dist/chunks/chunk-S74F7MFN.js +0 -412
  81. package/dist/chunks/chunk-UNEC2WXJ.js +0 -123
  82. package/dist/chunks/chunk-W2LRTZBJ.js +0 -382
  83. package/dist/chunks/compaction-config-HVHPJ6CS.js +0 -2
  84. package/dist/chunks/dist-BCT3UNMA.js +0 -2
  85. package/dist/chunks/host-V6ENYZAQ.js +0 -2
  86. package/dist/chunks/run-manager-ZOV7EKTZ.js +0 -2
@@ -1,13 +1,53 @@
1
- import { ai as KodaXGoalState, K as KodaXSessionLineage, aj as AgentActorStore, ak as AgentTurnExecutor, al as AgentBudgetPort, am as AgentActorOwner, an as AgentActorClient, ao as AgentExecutionResult, C as KodaXJsonValue, A as KodaXExtensionSessionRecord, B as KodaXExtensionSessionState, b as KodaXSessionArtifactLedgerEntry, _ as SessionErrorMetadata, P as KodaXSessionScope, Q as KodaXSessionStorage, M as MemoryContextIdentity, s as MemoryPack, u as MemoryReviewPlan, v as KodaXMemoryOutcomeDigest, d as MemoryReviewRunner } from './types.d-DeokRBs7.js';
1
+ import { ai as KodaXGoalState, K as KodaXSessionLineage, aj as AgentActorStore, ak as AgentTurnExecutor, al as AgentBudgetPort, am as AgentActorOwner, an as AgentActorClient, ao as AgentExecutionResult, C as KodaXJsonValue, A as KodaXExtensionSessionRecord, B as KodaXExtensionSessionState, b as KodaXSessionArtifactLedgerEntry, _ as SessionErrorMetadata, P as KodaXSessionScope, Q as KodaXSessionStorage, M as MemoryContextIdentity, s as MemoryPack, u as MemoryReviewPlan, v as KodaXMemoryOutcomeDigest, d as MemoryReviewRunner } from './types.d-EjZTEEVu.js';
2
2
  import { Diagnostic, Position, Location, Hover, DocumentSymbol, SymbolInformation, WorkspaceSymbol, CallHierarchyItem, CallHierarchyIncomingCall, CallHierarchyOutgoingCall } from 'vscode-languageserver-protocol';
3
3
  import { d as KodaXTokenUsage, b as KodaXMessage, f as KodaXToolDefinition, n as KodaXWireReasoningEffort, H as KodaXTaskRoutingDecision, I as KodaXTaskType, a8 as KodaXTaskWorkIntent, a6 as KodaXTaskComplexity, D as KodaXRiskLevel, Z as KodaXHarnessProfile, s as KodaXExecutionMode, p as KodaXChildFanoutClass, o as KodaXReasoningMode, C as KodaXReviewScale } from './types.d-Cv09EdJR.js';
4
- import { d as AgentMessage, ag as StopHookFn, ah as AgentControllerHealth, ai as AgentExecutorPlaneBinding, A as Agent, aj as WorkflowIsolation, ak as GuardrailPermissionIntent, k as AskUserQuestionOptions, g as AskUserAnswer, i as AskUserMultiOptions, D as WorkflowEventCorrelation, n as CompactionUpdate, c as WorkflowProcessEvent, a as WorkflowEvent, G as Guardrail, al as DiscoveredInstance, K as KodaXInputArtifact, am as UnifiedLearningReviewRunner } from './controller.d-1tydJm7c.js';
4
+ import { d as AgentMessage, ag as StopHookFn, ah as AgentControllerHealth, ai as AgentExecutorPlaneBinding, A as Agent, aj as WorkflowIsolation, ak as GuardrailPermissionIntent, k as AskUserQuestionOptions, g as AskUserAnswer, i as AskUserMultiOptions, D as WorkflowEventCorrelation, n as CompactionUpdate, c as WorkflowProcessEvent, a as WorkflowEvent, G as Guardrail, al as DiscoveredInstance, K as KodaXInputArtifact, am as UnifiedLearningReviewRunner } from './controller.d-Bm1i9RVj.js';
5
5
  import { a as SkillDynamicContextExecutor, I as ISkillRegistry } from './types.d-BEMcUOng.js';
6
6
  import { K as KodaXLlmTimeoutConfig, C as CostTracker } from './cost-tracker.d-MTAt6N7b.js';
7
7
  import { p as MemoryRecallRunner } from './types-D8OiIEwA.js';
8
8
  import { C as CapabilityKind, f as CapabilitySearchSnapshot, b as CapabilityResult } from './capability.d-K664nHOS.js';
9
9
  import { K as KodaXBaseProvider } from './base.d-JjF6aKsh.js';
10
10
 
11
+ type KodaXOutputSegmentMode = 'replace' | 'append';
12
+ interface KodaXOutputSegmentStarted {
13
+ readonly responseId: string;
14
+ readonly providerRequestId: string;
15
+ readonly mode: KodaXOutputSegmentMode;
16
+ }
17
+ interface KodaXOutputSegmentDelta {
18
+ readonly providerRequestId: string;
19
+ readonly text: string;
20
+ }
21
+ interface KodaXOutputSegmentActiveState {
22
+ readonly responseId: string;
23
+ readonly providerRequestId: string;
24
+ readonly mode: KodaXOutputSegmentMode;
25
+ /** Runtime journal sequence of the segment start, when the reducer has one. */
26
+ readonly startedAtSeq?: number;
27
+ readonly assistantText: string;
28
+ readonly thinkingText: string;
29
+ }
30
+ interface KodaXOutputSegmentProjection {
31
+ /** Effective append segments in provider-call order. Replaced segments are never retained. */
32
+ readonly retained: readonly KodaXOutputSegmentActiveState[];
33
+ readonly active?: KodaXOutputSegmentActiveState;
34
+ }
35
+ type KodaXOutputSegmentProjectionEvent = ({
36
+ readonly type: 'segment.started';
37
+ readonly startedAtSeq?: number;
38
+ } & KodaXOutputSegmentStarted) | ({
39
+ readonly type: 'assistant.delta';
40
+ } & KodaXOutputSegmentDelta) | ({
41
+ readonly type: 'thinking.delta';
42
+ } & KodaXOutputSegmentDelta);
43
+ interface KodaXOutputSegmentProjectionResult {
44
+ readonly state: KodaXOutputSegmentProjection;
45
+ readonly accepted: boolean;
46
+ }
47
+ declare function createOutputSegmentProjection(): KodaXOutputSegmentProjection;
48
+ declare function reduceOutputSegmentProjection(state: KodaXOutputSegmentProjection, event: KodaXOutputSegmentProjectionEvent): KodaXOutputSegmentProjectionResult;
49
+ declare function effectiveOutputSegmentText(state: KodaXOutputSegmentProjection, kind: 'assistant' | 'thinking'): string;
50
+
11
51
  /**
12
52
  * FEATURE_192 v0.7.44 Phase C — Goal-tools execution context.
13
53
  *
@@ -1696,6 +1736,8 @@ interface KodaXTurnFailedEvent extends KodaXLiveEventMeta {
1696
1736
  };
1697
1737
  }
1698
1738
  interface KodaXActivityEventMeta extends KodaXWorkflowEventMeta, Partial<KodaXLiveEventMeta> {
1739
+ /** Physical provider request currently producing this live output. */
1740
+ readonly providerRequestId?: string;
1699
1741
  readonly childAgentId?: string;
1700
1742
  readonly childAgentName?: string;
1701
1743
  readonly parentToolId?: string;
@@ -1882,9 +1924,14 @@ interface KodaXPromptCacheDiagnosticEvent {
1882
1924
  readonly cachedReadTokens?: number;
1883
1925
  readonly cachedWriteTokens?: number;
1884
1926
  }
1927
+ interface KodaXUserInputPromptContext {
1928
+ /** Aborted when the Runtime resolves, expires, or dismisses the interaction. */
1929
+ readonly signal: AbortSignal;
1930
+ }
1885
1931
  interface KodaXEvents {
1886
1932
  /** FEATURE_229: correlates child-agent SDK callbacks back to a workflow run/item. */
1887
1933
  workflowCorrelation?: WorkflowEventCorrelation;
1934
+ onOutputSegmentStart?: (segment: KodaXOutputSegmentStarted, meta?: KodaXActivityEventMeta) => void;
1888
1935
  onTextDelta?: (text: string, meta?: KodaXActivityEventMeta) => void;
1889
1936
  onThinkingDelta?: (text: string, meta?: KodaXActivityEventMeta) => void;
1890
1937
  onThinkingEnd?: (thinking: string, meta?: KodaXActivityEventMeta) => void;
@@ -2128,14 +2175,14 @@ interface KodaXEvents {
2128
2175
  beforeToolExecute?: (tool: string, input: Record<string, unknown>, meta?: KodaXToolEventMeta) => Promise<boolean | string>;
2129
2176
  /** Ask user a question interactively - Issue 069. Select answers may be
2130
2177
  * strings, arrays, or structured custom-input answers. */
2131
- askUser?: (options: AskUserQuestionOptions, meta?: KodaXToolEventMeta) => Promise<AskUserAnswer>;
2178
+ askUser?: (options: AskUserQuestionOptions, meta?: KodaXToolEventMeta, context?: KodaXUserInputPromptContext) => Promise<AskUserAnswer>;
2132
2179
  /** Ask user multiple independent questions sequentially - 澶氶棶棰橀『搴忔彁闂?*/
2133
- askUserMulti?: (options: AskUserMultiOptions, meta?: KodaXToolEventMeta) => Promise<Record<string, AskUserAnswer> | undefined>;
2180
+ askUserMulti?: (options: AskUserMultiOptions, meta?: KodaXToolEventMeta, context?: KodaXUserInputPromptContext) => Promise<Record<string, AskUserAnswer> | undefined>;
2134
2181
  /** Ask user for free-text input - 自由文本输入 (Issue 112) */
2135
2182
  askUserInput?: (options: {
2136
2183
  question: string;
2137
2184
  default?: string;
2138
- }, meta?: KodaXToolEventMeta) => Promise<string | undefined>;
2185
+ }, meta?: KodaXToolEventMeta, context?: KodaXUserInputPromptContext) => Promise<string | undefined>;
2139
2186
  /**
2140
2187
  * FEATURE_074: Exit plan mode with user approval. Called by the `exit_plan_mode` tool.
2141
2188
  * Returns:
@@ -4171,5 +4218,5 @@ interface CreateBashPrefixExtractorOptions {
4171
4218
  */
4172
4219
  declare function createBashPrefixExtractor(opts: CreateBashPrefixExtractorOptions): BashPrefixExtractor;
4173
4220
 
4174
- export { ALWAYS_RESIDENT_TOOL_NAMES as A, BASH_POLICY_SPEC as a, providerResilienceConfigFromTimeouts as b$, LSP_SERVERS as b2, LspService as b4, buildGoalRuntimeBinding as bK, consumeCompactionCooldown as bL, createBashPrefixExtractor as bM, createCompactionAntiThrashState as bN, createExternalActorTurnExecutor as bO, createLocalCodingActorControl as bP, createRuntimeContextBudgetSnapshot as bQ, decideWorkflowInvocation as bR, drainPendingSwaps as bS, estimateToolSchemaTokens as bT, extractCommandPrefix as bU, getDefaultLspService as bV, hasExplicitNaturalLanguageWorkflowIntent as bW, hasPendingSwap as bX, makeDisabledGoalToolsContext as bY, normalizeKodaXAgentMode as bZ, planToolExposure as b_, recordCompactionSavings as c0, resolveConstructedAgent as c1, shouldSkipLlmCompaction as c2, shutdownDefaultLspService as c3, withGoalBeforeNextTurn as c4, withGoalStopHook as c5, workflowStartOutcomeConsumesTurn as c6, CodingActorSession as d };
4175
- export type { KodaXManualTopicId as $, BashPrefixExtractor as B, CapabilityRuntimeContract as C, DiagnosticsRequest as D, ExtensionRuntimeContract as E, FailureStage as F, GoalBlockedResult as G, KodaXCompactionEndResult as H, KodaXCompactionFailureReason as I, KodaXCompactionOverride as J, KodaXActivityEventMeta as K, KodaXContextCompactionFinishedEvent as L, KodaXContextIdentity as M, KodaXContextOptions as N, KodaXContextTokenSnapshot as O, KodaXEffectiveTaskConfig as P, KodaXEvents as Q, RunScopedToolDefinition as R, KodaXFileSystemEffectLease as S, KodaXLiveEventMeta as T, KodaXManagedBudgetSnapshot as U, KodaXManagedTask as V, KodaXManagedTaskRuntimeState as W, KodaXManagedTaskStatusEvent as X, KodaXManualIndexTopic as Y, KodaXManualSource as Z, KodaXManualTopic as _, KodaXWorkflowAgentDigestEvent as a$, KodaXManualTopicInput as a0, KodaXMemoryStrategy as a1, KodaXOptions as a2, KodaXOrchestrationVerdict as a3, KodaXParentReductionContract as a4, KodaXPreparedShellSandboxInvocation as a5, KodaXPromptCacheDiagnosticEvent as a6, KodaXProviderPolicyHints as a7, KodaXRepoIntelligenceCapability as a8, KodaXRepoIntelligenceMode as a9, KodaXSkillScriptRunInput as aA, KodaXSkillScriptRunner as aB, KodaXTaskCapabilityHint as aC, KodaXTaskContract as aD, KodaXTaskEvidenceArtifact as aE, KodaXTaskEvidenceBundle as aF, KodaXTaskEvidenceEntry as aG, KodaXTaskRole as aH, KodaXTaskRoleAssignment as aI, KodaXTaskStatus as aJ, KodaXTaskSurface as aK, KodaXTaskToolPolicy as aL, KodaXTaskVerificationContract as aM, KodaXTaskVerificationCriterion as aN, KodaXTaskWorkItem as aO, KodaXTimeoutConfig as aP, KodaXToolEventMeta as aQ, KodaXToolExecutionContext as aR, KodaXToolSandboxObservationUpdate as aS, KodaXToolVisibilityMeta as aT, KodaXToolVisibilityPolicy as aU, KodaXTurnCompletedEvent as aV, KodaXTurnDeliveryKind as aW, KodaXTurnFailedEvent as aX, KodaXTurnStartedEvent as aY, KodaXVerificationScorecard as aZ, KodaXVerificationScorecardCriterion as a_, KodaXRepoIntelligenceResolvedMode as aa, KodaXRepoIntelligenceTrace as ab, KodaXRepoIntelligenceTraceEvent as ac, KodaXRepoRoutingSignals as ad, KodaXResult as ae, KodaXRoleRoundSummary as af, KodaXRuntimeVerificationContract as ag, KodaXSandboxOptions as ah, KodaXSelfManualConfig as ai, KodaXSessionControl as aj, KodaXSessionMutators as ak, KodaXSessionOptions as al, KodaXShellExecutionContract as am, KodaXShellKind as an, KodaXShellProfileMode as ao, KodaXShellSandbox as ap, KodaXShellSandboxBackend as aq, KodaXShellSandboxObservation as ar, KodaXShellSandboxPrepareInput as as, KodaXSidecarMessageEvent as at, KodaXSkillDynamicContextPolicy as au, KodaXSkillInvocationContext as av, KodaXSkillMap as aw, KodaXSkillProjectionConfidence as ax, KodaXSkillScriptInputFile as ay, KodaXSkillScriptOutputFile as az, BashPrefixResult as b, KodaXWorkflowEventMeta as b0, KodaXWorkflowTimeoutConfig as b1, LspServerInfo as b3, LspServiceConfig as b5, ProviderExecutionState as b6, ProviderRecoveryEvent as b7, ProviderResilienceConfig as b8, ProviderResiliencePolicy as b9, WorkflowHostPolicy as bA, WorkflowInvocationAction as bB, WorkflowInvocationPolicyDecision as bC, WorkflowInvocationPolicyInput as bD, WorkflowInvocationSource as bE, WorkflowStartOutcome as bF, WorkflowToolHost as bG, WorkflowToolHostInlineInput as bH, WorkflowToolHostResult as bI, WorkflowToolHostStartResult as bJ, RecoveryAction as ba, RecoveryDecision as bb, RecoveryLadderStep as bc, RecoveryResult as bd, ResilienceClassification as be, ResilienceErrorClass as bf, ResolveKodaXManualInput as bg, ResolveKodaXManualOptions as bh, ResolveKodaXManualResult as bi, RuntimeCompactionSkippedEvent as bj, RuntimeContextBudgetBreakdown as bk, RuntimeContextBudgetRecommendation as bl, RuntimeContextBudgetSnapshot as bm, RuntimeContextBudgetSnapshotInput as bn, RuntimeContextOptimizationProfile as bo, RuntimeContextPressure as bp, RuntimeDefaultsSnapshot as bq, RuntimeToolExposureDecision as br, RuntimeToolExposureMode as bs, RuntimeToolExposurePlan as bt, RuntimeToolExposurePlanInput as bu, RuntimeToolExposureReason as bv, TodoItem as bw, TodoList as bx, TodoStatus as by, ToolSideEffect as bz, BoundExtensionRuntimeController as c, KodaXManagedProtocolPayload as c7, KodaXActorHost as c8, KodaXChildExecutionResult as c9, CodingActorSessionOptions as e, CompactionAntiThrashConfig as f, CompactionAntiThrashState as g, CompactionSavingsDecision as h, CompactionSavingsSample as i, CompactionSkipReason as j, CreateBashPrefixExtractorOptions as k, ExtractCommandPrefixOptions as l, GoalCompleteResult as m, GoalCreateInput as n, GoalLifecycleContext as o, GoalRuntimeBinding as p, GoalRuntimeBindingDeps as q, GoalToolsContext as r, KodaXAgentMode as s, KodaXAgentProfile as t, KodaXAgentScope as u, KodaXBudgetDisclosureZone as v, KodaXBudgetExtensionRequest as w, KodaXCanonicalAgentMode as x, KodaXChildAgentResult as y, KodaXChildContextBundle as z };
4221
+ export { ALWAYS_RESIDENT_TOOL_NAMES as A, BASH_POLICY_SPEC as a, drainPendingSwaps as b$, buildGoalRuntimeBinding as bS, consumeCompactionCooldown as bT, createBashPrefixExtractor as bU, createCompactionAntiThrashState as bV, createExternalActorTurnExecutor as bW, createLocalCodingActorControl as bX, createOutputSegmentProjection as bY, createRuntimeContextBudgetSnapshot as bZ, decideWorkflowInvocation as b_, LSP_SERVERS as ba, LspService as bc, effectiveOutputSegmentText as c0, estimateToolSchemaTokens as c1, extractCommandPrefix as c2, getDefaultLspService as c3, hasExplicitNaturalLanguageWorkflowIntent as c4, hasPendingSwap as c5, makeDisabledGoalToolsContext as c6, normalizeKodaXAgentMode as c7, planToolExposure as c8, providerResilienceConfigFromTimeouts as c9, recordCompactionSavings as ca, reduceOutputSegmentProjection as cb, resolveConstructedAgent as cc, shouldSkipLlmCompaction as cd, shutdownDefaultLspService as ce, withGoalBeforeNextTurn as cf, withGoalStopHook as cg, workflowStartOutcomeConsumesTurn as ch, CodingActorSession as d };
4222
+ export type { KodaXManualTopicId as $, BashPrefixExtractor as B, CapabilityRuntimeContract as C, DiagnosticsRequest as D, ExtensionRuntimeContract as E, FailureStage as F, GoalBlockedResult as G, KodaXCompactionEndResult as H, KodaXCompactionFailureReason as I, KodaXCompactionOverride as J, KodaXActivityEventMeta as K, KodaXContextCompactionFinishedEvent as L, KodaXContextIdentity as M, KodaXContextOptions as N, KodaXContextTokenSnapshot as O, KodaXEffectiveTaskConfig as P, KodaXEvents as Q, RunScopedToolDefinition as R, KodaXFileSystemEffectLease as S, KodaXLiveEventMeta as T, KodaXManagedBudgetSnapshot as U, KodaXManagedTask as V, KodaXManagedTaskRuntimeState as W, KodaXManagedTaskStatusEvent as X, KodaXManualIndexTopic as Y, KodaXManualSource as Z, KodaXManualTopic as _, KodaXToolVisibilityPolicy as a$, KodaXManualTopicInput as a0, KodaXMemoryStrategy as a1, KodaXOptions as a2, KodaXOrchestrationVerdict as a3, KodaXOutputSegmentActiveState as a4, KodaXOutputSegmentDelta as a5, KodaXOutputSegmentMode as a6, KodaXOutputSegmentProjection as a7, KodaXOutputSegmentProjectionEvent as a8, KodaXOutputSegmentProjectionResult as a9, KodaXSidecarMessageEvent as aA, KodaXSkillDynamicContextPolicy as aB, KodaXSkillInvocationContext as aC, KodaXSkillMap as aD, KodaXSkillProjectionConfidence as aE, KodaXSkillScriptInputFile as aF, KodaXSkillScriptOutputFile as aG, KodaXSkillScriptRunInput as aH, KodaXSkillScriptRunner as aI, KodaXTaskCapabilityHint as aJ, KodaXTaskContract as aK, KodaXTaskEvidenceArtifact as aL, KodaXTaskEvidenceBundle as aM, KodaXTaskEvidenceEntry as aN, KodaXTaskRole as aO, KodaXTaskRoleAssignment as aP, KodaXTaskStatus as aQ, KodaXTaskSurface as aR, KodaXTaskToolPolicy as aS, KodaXTaskVerificationContract as aT, KodaXTaskVerificationCriterion as aU, KodaXTaskWorkItem as aV, KodaXTimeoutConfig as aW, KodaXToolEventMeta as aX, KodaXToolExecutionContext as aY, KodaXToolSandboxObservationUpdate as aZ, KodaXToolVisibilityMeta as a_, KodaXOutputSegmentStarted as aa, KodaXParentReductionContract as ab, KodaXPreparedShellSandboxInvocation as ac, KodaXPromptCacheDiagnosticEvent as ad, KodaXProviderPolicyHints as ae, KodaXRepoIntelligenceCapability as af, KodaXRepoIntelligenceMode as ag, KodaXRepoIntelligenceResolvedMode as ah, KodaXRepoIntelligenceTrace as ai, KodaXRepoIntelligenceTraceEvent as aj, KodaXRepoRoutingSignals as ak, KodaXResult as al, KodaXRoleRoundSummary as am, KodaXRuntimeVerificationContract as an, KodaXSandboxOptions as ao, KodaXSelfManualConfig as ap, KodaXSessionControl as aq, KodaXSessionMutators as ar, KodaXSessionOptions as as, KodaXShellExecutionContract as at, KodaXShellKind as au, KodaXShellProfileMode as av, KodaXShellSandbox as aw, KodaXShellSandboxBackend as ax, KodaXShellSandboxObservation as ay, KodaXShellSandboxPrepareInput as az, BashPrefixResult as b, KodaXTurnCompletedEvent as b0, KodaXTurnDeliveryKind as b1, KodaXTurnFailedEvent as b2, KodaXTurnStartedEvent as b3, KodaXUserInputPromptContext as b4, KodaXVerificationScorecard as b5, KodaXVerificationScorecardCriterion as b6, KodaXWorkflowAgentDigestEvent as b7, KodaXWorkflowEventMeta as b8, KodaXWorkflowTimeoutConfig as b9, RuntimeToolExposureMode as bA, RuntimeToolExposurePlan as bB, RuntimeToolExposurePlanInput as bC, RuntimeToolExposureReason as bD, TodoItem as bE, TodoList as bF, TodoStatus as bG, ToolSideEffect as bH, WorkflowHostPolicy as bI, WorkflowInvocationAction as bJ, WorkflowInvocationPolicyDecision as bK, WorkflowInvocationPolicyInput as bL, WorkflowInvocationSource as bM, WorkflowStartOutcome as bN, WorkflowToolHost as bO, WorkflowToolHostInlineInput as bP, WorkflowToolHostResult as bQ, WorkflowToolHostStartResult as bR, LspServerInfo as bb, LspServiceConfig as bd, ProviderExecutionState as be, ProviderRecoveryEvent as bf, ProviderResilienceConfig as bg, ProviderResiliencePolicy as bh, RecoveryAction as bi, RecoveryDecision as bj, RecoveryLadderStep as bk, RecoveryResult as bl, ResilienceClassification as bm, ResilienceErrorClass as bn, ResolveKodaXManualInput as bo, ResolveKodaXManualOptions as bp, ResolveKodaXManualResult as bq, RuntimeCompactionSkippedEvent as br, RuntimeContextBudgetBreakdown as bs, RuntimeContextBudgetRecommendation as bt, RuntimeContextBudgetSnapshot as bu, RuntimeContextBudgetSnapshotInput as bv, RuntimeContextOptimizationProfile as bw, RuntimeContextPressure as bx, RuntimeDefaultsSnapshot as by, RuntimeToolExposureDecision as bz, BoundExtensionRuntimeController as c, KodaXManagedProtocolPayload as ci, KodaXActorHost as cj, KodaXChildExecutionResult as ck, CodingActorSessionOptions as e, CompactionAntiThrashConfig as f, CompactionAntiThrashState as g, CompactionSavingsDecision as h, CompactionSavingsSample as i, CompactionSkipReason as j, CreateBashPrefixExtractorOptions as k, ExtractCommandPrefixOptions as l, GoalCompleteResult as m, GoalCreateInput as n, GoalLifecycleContext as o, GoalRuntimeBinding as p, GoalRuntimeBindingDeps as q, GoalToolsContext as r, KodaXAgentMode as s, KodaXAgentProfile as t, KodaXAgentScope as u, KodaXBudgetDisclosureZone as v, KodaXBudgetExtensionRequest as w, KodaXCanonicalAgentMode as x, KodaXChildAgentResult as y, KodaXChildContextBundle as z };
@@ -1,6 +1,6 @@
1
1
  import { b as KodaXMessage } from './types.d-Cv09EdJR.js';
2
- import { d as AgentMessage, y as SessionEntry, S as Session, z as SessionExtension, ab as CompactionDetails, ac as FileOperations, ad as WorkflowMeta, ae as WorkflowModelHint, af as WorkflowModule } from './controller.d-1tydJm7c.js';
3
- import { K as KodaXSessionLineage, C as KodaXJsonValue, z as KodaXCompactMemorySeed, G as KodaXSessionEntry, R as KodaXSessionTreeNode, I as KodaXSessionLabelEntry, ad as KodaXSessionGoalEntry, ae as KodaXSessionClientNoticeEntry, af as KodaXSessionRewindMarkerEntry, ag as KodaXSessionMemoryOutcomeDigestEntry, ah as KodaXSessionMemoryReviewReceiptEntry, N as KodaXSessionNavigationOptions, b as KodaXSessionArtifactLedgerEntry } from './types.d-DeokRBs7.js';
2
+ import { d as AgentMessage, y as SessionEntry, S as Session, z as SessionExtension, ab as CompactionDetails, ac as FileOperations, ad as WorkflowMeta, ae as WorkflowModelHint, af as WorkflowModule } from './controller.d-Bm1i9RVj.js';
3
+ import { K as KodaXSessionLineage, C as KodaXJsonValue, z as KodaXCompactMemorySeed, G as KodaXSessionEntry, R as KodaXSessionTreeNode, I as KodaXSessionLabelEntry, ad as KodaXSessionGoalEntry, ae as KodaXSessionClientNoticeEntry, af as KodaXSessionRewindMarkerEntry, ag as KodaXSessionMemoryOutcomeDigestEntry, ah as KodaXSessionMemoryReviewReceiptEntry, N as KodaXSessionNavigationOptions, b as KodaXSessionArtifactLedgerEntry } from './types.d-EjZTEEVu.js';
4
4
 
5
5
  /**
6
6
  * @kodax-ai/agent Constants
@@ -1,5 +1,5 @@
1
1
  import { f as KodaXToolDefinition, b as KodaXMessage, o as KodaXReasoningMode, n as KodaXWireReasoningEffort, R as KodaXToolResultContentItem, L as KodaXThinkingBlock, B as KodaXRedactedThinkingBlock } from './types.d-Cv09EdJR.js';
2
- import { w as MemoryReviewModelInput, v as KodaXMemoryOutcomeDigest, u as MemoryReviewPlan, z as KodaXCompactMemorySeed, b as KodaXSessionArtifactLedgerEntry, ap as AgentCapabilities, ak as AgentTurnExecutor, a4 as AgentExecutionKind, al as AgentBudgetPort, aj as AgentActorStore, am as AgentActorOwner, ac as AgentEvent, aq as AgentMailboxMessage, an as AgentActorClient, ao as AgentExecutionResult, a7 as AgentSpawnInput, ar as AgentMutationOptions, a8 as AgentTurnRef, a9 as AgentDataClassification, as as AgentMetadataValue, aa as AgentFollowupResult, at as AgentInterruptScope, a5 as AgentTreeSnapshot, a6 as AgentDetail, ab as AgentOutput } from './types.d-DeokRBs7.js';
2
+ import { w as MemoryReviewModelInput, v as KodaXMemoryOutcomeDigest, u as MemoryReviewPlan, z as KodaXCompactMemorySeed, b as KodaXSessionArtifactLedgerEntry, ap as AgentCapabilities, ak as AgentTurnExecutor, a4 as AgentExecutionKind, al as AgentBudgetPort, aj as AgentActorStore, am as AgentActorOwner, ac as AgentEvent, aq as AgentMailboxMessage, an as AgentActorClient, ao as AgentExecutionResult, a7 as AgentSpawnInput, ar as AgentMutationOptions, a8 as AgentTurnRef, a9 as AgentDataClassification, as as AgentMetadataValue, aa as AgentFollowupResult, at as AgentInterruptScope, a5 as AgentTreeSnapshot, a6 as AgentDetail, ab as AgentOutput } from './types.d-EjZTEEVu.js';
3
3
 
4
4
  /**
5
5
  * Layer A Primitive: Agent / Handoff / Guardrail / AgentReasoningProfile
@@ -1973,6 +1973,8 @@ interface AskUserQuestionItem {
1973
1973
  * of parsing it out of natural-language question text.
1974
1974
  */
1975
1975
  maxSelections?: number;
1976
+ /** Runtime-validated option value selected if the interaction expires. */
1977
+ default?: string;
1976
1978
  /**
1977
1979
  * Choice surfaces are open-ended by default: hosts SHOULD offer a synthetic
1978
1980
  * custom-input option unless this is explicitly false.
@@ -2001,6 +2003,7 @@ interface AskUserQuestionOptions {
2001
2003
  minSelections?: number;
2002
2004
  /** FEATURE_222 — see {@link AskUserQuestionItem.maxSelections}. */
2003
2005
  maxSelections?: number;
2006
+ /** Input text or a Runtime-validated option value selected on expiry. */
2004
2007
  default?: string;
2005
2008
  /**
2006
2009
  * Choice surfaces are open-ended by default: hosts SHOULD offer a synthetic
@@ -2041,6 +2044,11 @@ declare function isAskUserCustomInputAnswer(value: unknown): value is AskUserCus
2041
2044
  * predictably instead of leaking `[object Array]` into a string comparison.
2042
2045
  */
2043
2046
  declare function asSingleSelection(answer: AskUserAnswer): string;
2047
+ /** Lifecycle signal supplied by a bounded interaction owner. */
2048
+ interface UserInteractionPromptContext {
2049
+ /** Aborted when the interaction expires or its owner settles it elsewhere. */
2050
+ readonly signal: AbortSignal;
2051
+ }
2044
2052
  /**
2045
2053
  * The host-provided user-interaction surface. Each method is optional — a
2046
2054
  * headless host omits them and callers degrade gracefully. This is the single
@@ -2055,16 +2063,16 @@ interface UserInteraction {
2055
2063
  * return `{ kind: 'customInput', value }` in the single or array position.
2056
2064
  * Plain string/string[] hosts remain valid for backward compatibility.
2057
2065
  */
2058
- askUser?: (options: AskUserQuestionOptions) => Promise<AskUserAnswer>;
2066
+ askUser?: (options: AskUserQuestionOptions, context?: UserInteractionPromptContext) => Promise<AskUserAnswer>;
2059
2067
  /** Ask several independent questions sequentially. Resolves a per-question
2060
2068
  * value map using the same `AskUserAnswer` shape as `askUser`, or undefined
2061
2069
  * when the user cancels. */
2062
- askUserMulti?: (options: AskUserMultiOptions) => Promise<Record<string, AskUserAnswer> | undefined>;
2070
+ askUserMulti?: (options: AskUserMultiOptions, context?: UserInteractionPromptContext) => Promise<Record<string, AskUserAnswer> | undefined>;
2063
2071
  /** Ask for free-text input. Resolves the text, or undefined when cancelled. */
2064
2072
  askUserInput?: (options: {
2065
2073
  question: string;
2066
2074
  default?: string;
2067
- }) => Promise<string | undefined>;
2075
+ }, context?: UserInteractionPromptContext) => Promise<string | undefined>;
2068
2076
  }
2069
2077
  /** Register the live user-interaction surface (host calls this when interactive). */
2070
2078
  declare function setActiveUserInteraction(interaction: UserInteraction | undefined): void;
@@ -3940,5 +3948,5 @@ declare class AgentActorController {
3940
3948
  }
3941
3949
  declare function createAgentActorController(options?: AgentControllerOptions): Promise<AgentActorController>;
3942
3950
 
3943
- export { createAgent as E, createHandoff as F, createInMemorySession as J, registerPresetDispatcher as L, LearnedAreaStore as aD, ASK_USER_BACK_SIGNAL as aR, ASK_USER_CUSTOM_INPUT_SIGNAL as aS, AgentActorController as aX, DEFAULT_SYSTEM_CAP as bC, GuardrailBlockedError as bP, GuardrailEscalateError as bR, InvariantSession as bX, Tracer as c$, RunnerIterationLimitError as cD, SpanImpl as cO, LearningCapabilityError as cg, MAX_TOOL_LOOP_ITERATIONS as cr, createWorkflowProcessTracker as d$, WorkflowEventRecorder as d8, _resetAdmittedAgentBindings as dG, _resetPresetDispatchers as dH, admitAndRecordLearnedSkillInvocation as dI, admitLearnedSkillBinding as dJ, asSingleSelection as dK, assertLearnedCapabilityTransition as dL, attachRunnerRecoveryTranscript as dM, buildAssistantMessageFromLlmResult as dN, buildSystemPrompt as dO, buildToolResultMessage as dP, canTransitionLearnedCapability as dQ, collectGuardrails as dR, commitLearnedSkillRevision as dS, completeLearnedSkillOutcome as dT, completeLearnedSkillSessionOutcomes as dU, createAgentActorController as dV, createInvariantSessionForAgent as dW, createLearnedCapabilityScope as dX, createLearnedSkillRecord as dY, createStateWriter as dZ, createTrace as d_, defaultTracer as e0, detectInstructionsInjection as e1, discoverInstances as e2, eventFromCapability as e3, exactInvokedSkillSnapshotForSession as e4, executeRunnerToolCall as e5, extractAssistantTextFromMessage as e6, getActiveUserInteraction as e7, getAdmittedAgentBindings as e8, invokeLearnedSkillCanary as e9, setActiveUserInteraction as eA, setAdmittedAgentBindings as eB, slugifyLearnedCapabilityName as eC, stageLearnedSkillRevision as eD, validateDeclarativeSkillSpec as eE, isAskUserCustomInputAnswer as ea, isFinalWorkflowProcessStatus as eb, isLearnedCapabilityRecordV2 as ec, isRunnableTool as ed, isRunnerIterationLimitError as ee, isRunnerLlmResult as ef, isUnifiedLearningReviewModelInput as eg, learningEventIdFor as eh, learningEventKindForLifecycle as ei, listLearnedSkillUsageReceipts as ej, normalizeHostMetadata as ek, normalizeUnifiedLearningReview as el, quarantineLearnedSkillRevision as em, readRunnerRecoveryTranscript as en, reconcileLearnedSkillBindingOutcomes as eo, recordLearnedSkillOffered as ep, releaseLearnedSkillBinding as eq, renderDeclarativeSkill as er, resolveLearnedAreaPaths as es, resolveProjectLearnedAreaRoot as et, runAdmissionAudit as eu, runInputGuardrails as ev, runOutputGuardrails as ew, runToolAfterGuardrails as ex, runToolBeforeGuardrails as ey, sanitizeUnifiedLearningReviewInput as ez, Runner as x };
3944
- export type { AgentDispatchPolicy as $, Agent as A, SessionForkOptions as B, CompactionAnchor as C, WorkflowEventCorrelation as D, Guardrail as G, Handoff as H, InMemorySessionOptions as I, KodaXInputArtifact as K, MessageEntry as M, WorkflowProcessSource as N, LearningSurfaceSnapshot as O, PresetDispatcher as P, LearningQuery as Q, ReasoningDepth as R, Session as S, LearningPage as T, LearnedCapabilityRecord as U, LearningEvent as V, WorkflowProcessTrackerOptions as W, LearningSubscribeOptions as X, CompactionReport as Y, AgentDispatchContext as Z, AgentExecutorFactory as _, WorkflowEvent as a, AgentCapabilityDeclaration as a$, AgentCredentialBroker as a0, AgentArtifactPolicy as a1, AgentRegistrationService as a2, DispatchableAgentQuery as a3, DispatchableAgentListing as a4, AgentPreflightInput as a5, AgentPreflightResult as a6, RunnerToolCall as a7, ToolGuardrail as a8, ExternalAgentRegistration as a9, StopHookResult as aA, LearningActionDriver as aB, LearningExplicitUserAuthority as aC, LearnedCapabilityScope as aE, CompactionConfig as aF, WorkflowRunState as aG, WorkflowOutcome as aH, WorkflowApi as aI, WorkflowAgentBackend as aJ, WorkflowLimits as aK, WorkflowLogEvent as aL, WorkflowTaskResult as aM, AgentExecutorPlaneStore as aN, CreateAgentExecutorPlaneOptions as aO, AgentExecutorPlane as aP, ExternalAgentProtocol as aQ, AdmissionAuditOptions as aT, AdmissionCtx as aU, AdmissionVerdict as aV, AdmittedHandle as aW, AgentArtifactPolicyDecision as aY, AgentArtifactPolicyInput as aZ, AgentArtifactReference as a_, AgentEffectDeclaration as aa, CompactionDetails as ab, FileOperations as ac, WorkflowMeta as ad, WorkflowModelHint as ae, WorkflowModule as af, StopHookFn as ag, AgentControllerHealth as ah, AgentExecutorPlaneBinding as ai, WorkflowIsolation as aj, GuardrailPermissionIntent as ak, DiscoveredInstance as al, UnifiedLearningReviewRunner as am, Span as an, Trace as ao, RunnerToolResult as ap, AgentManifest as aq, ManifestPatch as ar, InvariantId as as, QualityInvariant as at, SessionMeta as au, SessionStateSnapshot as av, StateWriterFs as aw, InstanceDiscoveryFs as ax, StateWriter as ay, StopHookContext as az, WorkflowProcessSnapshot as b, LearnedCapabilityCanaryBinding as b$, AgentCapabilityRequirements as b0, AgentContinuationInput as b1, AgentControllerOptions as b2, AgentDispatchPolicyDecision as b3, AgentDispatchPolicyInput as b4, AgentDispatchabilitySnapshot as b5, AgentDispatchabilityStatus as b6, AgentExecutor as b7, AgentExecutorEvent as b8, AgentExecutorFactoryContext as b9, CreateLearnedSkillRecordInput as bA, CurrentTodoSummary as bB, DeclarativeSkillSpec as bD, Deliverable as bE, DiscoveryOptions as bF, DispatchableAgentDescriptor as bG, DispatchableAgentOrigin as bH, EvidenceSpanData as bI, ExactInvokedSkillSnapshot as bJ, ExternalAgentEffectDeclaration as bK, ExternalAgentHealth as bL, ExternalAgentRegistrationSummary as bM, FanoutSpanData as bN, GenerationSpanData as bO, GuardrailContext as bQ, GuardrailSpanData as bS, GuardrailVerdict as bT, HandoffSpanData as bU, InputGuardrail as bV, InvariantResult as bW, LearnedAreaPaths as bY, LearnedCapabilityArtifact as bZ, LearnedCapabilityCanary as b_, AgentExecutorPlaneBackgroundErrorContext as ba, AgentExecutorPlaneBackgroundErrorHandler as bb, AgentExecutorPreflightResult as bc, AgentExecutorProtocol as bd, AgentExecutorTaskReference as be, AgentExecutorTaskSnapshot as bf, AgentJsonObject as bg, AgentJsonValue as bh, AgentMiddlewareDeclaration as bi, AgentRegistrationEnabledMutationOptions as bj, AgentRegistrationMutationOptions as bk, AgentSpanData as bl, AgentTaskCancellation as bm, AgentTaskCorrelation as bn, AgentTaskEvent as bo, AgentTaskFilter as bp, AgentTaskProgress as bq, AgentTaskRegistrationSnapshot as br, AgentTaskService as bs, AgentTaskSnapshot as bt, AgentTaskStartInput as bu, AgentTaskState as bv, AgentTaskUsage as bw, CapabilitySupport as bx, CommitLearnedSkillRevisionInput as by, CompactionSpanData as bz, WorkflowProcessEvent as c, LearnedCapabilityCanaryInvocation as c0, LearnedCapabilityCarrier as c1, LearnedCapabilityLifecycle as c2, LearnedCapabilityProvenance as c3, LearnedCapabilityRecordV1 as c4, LearnedCapabilityRecordV2 as c5, LearnedCapabilitySource as c6, LearnedSkillBindingAdmission as c7, LearnedSkillCanaryOutcome as c8, LearnedSkillDecisionDisposition as c9, RecentlyModifiedFile as cA, RunnableTool as cB, RunnerEvent as cC, RunnerLlmResult as cE, RunnerLlmReturn as cF, RunnerRecoveryTranscriptCarrier as cG, RunnerToolContext as cH, RunnerToolObserver as cI, RunnerToolResultBatch as cJ, RunnerToolResultBatchTransform as cK, SessionDispatchResult as cL, SpanData as cM, SpanError as cN, SpanImplOptions as cP, StagedLearnedSkillArtifact as cQ, StartTraceOptions as cR, StateWriterOptions as cS, StopHookSpanData as cT, SystemCap as cU, TerminalCtx as cV, ToolBeforeOutcome as cW, ToolCallSpanData as cX, ToolCapability as cY, ToolPermission as cZ, TraceOptions as c_, LearnedSkillInvocationAdmission as ca, LearnedSkillInvokedReceipt as cb, LearnedSkillOfferedReceipt as cc, LearnedSkillOutcomeReceipt as cd, LearnedSkillUsageReceipt as ce, LearningAction as cf, LearningCapabilityErrorCode as ch, LearningClientEventState as ci, LearningClientRecord as cj, LearningEventKind as ck, LearningNotificationState as cl, LearningReviewEvidencePacket as cm, LearningReviewQualification as cn, LearningReviewVerifierFact as co, LocalAgentTaskInput as cp, LocalAgentTaskUpdate as cq, MemoryDecisionTraceReceipt as cs, NormalizedLearnedSkillDecision as ct, ObserveCtx as cu, OutputGuardrail as cv, PersistedSessionState as cw, PresetTracingContext as cx, ReadonlyMutationTracker as cy, ReadonlyRecorder as cz, AgentMessage as d, TracerOptions as d0, UnifiedLearningReviewModelInput as d1, UnifiedLearningReviewResult as d2, UserInteraction as d3, WorkflowApproval as d4, WorkflowApprovalSummary as d5, WorkflowArtifactRef as d6, WorkflowBudget as d7, WorkflowEventType as d9, WorkflowTaskSummaryKind as dA, WorkflowTaskSummaryUpdate as dB, WorkflowTaskUsage as dC, WorkflowTaskVerification as dD, WorkflowTaskVerificationResult as dE, WorkflowWaitOptions as dF, WorkflowOutcomeError as da, WorkflowOutcomeResult as db, WorkflowOutcomeStatus as dc, WorkflowOutcomeUsage as dd, WorkflowParallelOptions as de, WorkflowProcessArtifact as df, WorkflowProcessCounts as dg, WorkflowProcessItem as dh, WorkflowProcessItemKind as di, WorkflowProcessItemOrigin as dj, WorkflowProcessItemStatus as dk, WorkflowProcessProgress as dl, WorkflowProcessStatus as dm, WorkflowProcessSummaryStatus as dn, WorkflowProcessTokenUsage as dp, WorkflowProcessTracker as dq, WorkflowRun as dr, WorkflowRunStatus as ds, WorkflowSpawnAgentInput as dt, WorkflowSynthesis as du, WorkflowSynthesizeInput as dv, WorkflowTaskHandle as dw, WorkflowTaskSnapshot as dx, WorkflowTaskStatus as dy, WorkflowTaskSummaryEventUpdate as dz, AgentReasoningProfile as e, AgentTool as f, AskUserAnswer as g, AskUserCustomInputAnswer as h, AskUserMultiOptions as i, AskUserQuestionItem as j, AskUserQuestionOptions as k, AskUserSelectionAnswer as l, CompactionResult as m, CompactionUpdate as n, KodaXFileInputArtifact as o, KodaXImageInputArtifact as p, KodaXImageMediaType as q, KodaXInputArtifactSource as r, KodaXVideoInputArtifact as s, KodaXVideoMediaType as t, RunEvent as u, RunOptions as v, RunResult as w, SessionEntry as y, SessionExtension as z };
3951
+ export { createAgent as E, createHandoff as F, createInMemorySession as J, registerPresetDispatcher as L, LearnedAreaStore as aD, ASK_USER_BACK_SIGNAL as aR, ASK_USER_CUSTOM_INPUT_SIGNAL as aS, AgentActorController as aX, DEFAULT_SYSTEM_CAP as bC, GuardrailBlockedError as bP, GuardrailEscalateError as bR, InvariantSession as bX, Tracer as c$, RunnerIterationLimitError as cD, SpanImpl as cO, LearningCapabilityError as cg, MAX_TOOL_LOOP_ITERATIONS as cr, createTrace as d$, WorkflowEventRecorder as d9, _resetAdmittedAgentBindings as dH, _resetPresetDispatchers as dI, admitAndRecordLearnedSkillInvocation as dJ, admitLearnedSkillBinding as dK, asSingleSelection as dL, assertLearnedCapabilityTransition as dM, attachRunnerRecoveryTranscript as dN, buildAssistantMessageFromLlmResult as dO, buildSystemPrompt as dP, buildToolResultMessage as dQ, canTransitionLearnedCapability as dR, collectGuardrails as dS, commitLearnedSkillRevision as dT, completeLearnedSkillOutcome as dU, completeLearnedSkillSessionOutcomes as dV, createAgentActorController as dW, createInvariantSessionForAgent as dX, createLearnedCapabilityScope as dY, createLearnedSkillRecord as dZ, createStateWriter as d_, createWorkflowProcessTracker as e0, defaultTracer as e1, detectInstructionsInjection as e2, discoverInstances as e3, eventFromCapability as e4, exactInvokedSkillSnapshotForSession as e5, executeRunnerToolCall as e6, extractAssistantTextFromMessage as e7, getActiveUserInteraction as e8, getAdmittedAgentBindings as e9, sanitizeUnifiedLearningReviewInput as eA, setActiveUserInteraction as eB, setAdmittedAgentBindings as eC, slugifyLearnedCapabilityName as eD, stageLearnedSkillRevision as eE, validateDeclarativeSkillSpec as eF, invokeLearnedSkillCanary as ea, isAskUserCustomInputAnswer as eb, isFinalWorkflowProcessStatus as ec, isLearnedCapabilityRecordV2 as ed, isRunnableTool as ee, isRunnerIterationLimitError as ef, isRunnerLlmResult as eg, isUnifiedLearningReviewModelInput as eh, learningEventIdFor as ei, learningEventKindForLifecycle as ej, listLearnedSkillUsageReceipts as ek, normalizeHostMetadata as el, normalizeUnifiedLearningReview as em, quarantineLearnedSkillRevision as en, readRunnerRecoveryTranscript as eo, reconcileLearnedSkillBindingOutcomes as ep, recordLearnedSkillOffered as eq, releaseLearnedSkillBinding as er, renderDeclarativeSkill as es, resolveLearnedAreaPaths as et, resolveProjectLearnedAreaRoot as eu, runAdmissionAudit as ev, runInputGuardrails as ew, runOutputGuardrails as ex, runToolAfterGuardrails as ey, runToolBeforeGuardrails as ez, Runner as x };
3952
+ export type { ExternalAgentRegistration as $, Agent as A, SessionForkOptions as B, CompactionAnchor as C, WorkflowEventCorrelation as D, Guardrail as G, Handoff as H, InMemorySessionOptions as I, KodaXInputArtifact as K, MessageEntry as M, WorkflowProcessSource as N, LearningSurfaceSnapshot as O, PresetDispatcher as P, LearningQuery as Q, ReasoningDepth as R, Session as S, LearningPage as T, LearnedCapabilityRecord as U, LearningEvent as V, WorkflowProcessTrackerOptions as W, LearningSubscribeOptions as X, CompactionReport as Y, RunnerToolCall as Z, ToolGuardrail as _, WorkflowEvent as a, AgentCapabilityDeclaration as a$, AgentEffectDeclaration as a0, AgentExecutorFactory as a1, AgentArtifactPolicy as a2, AgentDispatchContext as a3, AgentDispatchPolicy as a4, AgentCredentialBroker as a5, AgentRegistrationService as a6, DispatchableAgentQuery as a7, DispatchableAgentListing as a8, AgentPreflightInput as a9, StopHookResult as aA, LearningActionDriver as aB, LearningExplicitUserAuthority as aC, LearnedCapabilityScope as aE, CompactionConfig as aF, WorkflowRunState as aG, WorkflowOutcome as aH, WorkflowApi as aI, WorkflowAgentBackend as aJ, WorkflowLimits as aK, WorkflowLogEvent as aL, WorkflowTaskResult as aM, AgentExecutorPlaneStore as aN, CreateAgentExecutorPlaneOptions as aO, AgentExecutorPlane as aP, ExternalAgentProtocol as aQ, AdmissionAuditOptions as aT, AdmissionCtx as aU, AdmissionVerdict as aV, AdmittedHandle as aW, AgentArtifactPolicyDecision as aY, AgentArtifactPolicyInput as aZ, AgentArtifactReference as a_, AgentPreflightResult as aa, CompactionDetails as ab, FileOperations as ac, WorkflowMeta as ad, WorkflowModelHint as ae, WorkflowModule as af, StopHookFn as ag, AgentControllerHealth as ah, AgentExecutorPlaneBinding as ai, WorkflowIsolation as aj, GuardrailPermissionIntent as ak, DiscoveredInstance as al, UnifiedLearningReviewRunner as am, Span as an, Trace as ao, RunnerToolResult as ap, AgentManifest as aq, ManifestPatch as ar, InvariantId as as, QualityInvariant as at, SessionMeta as au, SessionStateSnapshot as av, StateWriterFs as aw, InstanceDiscoveryFs as ax, StateWriter as ay, StopHookContext as az, WorkflowProcessSnapshot as b, LearnedCapabilityCanaryBinding as b$, AgentCapabilityRequirements as b0, AgentContinuationInput as b1, AgentControllerOptions as b2, AgentDispatchPolicyDecision as b3, AgentDispatchPolicyInput as b4, AgentDispatchabilitySnapshot as b5, AgentDispatchabilityStatus as b6, AgentExecutor as b7, AgentExecutorEvent as b8, AgentExecutorFactoryContext as b9, CreateLearnedSkillRecordInput as bA, CurrentTodoSummary as bB, DeclarativeSkillSpec as bD, Deliverable as bE, DiscoveryOptions as bF, DispatchableAgentDescriptor as bG, DispatchableAgentOrigin as bH, EvidenceSpanData as bI, ExactInvokedSkillSnapshot as bJ, ExternalAgentEffectDeclaration as bK, ExternalAgentHealth as bL, ExternalAgentRegistrationSummary as bM, FanoutSpanData as bN, GenerationSpanData as bO, GuardrailContext as bQ, GuardrailSpanData as bS, GuardrailVerdict as bT, HandoffSpanData as bU, InputGuardrail as bV, InvariantResult as bW, LearnedAreaPaths as bY, LearnedCapabilityArtifact as bZ, LearnedCapabilityCanary as b_, AgentExecutorPlaneBackgroundErrorContext as ba, AgentExecutorPlaneBackgroundErrorHandler as bb, AgentExecutorPreflightResult as bc, AgentExecutorProtocol as bd, AgentExecutorTaskReference as be, AgentExecutorTaskSnapshot as bf, AgentJsonObject as bg, AgentJsonValue as bh, AgentMiddlewareDeclaration as bi, AgentRegistrationEnabledMutationOptions as bj, AgentRegistrationMutationOptions as bk, AgentSpanData as bl, AgentTaskCancellation as bm, AgentTaskCorrelation as bn, AgentTaskEvent as bo, AgentTaskFilter as bp, AgentTaskProgress as bq, AgentTaskRegistrationSnapshot as br, AgentTaskService as bs, AgentTaskSnapshot as bt, AgentTaskStartInput as bu, AgentTaskState as bv, AgentTaskUsage as bw, CapabilitySupport as bx, CommitLearnedSkillRevisionInput as by, CompactionSpanData as bz, WorkflowProcessEvent as c, LearnedCapabilityCanaryInvocation as c0, LearnedCapabilityCarrier as c1, LearnedCapabilityLifecycle as c2, LearnedCapabilityProvenance as c3, LearnedCapabilityRecordV1 as c4, LearnedCapabilityRecordV2 as c5, LearnedCapabilitySource as c6, LearnedSkillBindingAdmission as c7, LearnedSkillCanaryOutcome as c8, LearnedSkillDecisionDisposition as c9, RecentlyModifiedFile as cA, RunnableTool as cB, RunnerEvent as cC, RunnerLlmResult as cE, RunnerLlmReturn as cF, RunnerRecoveryTranscriptCarrier as cG, RunnerToolContext as cH, RunnerToolObserver as cI, RunnerToolResultBatch as cJ, RunnerToolResultBatchTransform as cK, SessionDispatchResult as cL, SpanData as cM, SpanError as cN, SpanImplOptions as cP, StagedLearnedSkillArtifact as cQ, StartTraceOptions as cR, StateWriterOptions as cS, StopHookSpanData as cT, SystemCap as cU, TerminalCtx as cV, ToolBeforeOutcome as cW, ToolCallSpanData as cX, ToolCapability as cY, ToolPermission as cZ, TraceOptions as c_, LearnedSkillInvocationAdmission as ca, LearnedSkillInvokedReceipt as cb, LearnedSkillOfferedReceipt as cc, LearnedSkillOutcomeReceipt as cd, LearnedSkillUsageReceipt as ce, LearningAction as cf, LearningCapabilityErrorCode as ch, LearningClientEventState as ci, LearningClientRecord as cj, LearningEventKind as ck, LearningNotificationState as cl, LearningReviewEvidencePacket as cm, LearningReviewQualification as cn, LearningReviewVerifierFact as co, LocalAgentTaskInput as cp, LocalAgentTaskUpdate as cq, MemoryDecisionTraceReceipt as cs, NormalizedLearnedSkillDecision as ct, ObserveCtx as cu, OutputGuardrail as cv, PersistedSessionState as cw, PresetTracingContext as cx, ReadonlyMutationTracker as cy, ReadonlyRecorder as cz, AgentMessage as d, TracerOptions as d0, UnifiedLearningReviewModelInput as d1, UnifiedLearningReviewResult as d2, UserInteraction as d3, UserInteractionPromptContext as d4, WorkflowApproval as d5, WorkflowApprovalSummary as d6, WorkflowArtifactRef as d7, WorkflowBudget as d8, WorkflowTaskSummaryEventUpdate as dA, WorkflowTaskSummaryKind as dB, WorkflowTaskSummaryUpdate as dC, WorkflowTaskUsage as dD, WorkflowTaskVerification as dE, WorkflowTaskVerificationResult as dF, WorkflowWaitOptions as dG, WorkflowEventType as da, WorkflowOutcomeError as db, WorkflowOutcomeResult as dc, WorkflowOutcomeStatus as dd, WorkflowOutcomeUsage as de, WorkflowParallelOptions as df, WorkflowProcessArtifact as dg, WorkflowProcessCounts as dh, WorkflowProcessItem as di, WorkflowProcessItemKind as dj, WorkflowProcessItemOrigin as dk, WorkflowProcessItemStatus as dl, WorkflowProcessProgress as dm, WorkflowProcessStatus as dn, WorkflowProcessSummaryStatus as dp, WorkflowProcessTokenUsage as dq, WorkflowProcessTracker as dr, WorkflowRun as ds, WorkflowRunStatus as dt, WorkflowSpawnAgentInput as du, WorkflowSynthesis as dv, WorkflowSynthesizeInput as dw, WorkflowTaskHandle as dx, WorkflowTaskSnapshot as dy, WorkflowTaskStatus as dz, AgentReasoningProfile as e, AgentTool as f, AskUserAnswer as g, AskUserCustomInputAnswer as h, AskUserMultiOptions as i, AskUserQuestionItem as j, AskUserQuestionOptions as k, AskUserSelectionAnswer as l, CompactionResult as m, CompactionUpdate as n, KodaXFileInputArtifact as o, KodaXImageInputArtifact as p, KodaXImageMediaType as q, KodaXInputArtifactSource as r, KodaXVideoInputArtifact as s, KodaXVideoMediaType as t, RunEvent as u, RunOptions as v, RunResult as w, SessionEntry as y, SessionExtension as z };
@@ -1,4 +1,4 @@
1
- import { M as MemoryContextIdentity, a as MemoryItemRef, K as KodaXSessionLineage, b as KodaXSessionArtifactLedgerEntry, c as MemoryEvent, d as MemoryReviewRunner, e as MemoryManagementController, f as MemoryActionProposal, g as MemoryApplyResult, h as MemoryRejectResult, i as MemoryRefFilter, j as MemoryBodySnapshot, k as MemoryRememberInput, l as MemoryRememberResult, m as MemoryLifecycleOperationResult, n as MemoryCuratorInput, o as MemoryGovernanceReport, p as MemoryAutoCuratorInput, q as MemoryAutoCuratorResult, r as MemoryPackInput, s as MemoryPack, t as MemoryReviewInput, u as MemoryReviewPlan, v as KodaXMemoryOutcomeDigest, w as MemoryReviewModelInput, x as MemoryEpisodeReviewResult } from './types.d-DeokRBs7.js';
1
+ import { M as MemoryContextIdentity, a as MemoryItemRef, K as KodaXSessionLineage, b as KodaXSessionArtifactLedgerEntry, c as MemoryEvent, d as MemoryReviewRunner, e as MemoryManagementController, f as MemoryActionProposal, g as MemoryApplyResult, h as MemoryRejectResult, i as MemoryRefFilter, j as MemoryBodySnapshot, k as MemoryRememberInput, l as MemoryRememberResult, m as MemoryLifecycleOperationResult, n as MemoryCuratorInput, o as MemoryGovernanceReport, p as MemoryAutoCuratorInput, q as MemoryAutoCuratorResult, r as MemoryPackInput, s as MemoryPack, t as MemoryReviewInput, u as MemoryReviewPlan, v as KodaXMemoryOutcomeDigest, w as MemoryReviewModelInput, x as MemoryEpisodeReviewResult } from './types.d-EjZTEEVu.js';
2
2
 
3
3
  interface CreateMemoryControlPlaneOptions {
4
4
  readonly cwd: string;
@@ -1,10 +1,10 @@
1
1
  import { M as McpServersConfig, a as McpConnectMode, b as McpServerConfig, c as McpTransportKind } from './config.d-CTPaqsD-.js';
2
2
  import { K as KodaXBaseProvider } from './base.d-JjF6aKsh.js';
3
3
  import { C as CostTracker } from './cost-tracker.d-MTAt6N7b.js';
4
- import { a7 as RunnerToolCall, a8 as ToolGuardrail } from './controller.d-1tydJm7c.js';
4
+ import { Z as RunnerToolCall, _ as ToolGuardrail } from './controller.d-Bm1i9RVj.js';
5
5
  import { b as KodaXMessage } from './types.d-Cv09EdJR.js';
6
6
  import { S as SideQueryDiagnostics } from './side-query.d-DNes6rHA.js';
7
- import { bz as ToolSideEffect } from './bash-prefix-extractor.d-BLlhCRI-.js';
7
+ import { bH as ToolSideEffect } from './bash-prefix-extractor.d-BMi_TJIY.js';
8
8
 
9
9
  /**
10
10
  * FEATURE_200 Phase F (v0.7.45) — MCP domain types extracted from types.ts.
@@ -1,5 +1,5 @@
1
1
  import { b as KodaXMessage } from './types.d-Cv09EdJR.js';
2
- import { K as KodaXSessionLineage } from './types.d-DeokRBs7.js';
2
+ import { K as KodaXSessionLineage } from './types.d-EjZTEEVu.js';
3
3
 
4
4
  type KodaXSessionHistoryScope = 'compacted' | 'all';
5
5
  type KodaXSessionHistorySource = 'user' | 'assistant' | 'system' | 'tool' | 'child_task';
@@ -1,7 +1,7 @@
1
- import { B as BashPrefixExtractor, s as KodaXAgentMode } from './bash-prefix-extractor.d-BLlhCRI-.js';
1
+ import { B as BashPrefixExtractor, s as KodaXAgentMode } from './bash-prefix-extractor.d-BMi_TJIY.js';
2
2
  import { o as KodaXReasoningMode, b as KodaXMessage, a as KodaXTaskResultMetadata } from './types.d-Cv09EdJR.js';
3
- import { O as LearningSurfaceSnapshot$1, Q as LearningQuery, T as LearningPage, U as LearnedCapabilityRecord, V as LearningEvent, X as LearningSubscribeOptions, Y as CompactionReport } from './controller.d-1tydJm7c.js';
4
- import { F as KodaXSessionData, K as KodaXSessionLineage, N as KodaXSessionNavigationOptions, O as KodaXSessionRuntimeInfo, Q as KodaXSessionStorage, G as KodaXSessionEntry, b as KodaXSessionArtifactLedgerEntry, A as KodaXExtensionSessionRecord, S as KodaXSessionUiHistoryItem, P as KodaXSessionScope, a2 as AgentActorSnapshot, a3 as AgentActorSaveAttempt, C as KodaXJsonValue } from './types.d-DeokRBs7.js';
3
+ import { O as LearningSurfaceSnapshot$1, Q as LearningQuery, T as LearningPage, U as LearnedCapabilityRecord, V as LearningEvent, X as LearningSubscribeOptions, Y as CompactionReport } from './controller.d-Bm1i9RVj.js';
4
+ import { F as KodaXSessionData, K as KodaXSessionLineage, N as KodaXSessionNavigationOptions, O as KodaXSessionRuntimeInfo, Q as KodaXSessionStorage, G as KodaXSessionEntry, b as KodaXSessionArtifactLedgerEntry, A as KodaXExtensionSessionRecord, S as KodaXSessionUiHistoryItem, P as KodaXSessionScope, a2 as AgentActorSnapshot, a3 as AgentActorSaveAttempt, C as KodaXJsonValue } from './types.d-EjZTEEVu.js';
5
5
 
6
6
  /**
7
7
  * TextBuffer - Text buffer management class - 文本缓冲区管理类
@@ -1391,7 +1391,7 @@ interface SessionTranscriptEntry {
1391
1391
  readonly parentId: string | null;
1392
1392
  /** Stable logical identity shared by cloned/forked copies of the same entry. */
1393
1393
  readonly logicalId: string;
1394
- /** Root source physical entry id when this transcript entry was cloned/forked. */
1394
+ /** Direct physical predecessor entry id when this transcript entry was cloned/forked. */
1395
1395
  readonly sourceEntryId?: string;
1396
1396
  readonly timestamp: string;
1397
1397
  readonly type: SessionTranscriptEntryType;
@@ -1,8 +1,8 @@
1
- import { e as ResolvedAutoModeSettings, u as CommandDefinition, v as CommandSource, w as CommandInfo, x as Command$1, I as InteractiveContext, C as CommandCallbacks, a as CurrentConfig, y as CommandInvocationRequest, z as CommandWorkflowInvocationRequest, B as RuntimeSurfaceStatus } from './utils.d-0h1NTEsX.js';
2
- import { S as SessionStorage$1, b as PermissionMode, L as LearningBinding } from './public-api.d-CMZa4JPa.js';
3
- import { a2 as KodaXOptions, ae as KodaXResult } from './bash-prefix-extractor.d-BLlhCRI-.js';
4
- import { Q as KodaXSessionStorage, F as KodaXSessionData } from './types.d-DeokRBs7.js';
5
- import { u as AutoModeStats } from './guardrail.d-DqWHIgt6.js';
1
+ import { e as ResolvedAutoModeSettings, u as CommandDefinition, v as CommandSource, w as CommandInfo, x as Command$1, I as InteractiveContext, C as CommandCallbacks, a as CurrentConfig, y as CommandInvocationRequest, z as CommandWorkflowInvocationRequest, B as RuntimeSurfaceStatus } from './utils.d-Qa_Z1w2Q.js';
2
+ import { S as SessionStorage$1, b as PermissionMode, L as LearningBinding } from './public-api.d-ItHKrP7K.js';
3
+ import { a2 as KodaXOptions, al as KodaXResult } from './bash-prefix-extractor.d-BMi_TJIY.js';
4
+ import { Q as KodaXSessionStorage, F as KodaXSessionData } from './types.d-EjZTEEVu.js';
5
+ import { u as AutoModeStats } from './guardrail.d-CKkoea7y.js';
6
6
 
7
7
  interface ReplRuntimePermissionGrantSuggestion {
8
8
  readonly id: string;
@@ -18,6 +18,11 @@ interface ReplRuntimePermissionRequest {
18
18
  readonly risk?: 'low' | 'medium' | 'high';
19
19
  readonly executionCwd?: string;
20
20
  readonly grantSuggestions?: readonly ReplRuntimePermissionGrantSuggestion[];
21
+ readonly createdAt?: string;
22
+ readonly expiresAt?: string;
23
+ }
24
+ interface ReplRuntimePermissionPromptContext {
25
+ readonly signal: AbortSignal;
21
26
  }
22
27
  type ReplRuntimePermissionDecision = {
23
28
  readonly type: 'allow_once';
@@ -31,7 +36,7 @@ type ReplRuntimePermissionDecision = {
31
36
  readonly type: 'reject';
32
37
  readonly reason?: string;
33
38
  };
34
- type ReplRuntimePermissionPrompt = (request: ReplRuntimePermissionRequest) => Promise<ReplRuntimePermissionDecision>;
39
+ type ReplRuntimePermissionPrompt = (request: ReplRuntimePermissionRequest, context: ReplRuntimePermissionPromptContext) => Promise<ReplRuntimePermissionDecision>;
35
40
  declare const RUNTIME_PERMISSION_PENDING_NOTICE = "Runtime state: run active until this approval is resolved.";
36
41
  interface ReplRuntimeAutoModeControl {
37
42
  getStats(sessionId: string): Promise<AutoModeStats | undefined>;
@@ -151,6 +151,7 @@ declare abstract class KodaXAnthropicCompatProvider extends KodaXBaseProvider {
151
151
  readonly supportsThinking = true;
152
152
  protected abstract readonly config: KodaXProviderConfig;
153
153
  private _client?;
154
+ private _clientPromise?;
154
155
  /**
155
156
  * The SDK client is built lazily on first use. Constructing it requires the
156
157
  * API key (`getApiKey()` throws when the env var is unset), so deferring it
@@ -158,9 +159,9 @@ declare abstract class KodaXAnthropicCompatProvider extends KodaXBaseProvider {
158
159
  * window, model descriptors) without a key. This also keeps key-less unit
159
160
  * tests (which mock the actual LLM calls) from failing at construction time.
160
161
  */
161
- protected get client(): Anthropic;
162
+ protected getClient(): Promise<Anthropic>;
162
163
  protected set client(client: Anthropic);
163
- protected buildClient(): Anthropic;
164
+ protected buildClient(): Anthropic | Promise<Anthropic>;
164
165
  protected onStaleConnection(): void;
165
166
  private buildMessageCreateOptions;
166
167
  private applyReasoningProfile;
@@ -271,6 +272,7 @@ declare abstract class KodaXOpenAICompatProvider extends KodaXBaseProvider {
271
272
  readonly supportsThinking = true;
272
273
  protected abstract readonly config: KodaXProviderConfig;
273
274
  private _client?;
275
+ private _clientPromise?;
274
276
  supportsEphemeralSuffix(): boolean;
275
277
  /**
276
278
  * The SDK client is built lazily on first use. Constructing it requires the
@@ -279,9 +281,9 @@ declare abstract class KodaXOpenAICompatProvider extends KodaXBaseProvider {
279
281
  * window, model descriptors) without a key. This also keeps key-less unit
280
282
  * tests (which mock the actual LLM calls) from failing at construction time.
281
283
  */
282
- protected get client(): OpenAI;
284
+ protected getClient(): Promise<OpenAI>;
283
285
  protected set client(client: OpenAI);
284
- protected buildClient(): OpenAI;
286
+ protected buildClient(): OpenAI | Promise<OpenAI>;
285
287
  private getEffectiveMaxOutputTokensField;
286
288
  protected onStaleConnection(): void;
287
289
  /**
@@ -1,4 +1,4 @@
1
- import { v as KodaXMemoryOutcomeDigest, M as MemoryContextIdentity } from './types.d-DeokRBs7.js';
1
+ import { v as KodaXMemoryOutcomeDigest, M as MemoryContextIdentity } from './types.d-EjZTEEVu.js';
2
2
 
3
3
  interface PendingEpisodeReviewV1 {
4
4
  readonly version: 1;
@@ -1,4 +1,4 @@
1
- import { W as WorkflowProcessTrackerOptions, a as WorkflowEvent, b as WorkflowProcessSnapshot, c as WorkflowProcessEvent } from './controller.d-1tydJm7c.js';
1
+ import { W as WorkflowProcessTrackerOptions, a as WorkflowEvent, b as WorkflowProcessSnapshot, c as WorkflowProcessEvent } from './controller.d-Bm1i9RVj.js';
2
2
 
3
3
  /**
4
4
  * FEATURE_246 Part A0 (ADR-046) — neutral workflow run lifecycle manager.
@@ -1,6 +1,6 @@
1
- import { j as CreatableHistoryItem, T as ToolCall } from './public-api.d-CMZa4JPa.js';
1
+ import { j as CreatableHistoryItem, T as ToolCall } from './public-api.d-ItHKrP7K.js';
2
2
  import { b as KodaXMessage, q as KodaXContentBlock } from './types.d-Cv09EdJR.js';
3
- import { S as KodaXSessionUiHistoryItem, W as KodaXSessionUiToolCall } from './types.d-DeokRBs7.js';
3
+ import { S as KodaXSessionUiHistoryItem, W as KodaXSessionUiToolCall } from './types.d-EjZTEEVu.js';
4
4
 
5
5
  interface RestoreHistoryItemsFromSessionInput {
6
6
  messages: readonly KodaXMessage[];
@@ -1,4 +1,4 @@
1
- import { R as RunScopedToolDefinition, B as BashPrefixExtractor } from './bash-prefix-extractor.d-BLlhCRI-.js';
1
+ import { R as RunScopedToolDefinition, B as BashPrefixExtractor } from './bash-prefix-extractor.d-BMi_TJIY.js';
2
2
 
3
3
  /**
4
4
  * Permission Utilities
@@ -1,4 +1,4 @@
1
- import { K as KodaXInputArtifact } from './controller.d-1tydJm7c.js';
1
+ import { K as KodaXInputArtifact } from './controller.d-Bm1i9RVj.js';
2
2
  import { a as KodaXTaskResultMetadata } from './types.d-Cv09EdJR.js';
3
3
 
4
4
  /**
@@ -1,8 +1,8 @@
1
1
  import { n as KodaXWireReasoningEffort, f as KodaXToolDefinition, R as KodaXToolResultContentItem, b as KodaXMessage } from './types.d-Cv09EdJR.js';
2
2
  import { K as KodaXBaseProvider } from './base.d-JjF6aKsh.js';
3
3
  import { C as CapabilityKind, a as CapabilityProvider } from './capability.d-K664nHOS.js';
4
- import { C as KodaXJsonValue, A as KodaXExtensionSessionRecord, a1 as KodaXExtensionStore } from './types.d-DeokRBs7.js';
5
- import { aR as KodaXToolExecutionContext, bz as ToolSideEffect } from './bash-prefix-extractor.d-BLlhCRI-.js';
4
+ import { C as KodaXJsonValue, A as KodaXExtensionSessionRecord, a1 as KodaXExtensionStore } from './types.d-EjZTEEVu.js';
5
+ import { aY as KodaXToolExecutionContext, bH as ToolSideEffect } from './bash-prefix-extractor.d-BMi_TJIY.js';
6
6
 
7
7
  /**
8
8
  * KodaX Constructed-World types (FEATURE_087, v0.7.28).
@@ -338,7 +338,8 @@ interface KodaXSessionEntryBase {
338
338
  * SDK hosts to group or fold cloned history without comparing content.
339
339
  */
340
340
  logicalId?: string;
341
- /** Root physical entry id this item was cloned from, when it is a clone. */
341
+ /** Direct physical predecessor entry id this clone was copied from (the
342
+ * clone source's own id, not a transitive root — see the SDK embedder guide). */
342
343
  sourceEntryId?: string;
343
344
  }
344
345
  interface KodaXSessionMessageEntry extends KodaXSessionEntryBase {
@@ -1,10 +1,10 @@
1
1
  import { b as KodaXMessage, o as KodaXReasoningMode, r as KodaXCustomProviderConfig, k as KodaXProviderCapabilityProfile } from './types.d-Cv09EdJR.js';
2
- import { N as WorkflowProcessSource } from './controller.d-1tydJm7c.js';
3
- import { O as KodaXContextTokenSnapshot, au as KodaXSkillDynamicContextPolicy, s as KodaXAgentMode, a9 as KodaXRepoIntelligenceMode, a2 as KodaXOptions, av as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-BLlhCRI-.js';
4
- import { f as AgentsFile, u as AutoModeStats, S as KodaXMcpServersConfig } from './guardrail.d-DqWHIgt6.js';
2
+ import { N as WorkflowProcessSource } from './controller.d-Bm1i9RVj.js';
3
+ import { O as KodaXContextTokenSnapshot, aB as KodaXSkillDynamicContextPolicy, s as KodaXAgentMode, ag as KodaXRepoIntelligenceMode, a2 as KodaXOptions, aC as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-BMi_TJIY.js';
4
+ import { f as AgentsFile, u as AutoModeStats, S as KodaXMcpServersConfig } from './guardrail.d-CKkoea7y.js';
5
5
  import * as readline from 'readline';
6
- import { S as KodaXSessionUiHistoryItem, K as KodaXSessionLineage, b as KodaXSessionArtifactLedgerEntry, B as KodaXExtensionSessionState, A as KodaXExtensionSessionRecord, O as KodaXSessionRuntimeInfo } from './types.d-DeokRBs7.js';
7
- import { b as PermissionMode, L as LearningBinding, c as LearningSurfaceSnapshot } from './public-api.d-CMZa4JPa.js';
6
+ import { S as KodaXSessionUiHistoryItem, K as KodaXSessionLineage, b as KodaXSessionArtifactLedgerEntry, B as KodaXExtensionSessionState, A as KodaXExtensionSessionRecord, O as KodaXSessionRuntimeInfo } from './types.d-EjZTEEVu.js';
7
+ import { b as PermissionMode, L as LearningBinding, c as LearningSurfaceSnapshot } from './public-api.d-ItHKrP7K.js';
8
8
  import { SpawnSyncReturns } from 'child_process';
9
9
 
10
10
  /**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kodax-ai/kodax",
3
- "version": "0.7.89",
3
+ "version": "0.7.91",
4
4
  "description": "KodaX lightweight coding agent - TypeScript implementation with 16 built-in LLM provider aliases, published as a Node-free single-file CLI and SDK",
5
5
  "type": "module",
6
6
  "private": false,
@@ -12,7 +12,9 @@
12
12
  "daemonShutdownVerification": 1,
13
13
  "integrationConfigResilience": 1,
14
14
  "managedRunDurability": 1,
15
- "sessionEventJournal": 1
15
+ "runtimeExitSettlement": 1,
16
+ "sessionEventJournal": 1,
17
+ "liveOutputSegments": 1
16
18
  },
17
19
  "workspaces": [
18
20
  "packages/*"
@@ -1,2 +0,0 @@
1
- // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
2
- import{Ha as a,Ia as b}from"./chunk-CQHLFQSU.js";import"./chunk-SOIIBADK.js";import"./chunk-4Y6OSDZE.js";import"./chunk-S74F7MFN.js";import"./chunk-IFD6TUQU.js";import"./chunk-A63MGLH6.js";import"./chunk-O2ZV775M.js";import"./chunk-BOMSVUJS.js";import"./chunk-5UBP47VJ.js";import"./chunk-W5RPVR3O.js";import"./chunk-PROPMIT4.js";import"./chunk-UNEC2WXJ.js";import"./chunk-72H6JNPN.js";import"./chunk-5247AKGN.js";import"./chunk-ONUPGMER.js";export{a as ArgumentCompleter,b as createArgumentCompleter};