@kodax-ai/kodax 0.7.76 → 0.7.77

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 (115) hide show
  1. package/CHANGELOG.md +595 -380
  2. package/LICENSE +158 -158
  3. package/README.md +1608 -1550
  4. package/README_CN.md +942 -896
  5. package/config-templates/config.example.jsonc +33 -33
  6. package/config-templates/integrations/a2a.example.jsonc +98 -98
  7. package/config-templates/integrations/extensions.example.jsonc +7 -7
  8. package/config-templates/integrations/mcp.example.jsonc +16 -16
  9. package/dist/builtin/code-review/SKILL.md +22 -22
  10. package/dist/builtin/skill-creator/scripts/aggregate-benchmark.d.ts +46 -46
  11. package/dist/builtin/skill-creator/scripts/analyze-benchmark.d.ts +46 -46
  12. package/dist/builtin/skill-creator/scripts/compare-runs.d.ts +62 -62
  13. package/dist/builtin/skill-creator/scripts/generate-review.d.ts +33 -33
  14. package/dist/builtin/skill-creator/scripts/grade-evals.d.ts +73 -73
  15. package/dist/builtin/skill-creator/scripts/improve-description.d.ts +23 -23
  16. package/dist/builtin/skill-creator/scripts/init-skill.d.ts +14 -14
  17. package/dist/builtin/skill-creator/scripts/install-skill.d.ts +29 -29
  18. package/dist/builtin/skill-creator/scripts/package-skill.d.ts +38 -38
  19. package/dist/builtin/skill-creator/scripts/quick-validate.d.ts +8 -8
  20. package/dist/builtin/skill-creator/scripts/run-eval.d.ts +66 -66
  21. package/dist/builtin/skill-creator/scripts/run-loop.d.ts +49 -49
  22. package/dist/builtin/skill-creator/scripts/run-trigger-eval.d.ts +58 -58
  23. package/dist/chunks/agent-NGSWFE73.js +2 -0
  24. package/dist/chunks/argument-completer-WGGZPEEO.js +2 -0
  25. package/dist/chunks/chunk-27QLRH3D.js +5 -0
  26. package/dist/chunks/chunk-2MQPVY6P.js +770 -0
  27. package/dist/chunks/chunk-3DD4QEBH.js +22 -0
  28. package/dist/chunks/chunk-6WAPVAGQ.js +74 -0
  29. package/dist/chunks/chunk-AOENDSVN.js +448 -0
  30. package/dist/chunks/{chunk-PXKSE54E.js → chunk-EH7AOMJ7.js} +1 -1
  31. package/dist/chunks/{chunk-SMT2JSM3.js → chunk-FNW2XUL5.js} +9 -9
  32. package/dist/chunks/chunk-FSXI4MAV.js +78 -0
  33. package/dist/chunks/{chunk-RDXRM3UI.js → chunk-HORNWBYR.js} +1 -1
  34. package/dist/chunks/chunk-HV2GMZUZ.js +343 -0
  35. package/dist/chunks/chunk-IQT4RPCE.js +46 -0
  36. package/dist/chunks/{chunk-4PWPNCNK.js → chunk-JS2BHGJP.js} +2 -2
  37. package/dist/chunks/chunk-OAMKECRG.js +381 -0
  38. package/dist/chunks/{chunk-HS3XHF3R.js → chunk-ON2WG2LG.js} +2 -2
  39. package/dist/chunks/{chunk-HGT6WQ24.js → chunk-RUGAAHTF.js} +17 -17
  40. package/dist/chunks/chunk-TGCG7U2W.js +37 -0
  41. package/dist/chunks/chunk-XSA37BVM.js +5 -0
  42. package/dist/chunks/compaction-config-BE7VYWH6.js +2 -0
  43. package/dist/chunks/{construction-bootstrap-5F5KF2BZ.js → construction-bootstrap-RPRL3L7R.js} +1 -1
  44. package/dist/chunks/dist-FDSOIR35.js +2 -0
  45. package/dist/chunks/dist-ZZBNVTKU.js +2 -0
  46. package/dist/chunks/host-QAKQVC4A.js +2 -0
  47. package/dist/chunks/run-manager-N4UFWA2D.js +2 -0
  48. package/dist/chunks/{utils-X3TEH6IO.js → utils-AUHCI4D5.js} +1 -1
  49. package/dist/index.d.ts +17 -16
  50. package/dist/index.js +2 -2
  51. package/dist/kodax_bootstrap.js +25 -25
  52. package/dist/kodax_cli.js +1276 -1229
  53. package/dist/provider-capabilities.json +392 -362
  54. package/dist/runtime-worker.js +1162 -1115
  55. package/dist/sdk-a2a.d.ts +12 -11
  56. package/dist/sdk-a2a.js +1 -1
  57. package/dist/sdk-agent.d.ts +56 -21
  58. package/dist/sdk-agent.js +1 -1
  59. package/dist/sdk-coding.d.ts +120 -21
  60. package/dist/sdk-coding.js +1 -1
  61. package/dist/sdk-experimental-memory.d.ts +14 -597
  62. package/dist/sdk-experimental-memory.js +1 -1
  63. package/dist/sdk-llm.d.ts +218 -6
  64. package/dist/sdk-llm.js +1 -1
  65. package/dist/sdk-mcp.js +1 -1
  66. package/dist/sdk-media.d.ts +1 -1
  67. package/dist/sdk-media.js +1 -1
  68. package/dist/sdk-repl.d.ts +15 -14
  69. package/dist/sdk-repl.js +1 -1
  70. package/dist/sdk-runtime.d.ts +34 -18
  71. package/dist/sdk-runtime.js +1 -1
  72. package/dist/sdk-session.d.ts +7 -6
  73. package/dist/sdk-session.js +1 -1
  74. package/dist/sdk-skills.js +1 -1
  75. package/dist/semantic-worker.js +14 -14
  76. package/dist/types-chunks/{base.d-ChvpaKjZ.d.ts → base.d-4e74xDdy.d.ts} +13 -1
  77. package/dist/types-chunks/{bash-prefix-extractor.d-r1beOESM.d.ts → bash-prefix-extractor.d-pZdu6qt7.d.ts} +197 -5
  78. package/dist/types-chunks/{capability-learning.d-DPrYxRjF.d.ts → capability-learning.d-CVsdHw4j.d.ts} +1 -1
  79. package/dist/types-chunks/{capsule.d-zeqV4IQX.d.ts → capsule.d-CxCm1KZz.d.ts} +2 -2
  80. package/dist/types-chunks/{commands.d-DUxnK2TU.d.ts → commands.d-BccESAMV.d.ts} +5 -5
  81. package/dist/types-chunks/{guardrail.d-qjuKJZ31.d.ts → guardrail.d-B0PwAZVR.d.ts} +3 -3
  82. package/dist/types-chunks/{guardrail.d-CWYD1bdL.d.ts → guardrail.d-CJx9RRd3.d.ts} +1 -1
  83. package/dist/types-chunks/{history-retrieval.d-BKTJIrVd.d.ts → history-retrieval.d-B__aEN62.d.ts} +2 -2
  84. package/dist/types-chunks/{public-api.d-CX4B11qY.d.ts → public-api.d--fF88JrC.d.ts} +3 -3
  85. package/dist/types-chunks/{run-manager.d-B9fEIjZk.d.ts → run-manager.d-B47hIqnI.d.ts} +1 -1
  86. package/dist/types-chunks/{sdk-session-B0fhAOPa.d.ts → sdk-session-CLWf8Adb.d.ts} +3 -3
  87. package/dist/types-chunks/{side-query.d-DWTMsndP.d.ts → side-query.d-5JvXhuOZ.d.ts} +22 -10
  88. package/dist/types-chunks/types-LanCEDj8.d.ts +623 -0
  89. package/dist/types-chunks/{types.d-DEctY20M.d.ts → types.d-CODuyyqy.d.ts} +2 -2
  90. package/dist/types-chunks/{types.d-Bm_y6YuM.d.ts → types.d-DCsKM8aT.d.ts} +4 -4
  91. package/dist/types-chunks/{types.d-CSmF0t0n.d.ts → types.d-DIpZJKUl.d.ts} +15 -0
  92. package/dist/types-chunks/{types.d-sRLugmjy.d.ts → types.d-RdWRfUEs.d.ts} +47 -4
  93. package/dist/types-chunks/{utils.d-D0wPxz8y.d.ts → utils.d-CDduqbFw.d.ts} +5 -5
  94. package/docs/SDK_EMBEDDER_GUIDE.md +197 -68
  95. package/package.json +2 -1
  96. package/scripts/kodax-bin.cjs +28 -28
  97. package/scripts/production-env.cjs +25 -25
  98. package/dist/chunks/agent-7X5CFET2.js +0 -2
  99. package/dist/chunks/argument-completer-3NHIKB4N.js +0 -2
  100. package/dist/chunks/chunk-7FJNLJLF.js +0 -369
  101. package/dist/chunks/chunk-COQYLD4U.js +0 -5
  102. package/dist/chunks/chunk-D3T24FJW.js +0 -78
  103. package/dist/chunks/chunk-EI4JBQKL.js +0 -46
  104. package/dist/chunks/chunk-IDCGNQ4H.js +0 -5
  105. package/dist/chunks/chunk-KAY2XLCP.js +0 -74
  106. package/dist/chunks/chunk-OD6LVXU6.js +0 -329
  107. package/dist/chunks/chunk-OSF3H4RR.js +0 -22
  108. package/dist/chunks/chunk-TGMBHGZO.js +0 -427
  109. package/dist/chunks/chunk-VWSLC2WO.js +0 -770
  110. package/dist/chunks/chunk-Y3AMP22L.js +0 -37
  111. package/dist/chunks/compaction-config-7J2XE35D.js +0 -2
  112. package/dist/chunks/dist-2RA7LSH3.js +0 -2
  113. package/dist/chunks/dist-URKXBOC6.js +0 -2
  114. package/dist/chunks/host-RKZ2OGFT.js +0 -2
  115. package/dist/chunks/run-manager-7RM4HEH6.js +0 -2
