@kodax-ai/kodax 0.7.96 → 0.7.97-alpha.2

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 (127) hide show
  1. package/CHANGELOG.md +86 -0
  2. package/README.md +85 -62
  3. package/README_CN.md +57 -67
  4. package/config-templates/config.example.jsonc +0 -14
  5. package/dist/chunks/{agent-7N427EVB.js → agent-J7SHFM5N.js} +1 -1
  6. package/dist/chunks/argument-completer-ZJQOWTIS.js +2 -0
  7. package/dist/chunks/{chunk-ABZDFK2X.js → chunk-2GV6MQ4T.js} +14 -14
  8. package/dist/chunks/{chunk-6QI3GOYG.js → chunk-3PS3YEDS.js} +1 -1
  9. package/dist/chunks/chunk-4VJMQDTH.js +417 -0
  10. package/dist/chunks/{chunk-NI7PBPUR.js → chunk-5DSUVP46.js} +1 -1
  11. package/dist/chunks/chunk-5P7RTSZT.js +21 -0
  12. package/dist/chunks/{chunk-XXNR6S4Q.js → chunk-6ZAQKFIM.js} +1 -1
  13. package/dist/chunks/chunk-7V2QBZ73.js +137 -0
  14. package/dist/chunks/{chunk-C7U542KM.js → chunk-F7DHZH6T.js} +1 -1
  15. package/dist/chunks/{chunk-7IMWOR34.js → chunk-HSRYDDPF.js} +1 -1
  16. package/dist/chunks/chunk-K3DQGSQU.js +372 -0
  17. package/dist/chunks/chunk-NO23K2CB.js +2 -0
  18. package/dist/chunks/{chunk-NKT3B3DR.js → chunk-OT5WHAX4.js} +1 -1
  19. package/dist/chunks/{chunk-YEAUDI6U.js → chunk-QGWHJIO4.js} +1 -1
  20. package/dist/chunks/chunk-QOFFAY5C.js +261 -0
  21. package/dist/chunks/{chunk-4PFZ7BEE.js → chunk-QVDTORL3.js} +11 -11
  22. package/dist/chunks/chunk-QZ4B4AWG.js +473 -0
  23. package/dist/chunks/chunk-RXDS6CNA.js +355 -0
  24. package/dist/chunks/{chunk-WV3DJVW4.js → chunk-VDGPJQL7.js} +135 -135
  25. package/dist/chunks/chunk-VEZ4WHPN.js +641 -0
  26. package/dist/chunks/chunk-ZPPAT25E.js +5 -0
  27. package/dist/chunks/chunk-ZQYWDI4O.js +1 -0
  28. package/dist/chunks/chunk-ZS2GUADU.js +498 -0
  29. package/dist/chunks/{chunk-GN2IY5YE.js → chunk-ZTYZYXGV.js} +1 -1
  30. package/dist/chunks/{chunk-EM4XJBTK.js → chunk-ZZQ4GDVU.js} +1 -1
  31. package/dist/chunks/{client-6WZZTTSV.js → client-MXOJ5XUN.js} +1 -1
  32. package/dist/chunks/{compaction-config-ZMEJU4U7.js → compaction-config-5VZSGKBQ.js} +1 -1
  33. package/dist/chunks/{construction-bootstrap-RX4DMHI7.js → construction-bootstrap-U2ZU2WAT.js} +1 -1
  34. package/dist/chunks/dist-CSLNWLOE.js +2 -0
  35. package/dist/chunks/dist-XXMJMJDU.js +2 -0
  36. package/dist/chunks/host-RUXYZFYN.js +2 -0
  37. package/dist/chunks/readline-helpers-JCVULR4C.js +2 -0
  38. package/dist/chunks/run-manager-DRIM5VNE.js +2 -0
  39. package/dist/chunks/utils-MQEBGKIX.js +2 -0
  40. package/dist/index.d.ts +63 -30
  41. package/dist/index.js +10 -6
  42. package/dist/kodax_bootstrap.js +1 -1
  43. package/dist/kodax_cli.js +1745 -1734
  44. package/dist/kodax_resume.js +32 -35
  45. package/dist/native/win32-x64/kodax-windows-sandbox.exe +0 -0
  46. package/dist/native/win32-x64/kodax-windows-text-transaction.node +0 -0
  47. package/dist/native/win32-x64/manifest.json +2 -2
  48. package/dist/sandbox-network-broker.js +77 -77
  49. package/dist/sdk-a2a.d.ts +33 -18
  50. package/dist/sdk-a2a.js +8 -9
  51. package/dist/sdk-agent.d.ts +33 -26
  52. package/dist/sdk-agent.js +1 -1
  53. package/dist/sdk-client.d.ts +40 -0
  54. package/dist/sdk-client.js +2 -0
  55. package/dist/sdk-coding.d.ts +87 -499
  56. package/dist/sdk-coding.js +1 -1
  57. package/dist/sdk-experimental-memory.d.ts +3 -4
  58. package/dist/sdk-experimental-memory.js +1 -1
  59. package/dist/sdk-llm.d.ts +11 -9
  60. package/dist/sdk-llm.js +1 -1
  61. package/dist/sdk-mcp.d.ts +3 -3
  62. package/dist/sdk-mcp.js +1 -1
  63. package/dist/sdk-media.d.ts +3 -1
  64. package/dist/sdk-media.js +1 -1
  65. package/dist/sdk-repl.d.ts +317 -70
  66. package/dist/sdk-repl.js +2 -2
  67. package/dist/sdk-runtime.d.ts +580 -452
  68. package/dist/sdk-runtime.js +1 -1
  69. package/dist/sdk-sandbox.js +1 -1
  70. package/dist/sdk-session.d.ts +13 -9
  71. package/dist/sdk-session.js +1 -1
  72. package/dist/sdk-skills.js +1 -1
  73. package/dist/semantic-worker.js +57 -57
  74. package/dist/types-chunks/{base.d-Bt9lhwSV.d.ts → base.d-ZBOdjDUT.d.ts} +2 -1
  75. package/dist/types-chunks/{bash-prefix-extractor.d-DWFIMg0v.d.ts → bash-prefix-extractor.d-DvswAXKS.d.ts} +136 -66
  76. package/dist/types-chunks/{capability-learning.d-gRtO03f6.d.ts → capability-learning.d-B4pxKwP4.d.ts} +1 -1
  77. package/dist/types-chunks/{capability.d-Ch5Vos33.d.ts → capability.d-DOF3r0fJ.d.ts} +1 -1
  78. package/dist/types-chunks/{capsule.d-Dj1n6s0Y.d.ts → capsule.d-B4atvlxE.d.ts} +7 -19
  79. package/dist/types-chunks/client-contract-A1jdk6xz.d.ts +1993 -0
  80. package/dist/types-chunks/{controller.d-C0IM1Tud.d.ts → controller.d-BkUJ_3sl.d.ts} +1 -1
  81. package/dist/types-chunks/{controller.d-J2t1q8Ly.d.ts → controller.d-yyKajPTi.d.ts} +140 -1380
  82. package/dist/types-chunks/{cost-tracker.d-BWI4lFWn.d.ts → cost-tracker.d-BeaenODW.d.ts} +2 -47
  83. package/dist/types-chunks/{history-retrieval.d-CPN5PMBV.d.ts → history-retrieval.d-JdFfkeF3.d.ts} +2 -2
  84. package/dist/types-chunks/{manager.d-rtmywU9M.d.ts → manager.d-C_20XqCV.d.ts} +8 -1
  85. package/dist/types-chunks/manifest.d-Bw2i-zQi.d.ts +18 -0
  86. package/dist/types-chunks/provider-credential-context.d-BH2OaB1b.d.ts +47 -0
  87. package/dist/types-chunks/provider-request-observation.d-jL8T6wVO.d.ts +34 -0
  88. package/dist/types-chunks/{public-api.d-amBop8Nk.d.ts → public-api.d-Cq8ILMte.d.ts} +52 -13
  89. package/dist/types-chunks/{resolver.d-BrwLoWNr.d.ts → resolver.d-DLY01RHx.d.ts} +4 -2
  90. package/dist/types-chunks/{types.d-CSv0_cZC.d.ts → review-inbox.d-BeaLRNHx.d.ts} +251 -3
  91. package/dist/types-chunks/{shell-command-sets.d-oejwpP_7.d.ts → review-packet.d-D4bbTbq3.d.ts} +46 -3
  92. package/dist/types-chunks/{exec-policy.d-BPESl90L.d.ts → run-manager.d-C7Q71rin.d.ts} +385 -62
  93. package/dist/types-chunks/runtime-client-info-CxnlZlW5.d.ts +175 -0
  94. package/dist/types-chunks/{sdk-session-B6XjHNU1.d.ts → sdk-session-BDFjCpDn.d.ts} +12 -4
  95. package/dist/types-chunks/{side-query.d-DHWG1JZg.d.ts → side-query.d-DTrhVd_r.d.ts} +4 -3
  96. package/dist/types-chunks/trusted-repl-entry-vbUM8R6P.d.ts +445 -0
  97. package/dist/types-chunks/{types.d-CtO8mR1s.d.ts → types.d-BJTN-RZr.d.ts} +5 -5
  98. package/dist/types-chunks/{types.d-BrQMB-hy.d.ts → types.d-BjOq57-z.d.ts} +6 -0
  99. package/dist/types-chunks/types.d-o7t9dds4.d.ts +1484 -0
  100. package/dist/types-chunks/{utils.d-DcznBeQ3.d.ts → utils.d-CWiMhFfu.d.ts} +202 -36
  101. package/docs/CLIENT_CONTRACT.md +441 -0
  102. package/docs/SDK_MIGRATION.md +123 -0
  103. package/docs/SPACE_SDK_SEAMS.md +139 -0
  104. package/package.json +10 -5
  105. package/public_docs/README.md +12 -133
  106. package/public_docs/configuration/config-files.md +8 -14
  107. package/public_docs/sdk/embedder-guide.md +494 -420
  108. package/dist/chunks/argument-completer-FAIHW7HZ.js +0 -2
  109. package/dist/chunks/chunk-66XN5AFU.js +0 -417
  110. package/dist/chunks/chunk-7O2AIFNE.js +0 -373
  111. package/dist/chunks/chunk-DSXUXUZG.js +0 -5
  112. package/dist/chunks/chunk-GYO73UYQ.js +0 -275
  113. package/dist/chunks/chunk-HPCS3LZ5.js +0 -324
  114. package/dist/chunks/chunk-HZYRLIOC.js +0 -137
  115. package/dist/chunks/chunk-SC2ELSUS.js +0 -675
  116. package/dist/chunks/chunk-TEUD5VPJ.js +0 -471
  117. package/dist/chunks/chunk-TYZ2ZAYL.js +0 -487
  118. package/dist/chunks/dist-3UCCMCYR.js +0 -2
  119. package/dist/chunks/dist-F5IWZSAY.js +0 -2
  120. package/dist/chunks/host-W2JJ3V3Q.js +0 -2
  121. package/dist/chunks/run-manager-RBWU3EVE.js +0 -2
  122. package/dist/chunks/utils-DJ4ZFJGL.js +0 -2
  123. package/dist/runtime-worker.js +0 -5381
  124. package/dist/types-chunks/review-inbox.d-CTeUIKda.d.ts +0 -225
  125. package/dist/types-chunks/run-manager.d-hm1XgEou.d.ts +0 -94
  126. package/dist/types-chunks/trusted-repl-entry-D0w5M0UZ.d.ts +0 -323
  127. package/dist/types-chunks/types.d-B1l9pWyX.d.ts +0 -146
@@ -1,4 +1,4 @@
1
- import { r as KodaXProviderConfig, k as KodaXMessage, a3 as KodaXToolDefinition, I as KodaXReasoningRequest, z as KodaXProviderStreamOptions, P as KodaXStreamResult, a9 as KodaXVerifyCredentialResult, l as KodaXModelDescriptor, q as KodaXProviderCapabilityProfile, C as KodaXReasoningCapability, H as KodaXReasoningProfile, n as KodaXNormalizedReasoningRequest, ab as KodaXWireReasoningEffort } from './types.d-BrQMB-hy.js';
1
+ import { r as KodaXProviderConfig, k as KodaXMessage, a3 as KodaXToolDefinition, I as KodaXReasoningRequest, z as KodaXProviderStreamOptions, P as KodaXStreamResult, a9 as KodaXVerifyCredentialResult, l as KodaXModelDescriptor, q as KodaXProviderCapabilityProfile, C as KodaXReasoningCapability, H as KodaXReasoningProfile, n as KodaXNormalizedReasoningRequest, ab as KodaXWireReasoningEffort } from './types.d-BjOq57-z.js';
2
2
 
3
3
  /**
4
4
  * KodaX AI Errors
@@ -199,6 +199,7 @@ interface KodaXRetryAfterEvent {
199
199
  }
200
200
  type KodaXOnRetryAfterCallback = (event: KodaXRetryAfterEvent) => void;
201
201
  declare abstract class KodaXBaseProvider {
202
+ protected readonly requestObservationBoundary: 'physical_attempt' | 'provider_operation';
202
203
  abstract readonly name: string;
203
204
  abstract readonly supportsThinking: boolean;
204
205
  protected abstract readonly config: KodaXProviderConfig;
@@ -1,53 +1,15 @@
1
- import { _ as KodaXGoalState, ag as KodaXSessionLineage, k as AgentActorStore, P as AgentTurnExecutor, p as AgentBudgetPort, b as AgentActorOwner, a as AgentActorClient, M as AgentSpawnInput, H as AgentMutationOptions, Q as AgentTurnRef, y as AgentFollowupResult, x as AgentExecutionResult, a1 as KodaXJsonValue, V as KodaXExtensionSessionRecord, W as KodaXExtensionSessionState, a7 as KodaXSessionArtifactLedgerEntry, bf as SessionErrorMetadata, ao as KodaXSessionScope, ap as KodaXSessionStorage, aJ as MemoryContextIdentity, aV as MemoryPack, b9 as MemoryReviewPlan, a4 as KodaXMemoryOutcomeDigest, ba as MemoryReviewRunner } from './types.d-CSv0_cZC.js';
1
+ import { af as KodaXGoalState, ax as KodaXSessionLineage, k as AgentActorStore, P as AgentTurnExecutor, p as AgentBudgetPort, b as AgentActorOwner, a as AgentActorClient, M as AgentSpawnInput, H as AgentMutationOptions, v as AgentExecutionInput, x as AgentExecutionResult, Q as AgentTurnRef, y as AgentFollowupResult, ai as KodaXJsonValue, aa as KodaXExtensionSessionRecord, aF as KodaXSessionScope, aG as KodaXSessionStorage, ab as KodaXExtensionSessionState, a_ as MemoryContextIdentity, ba as MemoryPack, bq as MemoryReviewPlan, al as KodaXMemoryOutcomeDigest, br as MemoryReviewRunner, ao as KodaXSessionArtifactLedgerEntry, bB as SessionErrorMetadata } from './review-inbox.d-BeaLRNHx.js';
2
2
  import { Diagnostic, Position, Location, Hover, DocumentSymbol, SymbolInformation, WorkspaceSymbol, CallHierarchyItem, CallHierarchyIncomingCall, CallHierarchyOutgoingCall } from 'vscode-languageserver-protocol';
3
- import { a2 as KodaXTokenUsage, k as KodaXMessage, a5 as KodaXToolResultContentItem, a3 as KodaXToolDefinition, ab as KodaXWireReasoningEffort, W as KodaXTaskRoutingDecision, X as KodaXTaskType, Y as KodaXTaskWorkIntent, S as KodaXTaskComplexity, N as KodaXRiskLevel, h as KodaXHarnessProfile, f as KodaXExecutionMode, b as KodaXChildFanoutClass, G as KodaXReasoningMode, J as KodaXReasoningResolution, I as KodaXReasoningRequest, M as KodaXReviewScale } from './types.d-BrQMB-hy.js';
4
- import { P as AgentMessage, cz as StopHookFn, o as AgentControllerHealth, G as AgentExecutorPlaneBinding, f as Agent, d0 as WorkflowIsolation, aO as GuardrailPermissionIntent, cZ as WorkflowEventCorrelation, bO as ManagedRunChildProcessReference, an as CompactionUpdate, aj as CompactionReport, de as WorkflowProcessEvent, cY as WorkflowEvent, ac as AskUserQuestionOptions, a8 as AskUserAnswer, aa as AskUserMultiOptions, aK as Guardrail, au as DiscoveredInstance, b0 as KodaXInputArtifact, cP as UnifiedLearningReviewRunner } from './controller.d-J2t1q8Ly.js';
5
- import { d as ProviderCredentialLeaseAccess, K as KodaXLlmTimeoutConfig, a as CostTracker } from './cost-tracker.d-BWI4lFWn.js';
3
+ import { a2 as KodaXTokenUsage, k as KodaXMessage, a5 as KodaXToolResultContentItem, a3 as KodaXToolDefinition, ab as KodaXWireReasoningEffort, G as KodaXReasoningMode, h as KodaXHarnessProfile, a4 as KodaXToolResultBlock, J as KodaXReasoningResolution, b as KodaXChildFanoutClass, W as KodaXTaskRoutingDecision, I as KodaXReasoningRequest, Y as KodaXTaskWorkIntent, M as KodaXReviewScale, S as KodaXTaskComplexity, X as KodaXTaskType, N as KodaXRiskLevel, f as KodaXExecutionMode } from './types.d-BjOq57-z.js';
4
+ import { i as AgentMessage, a$ as StopHookFn, f as AgentControllerHealth, d as Agent, H as GuardrailPermissionIntent, z as GuardrailContext, a8 as ManagedRunChildProcessReference, x as Guardrail, t as DiscoveredInstance, ao as QueuedMessage, bf as UnifiedLearningReviewRunner } from './controller.d-yyKajPTi.js';
5
+ import { a as ProviderCredentialLeaseAccess } from './provider-credential-context.d-BH2OaB1b.js';
6
+ import { x as AgentExecutorPlaneBinding, b5 as WorkflowEventCorrelation, a7 as CompactionUpdate, a4 as CompactionReport, bm as WorkflowProcessEvent, b4 as WorkflowEvent, _ as AskUserQuestionOptions, W as AskUserAnswer, Y as AskUserMultiOptions, am as KodaXInputArtifact, b8 as WorkflowIsolation } from './types.d-o7t9dds4.js';
6
7
  import * as node_child_process from 'node:child_process';
7
- import { d as SkillDynamicContextExecutor, I as ISkillRegistry } from './types.d-Cb8RdrjU.js';
8
+ import { d as SkillDynamicContextExecutor, I as ISkillRegistry, h as SkillHooks } from './types.d-Cb8RdrjU.js';
9
+ import { K as KodaXLlmTimeoutConfig, a as CostTracker } from './cost-tracker.d-BeaenODW.js';
8
10
  import { p as MemoryRecallRunner } from './types-DDJu9iWX.js';
9
- import { C as CapabilityKind, f as CapabilitySearchSnapshot, b as CapabilityResult } from './capability.d-Ch5Vos33.js';
10
- import { K as KodaXBaseProvider } from './base.d-Bt9lhwSV.js';
11
-
12
- type KodaXOutputSegmentMode = 'replace' | 'append';
13
- interface KodaXOutputSegmentStarted {
14
- readonly responseId: string;
15
- readonly providerRequestId: string;
16
- readonly mode: KodaXOutputSegmentMode;
17
- }
18
- interface KodaXOutputSegmentDelta {
19
- readonly providerRequestId: string;
20
- readonly text: string;
21
- }
22
- interface KodaXOutputSegmentActiveState {
23
- readonly responseId: string;
24
- readonly providerRequestId: string;
25
- readonly mode: KodaXOutputSegmentMode;
26
- /** Runtime journal sequence of the segment start, when the reducer has one. */
27
- readonly startedAtSeq?: number;
28
- readonly assistantText: string;
29
- readonly thinkingText: string;
30
- }
31
- interface KodaXOutputSegmentProjection {
32
- /** Effective append segments in provider-call order. Replaced segments are never retained. */
33
- readonly retained: readonly KodaXOutputSegmentActiveState[];
34
- readonly active?: KodaXOutputSegmentActiveState;
35
- }
36
- type KodaXOutputSegmentProjectionEvent = ({
37
- readonly type: 'segment.started';
38
- readonly startedAtSeq?: number;
39
- } & KodaXOutputSegmentStarted) | ({
40
- readonly type: 'assistant.delta';
41
- } & KodaXOutputSegmentDelta) | ({
42
- readonly type: 'thinking.delta';
43
- } & KodaXOutputSegmentDelta);
44
- interface KodaXOutputSegmentProjectionResult {
45
- readonly state: KodaXOutputSegmentProjection;
46
- readonly accepted: boolean;
47
- }
48
- declare function createOutputSegmentProjection(): KodaXOutputSegmentProjection;
49
- declare function reduceOutputSegmentProjection(state: KodaXOutputSegmentProjection, event: KodaXOutputSegmentProjectionEvent): KodaXOutputSegmentProjectionResult;
50
- declare function effectiveOutputSegmentText(state: KodaXOutputSegmentProjection, kind: 'assistant' | 'thinking'): string;
11
+ import { C as CapabilityKind, f as CapabilitySearchSnapshot, b as CapabilityResult } from './capability.d-DOF3r0fJ.js';
12
+ import { K as KodaXBaseProvider } from './base.d-ZBOdjDUT.js';
51
13
 