package/dist/sdk-llm.d.ts CHANGED
@@ -1,9 +1,11 @@
1
- import { p as KodaXProviderCapabilityProfile, a8 as KodaXVerifyStrategy, a7 as KodaXVerifyCredentialResult, c as KodaXContentBlock, a as KodaXCacheBoundary } from './types-chunks/types.d-CSmF0t0n.js';
2
- export { K as KodaXAssuranceIntent, b as KodaXChildFanoutClass, d as KodaXCustomProviderConfig, e as KodaXEphemeralSuffix, f as KodaXExecutionMode, g as KodaXExecutionPattern, h as KodaXHarnessProfile, i as KodaXImageBlock, j as KodaXListModelsResult, k as KodaXMessage, l as KodaXModelDescriptor, m as KodaXMutationSurface, n as KodaXNormalizedReasoningRequest, o as KodaXProtocolFamily, q as KodaXProviderConfig, r as KodaXProviderContextFidelity, s as KodaXProviderConversationSemantics, t as KodaXProviderEvidenceSupport, u as KodaXProviderLongRunningSupport, v as KodaXProviderMcpSupport, w as KodaXProviderMultimodalSupport, x as KodaXProviderSessionSupport, y as KodaXProviderStreamOptions, z as KodaXProviderToolCallingFidelity, A as KodaXProviderTransport, B as KodaXReasoningCapability, C as KodaXReasoningEffortPreset, D as KodaXReasoningEffortRequest, E as KodaXReasoningEffortWireStrategy, F as KodaXReasoningMode, G as KodaXReasoningProfile, H as KodaXReasoningRequest, I as KodaXRedactedThinkingBlock, J as KodaXReviewScale, L as KodaXRiskLevel, M as KodaXStableEffortIntent, N as KodaXStreamResult, O as KodaXTaskActionability, P as KodaXTaskBudgetOverrides, Q as KodaXTaskComplexity, R as KodaXTaskFamily, S as KodaXTaskResultMetadata, T as KodaXTaskResultSource, U as KodaXTaskRoutingDecision, V as KodaXTaskType, W as KodaXTaskWorkIntent, X as KodaXTextBlock, Y as KodaXThinkingBlock, Z as KodaXThinkingBudgetMap, _ as KodaXThinkingDepth, $ as KodaXThinkingWireStrategy, a0 as KodaXTokenUsage, a1 as KodaXToolDefinition, a2 as KodaXToolResultBlock, a3 as KodaXToolResultContentItem, a4 as KodaXToolResultImageItem, a5 as KodaXToolResultTextItem, a6 as KodaXToolUseBlock, a9 as KodaXWireReasoningEffort } from './types-chunks/types.d-CSmF0t0n.js';
3
- export { K as KODAX_DEFAULT_PROVIDER, a as KODAX_DEFAULT_THINKING_BUDGETS, b as KODAX_PROVIDERS, c as KODAX_PROVIDER_SNAPSHOTS, d as KODAX_REASONING_MODE_SEQUENCE, e as KODAX_REASONING_SAFETY_RESERVE, f as KODAX_STABLE_EFFORT_INTENTS, g as KodaXAnthropicCompatProvider, h as KodaXError, i as KodaXModelCapabilities, j as KodaXNetworkError, k as KodaXOpenAICompatProvider, l as KodaXProviderError, m as KodaXRateLimitError, n as KodaXToolCallIdError, P as ProviderName, R as ResolveWireEffortInput, o as ResolvedWireEffort, S as SideQueryDiagnostics, p as SideQueryRequest, q as SideQueryResult, r as SideQueryStopReason, s as SideQueryTerminalPhase, t as clampThinkingBudget, u as clearRuntimeModelProviders, v as createCustomProvider, w as effortToLegacyReasoningMode, x as getAvailableProviderNames, y as getCustomModelCapabilities, z as getCustomProvider, A as getCustomProviderList, B as getCustomProviderModelDescriptors, C as getCustomProviderModels, D as getCustomProviderNames, E as getDefaultThinkingDepthForMode, F as getModelCapabilities, G as getProvider, H as getProviderConfiguredCapabilityProfile, I as getProviderConfiguredReasoningCapability, J as getProviderList, L as getProviderModel, M as getProviderModelDescriptors, N as getProviderModels, O as getReasoningCapability, Q as getRuntimeModelProvider, T as getRuntimeModelProviderNames, U as isCustomProviderName, V as isKnownProvider, W as isProviderConfigured, X as isProviderName, Y as isReasoningEnabled, Z as isRuntimeModelProviderName, _ as listAllModelCapabilities, $ as listBuiltinModelCapabilities, a0 as listCustomProviderModelCapabilities, a1 as listProviderModels, a2 as mapDepthToOpenAIReasoningEffort, a3 as mapLegacyReasoningModeToEffortIntent, a4 as normalizeReasoningEffortValue, a5 as normalizeReasoningRequest, a6 as parseReasoningEffortEnv, a7 as registerCustomProviders, a8 as registerModelProvider, a9 as resolveModelCapabilities, aa as resolveProvider, ab as resolveProviderModelDescriptors, ac as resolveReasoningEffort, ad as resolveReasoningEffortForModelSwitch, ae as resolveThinkingBudget, af as resolveWireEffort, ag as sideQuery, ah as validateCustomProviderConfig, ai as verifyProviderCredential } from './types-chunks/side-query.d-DWTMsndP.js';
1
+ import { a7 as KodaXVerifyCredentialResult, k as KodaXMessage, p as KodaXProviderCapabilityProfile, i as KodaXImageBlock, a1 as KodaXToolDefinition, H as KodaXReasoningRequest, y as KodaXProviderStreamOptions, N as KodaXStreamResult, a8 as KodaXVerifyStrategy, c as KodaXContentBlock, a as KodaXCacheBoundary } from './types-chunks/types.d-DIpZJKUl.js';
2
+ export { K as KodaXAssuranceIntent, b as KodaXChildFanoutClass, d as KodaXCustomProviderConfig, e as KodaXEphemeralSuffix, f as KodaXExecutionMode, g as KodaXExecutionPattern, h as KodaXHarnessProfile, j as KodaXListModelsResult, l as KodaXModelDescriptor, m as KodaXMutationSurface, n as KodaXNormalizedReasoningRequest, o as KodaXProtocolFamily, q as KodaXProviderConfig, r as KodaXProviderContextFidelity, s as KodaXProviderConversationSemantics, t as KodaXProviderEvidenceSupport, u as KodaXProviderLongRunningSupport, v as KodaXProviderMcpSupport, w as KodaXProviderMultimodalSupport, x as KodaXProviderSessionSupport, z as KodaXProviderToolCallingFidelity, A as KodaXProviderTransport, B as KodaXReasoningCapability, C as KodaXReasoningEffortPreset, D as KodaXReasoningEffortRequest, E as KodaXReasoningEffortWireStrategy, F as KodaXReasoningMode, G as KodaXReasoningProfile, I as KodaXRedactedThinkingBlock, J as KodaXReviewScale, L as KodaXRiskLevel, M as KodaXStableEffortIntent, O as KodaXTaskActionability, P as KodaXTaskBudgetOverrides, Q as KodaXTaskComplexity, R as KodaXTaskFamily, S as KodaXTaskResultMetadata, T as KodaXTaskResultSource, U as KodaXTaskRoutingDecision, V as KodaXTaskType, W as KodaXTaskWorkIntent, X as KodaXTextBlock, Y as KodaXThinkingBlock, Z as KodaXThinkingBudgetMap, _ as KodaXThinkingDepth, $ as KodaXThinkingWireStrategy, a0 as KodaXTokenUsage, a2 as KodaXToolResultBlock, a3 as KodaXToolResultContentItem, a4 as KodaXToolResultImageItem, a5 as KodaXToolResultTextItem, a6 as KodaXToolUseBlock, a9 as KodaXWireReasoningEffort } from './types-chunks/types.d-DIpZJKUl.js';
3
+ export { K as KODAX_DEFAULT_PROVIDER, a as KODAX_DEFAULT_THINKING_BUDGETS, b as KODAX_PROVIDERS, c as KODAX_PROVIDER_SNAPSHOTS, d as KODAX_REASONING_MODE_SEQUENCE, e as KODAX_REASONING_SAFETY_RESERVE, f as KODAX_STABLE_EFFORT_INTENTS, g as KodaXAnthropicCompatProvider, h as KodaXError, i as KodaXModelCapabilities, j as KodaXNetworkError, k as KodaXOpenAICompatProvider, l as KodaXProviderError, m as KodaXRateLimitError, n as KodaXToolCallIdError, P as ProviderName, R as ResolveWireEffortInput, o as ResolvedWireEffort, S as SideQueryDiagnostics, p as SideQueryRequest, q as SideQueryResult, r as SideQueryStopReason, s as SideQueryTerminalPhase, t as clampThinkingBudget, u as clearRuntimeModelProviders, v as createCustomProvider, w as effortToLegacyReasoningMode, x as getAvailableProviderNames, y as getCustomModelCapabilities, z as getCustomProvider, A as getCustomProviderList, B as getCustomProviderModelDescriptors, C as getCustomProviderModels, D as getCustomProviderNames, E as getDefaultThinkingDepthForMode, F as getModelCapabilities, G as getProvider, H as getProviderConfiguredCapabilityProfile, I as getProviderConfiguredReasoningCapability, J as getProviderCredentialEnvironmentNames, L as getProviderList, M as getProviderModel, N as getProviderModelDescriptors, O as getProviderModels, Q as getReasoningCapability, T as getRuntimeModelProvider, U as getRuntimeModelProviderCredentialEnvironmentNames, V as getRuntimeModelProviderNames, W as isCustomProviderName, X as isKnownProvider, Y as isProviderConfigured, Z as isProviderName, _ as isReasoningEnabled, $ as isRuntimeModelProviderName, a0 as listAllModelCapabilities, a1 as listBuiltinModelCapabilities, a2 as listCustomProviderModelCapabilities, a3 as listProviderModels, a4 as mapDepthToOpenAIReasoningEffort, a5 as mapLegacyReasoningModeToEffortIntent, a6 as normalizeReasoningEffortValue, a7 as normalizeReasoningRequest, a8 as parseReasoningEffortEnv, a9 as registerCustomProviders, aa as registerModelProvider, ab as resolveModelCapabilities, ac as resolveProvider, ad as resolveProviderModelDescriptors, ae as resolveReasoningEffort, af as resolveReasoningEffortForModelSwitch, ag as resolveThinkingBudget, ah as resolveWireEffort, ai as sideQuery, aj as validateCustomProviderConfig, ak as verifyProviderCredential } from './types-chunks/side-query.d-5JvXhuOZ.js';
4
4
  export { C as CostRate, a as CostTracker, D as DEFAULT_COST_RATES, K as KodaXLlmTimeoutConfig, b as KodaXResolvedLlmTimeoutConfig, P as ProviderCostSummary, R as RetryRecord, S as SessionCostSummary, T as TokenUsageRecord, c as calculateCost, d as createCostTracker, f as formatCost, e as formatCostReport, g as getCostRate, h as getSummary, p as parseTimeoutSecEnvMs, r as recordRetry, i as recordUsage, j as resolveLlmTimeoutConfig, t as timeoutSecToMs } from './types-chunks/cost-tracker.d-BeaenODW.js';
5
- export { C as CapabilityCache, a as CapabilityCacheEntry, b as CapabilityCacheSource, c as addRejectedEffort, d as capabilityCacheKey, g as getRejectedEfforts, n as narrowReasoningProfile, r as removeCacheEntry, s as sanitizeCapabilityCache } from './types-chunks/capability-learning.d-DPrYxRjF.js';
6
- export { K as KodaXBaseProvider, a as KodaXOnRetryAfterCallback, b as KodaXRetryAfterEvent, P as ParseRetryAfterOptions, R as RetryAfterResult, c as RetryAfterSource, e as extractHeadersFromError, p as parseRetryAfter } from './types-chunks/base.d-ChvpaKjZ.js';
5
+ export { C as CapabilityCache, a as CapabilityCacheEntry, b as CapabilityCacheSource, c as addRejectedEffort, d as capabilityCacheKey, g as getRejectedEfforts, n as narrowReasoningProfile, r as removeCacheEntry, s as sanitizeCapabilityCache } from './types-chunks/capability-learning.d-CVsdHw4j.js';
6
+ import { K as KodaXBaseProvider } from './types-chunks/base.d-4e74xDdy.js';
7
+ export { a as KodaXOnRetryAfterCallback, b as KodaXRetryAfterEvent, P as ParseRetryAfterOptions, R as RetryAfterResult, c as RetryAfterSource, e as extractHeadersFromError, p as parseRetryAfter } from './types-chunks/base.d-4e74xDdy.js';
8
+ import { SessionNotification } from '@agentclientprotocol/sdk';
7
9
  export { C as CapabilityKind, a as CapabilityProvider, b as CapabilityResult, c as CapabilitySearchFailure, d as CapabilitySearchFreshness, e as CapabilitySearchOptions, f as CapabilitySearchSnapshot } from './types-chunks/capability.d-K664nHOS.js';
8
10
  import '@anthropic-ai/sdk';
9
11
  import 'openai';
@@ -41,6 +43,209 @@ declare const KODAX_CAPPED_MAX_OUTPUT_TOKENS = 32000;
41
43
  declare const KODAX_ESCALATED_MAX_OUTPUT_TOKENS = 64000;
42
44
  declare const KODAX_API_MIN_INTERVAL = 0.5;
43
45
 