52
14
  /**
53
15
  * FEATURE_192 v0.7.44 Phase C — Goal-tools execution context.
@@ -886,27 +848,49 @@ interface CodingActorSessionOptions {
886
848
  readonly isOwnerAlive?: (owner: AgentActorOwner) => boolean | Promise<boolean>;
887
849
  readonly onHealthChanged?: (health: AgentControllerHealth) => void;
888
850
  }
851
+ interface CodingActorEnvironment {
852
+ readonly parentCtx: KodaXToolExecutionContext;
853
+ readonly options: KodaXOptions;
854
+ readonly signal?: AbortSignal;
855
+ readonly tools?: readonly string[];
856
+ readonly release?: (result?: AgentExecutionResult, error?: unknown) => void;
857
+ readonly run?: <T>(operation: () => Promise<T>) => Promise<T>;
858
+ }
859
+ type CodingActorEnvironmentFactory = (input: AgentExecutionInput) => Promise<CodingActorEnvironment>;
889
860
  interface CodingActorCredentialTarget {
890
861
  readonly actorPath: string;
891
862
  readonly turnId: string;
892
863
  readonly providers: readonly string[];
893
864
  }
894
865
  type CodingActorCredentialAccessFactory = (target: CodingActorCredentialTarget) => ProviderCredentialLeaseAccess;
866
+ type ClientActorMutationOptions = AgentMutationOptions & {
867
+ readonly executionPrincipalId?: string;
868
+ };
895
869
  /** One Runtime-owned Actor tree for one KodaX session. */
896
870
  declare class CodingActorSession {
897
871
  private readonly sessionOptions;
898
872
  private readonly controller;
899
873
  private readonly turnExecutors;
900
874
  private readonly turnCredentialAccess;
875
+ private readonly turnEnvironments;
876
+ private readonly environmentsByActor;
877
+ private readonly clientTurnOwners;
878
+ private readonly executingTurns;
901
879
  private environment?;
902
880
  private activeBudget?;
903
881
  constructor(sessionOptions?: CodingActorSessionOptions);
904
882
  initialize(): Promise<void>;
905
883
  attach(parentCtx: KodaXToolExecutionContext, options: KodaXOptions, callerPath?: string): AgentActorClient;
906
884
  rootControl(): AgentActorClient;
907
- spawnRoot(input: AgentSpawnInput, options?: AgentMutationOptions, credentialAccess?: CodingActorCredentialAccessFactory): Promise<AgentTurnRef>;
908
- followupRoot(actorPath: string, objective: string, options?: AgentMutationOptions, credentialAccess?: CodingActorCredentialAccessFactory, requireCredentialForNewTurn?: boolean): Promise<AgentFollowupResult>;
885
+ spawnRoot(input: AgentSpawnInput, options?: ClientActorMutationOptions, credentialAccess?: CodingActorCredentialAccessFactory, environment?: CodingActorEnvironmentFactory): Promise<AgentTurnRef>;
886
+ followupRoot(actorPath: string, objective: string, options?: ClientActorMutationOptions, credentialAccess?: CodingActorCredentialAccessFactory, requireCredentialForNewTurn?: boolean, environment?: CodingActorEnvironmentFactory): Promise<AgentFollowupResult>;
909
887
  health(): AgentControllerHealth;
888
+ private turnOwner;
889
+ independentTurnIds(): ReadonlySet<string>;
890
+ quiesceClient(principalId: string): Promise<{
891
+ readonly turns: readonly Pick<AgentTurnRef, 'actorPath' | 'turnId'>[];
892
+ readonly unsettledTurnIds: readonly string[];
893
+ }>;
910
894
  ownerId(): string | undefined;
911
895
  ownsDurableFence(): boolean;
912
896
  createWorkflowOwner(parentPath: string, runId: string): Promise<AgentActorClient>;
@@ -1190,6 +1174,15 @@ interface RuntimeContextBudgetBreakdown {
1190
1174
  readonly total: number;
1191
1175
  }
1192
1176
  interface RuntimeContextBudgetSnapshot {
1177
+ /** The policy used by the execution owner, including its actual physical reserves. */
1178
+ readonly compactionBudget?: {
1179
+ readonly triggerPercent: number;
1180
+ readonly absoluteTriggerTokens?: number;
1181
+ readonly triggerTokens: number;
1182
+ readonly physicalCapacityTokens: number;
1183
+ readonly reservedResponseTokens: number;
1184
+ readonly reservedMemoryTokens: number;
1185
+ };
1193
1186
  readonly sessionId?: string;
1194
1187
  readonly runId?: string;
1195
1188
  readonly turnId?: string;
@@ -1292,6 +1285,48 @@ interface RuntimeToolExposurePlanInput {
1292
1285
  declare const ALWAYS_RESIDENT_TOOL_NAMES: ReadonlySet<string>;
1293
1286
  declare function planToolExposure(input: RuntimeToolExposurePlanInput): RuntimeToolExposurePlan;
1294
1287
 
1288
+ type KodaXOutputSegmentMode = 'replace' | 'append';
1289
+ interface KodaXOutputSegmentStarted {
1290
+ readonly responseId: string;
1291
+ /** Assistant message being generated; distinct from its owning Turn and physical requests. */
1292
+ readonly outputId?: string;
1293
+ readonly providerRequestId: string;
1294
+ readonly mode: KodaXOutputSegmentMode;
1295
+ }
1296
+ interface KodaXOutputSegmentDelta {
1297
+ readonly providerRequestId: string;
1298
+ readonly text: string;
1299
+ }
1300
+ interface KodaXOutputSegmentActiveState {
1301
+ readonly responseId: string;
1302
+ readonly providerRequestId: string;
1303
+ readonly mode: KodaXOutputSegmentMode;
1304
+ /** Runtime journal sequence of the segment start, when the reducer has one. */
1305
+ readonly startedAtSeq?: number;
1306
+ readonly assistantText: string;
1307
+ readonly thinkingText: string;
1308
+ }
1309
+ interface KodaXOutputSegmentProjection {
1310
+ /** Effective append segments in provider-call order. Replaced segments are never retained. */
1311
+ readonly retained: readonly KodaXOutputSegmentActiveState[];
1312
+ readonly active?: KodaXOutputSegmentActiveState;
1313
+ }
1314
+ type KodaXOutputSegmentProjectionEvent = ({
1315
+ readonly type: 'segment.started';
1316
+ readonly startedAtSeq?: number;
1317
+ } & KodaXOutputSegmentStarted) | ({
1318
+ readonly type: 'assistant.delta';
1319
+ } & KodaXOutputSegmentDelta) | ({
1320
+ readonly type: 'thinking.delta';
1321
+ } & KodaXOutputSegmentDelta);
1322
+ interface KodaXOutputSegmentProjectionResult {
1323
+ readonly state: KodaXOutputSegmentProjection;
1324
+ readonly accepted: boolean;
1325
+ }
1326
+ declare function createOutputSegmentProjection(): KodaXOutputSegmentProjection;
1327
+ declare function reduceOutputSegmentProjection(state: KodaXOutputSegmentProjection, event: KodaXOutputSegmentProjectionEvent): KodaXOutputSegmentProjectionResult;
1328
+ declare function effectiveOutputSegmentText(state: KodaXOutputSegmentProjection, kind: 'assistant' | 'thinking'): string;
1329
+
1295
1330
  interface CompactionAntiThrashState {
1296
1331
  readonly lowSavingsStreak: number;
1297
1332
  readonly cooldownTurnsRemaining: number;
@@ -1802,6 +1837,8 @@ interface KodaXWorkflowAgentDigestEvent {
1802
1837
  }
1803
1838
  interface KodaXToolEventMeta extends KodaXActivityEventMeta {
1804
1839
  readonly toolId?: string;
1840
+ /** One SDK invocation; Provider tool IDs can repeat, including within a batch. */
1841
+ readonly executionId?: string;
1805
1842
  }
1806
1843
  type KodaXShellSandboxBackend = 'windows-restricted-user' | 'macos-seatbelt' | 'linux-bubblewrap' | 'unsupported';
1807
1844
  type KodaXShellSandboxObservation = {
@@ -1972,6 +2009,10 @@ interface KodaXEvents {
1972
2009
  workflowCorrelation?: WorkflowEventCorrelation;
1973
2010
  onOutputSegmentStart?: (segment: KodaXOutputSegmentStarted, meta?: KodaXActivityEventMeta) => void;
1974
2011
  onTextDelta?: (text: string, meta?: KodaXActivityEventMeta) => void;
2012
+ /** A provider declined this output; this fact is not assistant-authored text. */
2013
+ onOutputNotice?: (notice: {
2014
+ code: 'model_refused';
2015
+ }, meta?: KodaXActivityEventMeta) => void;
1975
2016
  onThinkingDelta?: (text: string, meta?: KodaXActivityEventMeta) => void;
1976
2017
  onThinkingEnd?: (thinking: string, meta?: KodaXActivityEventMeta) => void;
1977
2018
  onToolUseStart?: (tool: {
@@ -1983,6 +2024,8 @@ interface KodaXEvents {
1983
2024
  id: string;
1984
2025
  name: string;
1985
2026
  content: string;
2027
+ /** Canonical typed output; is_error and metadata.cancelled take precedence over display text. */
2028
+ toolResult?: KodaXToolResultBlock;
1986
2029
  }, meta?: KodaXToolEventMeta) => void;
1987
2030
  /** Internal execution lease boundary; fires immediately around tool.execute. */
1988
2031
  onToolExecutionStart?: (tool: {
@@ -2126,10 +2169,10 @@ interface KodaXEvents {
2126
2169
  provider: string;
2127
2170
  model: string;
2128
2171
  effort: string;
2129
- } & Partial<KodaXLiveEventMeta>) => void;
2130
- onReasoningResolved?: (event: KodaXReasoningResolution & Partial<KodaXLiveEventMeta>) => void;
2172
+ } & KodaXActivityEventMeta) => void;
2173
+ onReasoningResolved?: (event: KodaXReasoningResolution & KodaXActivityEventMeta) => void;
2131
2174
  onRepoIntelligenceTrace?: (event: KodaXRepoIntelligenceTraceEvent & Partial<KodaXLiveEventMeta>) => void;
2132
- /** Optional bounded context diagnostics. Emitted only when context.contextDiagnostics is true. */
2175
+ /** Bounded request context and the execution owner's resolved compaction capacity. */
2133
2176
  onContextBudgetSnapshot?: (event: RuntimeContextBudgetSnapshot & Partial<KodaXLiveEventMeta>) => void;
2134
2177
  /**
2135
2178
  * Hash-only prompt-cache diagnostics; never contains prompt or message text.
@@ -2294,6 +2337,8 @@ interface ProviderRecoveryEvent {
2294
2337
  }
2295
2338
  interface KodaXSessionOptions {
2296
2339
  id?: string;
2340
+ /** Identity of the Host-accepted user input already present in the transcript. */
2341
+ inputId?: string;
2297
2342
  resume?: boolean;
2298
2343
  autoResume?: boolean;
2299
2344
  scope?: KodaXSessionScope;
@@ -2467,6 +2512,18 @@ interface KodaXSkillInvocationContext {
2467
2512
  runtimePolicy?: KodaXSkillInvocationRuntimePolicy;
2468
2513
  expandedContent: string;
2469
2514
  }
2515
+ /** Host-only trusted descriptor for a registered prompt or extension invocation. */
2516
+ interface KodaXCommandInvocationContext {
2517
+ readonly name: string;
2518
+ readonly source: 'prompt' | 'extension';
2519
+ readonly path?: string;
2520
+ readonly allowedTools?: string;
2521
+ readonly context?: 'fork';
2522
+ readonly agent?: string;
2523
+ readonly model?: string;
2524
+ readonly hooks?: SkillHooks;
2525
+ readonly runtimePolicy?: KodaXSkillInvocationRuntimePolicy;
2526
+ }
2470
2527
  interface KodaXSkillMap {
2471
2528
  skillSummary: string;
2472
2529
  executionObligations: string[];
@@ -3076,7 +3133,9 @@ interface KodaXShellHostExecutionRequest {
3076
3133
  readonly permissionMode?: KodaXShellPermissionMode;
3077
3134
  readonly diagnostic?: string;
3078
3135
  }
3079
- type KodaXShellHostExecutionAuthorizer = (request: KodaXShellHostExecutionRequest) => Promise<boolean | string>;
3136
+ type KodaXShellHostExecutionAuthorizer = (request: KodaXShellHostExecutionRequest,
3137
+ /** Trusted in-process dispatch context; absent for direct tool callers. */
3138
+ context?: GuardrailContext) => Promise<boolean | string>;
3080
3139
  type KodaXShellPermissionMode = 'plan' | 'accept-edits' | 'auto' | 'full-access';
3081
3140
  /** Canonical snapshot produced by the trusted main-process text authority. */
3082
3141
  interface KodaXTrustedTextFileSnapshot {
@@ -3138,35 +3197,40 @@ interface KodaXWorkspaceSandboxRootRegistry {
3138
3197
  register(root: string): Promise<void>;
3139
3198
  unregister(root: string): Promise<void>;
3140
3199
  }
3141
- /** One tool operation reconstructed from an interrupted Run's event journal. */
3200
+ /** One tool operation reconstructed from an interrupted Run's saved Host checkpoint. */
3142
3201
  interface KodaXInterruptedRunOperation {
3202
+ readonly assistantOutputId?: string;
3143
3203
  /** Provider call id; unique only within one turn, never across turns. */
3144
3204
  readonly toolUseId: string;
3145
- /** Turn that owned the invocation; falls back to the journal's turn when absent. */
3205
+ /** Turn that owned the invocation; falls back to the Run's turn when absent. */
3146
3206
  readonly turnId?: string;
3147
3207
  readonly name: string;
3148
3208
  /** Short, already-bounded description of the tool input (path, command, url). */
3149
3209
  readonly target?: string;
3150
- /** First line of the recorded result; absent when no result was journaled. */
3210
+ /** First line of the recorded result; absent when no result was recorded. */
3151
3211
  readonly result?: string;
3152
3212
  }
3153
3213
  /** Assistant text one provider call streamed before an interrupted Run stopped. */
3154
3214
  interface KodaXInterruptedRunReply {
3155
- readonly turnId: string;
3215
+ readonly turnId?: string;
3216
+ /** Canonical generated output identity; supplied by the Host checkpoint. */
3217
+ readonly outputId?: string;
3156
3218
  /** Effective streamed text (retries replaced); only its tail is kept when long. */
3157
3219
  readonly text: string;
3158
3220
  /** True when earlier text of the same reply was dropped by the bound. */
3159
3221
  readonly truncated: boolean;
3160
3222
  }
3161
- /** Journal evidence for one earlier Run whose effects are not in formal history. */
3162
- interface KodaXInterruptedRunJournal {
3223
+ /** Saved Host evidence for one earlier Run whose effects are not in formal history. */
3224
+ interface KodaXInterruptedRunEvidence {
3163
3225
  readonly runId: string;
3164
3226
  /** Turn of the user message that started the Run; anchors branch membership. */
3165
- readonly turnId: string;
3227
+ readonly turnId?: string;
3228
+ /** Accepted input identity anchors Runs interrupted before their first turn. */
3229
+ readonly inputId?: string;
3166
3230
  readonly terminalCode: string;
3167
- /** Journal order; operations without `result` have an unknown outcome. */
3231
+ /** Checkpoint order; operations without `result` have an unknown outcome. */
3168
3232
  readonly operations: readonly KodaXInterruptedRunOperation[];
3169
- /** Streamed replies in journal order; unconfirmed text, never formal history. */
3233
+ /** Checkpointed replies in output order; unconfirmed text, never formal history. */
3170
3234
  readonly replies?: readonly KodaXInterruptedRunReply[];
3171
3235
  }
3172
3236
  interface KodaXContextOptions {
@@ -3225,6 +3289,10 @@ interface KodaXContextOptions {
3225
3289
  interruptInput?: {
3226
3290
  closeInputWindow(): void;
3227
3291
  reopenInputWindow(): void;
3292
+ /** Host retains the batch until the supplied canonical persistence succeeds. */
3293
+ consumePendingInputs?(persist: (inputs: readonly QueuedMessage[]) => Promise<void>): Promise<readonly QueuedMessage[]>;
3294
+ /** Read-only Host queue fact for invalidating a recovery plan; does not request end-of-turn yielding. */
3295
+ hasPendingInputs?(): boolean;
3228
3296
  };
3229
3297
  /** Host attribution for an explicit Workflow command, SDK request, or natural-language product word. */
3230
3298
  workflowIntent?: 'explicit';
@@ -3315,6 +3383,8 @@ interface KodaXContextOptions {
3315
3383
  skillScriptRunner?: KodaXSkillScriptRunner;
3316
3384
  rawUserInput?: string;
3317
3385
  skillInvocation?: KodaXSkillInvocationContext;
3386
+ /** Trusted Host execution only; never accepted from the product wire. */
3387
+ commandInvocation?: KodaXCommandInvocationContext;
3318
3388
  /** Optional repository-intelligence snapshot injected into the system prompt. */
3319
3389
  repoIntelligenceContext?: string;
3320
3390
  /** Optional user-supplied artifacts carried with the current prompt. */
@@ -3329,7 +3399,7 @@ interface KodaXContextOptions {
3329
3399
  *
3330
3400
  * @internal
3331
3401
  */
3332
- interruptedRunJournals?: readonly KodaXInterruptedRunJournal[];
3402
+ interruptedRunEvidence?: readonly KodaXInterruptedRunEvidence[];
3333
3403
  /**
3334
3404
  * Scoped specialist-agent resolver for embedders that run multiple
3335
3405
  * projects/sessions in one process. When absent, constructed-agent
@@ -3635,7 +3705,7 @@ interface KodaXSandboxOptions {
3635
3705
  interface KodaXSessionMutators {
3636
3706
  setProvider(name: string): void;
3637
3707
  setModel(model: string | undefined): void;
3638
- setReasoning(mode: KodaXReasoningMode | undefined): void;
3708
+ setReasoning(mode: KodaXReasoningMode | undefined, options?: Pick<KodaXOptions, 'effort' | 'thinking'>): void;
3639
3709
  }
3640
3710
  /**
3641
3711
  * Embedder-facing control surface. Created by the embedder (or by
@@ -4496,5 +4566,5 @@ interface CreateBashPrefixExtractorOptions {
4496
4566
  */
4497
4567
  declare function createBashPrefixExtractor(opts: CreateBashPrefixExtractorOptions): BashPrefixExtractor;
4498
4568
 
4499
- export { ALWAYS_RESIDENT_TOOL_NAMES as A, BASH_POLICY_SPEC as B, LSP_SERVERS as bt, LspService as bv, withGoalStopHook as cA, workflowStartOutcomeConsumesTurn as cB, buildGoalRuntimeBinding as ca, consumeCompactionCooldown as cb, createBashPrefixExtractor as cc, createCompactionAntiThrashState as cd, createExternalActorTurnExecutor as ce, createLocalCodingActorControl as cf, createOutputSegmentProjection as cg, createRuntimeContextBudgetSnapshot as ch, decideWorkflowInvocation as ci, drainPendingSwaps as cj, effectiveOutputSegmentText as ck, estimateToolSchemaTokens as cl, extractCommandPrefix as cm, getDefaultLspService as cn, hasExplicitNaturalLanguageWorkflowIntent as co, hasPendingSwap as cp, makeDisabledGoalToolsContext as cq, normalizeKodaXAgentMode as cr, planToolExposure as cs, providerResilienceConfigFromTimeouts as ct, recordCompactionSavings as cu, reduceOutputSegmentProjection as cv, resolveConstructedAgent as cw, shouldSkipLlmCompaction as cx, shutdownDefaultLspService as cy, withGoalBeforeNextTurn as cz, CodingActorSession as e };
4500
- export type { KodaXManagedProtocolPayload as $, CapabilityRuntimeContract as C, DiagnosticsRequest as D, ExtensionExecutionScope as E, FailureStage as F, GoalBlockedResult as G, KodaXCanonicalAgentMode as H, KodaXChildAgentResult as I, KodaXChildContextBundle as J, KodaXActivityEventMeta as K, KodaXChildExecutionResult as L, KodaXCompactionEndResult as M, KodaXCompactionFailureReason as N, KodaXCompactionOverride as O, KodaXContextCompactionFinishedEvent as P, KodaXContextIdentity as Q, KodaXContextOptions as R, KodaXContextTokenSnapshot as S, KodaXEffectiveTaskConfig as T, KodaXEvents as U, KodaXExecutionFailure as V, KodaXInterruptedRunJournal as W, KodaXInterruptedRunOperation as X, KodaXInterruptedRunReply as Y, KodaXLiveEventMeta as Z, KodaXManagedBudgetSnapshot as _, BashPrefixExtractor as a, KodaXTaskRoleAssignment as a$, KodaXManagedTask as a0, KodaXManagedTaskRuntimeState as a1, KodaXManagedTaskStatusEvent as a2, KodaXManualIndexTopic as a3, KodaXManualSource as a4, KodaXManualTopic as a5, KodaXManualTopicId as a6, KodaXManualTopicInput as a7, KodaXMemoryStrategy as a8, KodaXOptions as a9, KodaXShellExecutionContract as aA, KodaXShellHostExecutionAuthorizer as aB, KodaXShellHostExecutionRequest as aC, KodaXShellKind as aD, KodaXShellPermissionMode as aE, KodaXShellProfileMode as aF, KodaXShellSandbox as aG, KodaXShellSandboxBackend as aH, KodaXShellSandboxCleanupResult as aI, KodaXShellSandboxObservation as aJ, KodaXShellSandboxPrepareInput as aK, KodaXShellSandboxProcessControl as aL, KodaXSidecarMessageEvent as aM, KodaXSkillDynamicContextPolicy as aN, KodaXSkillInvocationContext as aO, KodaXSkillMap as aP, KodaXSkillProjectionConfidence as aQ, KodaXSkillScriptInputFile as aR, KodaXSkillScriptOutputFile as aS, KodaXSkillScriptRunInput as aT, KodaXSkillScriptRunner as aU, KodaXTaskCapabilityHint as aV, KodaXTaskContract as aW, KodaXTaskEvidenceArtifact as aX, KodaXTaskEvidenceBundle as aY, KodaXTaskEvidenceEntry as aZ, KodaXTaskRole as a_, KodaXOrchestrationVerdict as aa, KodaXOutputSegmentActiveState as ab, KodaXOutputSegmentDelta as ac, KodaXOutputSegmentMode as ad, KodaXOutputSegmentProjection as ae, KodaXOutputSegmentProjectionEvent as af, KodaXOutputSegmentProjectionResult as ag, KodaXOutputSegmentStarted as ah, KodaXParentReductionContract as ai, KodaXPreparedShellSandboxInvocation as aj, KodaXPromptCacheDiagnosticEvent as ak, KodaXProviderPolicyHints as al, KodaXRepoIntelligenceCapability as am, KodaXRepoIntelligenceMode as an, KodaXRepoIntelligenceResolvedMode as ao, KodaXRepoIntelligenceTrace as ap, KodaXRepoIntelligenceTraceEvent as aq, KodaXRepoRoutingSignals as ar, KodaXResult as as, KodaXRoleRoundSummary as at, KodaXRuntimeVerificationContract as au, KodaXSandboxOptions as av, KodaXSelfManualConfig as aw, KodaXSessionControl as ax, KodaXSessionMutators as ay, KodaXSessionOptions as az, BashPrefixResult as b, ToolSideEffect as b$, KodaXTaskStatus as b0, KodaXTaskSurface as b1, KodaXTaskToolPolicy as b2, KodaXTaskVerificationContract as b3, KodaXTaskVerificationCriterion as b4, KodaXTaskWorkItem as b5, KodaXTimeoutConfig as b6, KodaXToolEventMeta as b7, KodaXToolExecutionContext as b8, KodaXToolSandboxObservationUpdate as b9, ProviderResiliencePolicy as bA, RecoveryAction as bB, RecoveryDecision as bC, RecoveryLadderStep as bD, RecoveryResult as bE, ResilienceClassification as bF, ResilienceErrorClass as bG, ResolveKodaXManualInput as bH, ResolveKodaXManualOptions as bI, ResolveKodaXManualResult as bJ, RunScopedToolDefinition as bK, RuntimeCompactionSkippedEvent as bL, RuntimeContextBudgetBreakdown as bM, RuntimeContextBudgetRecommendation as bN, RuntimeContextBudgetSnapshot as bO, RuntimeContextBudgetSnapshotInput as bP, RuntimeContextOptimizationProfile as bQ, RuntimeContextPressure as bR, RuntimeDefaultsSnapshot as bS, RuntimeToolExposureDecision as bT, RuntimeToolExposureMode as bU, RuntimeToolExposurePlan as bV, RuntimeToolExposurePlanInput as bW, RuntimeToolExposureReason as bX, TodoItem as bY, TodoList as bZ, TodoStatus as b_, KodaXToolVisibilityMeta as ba, KodaXToolVisibilityPolicy as bb, KodaXTrustedTextCommitInput as bc, KodaXTrustedTextCommitOutcome as bd, KodaXTrustedTextFileSnapshot as be, KodaXTrustedTextMutationHost as bf, KodaXTrustedTextToolCall as bg, KodaXTurnCompletedEvent as bh, KodaXTurnDeliveryKind as bi, KodaXTurnFailedEvent as bj, KodaXTurnStartedEvent as bk, KodaXUserInputPromptContext as bl, KodaXVerificationScorecard as bm, KodaXVerificationScorecardCriterion as bn, KodaXWorkflowAgentDigestEvent as bo, KodaXWorkflowEventMeta as bp, KodaXWorkflowTimeoutConfig as bq, KodaXWorkspaceSandboxRootRegistry as br, KodaXWrittenFile as bs, LspServerInfo as bu, LspServiceConfig as bw, ProviderExecutionState as bx, ProviderRecoveryEvent as by, ProviderResilienceConfig as bz, BoundExtensionRuntimeController as c, WorkflowHostPolicy as c0, WorkflowInvocationAction as c1, WorkflowInvocationPolicyDecision as c2, WorkflowInvocationPolicyInput as c3, WorkflowInvocationSource as c4, WorkflowStartOutcome as c5, WorkflowToolHost as c6, WorkflowToolHostInlineInput as c7, WorkflowToolHostResult as c8, WorkflowToolHostStartResult as c9, CodingActorCredentialAccessFactory as d, CodingActorSessionOptions as f, CompactionAntiThrashConfig as g, CompactionAntiThrashState as h, CompactionSavingsDecision as i, CompactionSavingsSample as j, CompactionSkipReason as k, CreateBashPrefixExtractorOptions as l, ExtensionRuntimeContract as m, ExtractCommandPrefixOptions as n, GoalCompleteResult as o, GoalCreateInput as p, GoalLifecycleContext as q, GoalRuntimeBinding as r, GoalRuntimeBindingDeps as s, GoalToolsContext as t, KodaXActorHost as u, KodaXAgentMode as v, KodaXAgentProfile as w, KodaXAgentScope as x, KodaXBudgetDisclosureZone as y, KodaXBudgetExtensionRequest as z };
4569
+ export { ALWAYS_RESIDENT_TOOL_NAMES as A, BASH_POLICY_SPEC as B, LSP_SERVERS as bu, LspService as bw, withGoalBeforeNextTurn as cA, withGoalStopHook as cB, workflowStartOutcomeConsumesTurn as cC, buildGoalRuntimeBinding as cb, consumeCompactionCooldown as cc, createBashPrefixExtractor as cd, createCompactionAntiThrashState as ce, createExternalActorTurnExecutor as cf, createLocalCodingActorControl as cg, createOutputSegmentProjection as ch, createRuntimeContextBudgetSnapshot as ci, decideWorkflowInvocation as cj, drainPendingSwaps as ck, effectiveOutputSegmentText as cl, estimateToolSchemaTokens as cm, extractCommandPrefix as cn, getDefaultLspService as co, hasExplicitNaturalLanguageWorkflowIntent as cp, hasPendingSwap as cq, makeDisabledGoalToolsContext as cr, normalizeKodaXAgentMode as cs, planToolExposure as ct, providerResilienceConfigFromTimeouts as cu, recordCompactionSavings as cv, reduceOutputSegmentProjection as cw, resolveConstructedAgent as cx, shouldSkipLlmCompaction as cy, shutdownDefaultLspService as cz, CodingActorSession as f };
4570
+ export type { KodaXManagedBudgetSnapshot as $, CapabilityRuntimeContract as C, DiagnosticsRequest as D, ExtensionExecutionScope as E, FailureStage as F, GoalBlockedResult as G, KodaXBudgetExtensionRequest as H, KodaXCanonicalAgentMode as I, KodaXChildAgentResult as J, KodaXActivityEventMeta as K, KodaXChildContextBundle as L, KodaXChildExecutionResult as M, KodaXCompactionEndResult as N, KodaXCompactionFailureReason as O, KodaXCompactionOverride as P, KodaXContextCompactionFinishedEvent as Q, KodaXContextIdentity as R, KodaXContextOptions as S, KodaXContextTokenSnapshot as T, KodaXEffectiveTaskConfig as U, KodaXEvents as V, KodaXExecutionFailure as W, KodaXInterruptedRunEvidence as X, KodaXInterruptedRunOperation as Y, KodaXInterruptedRunReply as Z, KodaXLiveEventMeta as _, BashPrefixExtractor as a, KodaXTaskRole as a$, KodaXManagedProtocolPayload as a0, KodaXManagedTask as a1, KodaXManagedTaskRuntimeState as a2, KodaXManagedTaskStatusEvent as a3, KodaXManualIndexTopic as a4, KodaXManualSource as a5, KodaXManualTopic as a6, KodaXManualTopicId as a7, KodaXManualTopicInput as a8, KodaXMemoryStrategy as a9, KodaXSessionOptions as aA, KodaXShellExecutionContract as aB, KodaXShellHostExecutionAuthorizer as aC, KodaXShellHostExecutionRequest as aD, KodaXShellKind as aE, KodaXShellPermissionMode as aF, KodaXShellProfileMode as aG, KodaXShellSandbox as aH, KodaXShellSandboxBackend as aI, KodaXShellSandboxCleanupResult as aJ, KodaXShellSandboxObservation as aK, KodaXShellSandboxPrepareInput as aL, KodaXShellSandboxProcessControl as aM, KodaXSidecarMessageEvent as aN, KodaXSkillDynamicContextPolicy as aO, KodaXSkillInvocationContext as aP, KodaXSkillMap as aQ, KodaXSkillProjectionConfidence as aR, KodaXSkillScriptInputFile as aS, KodaXSkillScriptOutputFile as aT, KodaXSkillScriptRunInput as aU, KodaXSkillScriptRunner as aV, KodaXTaskCapabilityHint as aW, KodaXTaskContract as aX, KodaXTaskEvidenceArtifact as aY, KodaXTaskEvidenceBundle as aZ, KodaXTaskEvidenceEntry as a_, KodaXOptions as aa, KodaXOrchestrationVerdict as ab, KodaXOutputSegmentActiveState as ac, KodaXOutputSegmentDelta as ad, KodaXOutputSegmentMode as ae, KodaXOutputSegmentProjection as af, KodaXOutputSegmentProjectionEvent as ag, KodaXOutputSegmentProjectionResult as ah, KodaXOutputSegmentStarted as ai, KodaXParentReductionContract as aj, KodaXPreparedShellSandboxInvocation as ak, KodaXPromptCacheDiagnosticEvent as al, KodaXProviderPolicyHints as am, KodaXRepoIntelligenceCapability as an, KodaXRepoIntelligenceMode as ao, KodaXRepoIntelligenceResolvedMode as ap, KodaXRepoIntelligenceTrace as aq, KodaXRepoIntelligenceTraceEvent as ar, KodaXRepoRoutingSignals as as, KodaXResult as at, KodaXRoleRoundSummary as au, KodaXRuntimeVerificationContract as av, KodaXSandboxOptions as aw, KodaXSelfManualConfig as ax, KodaXSessionControl as ay, KodaXSessionMutators as az, BashPrefixResult as b, TodoStatus as b$, KodaXTaskRoleAssignment as b0, KodaXTaskStatus as b1, KodaXTaskSurface as b2, KodaXTaskToolPolicy as b3, KodaXTaskVerificationContract as b4, KodaXTaskVerificationCriterion as b5, KodaXTaskWorkItem as b6, KodaXTimeoutConfig as b7, KodaXToolEventMeta as b8, KodaXToolExecutionContext as b9, ProviderResilienceConfig as bA, ProviderResiliencePolicy as bB, RecoveryAction as bC, RecoveryDecision as bD, RecoveryLadderStep as bE, RecoveryResult as bF, ResilienceClassification as bG, ResilienceErrorClass as bH, ResolveKodaXManualInput as bI, ResolveKodaXManualOptions as bJ, ResolveKodaXManualResult as bK, RunScopedToolDefinition as bL, RuntimeCompactionSkippedEvent as bM, RuntimeContextBudgetBreakdown as bN, RuntimeContextBudgetRecommendation as bO, RuntimeContextBudgetSnapshot as bP, RuntimeContextBudgetSnapshotInput as bQ, RuntimeContextOptimizationProfile as bR, RuntimeContextPressure as bS, RuntimeDefaultsSnapshot as bT, RuntimeToolExposureDecision as bU, RuntimeToolExposureMode as bV, RuntimeToolExposurePlan as bW, RuntimeToolExposurePlanInput as bX, RuntimeToolExposureReason as bY, TodoItem as bZ, TodoList as b_, KodaXToolSandboxObservationUpdate as ba, KodaXToolVisibilityMeta as bb, KodaXToolVisibilityPolicy as bc, KodaXTrustedTextCommitInput as bd, KodaXTrustedTextCommitOutcome as be, KodaXTrustedTextFileSnapshot as bf, KodaXTrustedTextMutationHost as bg, KodaXTrustedTextToolCall as bh, KodaXTurnCompletedEvent as bi, KodaXTurnDeliveryKind as bj, KodaXTurnFailedEvent as bk, KodaXTurnStartedEvent as bl, KodaXUserInputPromptContext as bm, KodaXVerificationScorecard as bn, KodaXVerificationScorecardCriterion as bo, KodaXWorkflowAgentDigestEvent as bp, KodaXWorkflowEventMeta as bq, KodaXWorkflowTimeoutConfig as br, KodaXWorkspaceSandboxRootRegistry as bs, KodaXWrittenFile as bt, LspServerInfo as bv, LspServiceConfig as bx, ProviderExecutionState as by, ProviderRecoveryEvent as bz, BoundExtensionRuntimeController as c, ToolSideEffect as c0, WorkflowHostPolicy as c1, WorkflowInvocationAction as c2, WorkflowInvocationPolicyDecision as c3, WorkflowInvocationPolicyInput as c4, WorkflowInvocationSource as c5, WorkflowStartOutcome as c6, WorkflowToolHost as c7, WorkflowToolHostInlineInput as c8, WorkflowToolHostResult as c9, WorkflowToolHostStartResult as ca, CodingActorCredentialAccessFactory as d, CodingActorEnvironmentFactory as e, CodingActorSessionOptions as g, CompactionAntiThrashConfig as h, CompactionAntiThrashState as i, CompactionSavingsDecision as j, CompactionSavingsSample as k, CompactionSkipReason as l, CreateBashPrefixExtractorOptions as m, ExtensionRuntimeContract as n, ExtractCommandPrefixOptions as o, GoalCompleteResult as p, GoalCreateInput as q, GoalLifecycleContext as r, GoalRuntimeBinding as s, GoalRuntimeBindingDeps as t, GoalToolsContext as u, KodaXActorHost as v, KodaXAgentMode as w, KodaXAgentProfile as x, KodaXAgentScope as y, KodaXBudgetDisclosureZone as z };
@@ -1,4 +1,4 @@
1
- import { H as KodaXReasoningProfile } from './types.d-BrQMB-hy.js';
1
+ import { H as KodaXReasoningProfile } from './types.d-BjOq57-z.js';
2
2
 
3
3
  type CapabilityCacheSource = 'observed' | 'probed';
4
4
  interface CapabilityCacheEntry {
@@ -1,4 +1,4 @@
1
- import { a5 as KodaXToolResultContentItem } from './types.d-BrQMB-hy.js';
1
+ import { a5 as KodaXToolResultContentItem } from './types.d-BjOq57-z.js';
2
2
 
3
3
  /**
4
4
  * Layer A Primitive: Capability provider contract.
@@ -1,6 +1,8 @@
1
- import { k as KodaXMessage } from './types.d-BrQMB-hy.js';
2
- import { P as AgentMessage, cj as SessionEntry, ch as Session, ck as SessionExtension, ai as CompactionDetails, aI as FileOperations, d3 as WorkflowMeta, d4 as WorkflowModelHint, d5 as WorkflowModule } from './controller.d-J2t1q8Ly.js';
3
- import { ag as KodaXSessionLineage, a1 as KodaXJsonValue, U as KodaXCompactMemorySeed, ac as KodaXSessionEntry, aq as KodaXSessionTreeNode, af as KodaXSessionLabelEntry, ae as KodaXSessionGoalEntry, a9 as KodaXSessionClientNoticeEntry, am as KodaXSessionRewindMarkerEntry, ah as KodaXSessionMemoryOutcomeDigestEntry, ai as KodaXSessionMemoryReviewReceiptEntry, al as KodaXSessionNavigationOptions, a7 as KodaXSessionArtifactLedgerEntry } from './types.d-CSv0_cZC.js';
1
+ import { k as KodaXMessage } from './types.d-BjOq57-z.js';
2
+ import { i as AgentMessage, aL as SessionEntry, aJ as Session, aM as SessionExtension } from './controller.d-yyKajPTi.js';
3
+ import { a3 as CompactionDetails, ai as FileOperations, bc as WorkflowModelHint, bd as WorkflowModule } from './types.d-o7t9dds4.js';
4
+ import { ax as KodaXSessionLineage, ai as KodaXJsonValue, a9 as KodaXCompactMemorySeed, at as KodaXSessionEntry, aH as KodaXSessionTreeNode, aw as KodaXSessionLabelEntry, av as KodaXSessionGoalEntry, aq as KodaXSessionClientNoticeEntry, aD as KodaXSessionRewindMarkerEntry, ay as KodaXSessionMemoryOutcomeDigestEntry, az as KodaXSessionMemoryReviewReceiptEntry, aC as KodaXSessionNavigationOptions, ao as KodaXSessionArtifactLedgerEntry } from './review-inbox.d-BeaLRNHx.js';
5
+ import { b as WorkflowScriptManifest } from './manifest.d-Bw2i-zQi.js';
4
6
 
5
7
  /**
6
8
  * @kodax-ai/agent Constants
@@ -657,20 +659,6 @@ declare function mergeFileOps(ops1: FileOperations, ops2: FileOperations): FileO
657
659
  declare function extractArtifactLedger(messages: KodaXMessage[]): KodaXSessionArtifactLedgerEntry[];
658
660
  declare function mergeArtifactLedger(existing: KodaXSessionArtifactLedgerEntry[], next: KodaXSessionArtifactLedgerEntry[]): KodaXSessionArtifactLedgerEntry[];
659
661
 
660
- declare const WORKFLOW_PATTERN_IDS: readonly ["classify-and-act", "fan-out-and-synthesize", "adversarial-verification", "generate-and-filter", "tournament", "loop-until-done"];
661
- type WorkflowPatternId = (typeof WORKFLOW_PATTERN_IDS)[number];
662
- interface WorkflowScriptManifest extends WorkflowMeta {
663
- readonly phases: readonly string[];
664
- readonly readOnly: boolean;
665
- readonly plannedAgents?: number;
666
- readonly maxAgents: number;
667
- readonly maxConcurrency: number;
668
- readonly tokenBudget?: number;
669
- readonly mayUseWorktree?: boolean;
670
- readonly patterns: readonly WorkflowPatternId[];
671
- }
672
- declare function validateWorkflowScriptManifest(value: unknown): WorkflowScriptManifest;
673
-
674
662
  type WorkflowQualityLintSeverity = 'error' | 'warning';
675
663
  interface WorkflowQualityLintFinding {
676
664
  readonly code: string;
@@ -768,5 +756,5 @@ declare function buildWorkflowCapsuleIntent(manifest: {
768
756
  readonly originalRequest?: string;
769
757
  }): WorkflowCapsuleIntent;
770
758
 
771
- export { createSessionLineage as $, DefaultSummaryCompaction as D, KODAX_API_MIN_INTERVAL as K, LINEAGE_ENTRY_TYPES as L, actorQueueId as N, appendSessionLineageLabel as O, PROMISE_PATTERN as P, applyLineageTruncation as Q, applySessionCompaction as R, archiveOldIslands as S, assertRestrictedWorkflowQuality as T, buildSessionTree as U, buildWorkflowCapsuleIntent as V, WORKFLOW_CAPSULE_API_VERSION as W, cleanupIncompleteToolCalls as X, countActiveLineageMessages as Y, countTokens as Z, _resetActiveRootQueueRoutesForTests as _, createWorkflowCapsule as a0, createWorkflowModuleFromCapsule as a1, estimateTokens as a2, evictOldIslandMessageContent as a3, extractArtifactLedger as a4, extractFileOps as a5, extractTitleFromMessages as a6, findPreviousUserEntryId as a7, forkSessionLineage as a8, generateSessionId as a9, generateSessionIdSync as aa, getAgentConfigHome as ab, getAgentConfigPath as ac, getAppDataDir as ad, getSessionLineagePath as ae, getSessionMessageEntryId as af, getSessionMessagesFromLineage as ag, isPathInsideDirectory as ah, lintRestrictedWorkflowSource as ai, mergeArtifactLedger as aj, mergeFileOps as ak, registerActiveRootQueueRoute as al, resolveActiveRootQueueRoute as am, resolveExecutionPath as an, resolveSessionLineageTarget as ao, rewindSessionLineage as ap, setAgentConfigHome as aq, setSessionLineageActiveEntry as ar, validateAndFixToolHistory as as, validateWorkflowCapsule as at, validateWorkflowScriptManifest as au, KODAX_DEFAULT_TIMEOUT as f, KODAX_HARD_TIMEOUT as g, KODAX_MAX_INCOMPLETE_RETRIES as h, KODAX_MAX_MAXTOKENS_RETRIES as i, KODAX_MAX_RETRIES as j, KODAX_MAX_TOKENS as k, KODAX_RETRY_BASE_DELAY as l, KODAX_STAGGER_DELAY as m, LineageCompaction as o, LineageExtension as r, WORKFLOW_CAPSULE_FORMAT as v, WORKFLOW_CAPSULE_VERSION as w, WORKFLOW_PATTERN_IDS as x };
772
- export type { WorkflowCapsuleInputs as A, WorkflowCapsuleIntent as B, CompactionContext as C, WorkflowCapsuleProvenance as E, WorkflowCapsuleRequirements as F, WorkflowPatternId as G, WorkflowQualityLintFinding as H, WorkflowQualityLintOptions as I, WorkflowQualityLintSeverity as J, WorkflowScriptManifest as M, CompactionEntry as a, CompactionEntryPayload as b, CompactionPolicy as c, CreateWorkflowCapsuleInput as d, DefaultSummaryCompactionOptions as e, LineageArtifactLedgerPayload as n, LineageCompactionDelegates as p, LineageEntryType as q, LineageLabelPayload as s, LineageTreeNode as t, PolicyCompactionResult as u, WorkflowCapsule as y, WorkflowCapsuleEnvironmentRequirement as z };
759
+ export { estimateTokens as $, DefaultSummaryCompaction as D, actorQueueId as I, appendSessionLineageLabel as J, KODAX_API_MIN_INTERVAL as K, LINEAGE_ENTRY_TYPES as L, applyLineageTruncation as M, applySessionCompaction as N, archiveOldIslands as O, PROMISE_PATTERN as P, assertRestrictedWorkflowQuality as Q, buildSessionTree as R, buildWorkflowCapsuleIntent as S, cleanupIncompleteToolCalls as T, countActiveLineageMessages as U, countTokens as V, WORKFLOW_CAPSULE_API_VERSION as W, createSessionLineage as X, createWorkflowCapsule as Y, createWorkflowModuleFromCapsule as Z, _resetActiveRootQueueRoutesForTests as _, evictOldIslandMessageContent as a0, extractArtifactLedger as a1, extractFileOps as a2, extractTitleFromMessages as a3, findPreviousUserEntryId as a4, forkSessionLineage as a5, generateSessionId as a6, generateSessionIdSync as a7, getAgentConfigHome as a8, getAgentConfigPath as a9, getAppDataDir as aa, getSessionLineagePath as ab, getSessionMessageEntryId as ac, getSessionMessagesFromLineage as ad, isPathInsideDirectory as ae, lintRestrictedWorkflowSource as af, mergeArtifactLedger as ag, mergeFileOps as ah, registerActiveRootQueueRoute as ai, resolveActiveRootQueueRoute as aj, resolveExecutionPath as ak, resolveSessionLineageTarget as al, rewindSessionLineage as am, setAgentConfigHome as an, setSessionLineageActiveEntry as ao, validateAndFixToolHistory as ap, validateWorkflowCapsule as aq, KODAX_DEFAULT_TIMEOUT as f, KODAX_HARD_TIMEOUT as g, KODAX_MAX_INCOMPLETE_RETRIES as h, KODAX_MAX_MAXTOKENS_RETRIES as i, KODAX_MAX_RETRIES as j, KODAX_MAX_TOKENS as k, KODAX_RETRY_BASE_DELAY as l, KODAX_STAGGER_DELAY as m, LineageCompaction as o, LineageExtension as r, WORKFLOW_CAPSULE_FORMAT as v, WORKFLOW_CAPSULE_VERSION as w };
760
+ export type { WorkflowCapsuleIntent as A, WorkflowCapsuleProvenance as B, CompactionContext as C, WorkflowCapsuleRequirements as E, WorkflowQualityLintFinding as F, WorkflowQualityLintOptions as G, WorkflowQualityLintSeverity as H, CompactionEntry as a, CompactionEntryPayload as b, CompactionPolicy as c, CreateWorkflowCapsuleInput as d, DefaultSummaryCompactionOptions as e, LineageArtifactLedgerPayload as n, LineageCompactionDelegates as p, LineageEntryType as q, LineageLabelPayload as s, LineageTreeNode as t, PolicyCompactionResult as u, WorkflowCapsule as x, WorkflowCapsuleEnvironmentRequirement as y, WorkflowCapsuleInputs as z };