46
+ /**
47
+ * Unified event model for CLI-backed providers.
48
+ * This hides the wire-format differences between Codex CLI and Gemini CLI.
49
+ */
50
+ type CLIEvent = CLISessionStartEvent | CLIMessageEvent | CLIToolUseEvent | CLIToolResultEvent | CLIThinkingEvent | CLIErrorEvent | CLICompleteEvent;
51
+ interface CLISessionStartEvent {
52
+ type: 'session_start';
53
+ timestamp: number;
54
+ sessionId: string;
55
+ model: string;
56
+ raw: unknown;
57
+ }
58
+ interface CLIMessageEvent {
59
+ type: 'message';
60
+ timestamp: number;
61
+ role: 'user' | 'assistant';
62
+ content: string;
63
+ delta?: boolean;
64
+ raw: unknown;
65
+ }
66
+ interface CLIToolUseEvent {
67
+ type: 'tool_use';
68
+ timestamp: number;
69
+ toolId: string;
70
+ toolName: string;
71
+ parameters: Record<string, unknown>;
72
+ raw: unknown;
73
+ }
74
+ interface CLIToolResultEvent {
75
+ type: 'tool_result';
76
+ timestamp: number;
77
+ toolId: string;
78
+ status: 'success' | 'error';
79
+ output: string;
80
+ raw: unknown;
81
+ }
82
+ interface CLIThinkingEvent {
83
+ type: 'thinking';
84
+ timestamp: number;
85
+ content: string;
86
+ delta?: boolean;
87
+ raw: unknown;
88
+ }
89
+ interface CLIErrorEvent {
90
+ type: 'error';
91
+ timestamp: number;
92
+ errorType: string;
93
+ message: string;
94
+ code?: number;
95
+ raw: unknown;
96
+ }
97
+ interface CLICompleteEvent {
98
+ type: 'complete';
99
+ timestamp: number;
100
+ status: 'success' | 'failed';
101
+ usage?: {
102
+ inputTokens: number;
103
+ outputTokens: number;
104
+ totalTokens: number;
105
+ cachedReadTokens?: number;
106
+ cachedWriteTokens?: number;
107
+ };
108
+ raw: unknown;
109
+ }
110
+ interface CLIExecutorConfig {
111
+ command: string;
112
+ baseArgs: string[];
113
+ timeout?: number;
114
+ cwd?: string;
115
+ env?: Record<string, string>;
116
+ }
117
+ interface CLIExecutionOptions {
118
+ prompt: string;
119
+ sessionId?: string;
120
+ model?: string;
121
+ reasoningEffort?: string;
122
+ signal?: AbortSignal;
123
+ }
124
+
125
+ declare abstract class CLIExecutor {
126
+ protected config: CLIExecutorConfig;
127
+ private _installedCache;
128
+ constructor(config: CLIExecutorConfig);
129
+ /**
130
+ * Check whether the backing CLI is installed, with a small in-memory cache
131
+ * so repeated stream() calls do not respawn the probe process.
132
+ */
133
+ isInstalled(): Promise<boolean>;
134
+ /**
135
+ * Provider-specific install probe implementation.
136
+ */
137
+ protected abstract checkInstalled(): Promise<boolean>;
138
+ /**
139
+ * Execute the CLI and stream normalized events back to the caller.
140
+ */
141
+ execute(options: CLIExecutionOptions): AsyncGenerator<CLIEvent>;
142
+ /**
143
+ * Build the CLI argument list for a single execution.
144
+ */
145
+ protected abstract buildArgs(options: CLIExecutionOptions): string[];
146
+ /**
147
+ * Parse the subprocess stdout stream as newline-delimited JSON.
148
+ */
149
+ protected parseOutputStream(stream: NodeJS.ReadableStream, signal?: AbortSignal): AsyncGenerator<CLIEvent>;
150
+ /**
151
+ * Parse a single JSONL record into a normalized CLI event.
152
+ */
153
+ protected abstract parseLine(line: string): CLIEvent | null;
154
+ }
155
+
156
+ interface AcpClientOptions {
157
+ /** Command used to launch a native ACP server process. */
158
+ command?: string;
159
+ /** Arguments passed to the native ACP server process. */
160
+ args?: string[];
161
+ /** Readable side of an in-memory pseudo ACP server transport. */
162
+ inputStream?: ReadableStream<Uint8Array>;
163
+ outputStream?: WritableStream<Uint8Array>;
164
+ /** Working directory for spawned native ACP processes. */
165
+ cwd?: string;
166
+ /** Session update callback forwarded from the ACP connection. */
167
+ onSessionUpdate?: (update: SessionNotification) => void;
168
+ /** Cleanup hook used by the in-memory pseudo server transport. */
169
+ abort?: () => void;
170
+ /** Release pseudo-server state for a completed one-shot ACP session. */
171
+ releaseSession?: (sessionId: string) => void;
172
+ /** Create a fresh equivalent transport after the current one is closed. */
173
+ recreate?: () => AcpClientOptions;
174
+ /** Optional executor exposed for install checks in higher layers. */
175
+ executor?: CLIExecutor;
176
+ }
177
+
178
+ /**
179
+ * Shared base class for ACP-backed providers.
180
+ * It can connect either to a native ACP server process or to our in-memory
181
+ * pseudo ACP bridge that adapts CLI executors into ACP session updates.
182
+ */
183
+ declare abstract class KodaXAcpProvider extends KodaXBaseProvider {
184
+ protected abstract readonly acpClientOptions: AcpClientOptions;
185
+ private _client;
186
+ private _clientConnectPromise;
187
+ private _connectingClient;
188
+ private _clientGeneration;
189
+ private _sessionMap;
190
+ private _activeStreams;
191
+ private _activeConversationIds;
192
+ private ensureClient;
193
+ private invalidateClient;
194
+ supportsEphemeralSuffix(): boolean;
195
+ isConfigured(): boolean;
196
+ /**
197
+ * FEATURE_216 v0.7.45 — CLI-bridge providers manage credentials in
198
+ * the CLI binary's own token store (gemini CLI / codex CLI OAuth
199
+ * tokens, etc.), which lives outside SDK reach. There is no HTTP
200
+ * primitive to probe. Always returns `unsupported` regardless of
201
+ * `verifyStrategy` (which provider-capabilities.json validates as
202
+ * 'unsupported' for cliBridge entries).
203
+ */
204
+ verifyCredential(): Promise<KodaXVerifyCredentialResult>;
205
+ /**
206
+ * Exact prompt text handed to ACP. Exposed only so diagnostics can hash the
207
+ * real CLI-visible request instead of incorrectly hashing full history.
208
+ */
209
+ getDiagnosticPromptText(messages: readonly KodaXMessage[], ephemeralSuffix?: string): string;
210
+ getCapabilityProfile(): KodaXProviderCapabilityProfile;
211
+ /**
212
+ * FEATURE_134 (v0.7.40) — extension point for CLI bridges that have a
213
+ * file-include syntax in their prompt grammar. Default implementation
214
+ * returns `null`, which makes the prompt flatten path drop image blocks
215
+ * silently (preserving the pre-FEATURE_134 behavior for CLIs that do
216
+ * not accept image input — Codex CLI's `codex exec --json --full-auto`
217
+ * mode currently has no image attachment surface).
218
+ *
219
+ * Subclasses that DO accept image input should override and return a
220
+ * single-token string the CLI will resolve to file content — for
221
+ * Gemini CLI 2.x that is `@<absolutePath>` (the `@file` reference
222
+ * syntax inlines arbitrary file content, including images).
223
+ *
224
+ * Callers must pass a `block.path` that already exists on disk;
225
+ * KodaX does not stat-check at this point because the image blocks
226
+ * come from `KodaXImageBlock` instances that the REPL or SDK has
227
+ * already validated (`preparePromptInputArtifacts` rewrites missing
228
+ * images to placeholders before they ever reach this layer).
229
+ */
230
+ protected serializeImageBlockToPromptToken(_block: KodaXImageBlock): string | null;
231
+ /**
232
+ * FEATURE_116 (v0.7.37) — Strip any `cache-boundary` markers from
233
+ * KodaXMessage content arrays before they reach the ACP CLI bridge.
234
+ * The CLI subprocess does not understand KodaX-internal cache markers;
235
+ * stripping at the entry point keeps the marker abstraction purely
236
+ * client-side.
237
+ *
238
+ * Idempotent: messages with no boundary content return the same
239
+ * reference.
240
+ */
241
+ protected stripCacheBoundariesFromMessages(messages: KodaXMessage[]): KodaXMessage[];
242
+ stream(messages: KodaXMessage[], tools: KodaXToolDefinition[], system: string, reasoning?: boolean | KodaXReasoningRequest, streamOptions?: KodaXProviderStreamOptions, signal?: AbortSignal): Promise<KodaXStreamResult>;
243
+ /**
244
+ * Manually close and clear the ACP connection maintained by this provider.
245
+ */
246
+ disconnect(): void;
247
+ }
248
+
44
249
  interface NormalizedKodaXProviderCapabilityProfile extends KodaXProviderCapabilityProfile {
45
250
  contextFidelity: NonNullable<KodaXProviderCapabilityProfile['contextFidelity']>;
46
251
  toolCallingFidelity: NonNullable<KodaXProviderCapabilityProfile['toolCallingFidelity']>;
@@ -195,6 +400,13 @@ declare function resolveWorkflowMaxConcurrency(): number;
195
400
  declare function runWithScopedConfig<T>(config: KodaXRunScopedConfig, fn: () => T): T;
196
401
  /** The current run's scoped config, or undefined outside any run (→ env fallback). */
197
402
  declare function getRunScopedConfig(): KodaXRunScopedConfig | undefined;
403
+ /**
404
+ * Resolve the effective prompt-cache disable switch without letting the
405
+ * process-wide env override an explicit per-run choice. Callers that already
406
+ * hold the public SDK option should pass it; provider code can omit it and
407
+ * read the active AsyncLocalStorage scope instead.
408
+ */
409
+ declare function resolvePromptCacheDisabled(explicit?: boolean): boolean;
198
410
 
199
411
  /**
200
412
  * KodaX Cache Control — FEATURE_116 (v0.7.37)
@@ -282,5 +494,5 @@ declare function stripCacheBoundaries<T extends {
282
494
  type: string;
283
495
  }>(blocks: readonly (T | KodaXCacheBoundary)[]): T[];
284
496
 
285
- export { KODAX_API_MIN_INTERVAL, KODAX_CAPPED_MAX_OUTPUT_TOKENS, KODAX_ESCALATED_MAX_OUTPUT_TOKENS, KODAX_MAX_TOKENS, KodaXCacheBoundary, KodaXContentBlock, KodaXProviderCapabilityProfile, KodaXVerifyCredentialResult, KodaXVerifyStrategy, WORKFLOW_MAX_CONCURRENCY_ABSOLUTE, WORKFLOW_MAX_CONCURRENCY_DEFAULT, classifyStopReason, classifyVerifyError, getCodexCliDefaultModel, getCodexCliKnownModels, getGeminiCliDefaultModel, getGeminiCliKnownModels, getRunScopedConfig, getScopedProviderCredential, insertCacheBoundary, isCacheBoundary, isCleanStop, lowerCacheBoundaries, normalizeCapabilityProfile, parseToolInputWithSalvage, redactScopedProviderCredential, resolveWorkflowMaxConcurrency, runVerifyCredential, runWithProviderCredential, runWithScopedConfig, stripCacheBoundaries };
497
+ export { KODAX_API_MIN_INTERVAL, KODAX_CAPPED_MAX_OUTPUT_TOKENS, KODAX_ESCALATED_MAX_OUTPUT_TOKENS, KODAX_MAX_TOKENS, KodaXAcpProvider, KodaXBaseProvider, KodaXCacheBoundary, KodaXContentBlock, KodaXImageBlock, KodaXMessage, KodaXProviderCapabilityProfile, KodaXProviderStreamOptions, KodaXReasoningRequest, KodaXStreamResult, KodaXToolDefinition, KodaXVerifyCredentialResult, KodaXVerifyStrategy, WORKFLOW_MAX_CONCURRENCY_ABSOLUTE, WORKFLOW_MAX_CONCURRENCY_DEFAULT, classifyStopReason, classifyVerifyError, getCodexCliDefaultModel, getCodexCliKnownModels, getGeminiCliDefaultModel, getGeminiCliKnownModels, getRunScopedConfig, getScopedProviderCredential, insertCacheBoundary, isCacheBoundary, isCleanStop, lowerCacheBoundaries, normalizeCapabilityProfile, parseToolInputWithSalvage, redactScopedProviderCredential, resolvePromptCacheDisabled, resolveWorkflowMaxConcurrency, runVerifyCredential, runWithProviderCredential, runWithScopedConfig, stripCacheBoundaries };
286
498
  export type { KodaXAnthropicCacheableBlock, KodaXCacheLowerMode, KodaXRunScopedConfig, KodaXStopClass, RunVerifyCredentialOpts, VerifyPrimitiveRunner };
package/dist/sdk-llm.js CHANGED
@@ -1,2 +1,2 @@
1
1
  // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
2
- import{$,$a as or,A,Aa as Bo,B,Ba as Co,C,Ca as Do,D,Da as Eo,E,Ea as Fo,F,Fa as Go,G,Ga as Ho,H,Ha as Io,I,Ia as Jo,J,Ja as Ko,K,Ka as Lo,L,La as Mo,M,Ma as No,N,Na as Oo,O,Oa as Po,P,Pa as Qo,Q,Qa as Ro,R,Ra as So,S,Sa as To,T,Ta as Uo,U,Ua as Vo,V,Va as Wo,W,Wa as Xo,X,Xa as Yo,Y,Ya as Zo,Z,Za as _o,_,_a as $o,a as o,aa as oo,ab as rr,b as r,ba as ro,bb as er,c as e,ca as eo,cb as fr,d as f,da as fo,e as m,ea as mo,f as p,fa as po,g as t,ga as to,h as x,ha as xo,i as a,ia as ao,j as b,ja as bo,k as c,ka as co,l as d,la as go,m as g,ma as ho,n as h,na as io,o as i,oa as jo,p as j,pa as ko,q as k,qa as lo,r as l,ra as no,s as n,sa as qo,t as q,ta as so,u as s,ua as uo,v as u,va as vo,w as v,wa as wo,x as w,xa as yo,y,ya as zo,z,za as Ao}from"./chunks/chunk-D3T24FJW.js";import"./chunks/chunk-ONUPGMER.js";export{Wo as DEFAULT_COST_RATES,d as KODAX_API_MIN_INTERVAL,b as KODAX_CAPPED_MAX_OUTPUT_TOKENS,co as KODAX_DEFAULT_PROVIDER,w as KODAX_DEFAULT_THINKING_BUDGETS,c as KODAX_ESCALATED_MAX_OUTPUT_TOKENS,a as KODAX_MAX_TOKENS,bo as KODAX_PROVIDERS,ao as KODAX_PROVIDER_SNAPSHOTS,u as KODAX_REASONING_MODE_SEQUENCE,y as KODAX_REASONING_SAFETY_RESERVE,v as KODAX_STABLE_EFFORT_INTENTS,eo as KodaXAnthropicCompatProvider,U as KodaXBaseProvider,f as KodaXError,t as KodaXNetworkError,fo as KodaXOpenAICompatProvider,m as KodaXProviderError,p as KodaXRateLimitError,x as KodaXToolCallIdError,P as WORKFLOW_MAX_CONCURRENCY_ABSOLUTE,O as WORKFLOW_MAX_CONCURRENCY_DEFAULT,n as addRejectedEffort,Yo as calculateCost,j as capabilityCacheKey,K as clampThinkingBudget,W as classifyStopReason,Z as classifyVerifyError,Mo as clearRuntimeModelProviders,Zo as createCostTracker,yo as createCustomProvider,E as effortToLegacyReasoningMode,N as extractHeadersFromError,rr as formatCost,er as formatCostReport,Po as getAvailableProviderNames,mo as getCodexCliDefaultModel,to as getCodexCliKnownModels,Xo as getCostRate,Go as getCustomModelCapabilities,Ao as getCustomProvider,Do as getCustomProviderList,Fo as getCustomProviderModelDescriptors,Eo as getCustomProviderModels,Co as getCustomProviderNames,I as getDefaultThinkingDepthForMode,po as getGeminiCliDefaultModel,xo as getGeminiCliKnownModels,uo as getModelCapabilities,go as getProvider,ko as getProviderConfiguredCapabilityProfile,jo as getProviderConfiguredReasoningCapability,lo as getProviderList,io as getProviderModel,so as getProviderModelDescriptors,no as getProviderModels,z as getReasoningCapability,l as getRejectedEfforts,S as getRunScopedConfig,Jo as getRuntimeModelProvider,Lo as getRuntimeModelProviderNames,r as getScopedProviderCredential,or as getSummary,_ as insertCacheBoundary,$ as isCacheBoundary,X as isCleanStop,Bo as isCustomProviderName,Oo as isKnownProvider,ho as isProviderConfigured,qo as isProviderName,A as isReasoningEnabled,Ko as isRuntimeModelProviderName,So as listAllModelCapabilities,vo as listBuiltinModelCapabilities,Ho as listCustomProviderModelCapabilities,Uo as listProviderModels,oo as lowerCacheBoundaries,L as mapDepthToOpenAIReasoningEffort,D as mapLegacyReasoningModeToEffortIntent,k as narrowReasoningProfile,T as normalizeCapabilityProfile,C as normalizeReasoningEffortValue,B as normalizeReasoningRequest,F as parseReasoningEffortEnv,M as parseRetryAfter,h as parseTimeoutSecEnvMs,V as parseToolInputWithSalvage,_o as recordRetry,$o as recordUsage,e as redactScopedProviderCredential,zo as registerCustomProviders,Io as registerModelProvider,q as removeCacheEntry,i as resolveLlmTimeoutConfig,Ro as resolveModelCapabilities,No as resolveProvider,Qo as resolveProviderModelDescriptors,G as resolveReasoningEffort,H as resolveReasoningEffortForModelSwitch,J as resolveThinkingBudget,Vo as resolveWireEffort,Q as resolveWorkflowMaxConcurrency,Y as runVerifyCredential,o as runWithProviderCredential,R as runWithScopedConfig,s as sanitizeCapabilityCache,fr as sideQuery,ro as stripCacheBoundaries,g as timeoutSecToMs,wo as validateCustomProviderConfig,To as verifyProviderCredential};
2
+ import{$,$a as or,A,Aa as Bo,B,Ba as Co,C,Ca as Do,D,Da as Eo,E,Ea as Fo,F,Fa as Go,G,Ga as Ho,H,Ha as Io,I,Ia as Jo,J,Ja as Ko,K,Ka as Lo,L,La as Mo,M,Ma as No,N,Na as Oo,O,Oa as Po,P,Pa as Qo,Q,Qa as Ro,R,Ra as So,S,Sa as To,T,Ta as Uo,U,Ua as Vo,V,Va as Wo,W,Wa as Xo,X,Xa as Yo,Y,Ya as Zo,Z,Za as _o,_,_a as $o,a as o,aa as oo,ab as rr,b as r,ba as ro,bb as er,c as e,ca as eo,cb as fr,d as f,da as fo,db as mr,e as m,ea as mo,eb as pr,f as p,fa as po,fb as tr,g as t,ga as to,gb as xr,h as x,ha as xo,i as a,ia as ao,j as b,ja as bo,k as c,ka as co,l as d,la as go,m as g,ma as ho,n as h,na as io,o as i,oa as jo,p as j,pa as ko,q as k,qa as lo,r as l,ra as no,s as n,sa as qo,t as q,ta as so,u as s,ua as uo,v as u,va as vo,w as v,wa as wo,x as w,xa as yo,y,ya as zo,z,za as Ao}from"./chunks/chunk-FSXI4MAV.js";import"./chunks/chunk-ONUPGMER.js";export{_o as DEFAULT_COST_RATES,d as KODAX_API_MIN_INTERVAL,b as KODAX_CAPPED_MAX_OUTPUT_TOKENS,ho as KODAX_DEFAULT_PROVIDER,w as KODAX_DEFAULT_THINKING_BUDGETS,c as KODAX_ESCALATED_MAX_OUTPUT_TOKENS,a as KODAX_MAX_TOKENS,go as KODAX_PROVIDERS,co as KODAX_PROVIDER_SNAPSHOTS,u as KODAX_REASONING_MODE_SEQUENCE,y as KODAX_REASONING_SAFETY_RESERVE,v as KODAX_STABLE_EFFORT_INTENTS,po as KodaXAcpProvider,fo as KodaXAnthropicCompatProvider,V as KodaXBaseProvider,f as KodaXError,t as KodaXNetworkError,mo as KodaXOpenAICompatProvider,m as KodaXProviderError,p as KodaXRateLimitError,x as KodaXToolCallIdError,P as WORKFLOW_MAX_CONCURRENCY_ABSOLUTE,O as WORKFLOW_MAX_CONCURRENCY_DEFAULT,n as addRejectedEffort,or as calculateCost,j as capabilityCacheKey,K as clampThinkingBudget,X as classifyStopReason,_ as classifyVerifyError,Po as clearRuntimeModelProviders,rr as createCostTracker,Ao as createCustomProvider,E as effortToLegacyReasoningMode,N as extractHeadersFromError,pr as formatCost,tr as formatCostReport,So as getAvailableProviderNames,to as getCodexCliDefaultModel,ao as getCodexCliKnownModels,$o as getCostRate,Io as getCustomModelCapabilities,Co as getCustomProvider,Fo as getCustomProviderList,Ho as getCustomProviderModelDescriptors,Go as getCustomProviderModels,Eo as getCustomProviderNames,I as getDefaultThinkingDepthForMode,xo as getGeminiCliDefaultModel,bo as getGeminiCliKnownModels,wo as getModelCapabilities,io as getProvider,no as getProviderConfiguredCapabilityProfile,lo as getProviderConfiguredReasoningCapability,To as getProviderCredentialEnvironmentNames,qo as getProviderList,ko as getProviderModel,vo as getProviderModelDescriptors,so as getProviderModels,z as getReasoningCapability,l as getRejectedEfforts,S as getRunScopedConfig,Lo as getRuntimeModelProvider,Oo as getRuntimeModelProviderCredentialEnvironmentNames,No as getRuntimeModelProviderNames,r as getScopedProviderCredential,mr as getSummary,$ as insertCacheBoundary,oo as isCacheBoundary,Y as isCleanStop,Do as isCustomProviderName,Ro as isKnownProvider,jo as isProviderConfigured,uo as isProviderName,A as isReasoningEnabled,Mo as isRuntimeModelProviderName,Wo as listAllModelCapabilities,yo as listBuiltinModelCapabilities,Jo as listCustomProviderModelCapabilities,Yo as listProviderModels,ro as lowerCacheBoundaries,L as mapDepthToOpenAIReasoningEffort,D as mapLegacyReasoningModeToEffortIntent,k as narrowReasoningProfile,U as normalizeCapabilityProfile,C as normalizeReasoningEffortValue,B as normalizeReasoningRequest,F as parseReasoningEffortEnv,M as parseRetryAfter,h as parseTimeoutSecEnvMs,W as parseToolInputWithSalvage,er as recordRetry,fr as recordUsage,e as redactScopedProviderCredential,Bo as registerCustomProviders,Ko as registerModelProvider,q as removeCacheEntry,i as resolveLlmTimeoutConfig,Vo as resolveModelCapabilities,T as resolvePromptCacheDisabled,Qo as resolveProvider,Uo as resolveProviderModelDescriptors,G as resolveReasoningEffort,H as resolveReasoningEffortForModelSwitch,J as resolveThinkingBudget,Zo as resolveWireEffort,Q as resolveWorkflowMaxConcurrency,Z as runVerifyCredential,o as runWithProviderCredential,R as runWithScopedConfig,s as sanitizeCapabilityCache,xr as sideQuery,eo as stripCacheBoundaries,g as timeoutSecToMs,zo as validateCustomProviderConfig,Xo as verifyProviderCredential};
package/dist/sdk-mcp.js CHANGED
@@ -1,2 +1,2 @@
1
1
  // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
2
- import{bc as e,cc as t,dc as r,ec as a,fc as i,gc as p,hc as c,ic as o,jc as M,kc as n,lc as s,mc as l,nc as d,oc as u,pc as C,qc as v,rc as g,sc as S,tc as h,uc as R,vc as A,wc as b,xc as f}from"./chunks/chunk-VWSLC2WO.js";import"./chunks/chunk-Y3AMP22L.js";import"./chunks/chunk-COQYLD4U.js";import"./chunks/chunk-EI4JBQKL.js";import"./chunks/chunk-ONUPGMER.js";export{o as McpAuthRequiredError,R as McpCapabilityProvider,c as McpExpiredSessionError,A as McpManager,h as McpServerRuntime,S as buildInitializeCapabilities,t as createMcpCapabilityId,b as createMcpManager,f as createMcpTestServerFixture,M as createMcpTransport,e as defaultMcpCacheDir,d as discoverAuthorizationServerMetadata,u as discoverOAuthEndpoints,l as discoverProtectedResourceMetadata,s as extractInsufficientScope,n as extractResourceMetadataUrl,p as getMcpCachePaths,g as loadValidToken,r as normalizeMcpCapabilityId,a as parseMcpCapabilityId,v as performOAuthLogin,C as registerOAuthClient,i as searchMcpCatalog};
2
+ import{$b as e,ac as t,bc as r,cc as a,dc as i,ec as p,fc as c,gc as o,hc as M,ic as n,jc as s,kc as l,lc as d,mc as u,nc as C,oc as v,pc as g,qc as S,rc as h,sc as R,tc as A,uc as b,vc as f}from"./chunks/chunk-2MQPVY6P.js";import"./chunks/chunk-TGCG7U2W.js";import"./chunks/chunk-XSA37BVM.js";import"./chunks/chunk-IQT4RPCE.js";import"./chunks/chunk-ONUPGMER.js";export{o as McpAuthRequiredError,R as McpCapabilityProvider,c as McpExpiredSessionError,A as McpManager,h as McpServerRuntime,S as buildInitializeCapabilities,t as createMcpCapabilityId,b as createMcpManager,f as createMcpTestServerFixture,M as createMcpTransport,e as defaultMcpCacheDir,d as discoverAuthorizationServerMetadata,u as discoverOAuthEndpoints,l as discoverProtectedResourceMetadata,s as extractInsufficientScope,n as extractResourceMetadataUrl,p as getMcpCachePaths,g as loadValidToken,r as normalizeMcpCapabilityId,a as parseMcpCapabilityId,v as performOAuthLogin,C as registerOAuthClient,i as searchMcpCatalog};
@@ -1,4 +1,4 @@
1
- import { i as KodaXImageBlock } from './types-chunks/types.d-CSmF0t0n.js';
1
+ import { i as KodaXImageBlock } from './types-chunks/types.d-DIpZJKUl.js';
2
2
 
3
3
  type KodaXMediaErrorCode = 'CLIPBOARD_EMPTY' | 'CLIPBOARD_IMAGE_UNAVAILABLE' | 'UNSUPPORTED_PLATFORM' | 'IMAGE_DECODE_FAILED' | 'IMAGE_TOO_LARGE' | 'UNSUPPORTED_MEDIA_TYPE' | 'MODEL_INPUT_UNSUPPORTED' | 'FILE_ACCESS_DENIED';
4
4
  interface KodaXMediaErrorOptions {
package/dist/sdk-media.js CHANGED
@@ -1,2 +1,2 @@
1
1
  // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
2
- import{F as u,a as o,b as r,c as e,d as f,e as m,f as p,g as t,h as x,i as a,j as b,k as c,l as d,m as g,n as h,o as i,p as j,q as k,r as l,s as n,t as q,u as s}from"./chunks/chunk-COQYLD4U.js";import"./chunks/chunk-EI4JBQKL.js";import"./chunks/chunk-ONUPGMER.js";export{r as ImageResizeError,n as KODAX_FILE_MEDIA_TYPES,k as KODAX_IMAGE_MEDIA_TYPES,l as KODAX_VIDEO_MEDIA_TYPES,o as KodaXMediaError,x as MAX_DIMENSION,g as PASTE_TMP_DIR_ENV,h as PASTE_TMP_TTL_MS,a as TARGET_RAW_SIZE_BYTES,p as createFileArtifactFromPath,m as createImageArtifactFromPath,t as createVideoArtifactFromPath,u as enqueueWithArtifacts,q as getModelInputCapabilities,e as inferImageMediaType,f as inferVideoMediaType,b as normalizePastedImage,i as persistImageAsBlock,j as prunePasteTmpDir,d as readAndNormalizeClipboardImage,c as readClipboardImage,s as validateInputArtifactsForModel};
2
+ import{A as k,B as l,C as n,D as q,E as s,F as u,k as o,l as r,m as e,n as f,o as m,p,q as t,r as x,s as a,t as b,u as c,v as d,w as g,x as h,y as i,z as j}from"./chunks/chunk-XSA37BVM.js";import"./chunks/chunk-IQT4RPCE.js";import"./chunks/chunk-ONUPGMER.js";export{r as ImageResizeError,n as KODAX_FILE_MEDIA_TYPES,k as KODAX_IMAGE_MEDIA_TYPES,l as KODAX_VIDEO_MEDIA_TYPES,o as KodaXMediaError,x as MAX_DIMENSION,g as PASTE_TMP_DIR_ENV,h as PASTE_TMP_TTL_MS,a as TARGET_RAW_SIZE_BYTES,p as createFileArtifactFromPath,m as createImageArtifactFromPath,t as createVideoArtifactFromPath,u as enqueueWithArtifacts,q as getModelInputCapabilities,e as inferImageMediaType,f as inferVideoMediaType,b as normalizePastedImage,i as persistImageAsBlock,j as prunePasteTmpDir,d as readAndNormalizeClipboardImage,c as readClipboardImage,s as validateInputArtifactsForModel};
@@ -1,28 +1,29 @@
1
1
  import React$1, { ReactNode } from 'react';
2
- import { A as AppProps, N as Message, ab as UIState, g as CreatableHistoryItem, l as HistoryItem, a8 as ToolCall, aa as UIActions, K as KeyInfo, z as KeypressHandler, a0 as StreamingState, S as PromptEditingMode, I as InputPromptProps, $ as StatusBarProps, a5 as Theme, a9 as ToolCallStatus, a1 as Suggestion, ac as UseTextBufferReturn, H as HistoryEntry, O as PastedContent, r as HistoryItemInfo, R as PermissionMode } from './types-chunks/public-api.d-CX4B11qY.js';
3
- export { a as AppState, b as AppendClientNoticeOptions, C as CompactSessionOptions, c as CompactSessionResult, d as Completer, e as Completion, f as ConfirmResult, h as CursorPosition, D as DEFAULT_UI_STATE, i as DeleteSessionResult, F as FILE_MODIFICATION_TOOLS, j as FileSessionStorage, k as FullTranscriptSessionData, m as HistoryItemAssistant, n as HistoryItemBase, o as HistoryItemError, p as HistoryItemEvent, q as HistoryItemHint, s as HistoryItemSidecar, t as HistoryItemSystem, u as HistoryItemThinking, v as HistoryItemToolGroup, w as HistoryItemType, x as HistoryItemUser, y as KeypressEvent, B as KeypressHandlerPriority, L as LearningBinding, E as LearningSurfaceSnapshot, G as LegacyMessageListProps, J as ListSessionsOptions, M as MemorySessionStorage, P as PERMISSION_MODES, Q as PermissionContext, T as PromptSubmitPayload, U as RunningSessionInfo, V as SessionData, W as SessionManager, X as SessionStorage, Y as SessionSummary, Z as SessionTranscriptEntry, _ as SessionTranscriptEntryType, a2 as TOOL_STATUS_ICONS, a3 as TextBuffer, a4 as TextBufferOptions, a6 as ThemeColors, a7 as ThemeSymbols, ad as VisualCursor, ae as VisualLayout, af as WatchSessionsCallback, ag as appendClientNotice, ah as archiveSession, ai as compactSession, aj as computeConfirmTools, ak as createMemorySessionStorage, al as createSessionManager, am as deleteSession, an as forkSession, ao as isPermissionMode, ap as listRunningSessions, aq as listSessions, ar as loadFullTranscript, as as loadSession, at as normalizePermissionMode, au as permissionModeDisplayName, av as rewindSession, aw as setActiveEntry, ax as unarchiveSession, ay as watchSessions } from './types-chunks/public-api.d-CX4B11qY.js';
4
- export { B as BUILTIN_COMMANDS, C as Command, I as InkREPLOptions, a as InkRuntimeRunner, b as InkRuntimeRunnerInput, c as InkRuntimeStatusProvider, R as RUNTIME_PERMISSION_PENDING_NOTICE, d as RepLOptions, e as ReplRuntimeAutoModeControl, f as ReplRuntimeAutoModeSettings, g as ReplRuntimePermissionDecision, h as ReplRuntimePermissionGrantSuggestion, i as ReplRuntimePermissionPrompt, j as ReplRuntimePermissionRequest, k as ReplRuntimeRunner, l as ReplRuntimeRunnerInput, m as ReplRuntimeStatusProvider, n as executeCommand, o as getCommandRegistry, p as parseCommand, q as processSpecialSyntax, r as runInkInteractiveMode, s as runInteractiveMode, t as toReplRuntimeAutoModeSettings } from './types-chunks/commands.d-DUxnK2TU.js';
5
- import { a as BashPrefixExtractor, Q as KodaXEvents, t as KodaXAgentMode, aX as ProviderRecoveryEvent, ab as KodaXResult } from './types-chunks/bash-prefix-extractor.d-r1beOESM.js';
6
- import { c as QueuedMessage } from './types-chunks/types.d-DEctY20M.js';
7
- export { H as HistorySeedSourceMessage, R as RestoreHistoryItemsFromSessionInput, a as RestoredHistorySeed, e as extractHistorySeedsFromMessage, b as extractHistorySeedsFromMessages, c as extractTextContent, d as extractTitle, f as formatMessagePreview, r as restoreHistoryItemsFromSession, s as seedToHistoryItem, t as toolCallSeedToHistoryToolCall, g as trimPersistedUiHistorySnapshot } from './types-chunks/sdk-session-B0fhAOPa.js';
8
- import { c as CommandInfo } from './types-chunks/utils.d-D0wPxz8y.js';
9
- export { A as AutoModeSettings, a as CommandCallbacks, g as CurrentConfig, I as InteractiveContext, h as InteractiveMode, K as KODAX_CONFIG_FILE, i as KODAX_DIR, j as KODAX_EXAMPLE_CONFIG_FILE, k as KODAX_INTEGRATION_EXAMPLE_FILES, l as KODAX_SESSIONS_DIR, m as KODAX_VERSION, P as PREVIEW_MAX_LENGTH, R as ResolveAutoModeSettingsInput, n as ResolvedAutoModeSettings, o as RuntimeSurfaceMode, p as RuntimeSurfaceStatus, q as createInteractiveContext, r as ensureExampleConfigFile, s as ensureExampleConfigFiles, t as getGitRoot, u as getProviderList, v as getProviderModel, w as getVersion, x as hydrateProcessEnvFromShell, y as isProviderConfigured, z as loadAutoModeSettings, B as loadConfig, D as prepareRuntimeConfig, E as rateLimitedCall, F as registerConfiguredCustomProviders, G as resolveAutoModeSettings, H as resolveRuntimeEffortSelection, J as resolveRuntimeModelSelection, L as resolveRuntimeProviderSelection, M as saveConfig, N as touchContext } from './types-chunks/utils.d-D0wPxz8y.js';
10
- import { d as KodaXCustomProviderConfig } from './types-chunks/types.d-CSmF0t0n.js';
11
- export { S as KodaXTaskResultMetadata, T as KodaXTaskResultSource } from './types-chunks/types.d-CSmF0t0n.js';
2
+ import { A as AppProps, N as Message, ab as UIState, g as CreatableHistoryItem, l as HistoryItem, a8 as ToolCall, aa as UIActions, K as KeyInfo, z as KeypressHandler, a0 as StreamingState, S as PromptEditingMode, I as InputPromptProps, $ as StatusBarProps, a5 as Theme, a9 as ToolCallStatus, a1 as Suggestion, ac as UseTextBufferReturn, H as HistoryEntry, O as PastedContent, r as HistoryItemInfo, R as PermissionMode } from './types-chunks/public-api.d--fF88JrC.js';
3
+ export { a as AppState, b as AppendClientNoticeOptions, C as CompactSessionOptions, c as CompactSessionResult, d as Completer, e as Completion, f as ConfirmResult, h as CursorPosition, D as DEFAULT_UI_STATE, i as DeleteSessionResult, F as FILE_MODIFICATION_TOOLS, j as FileSessionStorage, k as FullTranscriptSessionData, m as HistoryItemAssistant, n as HistoryItemBase, o as HistoryItemError, p as HistoryItemEvent, q as HistoryItemHint, s as HistoryItemSidecar, t as HistoryItemSystem, u as HistoryItemThinking, v as HistoryItemToolGroup, w as HistoryItemType, x as HistoryItemUser, y as KeypressEvent, B as KeypressHandlerPriority, L as LearningBinding, E as LearningSurfaceSnapshot, G as LegacyMessageListProps, J as ListSessionsOptions, M as MemorySessionStorage, P as PERMISSION_MODES, Q as PermissionContext, T as PromptSubmitPayload, U as RunningSessionInfo, V as SessionData, W as SessionManager, X as SessionStorage, Y as SessionSummary, Z as SessionTranscriptEntry, _ as SessionTranscriptEntryType, a2 as TOOL_STATUS_ICONS, a3 as TextBuffer, a4 as TextBufferOptions, a6 as ThemeColors, a7 as ThemeSymbols, ad as VisualCursor, ae as VisualLayout, af as WatchSessionsCallback, ag as appendClientNotice, ah as archiveSession, ai as compactSession, aj as computeConfirmTools, ak as createMemorySessionStorage, al as createSessionManager, am as deleteSession, an as forkSession, ao as isPermissionMode, ap as listRunningSessions, aq as listSessions, ar as loadFullTranscript, as as loadSession, at as normalizePermissionMode, au as permissionModeDisplayName, av as rewindSession, aw as setActiveEntry, ax as unarchiveSession, ay as watchSessions } from './types-chunks/public-api.d--fF88JrC.js';
4
+ export { B as BUILTIN_COMMANDS, C as Command, I as InkREPLOptions, a as InkRuntimeRunner, b as InkRuntimeRunnerInput, c as InkRuntimeStatusProvider, R as RUNTIME_PERMISSION_PENDING_NOTICE, d as RepLOptions, e as ReplRuntimeAutoModeControl, f as ReplRuntimeAutoModeSettings, g as ReplRuntimePermissionDecision, h as ReplRuntimePermissionGrantSuggestion, i as ReplRuntimePermissionPrompt, j as ReplRuntimePermissionRequest, k as ReplRuntimeRunner, l as ReplRuntimeRunnerInput, m as ReplRuntimeStatusProvider, n as executeCommand, o as getCommandRegistry, p as parseCommand, q as processSpecialSyntax, r as runInkInteractiveMode, s as runInteractiveMode, t as toReplRuntimeAutoModeSettings } from './types-chunks/commands.d-BccESAMV.js';
5
+ import { a as BashPrefixExtractor, Q as KodaXEvents, t as KodaXAgentMode, a$ as ProviderRecoveryEvent, ac as KodaXResult } from './types-chunks/bash-prefix-extractor.d-pZdu6qt7.js';
6
+ import { c as QueuedMessage } from './types-chunks/types.d-CODuyyqy.js';
7
+ export { H as HistorySeedSourceMessage, R as RestoreHistoryItemsFromSessionInput, a as RestoredHistorySeed, e as extractHistorySeedsFromMessage, b as extractHistorySeedsFromMessages, c as extractTextContent, d as extractTitle, f as formatMessagePreview, r as restoreHistoryItemsFromSession, s as seedToHistoryItem, t as toolCallSeedToHistoryToolCall, g as trimPersistedUiHistorySnapshot } from './types-chunks/sdk-session-CLWf8Adb.js';
8
+ import { c as CommandInfo } from './types-chunks/utils.d-CDduqbFw.js';
9
+ export { A as AutoModeSettings, a as CommandCallbacks, g as CurrentConfig, I as InteractiveContext, h as InteractiveMode, K as KODAX_CONFIG_FILE, i as KODAX_DIR, j as KODAX_EXAMPLE_CONFIG_FILE, k as KODAX_INTEGRATION_EXAMPLE_FILES, l as KODAX_SESSIONS_DIR, m as KODAX_VERSION, P as PREVIEW_MAX_LENGTH, R as ResolveAutoModeSettingsInput, n as ResolvedAutoModeSettings, o as RuntimeSurfaceMode, p as RuntimeSurfaceStatus, q as createInteractiveContext, r as ensureExampleConfigFile, s as ensureExampleConfigFiles, t as getGitRoot, u as getProviderList, v as getProviderModel, w as getVersion, x as hydrateProcessEnvFromShell, y as isProviderConfigured, z as loadAutoModeSettings, B as loadConfig, D as prepareRuntimeConfig, E as rateLimitedCall, F as registerConfiguredCustomProviders, G as resolveAutoModeSettings, H as resolveRuntimeEffortSelection, J as resolveRuntimeModelSelection, L as resolveRuntimeProviderSelection, M as saveConfig, N as touchContext } from './types-chunks/utils.d-CDduqbFw.js';
10
+ import { d as KodaXCustomProviderConfig } from './types-chunks/types.d-DIpZJKUl.js';
11
+ export { S as KodaXTaskResultMetadata, T as KodaXTaskResultSource } from './types-chunks/types.d-DIpZJKUl.js';
12
12
  import { Readable, Writable } from 'node:stream';
13
13
  import { a as McpServerConfig, b as McpServersConfig } from './types-chunks/config.d-CJy1WENT.js';
14
14
  export { E as ExtensionsIntegrationDocument, I as IntegrationConfigController, a as IntegrationConfigDiagnostic, b as IntegrationConfigListener, c as IntegrationConfigSnapshot, d as IntegrationConfigSource, e as IntegrationConfigStatus, f as IntegrationDocumentValidator, g as IntegrationDomain, L as LegacyIntegrationMigrationDomainPlan, h as LegacyIntegrationMigrationPlan, i as LegacyIntegrationMigrationResult, M as McpIntegrationDocument, m as migrateLegacyIntegrationConfig, p as parseExtensionsIntegrationDocument, j as parseMcpIntegrationDocument, k as planLegacyIntegrationMigration, r as readExtensionsIntegration, l as readMcpIntegration, n as resolveIntegrationConfigPath, w as writeIntegrationDocument } from './types-chunks/integration-config.d-ojG4swOP.js';
15
- export { bX as KodaXSessionUiHistoryItem, bY as KodaXSessionUiHistoryItemType, bZ as KodaXSessionUiTextHistoryItem, b_ as KodaXSessionUiTextHistoryItemType, b$ as KodaXSessionUiToolCall, c0 as KodaXSessionUiToolCallStatus, c1 as KodaXSessionUiToolGroupHistoryItem } from './types-chunks/types.d-sRLugmjy.js';
16
- import { S as SignalCollector, e as AutoModeAskUser, q as AutoModeSharedState, s as AutoModeToolGuardrail, B as RulesLoadResult } from './types-chunks/guardrail.d-qjuKJZ31.js';
15
+ export { bX as KodaXSessionUiHistoryItem, bY as KodaXSessionUiHistoryItemType, bZ as KodaXSessionUiTextHistoryItem, b_ as KodaXSessionUiTextHistoryItemType, b$ as KodaXSessionUiToolCall, c0 as KodaXSessionUiToolCallStatus, c1 as KodaXSessionUiToolGroupHistoryItem } from './types-chunks/types.d-RdWRfUEs.js';
16
+ import { S as SignalCollector, e as AutoModeAskUser, q as AutoModeSharedState, s as AutoModeToolGuardrail, B as RulesLoadResult } from './types-chunks/guardrail.d-B0PwAZVR.js';
17
17
  import './types-chunks/center-types.d-BBT122uJ.js';
18
18
  import './types-chunks/types.d-DCQVBqVn.js';
19
19
  import 'vscode-languageserver-protocol';
20
20
  import './types-chunks/cost-tracker.d-BeaenODW.js';
21
+ import './types-chunks/types-LanCEDj8.js';
21
22
  import './types-chunks/capability.d-K664nHOS.js';
22
- import './types-chunks/base.d-ChvpaKjZ.js';
23
+ import './types-chunks/base.d-4e74xDdy.js';
23
24
  import 'readline';
24
25
  import 'child_process';
25
- import './types-chunks/guardrail.d-CWYD1bdL.js';
26
+ import './types-chunks/guardrail.d-CJx9RRd3.js';
26
27
 
27
28
  /**
28
29
  * App - KodaX CLI root component.
package/dist/sdk-repl.js CHANGED
@@ -1,3 +1,3 @@
1
1
  // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
2
- import{$ as Wn,$a as Fo,$b as Fe,A as Q,Aa as lo,Ab as le,B as T,Ba as uo,Bb as ue,C as U,Ca as fo,Cb as fe,D as V,Da as go,Db as ge,E as Y,Ea as Co,Eb as Ce,F as Z,Fa as xo,Fb as xe,G as tt,Ga as yo,Gb as ye,H as nt,Ha as Ko,Hb as Ke,I as ot,Ia as Xo,Ib as Xe,J as et,Ja as ho,Jb as he,K as rt,Ka as Do,Kb as De,L as at,La as Po,Lb as Pe,M as pt,Ma as Mo,Mb as Me,N as lt,Na as bo,Nb as be,O as ut,Oa as wo,Ob as we,P as ft,Pa as No,Pb as Ne,Q as Nn,Qa as _o,Qb as _e,R as _n,Ra as jo,Rb as je,S as jn,Sa as ko,Sb as ke,T as kn,Ta as Ao,Tb as Ae,U as An,Ua as Oo,Ub as Oe,V as On,Va as Ro,Vb as Re,W as Rn,Wa as So,Wb as Se,X as Sn,Xa as vo,Xb as ve,Y as vn,Ya as Io,Yb as Ie,Z as In,Za as Lo,Zb as Le,_ as Ln,_a as Wo,_b as We,a as D,aa as Fn,ab as $o,ac as $e,b as P,ba as $n,bb as qo,bc as qe,c as M,ca as qn,cb as zo,cc as ze,d as b,da as zn,db as Bo,dc as Be,e as w,ea as Bn,eb as Eo,ec as Ee,f as N,fa as En,fb as Go,fc as Ge,g as _,ga as Gn,gb as Ho,h as j,ha as Hn,hb as Jo,i as k,ia as Jn,ib as Qo,j as A,ja as Qn,jb as To,k as O,ka as Tn,kb as Uo,l as R,la as Un,lb as Vo,m as S,ma as Vn,mb as Yo,n as v,na as Yn,nb as Zo,o as I,oa as Zn,ob as te,p as L,pa as to,pb as ne,q as W,qa as no,qb as oe,r as F,ra as oo,rb as ee,s as $,sa as eo,sb as re,t as q,ta as ro,tb as ae,u as z,ua as ao,ub as me,v as B,va as mo,vb as ie,w as E,wa as io,wb as se,x as G,xa as so,xb as ce,y as H,ya as co,yb as de,z as J,za as po,zb as pe}from"./chunks/chunk-HGT6WQ24.js";import{B as dn,C as pn,D as ln,Da as Dn,Ea as Pn,F as un,Fa as Mn,G as fn,Ga as bn,Ha as wn,Q as gn,R as Cn,S as xn,T as yn,U as Kn,Z as Xn,_ as hn,a as mt,b as it,c as st,d as ct,e as dt,f as gt,h as Ct,j as xt,k as yt,l as Kt,m as Xt,q as nn,s as on,t as en,u as rn,v as an,x as mn,y as sn,z as cn}from"./chunks/chunk-HS3XHF3R.js";import{K as qt,L as zt,M as Bt,N as Et,O as Gt,P as Ht,Q as Jt,T as Qt,U as Tt,W as Ut,X as Vt,Y as Yt,_ as Zt,b as ht,c as Dt,ca as tn,d as Pt,e as Mt,f as bt,g as wt,h as Nt,i as _t,j as jt,k as kt,l as At,m as Ot,n as Rt,o as St,p as vt,q as It,s as Lt,t as Wt,u as Ft,v as $t}from"./chunks/chunk-4PWPNCNK.js";import"./chunks/chunk-RDXRM3UI.js";import"./chunks/chunk-TGMBHGZO.js";import"./chunks/chunk-SMT2JSM3.js";import"./chunks/chunk-OSF3H4RR.js";import"./chunks/chunk-OD6LVXU6.js";import"./chunks/chunk-IDCGNQ4H.js";import"./chunks/chunk-PXKSE54E.js";import"./chunks/chunk-7FJNLJLF.js";import"./chunks/chunk-D3T24FJW.js";import"./chunks/chunk-VWSLC2WO.js";import"./chunks/chunk-Y3AMP22L.js";import"./chunks/chunk-COQYLD4U.js";import"./chunks/chunk-EI4JBQKL.js";import{a}from"./chunks/chunk-ONUPGMER.js";import l from"fs/promises";import c from"path";import x from"os";var u=c.join(x.homedir(),".kodax","commands");function y(){return u}a(y,"getDefaultCommandDir");async function K(e){let n=new Map,o=e??u;try{await l.mkdir(o,{recursive:!0});let r=await l.readdir(o);for(let t of r){let m=c.extname(t),f=t.replace(m,"");if(m===".md"){try{let d=await l.readFile(c.join(o,t),"utf-8"),i=(d.split(`
2
+ import{$ as Wn,$a as Fo,$b as Fe,A as Q,Aa as lo,Ab as le,B as T,Ba as uo,Bb as ue,C as U,Ca as fo,Cb as fe,D as V,Da as go,Db as ge,E as Y,Ea as Co,Eb as Ce,F as Z,Fa as xo,Fb as xe,G as tt,Ga as yo,Gb as ye,H as nt,Ha as Ko,Hb as Ke,I as ot,Ia as Xo,Ib as Xe,J as et,Ja as ho,Jb as he,K as rt,Ka as Do,Kb as De,L as at,La as Po,Lb as Pe,M as pt,Ma as Mo,Mb as Me,N as lt,Na as bo,Nb as be,O as ut,Oa as wo,Ob as we,P as ft,Pa as No,Pb as Ne,Q as Nn,Qa as _o,Qb as _e,R as _n,Ra as jo,Rb as je,S as jn,Sa as ko,Sb as ke,T as kn,Ta as Ao,Tb as Ae,U as An,Ua as Oo,Ub as Oe,V as On,Va as Ro,Vb as Re,W as Rn,Wa as So,Wb as Se,X as Sn,Xa as vo,Xb as ve,Y as vn,Ya as Io,Yb as Ie,Z as In,Za as Lo,Zb as Le,_ as Ln,_a as Wo,_b as We,a as D,aa as Fn,ab as $o,ac as $e,b as P,ba as $n,bb as qo,bc as qe,c as M,ca as qn,cb as zo,cc as ze,d as b,da as zn,db as Bo,dc as Be,e as w,ea as Bn,eb as Eo,ec as Ee,f as N,fa as En,fb as Go,fc as Ge,g as _,ga as Gn,gb as Ho,h as j,ha as Hn,hb as Jo,i as k,ia as Jn,ib as Qo,j as A,ja as Qn,jb as To,k as O,ka as Tn,kb as Uo,l as R,la as Un,lb as Vo,m as S,ma as Vn,mb as Yo,n as v,na as Yn,nb as Zo,o as I,oa as Zn,ob as te,p as L,pa as to,pb as ne,q as W,qa as no,qb as oe,r as F,ra as oo,rb as ee,s as $,sa as eo,sb as re,t as q,ta as ro,tb as ae,u as z,ua as ao,ub as me,v as B,va as mo,vb as ie,w as E,wa as io,wb as se,x as G,xa as so,xb as ce,y as H,ya as co,yb as de,z as J,za as po,zb as pe}from"./chunks/chunk-RUGAAHTF.js";import{B as dn,C as pn,D as ln,Da as Dn,Ea as Pn,F as un,Fa as Mn,G as fn,Ga as bn,Ha as wn,Q as gn,R as Cn,S as xn,T as yn,U as Kn,Z as Xn,_ as hn,a as mt,b as it,c as st,d as ct,e as dt,f as gt,h as Ct,j as xt,k as yt,l as Kt,m as Xt,q as nn,s as on,t as en,u as rn,v as an,x as mn,y as sn,z as cn}from"./chunks/chunk-ON2WG2LG.js";import{K as qt,L as zt,M as Bt,N as Et,O as Gt,P as Ht,Q as Jt,T as Qt,U as Tt,W as Ut,X as Vt,Y as Yt,_ as Zt,b as ht,c as Dt,ca as tn,d as Pt,e as Mt,f as bt,g as wt,h as Nt,i as _t,j as jt,k as kt,l as At,m as Ot,n as Rt,o as St,p as vt,q as It,s as Lt,t as Wt,u as Ft,v as $t}from"./chunks/chunk-JS2BHGJP.js";import"./chunks/chunk-HORNWBYR.js";import"./chunks/chunk-AOENDSVN.js";import"./chunks/chunk-FNW2XUL5.js";import"./chunks/chunk-3DD4QEBH.js";import"./chunks/chunk-HV2GMZUZ.js";import"./chunks/chunk-EH7AOMJ7.js";import"./chunks/chunk-OAMKECRG.js";import"./chunks/chunk-27QLRH3D.js";import"./chunks/chunk-FSXI4MAV.js";import"./chunks/chunk-2MQPVY6P.js";import"./chunks/chunk-TGCG7U2W.js";import"./chunks/chunk-XSA37BVM.js";import"./chunks/chunk-IQT4RPCE.js";import{a}from"./chunks/chunk-ONUPGMER.js";import l from"fs/promises";import c from"path";import x from"os";var u=c.join(x.homedir(),".kodax","commands");function y(){return u}a(y,"getDefaultCommandDir");async function K(e){let n=new Map,o=e??u;try{await l.mkdir(o,{recursive:!0});let r=await l.readdir(o);for(let t of r){let m=c.extname(t),f=t.replace(m,"");if(m===".md"){try{let d=await l.readFile(c.join(o,t),"utf-8"),i=(d.split(`
3
3
  `)[0]?.replace(/^#\s*/,"").trim()??"").slice(0,60)||"(prompt command)";n.set(f,{name:f,description:i,content:d,type:"prompt"})}catch{}continue}if(m===".js"||m===".ts")try{let g=await import(c.join(o,t));for(let[i,p]of Object.entries(g))if(i.startsWith("command_")&&typeof p=="function"){let s=i.replace("command_",""),C=p.description??s;n.set(s,{name:s,description:String(C).slice(0,60),content:`[Programmable command: ${s}]`,type:"programmable",execute:p})}}catch{}}}catch{}return n}a(K,"loadCommands");async function X(e,n,o,r){let t=o.get(e);return t?t.type==="prompt"?n?t.content.replace(/{args}/g,n):t.content:t.type==="programmable"&&t.execute?t.execute({args:n,runAgent:r}):null:null}a(X,"processCommandCall");function h(e){if(!e.startsWith("/"))return null;let n=e.slice(1).trim();if(!n)return null;let o=n.search(/\s/);if(o===-1)return[n];let r=n.slice(0,o),t=n.slice(o).trim();return t?[r,t]:[r]}a(h,"parseCommandCall");export{Gn as App,Nn as AutocompleteContextProvider,Pn as BUILTIN_COMMANDS,xo as BackgroundTaskBar,ht as CONFIG_TEMPLATES,Ko as ChildActivitySurface,ce as ConsoleCapturer,dt as DEFAULT_UI_STATE,lo as DialogSurface,In as DotsIndicator,xt as FILE_MODIFICATION_TOOLS,ke as FileSessionStorage,Jn as FullscreenTranscriptLayout,$n as HistoryItemRenderer,Rn as InputPrompt,At as IntegrationConfigController,u as KODAX_COMMANDS_DIR,St as KODAX_CONFIG_FILE,Ot as KODAX_DIR,Et as KODAX_EXAMPLE_CONFIG_FILE,Gt as KODAX_INTEGRATION_EXAMPLE_FILES,Rt as KODAX_SESSIONS_DIR,Ft as KODAX_VERSION,ft as KeyMatchers,ct as KeypressHandlerPriority,ot as KeypressParser,lt as KeypressProvider,L as LRUCache,Fn as LoadingIndicator,vo as MemorySessionStorage,Qn as MessageActions,qn as MessageList,Tn as MessageSelector,fo as NotificationsSurface,gt as PERMISSION_MODES,vt as PREVIEW_MAX_LENGTH,ne as PendingInputsIndicator,Ln as ProgressIndicator,Vn as PromptComposer,to as PromptFooter,Yn as PromptFooterLeftSide,Zn as PromptFooterRightSide,no as PromptHelpMenu,po as PromptSuggestionsSurface,ye as ProviderSetupConfigConflictError,Ke as ProviderSetupInvalidConfigError,uo as QueuedCommandsSurface,ko as RUNTIME_PERMISSION_PENDING_NOTICE,Hn as SimpleApp,Sn as SimpleInputPrompt,zn as SimpleMessageDisplay,En as SimpleStatusBar,tt as SingleLineTextInput,vn as Spinner,Co as StashNotice,Bn as StatusBar,go as StatusNoticesSurface,ho as StreamingProvider,mt as StreamingState,co as SuggestionsDisplay,st as TOOL_STATUS_ICONS,An as TextBuffer,Z as TextInput,Wn as ThinkingIndicator,Zo as ToolCallDisplay,it as ToolCallStatus,te as ToolGroup,Yo as ToolProgressBar,Vo as ToolStatusBadge,Un as TranscriptViewport,ao as UIStateProvider,jo as _resetQueuedPromptsCacheForTests,Ie as appendClientNotice,ze as archiveSession,So as bootstrapAutoMode,J as calculateVisualCursorFromLayout,H as calculateVisualLayout,cn as collectBashWriteTargets,Oe as compactSession,yt as computeConfirmTools,To as createCliEvents,eo as createHistoryItem,Oo as createInteractiveContext,Uo as createJsonEvents,wo as createKeyMatcher,pt as createKeypressManager,Io as createMemorySessionStorage,Go as createRecoveryHistoryItem,Bo as createRetryHistoryItem,Ge as createSessionManager,Xo as createStreamingManager,ro as createToolCall,Q as darkTheme,Ae as dedupeSessions,qe as deleteSession,se as detectTerminalCapabilities,j as detectTerminalHostProfile,_ as detectTerminalRenderHost,Ho as emitRecoveryHistoryItem,Eo as emitRetryHistoryItem,Jt as ensureExampleConfigFile,Ht as ensureExampleConfigFiles,wn as executeCommand,Lo as executeShellCommand,xn as extractHistorySeedsFromMessage,yn as extractHistorySeedsFromMessages,Kn as extractTextContent,Xn as extractTitle,zo as findMostRecentResumableSession,Le as forkSession,hn as formatMessagePreview,oo as generateId,rn as generateSavePattern,dn as getBashOutsideProjectWriteRisk,q as getCharAtCodePoint,W as getCodePointLength,Mn as getCommandRegistry,Dt as getConfigTemplate,ge as getCustomProviderConfig,y as getDefaultCommandDir,Zt as getGitRoot,at as getKeyDisplayName,we as getMcpServerConfig,pn as getPlanModeBlockReason,qt as getProviderList,$t as getProviderModel,Xe as getProviderSetupCatalog,S as getTerminalHostCapabilities,me as getTerminalWidth,V as getTheme,Y as getThemeNames,Wt as getVersion,$ as getVisualWidth,G as getVisualWidthCached,P as hasCursorUpViewportYankRisk,b as hasMainScreenRenderScrollRisk,It as hydrateProcessEnvFromShell,he as inspectProviderSetupReadiness,an as isAlwaysConfirmPath,nn as isBashReadCommand,on as isBashWriteCommand,I as isClassicReplForced,mn as isCommandOnProtectedPath,et as isFunctionKey,v as isOwnedRendererPreferred,sn as isPathInsideProject,Kt as isPermissionMode,rt as isPrintable,zt as isProviderConfigured,M as isRemoteConptyHost,ie as isScreenReader,Wo as isShellCommand,Fo as isShellCommandSuccess,w as isTmuxControlMode,en as isToolCallAllowed,D as isVsCodeTerminalHostEnv,F as isWideChar,fe as listCustomProviders,be as listMcpServers,Dn as listRegisteredCommands,$e as listRunningSessions,Re as listSessions,un as loadAutoModeSettings,K as loadCommands,Bt as loadConfig,ve as loadFullTranscript,Se as loadSession,yo as measureChildActivitySurfaceRows,jt as migrateLegacyIntegrationConfig,T as minimalTheme,Xt as normalizePermissionMode,bn as parseCommand,h as parseCommandCall,Mt as parseExtensionsIntegrationDocument,nt as parseKeypress,Pt as parseMcpIntegrationDocument,Ct as permissionModeDisplayName,De as persistProviderSetupChoice,_t as planLegacyIntegrationMigration,Qt as prepareRuntimeConfig,X as processCommandCall,ue as processSpecialSyntax,Pe as providerSetupRestartInstructions,tn as rateLimitedCall,Nt as readExtensionsIntegration,wt as readMcpIntegration,Lt as registerConfiguredCustomProviders,xe as removeCustomProvider,_e as removeMcpServer,ln as replBashPathSignalCollector,N as resetTmuxControlModeProbeForTesting,fn as resolveAutoModeSettings,k as resolveConfiguredTuiRendererMode,A as resolveEffectiveTuiRendererMode,R as resolveFullscreenPolicy,bt as resolveIntegrationConfigPath,O as resolveInteractiveSurfacePreference,Yt as resolveRuntimeEffortSelection,Vt as resolveRuntimeModelSelection,Ut as resolveRuntimeProviderSelection,qo as restoreHistoryItemsFromSession,We as rewindSession,Jo as runInkInteractiveMode,le as runInteractiveMode,Me as runProviderSetupWizard,Qo as runSessionPicker,Tt as saveConfig,gn as seedToHistoryItem,Fe as setActiveEntry,z as splitByCodePoints,ee as supports256Colors,ae as supportsEmoji,oe as supportsTrueColor,re as supportsUnicode,U as themes,Ao as toReplRuntimeAutoModeSettings,Cn as toolCallSeedToHistoryToolCall,Ro as touchContext,$o as trimPersistedUiHistorySnapshot,B as truncateByVisualWidth,Be as unarchiveSession,Ce as upsertCustomProvider,Ne as upsertMcpServer,jn as useAutocomplete,_n as useAutocompleteContext,kn as useInputHistory,bo as useKeypress,ut as useKeypressManager,_o as useQueuedPromptContents,No as useQueuedPrompts,Mo as useStreaming,Po as useStreamingActions,Do as useStreamingState,On as useTextBuffer,so as useUI,io as useUIActions,mo as useUIState,je as validateMcpServerConfig,E as visualWidthCache,Ee as watchSessions,de as withCapture,pe as withCaptureSync,kt as writeIntegrationDocument};
@@ -1,22 +1,23 @@
1
- import { F as KodaXReasoningMode, d as KodaXCustomProviderConfig } from './types-chunks/types.d-CSmF0t0n.js';
2
- export { k as KodaXMessage } from './types-chunks/types.d-CSmF0t0n.js';
3
- import { a1 as KodaXOptions, W as KodaXManagedTaskStatusEvent, Q as KodaXEvents, ab as KodaXResult, ba as RuntimeContextBudgetSnapshot, bh as RuntimeToolExposurePlan, N as KodaXContextOptions, K as KodaXActivityEventMeta, aF as KodaXToolEventMeta, aM as KodaXTurnStartedEvent, aJ as KodaXTurnCompletedEvent, aL as KodaXTurnFailedEvent, L as KodaXContextCompactionFinishedEvent, M as KodaXContextIdentity } from './types-chunks/bash-prefix-extractor.d-r1beOESM.js';
4
- import { C as AgentDispatchContext, Q as AgentExecutorFactory, D as AgentDispatchPolicy, y as AgentCredentialBroker, m as AgentArtifactPolicy, bu as KodaXImageInputArtifact, bx as KodaXInputArtifactSource, c3 as KodaXVideoInputArtifact, ea as WorkflowProcessSnapshot, e4 as WorkflowProcessEvent, M as AgentExecutionKind, al as AgentRegistrationService, b1 as DispatchableAgentQuery, a$ as DispatchableAgentListing, ad as AgentPreflightInput, ae as AgentPreflightResult, aA as AgentTreeSnapshot, B as AgentDetail, an as AgentSpawnInput, aD as AgentTurnRef, z as AgentDataClassification, $ as AgentFollowupResult, ac as AgentOutput, J as AgentEvent } from './types-chunks/types.d-sRLugmjy.js';
1
+ import { F as KodaXReasoningMode, d as KodaXCustomProviderConfig } from './types-chunks/types.d-DIpZJKUl.js';
2
+ export { k as KodaXMessage } from './types-chunks/types.d-DIpZJKUl.js';
3
+ import { a1 as KodaXOptions, aj as KodaXShellExecutionContract, W as KodaXManagedTaskStatusEvent, Q as KodaXEvents, ac as KodaXResult, be as RuntimeContextBudgetSnapshot, bl as RuntimeToolExposurePlan, a4 as KodaXPromptCacheDiagnosticEvent, N as KodaXContextOptions, K as KodaXActivityEventMeta, aJ as KodaXToolEventMeta, aQ as KodaXTurnStartedEvent, aN as KodaXTurnCompletedEvent, aP as KodaXTurnFailedEvent, L as KodaXContextCompactionFinishedEvent, M as KodaXContextIdentity } from './types-chunks/bash-prefix-extractor.d-pZdu6qt7.js';
4
+ import { C as AgentDispatchContext, Q as AgentExecutorFactory, D as AgentDispatchPolicy, y as AgentCredentialBroker, m as AgentArtifactPolicy, bu as KodaXImageInputArtifact, bx as KodaXInputArtifactSource, c3 as KodaXVideoInputArtifact, ea as WorkflowProcessSnapshot, e4 as WorkflowProcessEvent, M as AgentExecutionKind, al as AgentRegistrationService, b1 as DispatchableAgentQuery, a$ as DispatchableAgentListing, ad as AgentPreflightInput, ae as AgentPreflightResult, aA as AgentTreeSnapshot, B as AgentDetail, an as AgentSpawnInput, aD as AgentTurnRef, z as AgentDataClassification, $ as AgentFollowupResult, ac as AgentOutput, J as AgentEvent } from './types-chunks/types.d-RdWRfUEs.js';
5
5
  import { i as SkillMetadata } from './types-chunks/types.d-DCQVBqVn.js';
6
6
  import { a as McpServerConfig } from './types-chunks/config.d-CJy1WENT.js';
7
7
  import { t as McpServerStatus, u as McpServerToolList } from './types-chunks/manager.d-B67TmPO1.js';
8
- import { K as KodaXSessionHistoryHit } from './types-chunks/history-retrieval.d-BKTJIrVd.js';
9
- import { c as ManagedWorkflowSnapshot } from './types-chunks/run-manager.d-B9fEIjZk.js';
10
- import { L as LoadedExtensionDiagnostic, u as ExtensionRuntimeDiagnostics } from './types-chunks/types.d-Bm_y6YuM.js';
11
- import { r as AutoModeStats } from './types-chunks/guardrail.d-qjuKJZ31.js';
12
- import { M as saveConfig, c as CommandInfo } from './types-chunks/utils.d-D0wPxz8y.js';
13
- import { k as FullTranscriptSessionData, Z as SessionTranscriptEntry, c as CompactSessionResult } from './types-chunks/public-api.d-CX4B11qY.js';
8
+ import { K as KodaXSessionHistoryHit } from './types-chunks/history-retrieval.d-B__aEN62.js';
9
+ import { c as ManagedWorkflowSnapshot } from './types-chunks/run-manager.d-B47hIqnI.js';
10
+ import { L as LoadedExtensionDiagnostic, u as ExtensionRuntimeDiagnostics } from './types-chunks/types.d-DCsKM8aT.js';
11
+ import { r as AutoModeStats } from './types-chunks/guardrail.d-B0PwAZVR.js';
12
+ import { M as saveConfig, c as CommandInfo } from './types-chunks/utils.d-CDduqbFw.js';
13
+ import { k as FullTranscriptSessionData, Z as SessionTranscriptEntry, c as CompactSessionResult } from './types-chunks/public-api.d--fF88JrC.js';
14
14
  import { n as LearningQuery, m as LearningPage, b as LearnedCapabilityRecord, p as LearningSurfaceSnapshot, j as LearningEvent, o as LearningSubscribeOptions } from './types-chunks/center-types.d-BBT122uJ.js';
15
15
  import 'vscode-languageserver-protocol';
16
16
  import './types-chunks/cost-tracker.d-BeaenODW.js';
17
+ import './types-chunks/types-LanCEDj8.js';
17
18
  import './types-chunks/capability.d-K664nHOS.js';
18
- import './types-chunks/base.d-ChvpaKjZ.js';
19
- import './types-chunks/guardrail.d-CWYD1bdL.js';
19
+ import './types-chunks/base.d-4e74xDdy.js';
20
+ import './types-chunks/guardrail.d-CJx9RRd3.js';
20
21
  import 'readline';
21
22
  import 'child_process';
22
23
 
@@ -28,7 +29,9 @@ interface RuntimePermissionMatcherBase {
28
29
  }
29
30
  interface RuntimeExactCommandPermissionMatcher extends RuntimePermissionMatcherBase {
30
31
  readonly kind: 'exact-command';
31
- readonly shell: 'cmd' | 'posix';
32
+ readonly shell: 'cmd' | 'posix' | 'powershell';
33
+ /** Hash of the host-owned interpreter/environment contract, when configured. */
34
+ readonly shellContractFingerprint?: string;
32
35
  /** SHA-256 of the normalized concrete command; raw command text is never persisted. */
33
36
  readonly commandFingerprint: string;
34
37
  readonly cwd: string;
@@ -176,7 +179,7 @@ interface RuntimeLearningService {
176
179
 
177
180
  declare const KODAX_DAEMON_PROTOCOL = "kodax-runtime-daemon";
178
181
  declare const KODAX_DAEMON_PROTOCOL_VERSION = 1;
179
- type RuntimeDaemonMethod = 'initialize' | 'runtime.initialize' | 'ping' | 'runtime.identity' | 'runtime.status' | 'runtime.shutdown' | 'runtime.capabilities' | 'daemon.status' | 'daemon.stop' | 'daemon.logs' | 'daemon.preflight' | 'daemon.management.get' | 'daemon.rollbackToInline' | 'operation.get' | 'session.create' | 'session.load' | 'session.list' | 'session.transcript' | 'session.transcript.page' | 'session.transcript.entryChunk' | 'session.transcript.search' | 'session.observe' | 'session.fork' | 'session.notice.append' | 'session.rewind' | 'session.active_entry.set' | 'session.activeEntry.set' | 'session.compact' | 'session.archive' | 'session.unarchive' | 'session.delete' | 'session.settings.get' | 'session.settings.getVersioned' | 'session.autoMode.getStats' | 'session.settings.update' | 'session.settings.updateVersioned' | 'run.start' | 'run.input.submit' | 'run.get' | 'run.list' | 'run.await' | 'run.abort' | 'run.model.set' | 'run.provider.set' | 'run.reasoning.set' | 'run.setModel' | 'run.setProvider' | 'run.setReasoning' | 'event.subscribe' | 'event.unsubscribe' | 'event.replay' | 'permission.list' | 'permission.listPending' | 'permission.request' | 'permission.respond' | 'permission.grants.list' | 'permission.grants.revoke' | 'user_input.listPending' | 'user_input.respond' | 'user_input.dismiss' | 'credential.register' | 'credential.get' | 'credential.revoke' | 'credential.supply' | 'host_tool.register' | 'host_tool.get' | 'host_tool.invocation.get' | 'host_tool.revoke' | 'host_tool.complete' | 'workflow.list' | 'workflow.get' | 'workflow.subscribe' | 'workflow.unsubscribe' | 'workflow.pause' | 'workflow.resume' | 'workflow.stop' | 'learning.list' | 'learning.get' | 'learning.snapshot' | 'learning.events' | 'learning.acknowledge' | 'learning.snooze' | 'learning.reject' | 'learning.disable' | 'learning.rollback' | 'learning.promote' | 'learning.review' | 'learning.trust' | 'config.read' | 'config.patch' | 'config.reload' | 'model.list' | 'provider.list' | 'provider.custom.list' | 'provider.custom.upsert' | 'provider.custom.remove' | 'mcp.server.list' | 'mcp.server.get' | 'mcp.server.validate' | 'mcp.server.upsert' | 'mcp.server.delete' | 'mcp.server.remove' | 'mcp.server.reload' | 'mcp.tool.list' | 'extension.list' | 'extension.reload' | 'command.list' | 'command.resolve' | 'skill.list' | 'skill.describe' | 'skill.read' | 'artifact.create' | 'artifact.get' | 'artifact.delete' | 'agentRegistrations.list' | 'agentRegistrations.upsert' | 'agentRegistrations.setEnabled' | 'agentRegistrations.remove' | 'agents.listDispatchable' | 'agents.describe' | 'agents.preflight' | 'agents.tree' | 'agents.detail' | 'agents.spawn' | 'agents.send' | 'agents.followup' | 'agents.interrupt' | 'agents.output' | 'agents.events' | 'agents.wait' | 'context.budget.get' | 'tool.exposure.preview';
182
+ type RuntimeDaemonMethod = 'initialize' | 'runtime.initialize' | 'ping' | 'runtime.identity' | 'runtime.status' | 'runtime.shutdown' | 'runtime.capabilities' | 'daemon.status' | 'daemon.stop' | 'daemon.logs' | 'daemon.preflight' | 'daemon.management.get' | 'daemon.rollbackToInline' | 'operation.get' | 'session.create' | 'session.load' | 'session.list' | 'session.transcript' | 'session.transcript.page' | 'session.transcript.entryChunk' | 'session.transcript.search' | 'session.observe' | 'session.fork' | 'session.notice.append' | 'session.rewind' | 'session.active_entry.set' | 'session.activeEntry.set' | 'session.compact' | 'session.archive' | 'session.unarchive' | 'session.delete' | 'session.settings.get' | 'session.settings.getVersioned' | 'session.autoMode.getStats' | 'session.settings.update' | 'session.settings.updateVersioned' | 'run.start' | 'run.input.submit' | 'run.get' | 'run.list' | 'run.await' | 'run.abort' | 'run.model.set' | 'run.provider.set' | 'run.reasoning.set' | 'run.setModel' | 'run.setProvider' | 'run.setReasoning' | 'event.subscribe' | 'event.unsubscribe' | 'event.replay' | 'permission.list' | 'permission.listPending' | 'permission.request' | 'permission.respond' | 'permission.grants.list' | 'permission.grants.revoke' | 'user_input.listPending' | 'user_input.respond' | 'user_input.dismiss' | 'credential.register' | 'credential.get' | 'credential.revoke' | 'credential.supply' | 'host_tool.register' | 'host_tool.get' | 'host_tool.invocation.get' | 'host_tool.revoke' | 'host_tool.complete' | 'workflow.list' | 'workflow.get' | 'workflow.subscribe' | 'workflow.unsubscribe' | 'workflow.pause' | 'workflow.resume' | 'workflow.stop' | 'learning.list' | 'learning.get' | 'learning.snapshot' | 'learning.events' | 'learning.acknowledge' | 'learning.snooze' | 'learning.reject' | 'learning.disable' | 'learning.rollback' | 'learning.promote' | 'learning.review' | 'learning.trust' | 'config.read' | 'config.patch' | 'config.reload' | 'model.list' | 'provider.list' | 'provider.custom.list' | 'provider.custom.upsert' | 'provider.custom.remove' | 'mcp.server.list' | 'mcp.server.get' | 'mcp.server.validate' | 'mcp.server.upsert' | 'mcp.server.delete' | 'mcp.server.remove' | 'mcp.server.reload' | 'mcp.tool.list' | 'extension.list' | 'extension.reload' | 'command.list' | 'command.resolve' | 'skill.list' | 'skill.describe' | 'skill.read' | 'artifact.create' | 'artifact.get' | 'artifact.delete' | 'agentRegistrations.list' | 'agentRegistrations.upsert' | 'agentRegistrations.setEnabled' | 'agentRegistrations.remove' | 'agents.listDispatchable' | 'agents.describe' | 'agents.preflight' | 'agents.tree' | 'agents.detail' | 'agents.spawn' | 'agents.send' | 'agents.followup' | 'agents.interrupt' | 'agents.output' | 'agents.events' | 'agents.wait' | 'context.budget.get' | 'tool.exposure.preview' | 'provider.cache.diagnostics.get';
180
183
  type RuntimeDaemonRetiredMethod = 'agentTasks.list' | 'agentTasks.start' | 'agentTasks.get' | 'agentTasks.events' | 'agentTasks.wait' | 'agentTasks.sendInput' | 'agentTasks.cancel' | 'agentTasks.reconcile';
181
184
  type RuntimeDaemonWireMethod = RuntimeDaemonMethod | RuntimeDaemonRetiredMethod;
182
185
  type RuntimeDaemonNotificationMethod = 'event' | 'credential.request' | 'host_tool.invoke' | 'runtime.warning';
@@ -830,6 +833,12 @@ declare const RUNTIME_DAEMON_METHOD_SCHEMAS: {
830
833
  oneOf: RuntimeDaemonJsonSchema[];
831
834
  };
832
835
  };
836
+ 'provider.cache.diagnostics.get': {
837
+ params: RuntimeDaemonJsonSchema;
838
+ result: {
839
+ oneOf: RuntimeDaemonJsonSchema[];
840
+ };
841
+ };
833
842
  };
834
843
  declare const RUNTIME_DAEMON_NOTIFICATION_SCHEMAS: {
835
844
  event: RuntimeDaemonJsonSchema;
@@ -1078,10 +1087,14 @@ interface RuntimeOperationService {
1078
1087
  interface RuntimeDiagnosticFilter {
1079
1088
  readonly sessionId?: string;
1080
1089
  readonly runId?: string;
1090
+ /** Defaults to root so child physical requests do not replace root diagnostics. */
1091
+ readonly contextKind?: 'root' | 'child';
1092
+ readonly agentId?: string;
1081
1093
  }
1082
1094
  interface RuntimeDiagnosticsService {
1083
1095
  latestContextBudget(filter?: RuntimeDiagnosticFilter): Promise<RuntimeContextBudgetSnapshot | null>;
1084
1096
  latestToolExposure(filter?: RuntimeDiagnosticFilter): Promise<RuntimeToolExposurePlan | null>;
1097
+ latestProviderCacheDiagnostic(filter?: RuntimeDiagnosticFilter): Promise<KodaXPromptCacheDiagnosticEvent | null>;
1085
1098
  }
1086
1099
  interface RuntimeConnectionState {
1087
1100
  readonly state: 'connected' | 'disconnected';
@@ -1395,6 +1408,7 @@ interface RuntimeSessionSettings {
1395
1408
  readonly reasoningMode?: KodaXReasoningMode;
1396
1409
  readonly permissionMode?: string;
1397
1410
  readonly executionCwd?: string;
1411
+ readonly shellExecution?: KodaXShellExecutionContract;
1398
1412
  readonly agentMode?: KodaXOptions['agentMode'];
1399
1413
  readonly autoModeEngine?: 'llm' | 'rules';
1400
1414
  readonly autoModeClassifierModel?: string;
@@ -1413,6 +1427,7 @@ interface RuntimeSessionSettingsPatch {
1413
1427
  readonly reasoningMode?: KodaXReasoningMode | null;
1414
1428
  readonly permissionMode?: string | null;
1415
1429
  readonly executionCwd?: string | null;
1430
+ readonly shellExecution?: KodaXShellExecutionContract | null;
1416
1431
  readonly agentMode?: KodaXOptions['agentMode'] | null;
1417
1432
  readonly autoModeEngine?: 'llm' | 'rules' | null;
1418
1433
  readonly autoModeClassifierModel?: string | null;
@@ -1625,7 +1640,7 @@ type RuntimeKodaXOptions = Omit<KodaXOptions, 'provider' | 'session' | 'events'>
1625
1640
  readonly session?: KodaXOptions['session'];
1626
1641
  readonly events?: KodaXEvents;
1627
1642
  };
1628
- type RuntimeDaemonContextOptions = Pick<KodaXContextOptions, 'memoryIdentity' | 'gitRoot' | 'executionCwd' | 'contextTokenSnapshot' | 'projectSnapshot' | 'longRunning' | 'providerPolicyHints' | 'repoRoutingSignals' | 'repoIntelligenceMode' | 'repoIntelligenceTrace' | 'contextDiagnostics' | 'disableAutoTaskReroute' | 'toolConstructionMode' | 'skillsPrompt' | 'rawUserInput' | 'skillInvocation' | 'repoIntelligenceContext' | 'inputArtifacts' | 'promptOverlay' | 'taskSurface' | 'liveTurn' | 'managedTaskWorkspaceDir' | 'managedProtocolEmission' | 'excludeTools' | 'systemPromptOverride' | 'taskMetadata' | 'taskVerification' | 'agentProfile' | 'currentAgentId' | 'parentAgentId'>;
1643
+ type RuntimeDaemonContextOptions = Pick<KodaXContextOptions, 'memoryIdentity' | 'gitRoot' | 'executionCwd' | 'shellExecution' | 'contextTokenSnapshot' | 'projectSnapshot' | 'longRunning' | 'providerPolicyHints' | 'repoRoutingSignals' | 'repoIntelligenceMode' | 'repoIntelligenceTrace' | 'contextDiagnostics' | 'disableAutoTaskReroute' | 'toolConstructionMode' | 'skillsPrompt' | 'rawUserInput' | 'skillInvocation' | 'repoIntelligenceContext' | 'inputArtifacts' | 'promptOverlay' | 'taskSurface' | 'liveTurn' | 'managedTaskWorkspaceDir' | 'managedProtocolEmission' | 'excludeTools' | 'systemPromptOverride' | 'taskMetadata' | 'taskVerification' | 'agentProfile' | 'currentAgentId' | 'parentAgentId'>;
1629
1644
  type RuntimeDaemonKodaXOptions = Pick<RuntimeKodaXOptions, 'provider' | 'model' | 'modelOverride' | 'effort' | 'thinking' | 'reasoningMode' | 'agentMode' | 'maxIter' | 'workflowHostPolicy' | 'workflowRunsBaseDir' | 'modelTiers' | 'maxOutputTokens' | 'disablePromptCache' | 'lsp' | 'workflow' | 'selfManual' | 'compaction' | 'timeouts'> & {
1630
1645
  readonly context?: RuntimeDaemonContextOptions;
1631
1646
  };
@@ -1733,7 +1748,7 @@ interface RuntimeRunService {
1733
1748
  setProvider(runId: string, provider: string): Promise<void>;
1734
1749
  setReasoning(runId: string, reasoning: KodaXReasoningMode | undefined): Promise<void>;
1735
1750
  }
1736
- type RuntimeEventType = 'session.created' | 'session.loaded' | 'session.settings.updated' | 'session.notice.appended' | 'session.rewound' | 'session.active_entry.updated' | 'session.compacted' | 'run.queued' | 'run.started' | 'run.updated' | 'run.progress' | 'run.input.queued' | 'run.input.delivered' | 'turn.started' | 'turn.completed' | 'turn.failed' | 'assistant.delta' | 'thinking.delta' | 'thinking.finished' | 'tool.started' | 'tool.progress' | 'tool.finished' | 'user_input.requested' | 'user_input.resolved' | 'permission.requested' | 'permission.resolved' | 'permission.grant.changed' | 'workflow.started' | 'workflow.updated' | 'workflow.finished' | 'context.compaction.started' | 'context.compaction.stats' | 'context.compaction.finished' | 'context.compaction.messages' | 'context.compaction.ended' | 'context.compaction.skipped' | 'context.budget.snapshot' | 'tool.exposure.planned' | 'child_activity.finished' | 'provider.retry' | 'provider.recovery' | 'repo_intelligence.trace' | 'todo.updated' | 'todo.warning' | 'sidecar.message' | 'run.completed' | 'run.failed' | 'run.cancelled' | 'run.interrupted' | 'artifact.created' | 'config.effective' | 'runtime.warning';
1751
+ type RuntimeEventType = 'session.created' | 'session.loaded' | 'session.settings.updated' | 'session.notice.appended' | 'session.rewound' | 'session.active_entry.updated' | 'session.compacted' | 'run.queued' | 'run.started' | 'run.updated' | 'run.progress' | 'run.input.queued' | 'run.input.delivered' | 'turn.started' | 'turn.completed' | 'turn.failed' | 'assistant.delta' | 'thinking.delta' | 'thinking.finished' | 'tool.started' | 'tool.progress' | 'tool.finished' | 'user_input.requested' | 'user_input.resolved' | 'permission.requested' | 'permission.resolved' | 'permission.grant.changed' | 'workflow.started' | 'workflow.updated' | 'workflow.finished' | 'context.compaction.started' | 'context.compaction.stats' | 'context.compaction.finished' | 'context.compaction.messages' | 'context.compaction.ended' | 'context.compaction.skipped' | 'context.budget.snapshot' | 'tool.exposure.planned' | 'child_activity.finished' | 'provider.retry' | 'provider.recovery' | 'provider.cache.diagnostics' | 'repo_intelligence.trace' | 'todo.updated' | 'todo.warning' | 'sidecar.message' | 'run.completed' | 'run.failed' | 'run.cancelled' | 'run.interrupted' | 'artifact.created' | 'config.effective' | 'runtime.warning';
1737
1752
  interface RuntimeTextDeltaEventPayload {
1738
1753
  readonly text: string;
1739
1754
  readonly meta?: KodaXActivityEventMeta;
@@ -1856,7 +1871,7 @@ type RuntimeUserInputRequestedEventPayload = RuntimeUserInputRequest | {
1856
1871
  type RuntimeEventPayloadDefaults = {
1857
1872
  readonly [K in RuntimeEventType]: unknown;
1858
1873
  };
1859
- type RuntimeEventPayloadMap = Omit<RuntimeEventPayloadDefaults, 'session.created' | 'session.loaded' | 'run.queued' | 'run.started' | 'run.updated' | 'run.completed' | 'run.failed' | 'run.cancelled' | 'run.interrupted' | 'assistant.delta' | 'thinking.delta' | 'thinking.finished' | 'tool.started' | 'tool.progress' | 'tool.finished' | 'run.progress' | 'run.input.queued' | 'run.input.delivered' | 'todo.updated' | 'user_input.requested' | 'user_input.resolved' | 'permission.requested' | 'permission.resolved' | 'permission.grant.changed' | 'session.settings.updated' | 'turn.started' | 'turn.completed' | 'turn.failed' | 'workflow.started' | 'workflow.updated' | 'workflow.finished' | 'context.budget.snapshot' | 'tool.exposure.planned' | 'context.compaction.messages' | 'context.compaction.finished' | 'runtime.warning'> & {
1874
+ type RuntimeEventPayloadMap = Omit<RuntimeEventPayloadDefaults, 'session.created' | 'session.loaded' | 'run.queued' | 'run.started' | 'run.updated' | 'run.completed' | 'run.failed' | 'run.cancelled' | 'run.interrupted' | 'assistant.delta' | 'thinking.delta' | 'thinking.finished' | 'tool.started' | 'tool.progress' | 'tool.finished' | 'run.progress' | 'run.input.queued' | 'run.input.delivered' | 'todo.updated' | 'user_input.requested' | 'user_input.resolved' | 'permission.requested' | 'permission.resolved' | 'permission.grant.changed' | 'session.settings.updated' | 'turn.started' | 'turn.completed' | 'turn.failed' | 'workflow.started' | 'workflow.updated' | 'workflow.finished' | 'context.budget.snapshot' | 'provider.cache.diagnostics' | 'tool.exposure.planned' | 'context.compaction.messages' | 'context.compaction.finished' | 'runtime.warning'> & {
1860
1875
  readonly 'session.created': RuntimeSession;
1861
1876
  readonly 'session.loaded': RuntimeSessionLoadedEventPayload;
1862
1877
  readonly 'run.queued': RuntimeRunStatus;
@@ -1889,6 +1904,7 @@ type RuntimeEventPayloadMap = Omit<RuntimeEventPayloadDefaults, 'session.created
1889
1904
  readonly 'workflow.updated': WorkflowProcessEvent;
1890
1905
  readonly 'workflow.finished': WorkflowProcessEvent;
1891
1906
  readonly 'context.budget.snapshot': RuntimeContextBudgetSnapshot;
1907
+ readonly 'provider.cache.diagnostics': KodaXPromptCacheDiagnosticEvent;
1892
1908
  readonly 'tool.exposure.planned': RuntimeToolExposurePlan;
1893
1909
  readonly 'context.compaction.messages': RuntimeContextCompactionMessagesEventPayload;
1894
1910
  readonly 'context.compaction.finished': RuntimeContextCompactionFinishedEventPayload;
@@ -2200,5 +2216,5 @@ declare function createKodaXRuntime(options: CreateKodaXRuntimeOptions & {
2200
2216
  declare function createKodaXRuntime(options?: CreateKodaXRuntimeOptions): Promise<KodaXRuntime>;
2201
2217
  declare function connectKodaXRuntime(options?: ConnectKodaXRuntimeOptions): Promise<KodaXDaemonRuntime>;
2202
2218
 
2203
- export { KODAX_DAEMON_PROTOCOL, KODAX_DAEMON_PROTOCOL_VERSION, KodaXEvents, KodaXResult, RUNTIME_DAEMON_METHODS, RUNTIME_DAEMON_METHOD_SCHEMAS, RUNTIME_DAEMON_NOTIFICATION_SCHEMAS, RUNTIME_DAEMON_PROTOCOL_SCHEMA, RUNTIME_DAEMON_PROTOCOL_SCHEMA_JSON, RuntimeAutoModeConfigurationError, RuntimeContextBudgetSnapshot, RuntimeDaemonCapabilityUpgradeError, RuntimePermissionScopeUpgradeRequiredError, RuntimeToolExposurePlan, RuntimeTransportBoundaryError, SessionTranscriptEntry, acquireKodaXInlineOwner, connectKodaXRuntime, createKodaXRuntime, enableKodaXDaemonOwner, getKodaXRuntimeOwnerPolicy, getKodaXRuntimeOwnerState, listRuntimeDaemonSchemaMethods, parseRuntimeEvent, setKodaXRuntimeOwnerMode };
2219
+ export { KODAX_DAEMON_PROTOCOL, KODAX_DAEMON_PROTOCOL_VERSION, KodaXEvents, KodaXPromptCacheDiagnosticEvent, KodaXResult, RUNTIME_DAEMON_METHODS, RUNTIME_DAEMON_METHOD_SCHEMAS, RUNTIME_DAEMON_NOTIFICATION_SCHEMAS, RUNTIME_DAEMON_PROTOCOL_SCHEMA, RUNTIME_DAEMON_PROTOCOL_SCHEMA_JSON, RuntimeAutoModeConfigurationError, RuntimeContextBudgetSnapshot, RuntimeDaemonCapabilityUpgradeError, RuntimePermissionScopeUpgradeRequiredError, RuntimeToolExposurePlan, RuntimeTransportBoundaryError, SessionTranscriptEntry, acquireKodaXInlineOwner, connectKodaXRuntime, createKodaXRuntime, enableKodaXDaemonOwner, getKodaXRuntimeOwnerPolicy, getKodaXRuntimeOwnerState, listRuntimeDaemonSchemaMethods, parseRuntimeEvent, setKodaXRuntimeOwnerMode };
2204
2220
  export type { ConnectKodaXRuntimeOptions, CreateKodaXRuntimeOptions, KodaXDaemonRuntime, KodaXRuntime, KodaXRuntimeIsolation, KodaXRuntimeMode, RuntimeActiveAgentTurn, RuntimeActiveToolProjection, RuntimeAdminService, RuntimeAgentBindingService, RuntimeAgentOwnerSession, RuntimeAgentService, RuntimeAppendNoticeInput, RuntimeArtifact, RuntimeArtifactKind, RuntimeArtifactRefInput, RuntimeArtifactService, RuntimeBoundDefaultAgent, RuntimeBoundLocalAgent, RuntimeCapabilityRequirements, RuntimeCatalogService, RuntimeClientCapabilities, RuntimeClientInfo, RuntimeCommandInfo, RuntimeCommandResolveInput, RuntimeCompactSessionInput, RuntimeCompactSessionResult, RuntimeConfigPatch, RuntimeConfigReloadResult, RuntimeConfigService, RuntimeConnectionService, RuntimeConnectionState, RuntimeContextCompactionFinishedEventPayload, RuntimeContextCompactionMessagesEventPayload, RuntimeContinuationStatus, RuntimeCreateArtifactInput, RuntimeCreateSessionInput, RuntimeCredentialBroker, RuntimeCredentialLease, RuntimeCredentialRequest, RuntimeCredentialService, RuntimeDaemonClientTransport, RuntimeDaemonContextOptions, RuntimeDaemonEndpoint, RuntimeDaemonError, RuntimeDaemonErrorCode, RuntimeDaemonFrame, RuntimeDaemonJsonSchema, RuntimeDaemonKodaXOptions, RuntimeDaemonManagementService, RuntimeDaemonManagementState, RuntimeDaemonMethod, RuntimeDaemonMethodSchema, RuntimeDaemonNotification, RuntimeDaemonNotificationMethod, RuntimeDaemonPreflight, RuntimeDaemonProtocolSchema, RuntimeDaemonRequest, RuntimeDaemonRollbackInput, RuntimeDaemonRollbackResult, RuntimeDaemonRunService, RuntimeDaemonStartRunInput, RuntimeDaemonTransportLifecycleState, RuntimeDefaultAgentStartInput, RuntimeDeliveredInterruptInput, RuntimeDiagnosticFilter, RuntimeDiagnosticsService, RuntimeEffectiveSkillRef, RuntimeEvent, RuntimeEventEnvelope, RuntimeEventFilter, RuntimeEventListener, RuntimeEventParseResult, RuntimeEventPayloadMap, RuntimeEventReplayFilter, RuntimeEventService, RuntimeEventType, RuntimeExactCallPermissionMatcher, RuntimeExactCommandPermissionMatcher, RuntimeExactPathPermissionMatcher, RuntimeExecutionToolPolicy, RuntimeExtensionListResult, RuntimeExtensionReloadResult, RuntimeExternalAgentsOptions, RuntimeFileInput, RuntimeForkSessionInput, RuntimeGrantedScope, RuntimeHostToolDescriptor, RuntimeHostToolHandler, RuntimeHostToolInvocation, RuntimeHostToolInvocationStatus, RuntimeHostToolLease, RuntimeHostToolResult, RuntimeHostToolService, RuntimeIdentity, RuntimeImageInput, RuntimeInlineOwnerHandle, RuntimeInput, RuntimeInteractionResolvedEventPayload, RuntimeInterruptInputStatus, RuntimeKodaXOptions, RuntimeLocalAgentStartInput, RuntimeManagedTaskProjection, RuntimeMcpReloadResult, RuntimeMcpService, RuntimeMcpToolListFilter, RuntimeMcpValidateResult, RuntimeModelListFilter, RuntimeOperationOptions, RuntimeOperationReceipt, RuntimeOperationService, RuntimeOperationState, RuntimeOwnerIdentity, RuntimeOwnerPolicyState, RuntimeOwnerState, RuntimePendingUserInputProjection, RuntimePermissionBroker, RuntimePermissionDecision, RuntimePermissionFilter, RuntimePermissionGrant, RuntimePermissionGrantChangedEventPayload, RuntimePermissionGrantSuggestion, RuntimePermissionHostPlatform, RuntimePermissionMatcher, RuntimePermissionRequest, RuntimePermissionRequestInput, RuntimePermissionRespondOptions, RuntimePermissionRisk, RuntimePermissionScope, RuntimePermissionService, RuntimeResolvedLocalAgent, RuntimeRewindSessionInput, RuntimeRunFilter, RuntimeRunHandle, RuntimeRunInputDeliveredEventPayload, RuntimeRunInputQueuedEventPayload, RuntimeRunMode, RuntimeRunPhase, RuntimeRunProgressEventPayload, RuntimeRunRequirements, RuntimeRunResult, RuntimeRunService, RuntimeRunSessionLoadedEventPayload, RuntimeRunStatus, RuntimeSession, RuntimeSessionFilter, RuntimeSessionLiveProjection, RuntimeSessionLoadedEventPayload, RuntimeSessionObservation, RuntimeSessionObservationSnapshot, RuntimeSessionService, RuntimeSessionSettings, RuntimeSessionSettingsPatch, RuntimeSessionSettingsUpdatedEventPayload, RuntimeSessionSummary, RuntimeSetActiveEntryInput, RuntimeSkillDescribeInput, RuntimeSkillDescription, RuntimeSkillFileSummary, RuntimeSkillListFilter, RuntimeSkillSummary, RuntimeStartRunInput, RuntimeStatusService, RuntimeStatusSnapshot, RuntimeSubmitInput, RuntimeSubmitInputResult, RuntimeSubscription, RuntimeTerminalCode, RuntimeTerminalFact, RuntimeTextDeltaEventPayload, RuntimeTextInput, RuntimeThinkingFinishedEventPayload, RuntimeTodoUpdatedEventPayload, RuntimeToolFinishedEventPayload, RuntimeToolProgressEventPayload, RuntimeToolStartedEventPayload, RuntimeTranscript, RuntimeTranscriptEntryChunk, RuntimeTranscriptEntryChunkInput, RuntimeTranscriptPageInput, RuntimeTranscriptSearchHit, RuntimeTranscriptSearchInput, RuntimeTranscriptSearchResult, RuntimeTranscriptSlice, RuntimeTranscriptSliceEntry, RuntimeTypedEvent, RuntimeTypedEventListener, RuntimeUserInputFilter, RuntimeUserInputKind, RuntimeUserInputRequest, RuntimeUserInputRequestedEventPayload, RuntimeUserInputResolution, RuntimeUserInputService, RuntimeUserMarkdownAgentRef, RuntimeVersionedUpdateOptions, RuntimeVersionedValue, RuntimeVideoInput, RuntimeWarningEventPayload, RuntimeWorkerOptions, RuntimeWorkerResourceLimits, RuntimeWorkflowFilter, RuntimeWorkflowListener, RuntimeWorkflowService, RuntimeWorkflowSnapshot, RuntimeWorkflowSummary, RuntimeWorkspaceBinding };