@kodax-ai/kodax 0.7.87 → 0.7.89

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 (100) hide show
  1. package/CHANGELOG.md +95 -0
  2. package/README.md +29 -12
  3. package/README_CN.md +7 -3
  4. package/dist/chunks/agent-AKCXT573.js +2 -0
  5. package/dist/chunks/argument-completer-BJGY57H2.js +2 -0
  6. package/dist/chunks/{chunk-U44C5STU.js → chunk-4Y6OSDZE.js} +1 -1
  7. package/dist/chunks/{chunk-XH7UM4GO.js → chunk-5247AKGN.js} +3 -3
  8. package/dist/chunks/{chunk-DB4O33RR.js → chunk-5UBP47VJ.js} +223 -220
  9. package/dist/chunks/{chunk-ITP7J5HX.js → chunk-72H6JNPN.js} +142 -142
  10. package/dist/chunks/chunk-A63MGLH6.js +415 -0
  11. package/dist/chunks/{chunk-ZQNOEKOB.js → chunk-BOMSVUJS.js} +2 -2
  12. package/dist/chunks/{chunk-4OLXWSCQ.js → chunk-CQHLFQSU.js} +254 -254
  13. package/dist/chunks/chunk-GL6GVYF4.js +320 -0
  14. package/dist/chunks/{chunk-XKLVC7F6.js → chunk-IFD6TUQU.js} +1 -1
  15. package/dist/chunks/{chunk-JS4RSF4B.js → chunk-O2ZV775M.js} +1 -1
  16. package/dist/chunks/chunk-PROPMIT4.js +2 -0
  17. package/dist/chunks/{chunk-YB7YVAPL.js → chunk-QQBFQCMF.js} +4 -4
  18. package/dist/chunks/{chunk-BCYJIACJ.js → chunk-S74F7MFN.js} +124 -124
  19. package/dist/chunks/{chunk-ASFCAPIG.js → chunk-SOIIBADK.js} +2 -2
  20. package/dist/chunks/{chunk-SKELDH3G.js → chunk-UNEC2WXJ.js} +17 -17
  21. package/dist/chunks/{chunk-7XTUXMAI.js → chunk-W2LRTZBJ.js} +37 -34
  22. package/dist/chunks/{chunk-GRJ7NKWP.js → chunk-W5RPVR3O.js} +1 -1
  23. package/dist/chunks/client-ZXBSEDS4.js +2 -0
  24. package/dist/chunks/compaction-config-HVHPJ6CS.js +2 -0
  25. package/dist/chunks/{construction-bootstrap-YTFOT4M2.js → construction-bootstrap-WF6KQ7XV.js} +1 -1
  26. package/dist/chunks/dist-BCT3UNMA.js +2 -0
  27. package/dist/chunks/{dist-X55TWIK4.js → dist-WILA35IA.js} +1 -1
  28. package/dist/chunks/host-V6ENYZAQ.js +2 -0
  29. package/dist/chunks/run-manager-ZOV7EKTZ.js +2 -0
  30. package/dist/chunks/utils-BEWYGEMB.js +2 -0
  31. package/dist/index.d.ts +26 -26
  32. package/dist/index.js +5 -5
  33. package/dist/kodax_bootstrap.js +1 -1
  34. package/dist/kodax_cli.js +1564 -1555
  35. package/dist/kodax_resume.js +35 -826
  36. package/dist/provider-capabilities.json +1156 -1118
  37. package/dist/runtime-worker.js +1346 -1339
  38. package/dist/sandbox-workspace-session.js +261 -261
  39. package/dist/sdk-a2a.d.ts +20 -18
  40. package/dist/sdk-a2a.js +9 -9
  41. package/dist/sdk-agent.d.ts +23 -22
  42. package/dist/sdk-agent.js +1 -1
  43. package/dist/sdk-coding.d.ts +65 -38
  44. package/dist/sdk-coding.js +1 -1
  45. package/dist/sdk-experimental-memory.d.ts +6 -6
  46. package/dist/sdk-experimental-memory.js +1 -1
  47. package/dist/sdk-llm.d.ts +8 -8
  48. package/dist/sdk-llm.js +1 -1
  49. package/dist/sdk-mcp.d.ts +4 -4
  50. package/dist/sdk-mcp.js +1 -1
  51. package/dist/sdk-media.d.ts +1 -1
  52. package/dist/sdk-media.js +1 -1
  53. package/dist/sdk-repl.d.ts +21 -21
  54. package/dist/sdk-repl.js +1 -1
  55. package/dist/sdk-runtime.d.ts +28 -21
  56. package/dist/sdk-runtime.js +1 -1
  57. package/dist/sdk-sandbox.js +1 -1
  58. package/dist/sdk-session.d.ts +10 -10
  59. package/dist/sdk-session.js +1 -1
  60. package/dist/sdk-skills.d.ts +2 -2
  61. package/dist/sdk-skills.js +1 -1
  62. package/dist/semantic-worker.js +59 -59
  63. package/dist/types-chunks/{base.d-vopO1rml.d.ts → base.d-JjF6aKsh.d.ts} +1 -1
  64. package/dist/types-chunks/{bash-prefix-extractor.d-B36OQwNA.d.ts → bash-prefix-extractor.d-BLlhCRI-.d.ts} +33 -9
  65. package/dist/types-chunks/{capability-learning.d-CE1tm29C.d.ts → capability-learning.d-BAxy0mfx.d.ts} +1 -1
  66. package/dist/types-chunks/{capsule.d-DEncDNzD.d.ts → capsule.d-Cw4UlPTC.d.ts} +5 -5
  67. package/dist/types-chunks/{config.d-CJy1WENT.d.ts → config.d-CTPaqsD-.d.ts} +1 -1
  68. package/dist/types-chunks/{controller.d-Dif9pbC9.d.ts → controller.d-1tydJm7c.d.ts} +11 -4
  69. package/dist/types-chunks/{controller.d-C1YdP_pQ.d.ts → controller.d-BvwWz6yP.d.ts} +1 -1
  70. package/dist/types-chunks/{cost-tracker.d-BeaenODW.d.ts → cost-tracker.d-MTAt6N7b.d.ts} +1 -1
  71. package/dist/types-chunks/{guardrail.d-DhpnJv4Y.d.ts → guardrail.d-DqWHIgt6.d.ts} +15 -9
  72. package/dist/types-chunks/{history-retrieval.d-YJQpQt7h.d.ts → history-retrieval.d-ia-4iJpw.d.ts} +2 -2
  73. package/dist/types-chunks/{integration-config.d-BNowXE8k.d.ts → integration-config.d-BHoiz-WZ.d.ts} +3 -3
  74. package/dist/types-chunks/{manager.d-B67TmPO1.d.ts → manager.d-D_1fqveb.d.ts} +3 -3
  75. package/dist/types-chunks/{oauth-login.d-6i-vidxv.d.ts → oauth-login.d-Cz9OpSmz.d.ts} +3 -3
  76. package/dist/types-chunks/{public-api.d-D4q3WxKq.d.ts → public-api.d-CMZa4JPa.d.ts} +12 -7
  77. package/dist/types-chunks/{repl.d-D4ye29Kk.d.ts → repl.d-Byu2osV-.d.ts} +7 -7
  78. package/dist/types-chunks/{resolver.d-RyPo99tB.d.ts → resolver.d-bKttRr1V.d.ts} +4 -4
  79. package/dist/types-chunks/{review-inbox.d-C1_xZ-yg.d.ts → review-inbox.d-D3T-RxRs.d.ts} +3 -3
  80. package/dist/types-chunks/{run-manager.d-D30IvnwV.d.ts → run-manager.d-D0aKe12e.d.ts} +2 -2
  81. package/dist/types-chunks/{sdk-session-DIU6sHa2.d.ts → sdk-session-BEM7yvJB.d.ts} +3 -3
  82. package/dist/types-chunks/{shell-command-sets.d-rIHkZ_VR.d.ts → shell-command-sets.d-_SHjU3KP.d.ts} +2 -2
  83. package/dist/types-chunks/{side-query.d-iH0P9ASy.d.ts → side-query.d-DNes6rHA.d.ts} +3 -3
  84. package/dist/types-chunks/{types-PHjfwebT.d.ts → types-D8OiIEwA.d.ts} +1 -1
  85. package/dist/types-chunks/{types.d-BSPlmJqf.d.ts → types.d-BEMcUOng.d.ts} +1 -1
  86. package/dist/types-chunks/{types.d-COhAF5Xo.d.ts → types.d-B_IFJlti.d.ts} +3 -3
  87. package/dist/types-chunks/{types.d-Bz5Y-PD9.d.ts → types.d-BqK7eZ5u.d.ts} +6 -6
  88. package/dist/types-chunks/{types.d-CK9A9rpP.d.ts → types.d-Cv09EdJR.d.ts} +1 -1
  89. package/dist/types-chunks/{types.d-sW-OqiFt.d.ts → types.d-DeokRBs7.d.ts} +34 -3
  90. package/dist/types-chunks/{utils.d-B65ozSTV.d.ts → utils.d-0h1NTEsX.d.ts} +8 -8
  91. package/package.json +2 -2
  92. package/dist/chunks/agent-Z64QF7KG.js +0 -2
  93. package/dist/chunks/argument-completer-HIJBXRUT.js +0 -2
  94. package/dist/chunks/chunk-3PGNESV3.js +0 -415
  95. package/dist/chunks/chunk-UWKM3HNY.js +0 -319
  96. package/dist/chunks/compaction-config-E4TFBCDJ.js +0 -2
  97. package/dist/chunks/dist-M3JV4PNA.js +0 -2
  98. package/dist/chunks/host-SJHHJBPB.js +0 -2
  99. package/dist/chunks/run-manager-T5QGWNON.js +0 -2
  100. package/dist/chunks/utils-2FHVIO6X.js +0 -2
@@ -1,4 +1,4 @@
1
- import { a as BashPrefixExtractor } from './bash-prefix-extractor.d-B36OQwNA.js';
1
+ import { R as RunScopedToolDefinition, B as BashPrefixExtractor } from './bash-prefix-extractor.d-BLlhCRI-.js';
2
2
 
3
3
  /**
4
4
  * Permission Utilities
@@ -279,7 +279,7 @@ declare function getBashOutsideProjectWriteRisk(command: string, projectRoot: st
279
279
  * closes that gap structurally — new mutating tools auto-block until
280
280
  * explicitly opted in via `planModeAllowed: true`.
281
281
  */
282
- declare function getPlanModeBlockReason(toolName: string, input: Record<string, unknown>, projectRoot?: string, executionCwd?: string | undefined): string | null;
282
+ declare function getPlanModeBlockReason(toolName: string, input: Record<string, unknown>, projectRoot?: string, executionCwd?: string | undefined, runScopedTools?: ReadonlyMap<string, RunScopedToolDefinition>): string | null;
283
283
  /**
284
284
  * Infer PermissionMode from legacy options (backward compat)
285
285
  */
@@ -1,6 +1,6 @@
1
- import { k as KodaXMessage, I as KodaXReasoningRequest, a1 as KodaXTokenUsage } from './types.d-CK9A9rpP.js';
2
- import { K as KodaXBaseProvider } from './base.d-vopO1rml.js';
3
- import { a as CostTracker } from './cost-tracker.d-BeaenODW.js';
1
+ import { b as KodaXMessage, c as KodaXReasoningRequest, d as KodaXTokenUsage } from './types.d-Cv09EdJR.js';
2
+ import { K as KodaXBaseProvider } from './base.d-JjF6aKsh.js';
3
+ import { C as CostTracker } from './cost-tracker.d-MTAt6N7b.js';
4
4
 
5
5
  /**
6
6
  * sideQuery — independent one-shot LLM invocation.
@@ -531,4 +531,4 @@ interface CreateMemoryManagementAgentOptions extends Omit<CreateMemoryAgentOptio
531
531
  readonly controlPlane: MemoryManagementController;
532
532
  }
533
533
 
534
- export type { AcceptedMemoryView as A, CreateMemoryAgentOptions as C, KodaXHandledMemoryOperation as K, MemoryAgent as M, PersistedOutcomeDigest as P, CreateMemoryManagementAgentOptions as a, MemoryAgentTraceEvent as b, MemoryDecisionReceipt as c, MemoryEpisodeOutcome as d, MemoryEvidenceGrade as e, MemoryEvidenceRef as f, MemoryInterventionInput as g, MemoryInterventionTrigger as h, MemoryListFilter as i, MemoryManagementAgent as j, MemoryObservation as k, MemoryObservationKind as l, MemoryQueryInput as m, MemoryRecallCandidate as n, MemoryRecallInput as o, MemoryRecallRunner as p, MemoryRecallRunnerInput as q, MemoryReminder as r, MemorySelectionMode as s, MemorySession as t, MemorySessionInput as u, MemorySourcePolicy as v };
534
+ export type { AcceptedMemoryView as A, CreateMemoryManagementAgentOptions as C, KodaXHandledMemoryOperation as K, MemoryManagementAgent as M, PersistedOutcomeDigest as P, CreateMemoryAgentOptions as a, MemoryAgent as b, MemoryAgentTraceEvent as c, MemoryDecisionReceipt as d, MemoryEpisodeOutcome as e, MemoryEvidenceGrade as f, MemoryEvidenceRef as g, MemoryInterventionInput as h, MemoryInterventionTrigger as i, MemoryListFilter as j, MemoryObservation as k, MemoryObservationKind as l, MemoryQueryInput as m, MemoryRecallCandidate as n, MemoryRecallInput as o, MemoryRecallRunner as p, MemoryRecallRunnerInput as q, MemoryReminder as r, MemorySelectionMode as s, MemorySession as t, MemorySessionInput as u, MemorySourcePolicy as v };
@@ -275,4 +275,4 @@ declare function getSkillPathsFlat(config: SkillPathsConfig): Array<{
275
275
  }>;
276
276
 
277
277
  export { getDefaultSkillPaths as m, getSkillPathsFlat as n };
278
- export type { ISkillRegistry as I, LearnedSkillDiscoveryConfig as L, ResolvedSkillSource as R, Skill as S, IVariableResolver as a, SkillArtifact as b, SkillContext as c, SkillDynamicContextExecutor as d, SkillFile as e, SkillFrontmatter as f, SkillHook as g, SkillHooks as h, SkillMetadata as i, SkillPathsConfig as j, SkillResult as k, SkillSource as l };
278
+ export type { ISkillRegistry as I, LearnedSkillDiscoveryConfig as L, ResolvedSkillSource as R, SkillMetadata as S, SkillDynamicContextExecutor as a, IVariableResolver as b, Skill as c, SkillArtifact as d, SkillContext as e, SkillFile as f, SkillFrontmatter as g, SkillHook as h, SkillHooks as i, SkillPathsConfig as j, SkillResult as k, SkillSource as l };
@@ -1,5 +1,5 @@
1
- import { a$ as KodaXInputArtifact } from './controller.d-Dif9pbC9.js';
2
- import { T as KodaXTaskResultMetadata } from './types.d-CK9A9rpP.js';
1
+ import { K as KodaXInputArtifact } from './controller.d-1tydJm7c.js';
2
+ import { a as KodaXTaskResultMetadata } from './types.d-Cv09EdJR.js';
3
3
 
4
4
  /**
5
5
  * @kodax-ai/agent/messaging — Message queue types
@@ -132,4 +132,4 @@ interface EnqueueInput {
132
132
  readonly taskResult?: KodaXTaskResultMetadata;
133
133
  }
134
134
 
135
- export type { DequeueFilter as D, EnqueueInput as E, MessageMode as M, QueueEventListener as Q, MessagePriority as a, QueuedInputArtifact as b, QueuedMessage as c };
135
+ export type { DequeueFilter as D, EnqueueInput as E, MessagePriority as M, QueuedMessage as Q, QueueEventListener as a, QueuedInputArtifact as b, MessageMode as c };
@@ -1,8 +1,8 @@
1
- import { aa as KodaXWireReasoningEffort, a2 as KodaXToolDefinition, a4 as KodaXToolResultContentItem, k as KodaXMessage } from './types.d-CK9A9rpP.js';
2
- import { K as KodaXBaseProvider } from './base.d-vopO1rml.js';
1
+ import { n as KodaXWireReasoningEffort, f as KodaXToolDefinition, R as KodaXToolResultContentItem, b as KodaXMessage } from './types.d-Cv09EdJR.js';
2
+ import { K as KodaXBaseProvider } from './base.d-JjF6aKsh.js';
3
3
  import { C as CapabilityKind, a as CapabilityProvider } from './capability.d-K664nHOS.js';
4
- import { Y as KodaXJsonValue, Q as KodaXExtensionSessionRecord, S as KodaXExtensionStore } from './types.d-sW-OqiFt.js';
5
- import { aT as KodaXToolExecutionContext, bB as ToolSideEffect } from './bash-prefix-extractor.d-B36OQwNA.js';
4
+ import { C as KodaXJsonValue, A as KodaXExtensionSessionRecord, a1 as KodaXExtensionStore } from './types.d-DeokRBs7.js';
5
+ import { aR as KodaXToolExecutionContext, bz as ToolSideEffect } from './bash-prefix-extractor.d-BLlhCRI-.js';
6
6
 
7
7
  /**
8
8
  * KodaX Constructed-World types (FEATURE_087, v0.7.28).
@@ -1008,5 +1008,5 @@ interface KodaXExtensionModule {
1008
1008
  activate?: (api: KodaXExtensionAPI) => KodaXExtensionActivationResult;
1009
1009
  }
1010
1010
 
1011
- export { DEFAULT_HANDLER_TIMEOUT_MS as D, defaultPolicy as a5, exec as a6, webhook as a7, CapabilityDeniedError as c, ConstructionManifestError as e };
1012
- export type { ToolHandler as $, AgentArtifact as A, KodaXRetrievalItem as B, Capabilities as C, ExecOptions as E, KodaXRetrievalResult as F, KodaXRetrievalScope as G, KodaXRetrievalToolName as H, KodaXRetrievalTrust as I, LocalToolDefinition as J, KodaXExtensionAPI as K, LoadedExtensionDiagnostic as L, ModelProviderRegistration as M, RegisteredCommandDiagnostic as N, RegisteredHookDiagnostic as O, RegisteredToolDefinition as P, RegisteredToolDiagnostic as Q, RegisteredCapabilityProviderDiagnostic as R, RuntimeRemoteToolContext as S, RuntimeRemoteToolContract as T, RuntimeRemoteToolDecision as U, RuntimeRemoteWorkspaceBroker as V, ScriptSource as W, StagedHandle as X, TestResult as Y, ToolContent as Z, ToolDefinitionSource as _, AgentContent as a, ToolHandlerSync as a0, ToolRegistrationOptions as a1, ToolRegistry as a2, WebhookOptions as a3, WebhookResult as a4, ArtifactStatus as b, ConstructionArtifact as d, ConstructionPolicy as f, ConstructionPolicyVerdict as g, ExecResult as h, ExtensionCommandContext as i, ExtensionCommandDefinition as j, ExtensionCommandInvocation as k, ExtensionCommandResult as l, ExtensionContributionSource as m, ExtensionEventMap as n, ExtensionFailureDiagnostic as o, ExtensionFailureStage as p, ExtensionHookMap as q, ExtensionLoadSource as r, ExtensionLogger as s, ExtensionRuntimeController as t, ExtensionRuntimeDiagnostics as u, ExtensionToolBeforeHookContext as v, KodaXExtensionActivationResult as w, KodaXExtensionModule as x, KodaXRetrievalArtifact as y, KodaXRetrievalFreshness as z };
1011
+ export { DEFAULT_HANDLER_TIMEOUT_MS as D, defaultPolicy as a3, exec as a4, webhook as a5, CapabilityDeniedError as b, ConstructionManifestError as d };
1012
+ export type { ToolRegistrationOptions as $, AgentArtifact as A, KodaXRetrievalResult as B, Capabilities as C, ExecOptions as E, KodaXRetrievalScope as F, KodaXRetrievalToolName as G, KodaXRetrievalTrust as H, LocalToolDefinition as I, RegisteredCommandDiagnostic as J, KodaXExtensionAPI as K, LoadedExtensionDiagnostic as L, ModelProviderRegistration as M, RegisteredHookDiagnostic as N, RegisteredToolDefinition as O, RegisteredToolDiagnostic as P, RuntimeRemoteToolContext as Q, RegisteredCapabilityProviderDiagnostic as R, RuntimeRemoteToolContract as S, RuntimeRemoteToolDecision as T, RuntimeRemoteWorkspaceBroker as U, ScriptSource as V, StagedHandle as W, TestResult as X, ToolContent as Y, ToolDefinitionSource as Z, ToolHandler as _, ArtifactStatus as a, ToolRegistry as a0, WebhookOptions as a1, WebhookResult as a2, AgentContent as a6, ToolHandlerSync as a7, ConstructionArtifact as c, ConstructionPolicy as e, ConstructionPolicyVerdict as f, ExecResult as g, ExtensionCommandContext as h, ExtensionCommandDefinition as i, ExtensionCommandInvocation as j, ExtensionCommandResult as k, ExtensionContributionSource as l, ExtensionEventMap as m, ExtensionFailureDiagnostic as n, ExtensionFailureStage as o, ExtensionHookMap as p, ExtensionLoadSource as q, ExtensionLogger as r, ExtensionRuntimeController as s, ExtensionRuntimeDiagnostics as t, ExtensionToolBeforeHookContext as u, KodaXExtensionActivationResult as v, KodaXExtensionModule as w, KodaXRetrievalArtifact as x, KodaXRetrievalFreshness as y, KodaXRetrievalItem as z };
@@ -671,4 +671,4 @@ interface KodaXProviderStreamOptions {
671
671
  signal?: AbortSignal;
672
672
  }
673
673
 
674
- export type { KodaXThinkingDepth as $, KodaXProviderToolCallingFidelity as A, KodaXProviderTransport as B, KodaXReasoningCapability as C, KodaXReasoningEffortPreset as D, KodaXReasoningEffortRequest as E, KodaXReasoningEffortWireStrategy as F, KodaXReasoningMode as G, KodaXReasoningProfile as H, KodaXReasoningRequest as I, KodaXRedactedThinkingBlock as J, KodaXAssuranceIntent as K, KodaXReviewScale as L, KodaXRiskLevel as M, KodaXStableEffortIntent as N, KodaXStreamResult as O, KodaXTaskActionability as P, KodaXTaskBudgetOverrides as Q, KodaXTaskComplexity as R, KodaXTaskFamily as S, KodaXTaskResultMetadata as T, KodaXTaskResultSource as U, KodaXTaskRoutingDecision as V, KodaXTaskType as W, KodaXTaskWorkIntent as X, KodaXTextBlock as Y, KodaXThinkingBlock as Z, KodaXThinkingBudgetMap as _, KodaXCacheBoundary as a, KodaXThinkingWireStrategy as a0, KodaXTokenUsage as a1, KodaXToolDefinition as a2, KodaXToolResultBlock as a3, KodaXToolResultContentItem as a4, KodaXToolResultImageItem as a5, KodaXToolResultTextItem as a6, KodaXToolUseBlock as a7, KodaXVerifyCredentialResult as a8, KodaXVerifyStrategy as a9, KodaXWireReasoningEffort as aa, KodaXChildFanoutClass as b, KodaXContentBlock as c, KodaXCustomProviderConfig as d, KodaXEphemeralSuffix as e, KodaXExecutionMode as f, KodaXExecutionPattern as g, KodaXHarnessProfile as h, KodaXImageBlock as i, KodaXListModelsResult as j, KodaXMessage as k, KodaXModelDescriptor as l, KodaXMutationSurface as m, KodaXNormalizedReasoningRequest as n, KodaXOpenAICompatMaxOutputTokensField as o, KodaXProtocolFamily as p, KodaXProviderCapabilityProfile as q, KodaXProviderConfig as r, KodaXProviderContextFidelity as s, KodaXProviderConversationSemantics as t, KodaXProviderEvidenceSupport as u, KodaXProviderLongRunningSupport as v, KodaXProviderMcpSupport as w, KodaXProviderMultimodalSupport as x, KodaXProviderSessionSupport as y, KodaXProviderStreamOptions as z };
674
+ export type { KodaXProviderContextFidelity as $, KodaXReasoningEffortWireStrategy as A, KodaXRedactedThinkingBlock as B, KodaXReviewScale as C, KodaXRiskLevel as D, KodaXStableEffortIntent as E, KodaXTaskBudgetOverrides as F, KodaXTaskResultSource as G, KodaXTaskRoutingDecision as H, KodaXTaskType as I, KodaXTextBlock as J, KodaXReasoningProfile as K, KodaXThinkingBlock as L, KodaXThinkingBudgetMap as M, KodaXThinkingDepth as N, KodaXThinkingWireStrategy as O, KodaXToolResultBlock as P, KodaXToolUseBlock as Q, KodaXToolResultContentItem as R, KodaXOpenAICompatMaxOutputTokensField as S, KodaXVerifyStrategy as T, KodaXListModelsResult as U, KodaXCacheBoundary as V, KodaXAssuranceIntent as W, KodaXEphemeralSuffix as X, KodaXExecutionPattern as Y, KodaXHarnessProfile as Z, KodaXMutationSurface as _, KodaXTaskResultMetadata as a, KodaXProviderEvidenceSupport as a0, KodaXProviderLongRunningSupport as a1, KodaXProviderMultimodalSupport as a2, KodaXProviderSessionSupport as a3, KodaXProviderToolCallingFidelity as a4, KodaXTaskActionability as a5, KodaXTaskComplexity as a6, KodaXTaskFamily as a7, KodaXTaskWorkIntent as a8, KodaXToolResultImageItem as a9, KodaXToolResultTextItem as aa, KodaXMessage as b, KodaXReasoningRequest as c, KodaXTokenUsage as d, KodaXProviderConfig as e, KodaXToolDefinition as f, KodaXProviderStreamOptions as g, KodaXStreamResult as h, KodaXVerifyCredentialResult as i, KodaXModelDescriptor as j, KodaXProviderCapabilityProfile as k, KodaXReasoningCapability as l, KodaXNormalizedReasoningRequest as m, KodaXWireReasoningEffort as n, KodaXReasoningMode as o, KodaXChildFanoutClass as p, KodaXContentBlock as q, KodaXCustomProviderConfig as r, KodaXExecutionMode as s, KodaXImageBlock as t, KodaXProtocolFamily as u, KodaXProviderConversationSemantics as v, KodaXProviderMcpSupport as w, KodaXProviderTransport as x, KodaXReasoningEffortPreset as y, KodaXReasoningEffortRequest as z };
@@ -1,4 +1,4 @@
1
- import { k as KodaXMessage } from './types.d-CK9A9rpP.js';
1
+ import { b as KodaXMessage } from './types.d-Cv09EdJR.js';
2
2
 
3
3
  type AgentActorState = 'running' | 'idle' | 'closed';
4
4
  type AgentTurnState = 'accepted' | 'running' | 'completed' | 'failed' | 'interrupted';
@@ -244,10 +244,41 @@ interface AgentActorSnapshotV2 extends AgentActorSnapshotContents {
244
244
  readonly owner?: AgentActorOwner;
245
245
  }
246
246
  type AgentActorSnapshot = AgentActorSnapshotV1 | AgentActorSnapshotV2;
247
+ type AgentActorSavePhase = 'queued' | 'precommit' | 'commit_inflight' | 'committed' | 'not_committed';
248
+ type AgentActorSaveTiming = 'storageQueue' | 'fileLock' | 'readCas' | 'lineage' | 'topology' | 'tempWrite' | 'fsync' | 'rename' | 'postCommit' | 'total';
249
+ interface AgentActorSaveDiagnostics {
250
+ readonly attemptId: string;
251
+ readonly phase: AgentActorSavePhase;
252
+ readonly activeStage?: AgentActorSaveTiming;
253
+ readonly activeStageElapsedMs?: number;
254
+ readonly failedStage?: AgentActorSaveTiming;
255
+ readonly canonicalOutcome?: 'pending' | 'committed' | 'committed_by_readback' | 'not_committed' | 'ambiguous';
256
+ readonly completionOutcome?: 'pending' | 'succeeded' | 'failed';
257
+ readonly timingsMs: Readonly<Partial<Record<AgentActorSaveTiming, number>>>;
258
+ }
259
+ /** One storage-neutral Actor snapshot attempt with an explicit canonical boundary. */
260
+ interface AgentActorSaveAttempt {
261
+ /** Resolves after the process-local storage queue admits this attempt. */
262
+ readonly dequeued: Promise<void>;
263
+ /** Resolves after storage queueing and writer admission, before canonical preparation. */
264
+ readonly eligible: Promise<void>;
265
+ /** Resolves when the Actor snapshot is canonical; rejects before or during commit. */
266
+ readonly canonical: Promise<void>;
267
+ /** Full cache/watermark/topology maintenance completion for legacy callers and diagnostics. */
268
+ readonly completion: Promise<void>;
269
+ phase(): AgentActorSavePhase;
270
+ /** Prevents a queued/precommit attempt from ever entering canonical commit. */
271
+ cancelBeforeCommit(): boolean;
272
+ diagnostics(): AgentActorSaveDiagnostics;
273
+ }
247
274
  interface AgentActorStore {
248
275
  load(): Promise<AgentActorSnapshot | undefined>;
249
276
  /** CAS save. Implementations must throw actor_snapshot_conflict on a revision mismatch. */
250
277
  save(snapshot: AgentActorSnapshot, expectedRevision: number): Promise<void>;
278
+ /** Optional phase-aware save used by Actor settlement convergence v2. */
279
+ beginSave?(snapshot: AgentActorSnapshot, expectedRevision: number): AgentActorSaveAttempt;
280
+ /** Maximum expected writer-admission wait after a phase-aware save is dequeued. */
281
+ readonly eligibilityTimeoutMs?: number;
251
282
  }
252
283
  /** Runtime-bound actor control surface. The caller path is minted by Runtime. */
253
284
  interface AgentActorClient {
@@ -1053,5 +1084,5 @@ type MemoryEvent = {
1053
1084
  readonly actionCount: number;
1054
1085
  };
1055
1086
 
1056
- export { hashMemoryIdentityComponent as bb, isMemoryManagementController as bc, matchesMemoryApplicability as bd, memoryApplicabilityFingerprint as be };
1057
- export type { KodaXMemoryOutcomeDigest as $, AgentActor as A, AgentMetadataValue as B, AgentMutationOptions as C, AgentOutput as D, AgentProgressItem as E, AgentProgressKind as F, AgentProgressUpdate as G, AgentSpawnInput as H, AgentTreeSnapshot as I, AgentTurn as J, AgentTurnExecutor as K, AgentTurnRef as L, AgentTurnState as M, AgentTurnSummary as N, KodaXCompactMemoryProgress as O, KodaXCompactMemorySeed as P, KodaXExtensionSessionRecord as Q, KodaXExtensionSessionState as R, KodaXExtensionStore as S, KodaXExtensionStoreEntry as T, KodaXGoalEventType as U, KodaXGoalState as V, KodaXGoalStatus as W, KodaXHandledMemoryOperation as X, KodaXJsonValue as Y, KodaXMemoryInfluenceRef as Z, KodaXMemoryIntent as _, AgentActorClient as a, MemoryReviewDraftAction as a$, KodaXMemoryOutcomeEvidence as a0, KodaXSessionArchiveMarkerEntry as a1, KodaXSessionArtifactLedgerEntry as a2, KodaXSessionBranchSummaryEntry as a3, KodaXSessionClientNoticeEntry as a4, KodaXSessionCompactionEntry as a5, KodaXSessionData as a6, KodaXSessionEntry as a7, KodaXSessionEntryBase as a8, KodaXSessionGoalEntry as a9, MemoryAutoCuratorInput as aA, MemoryAutoCuratorResult as aB, MemoryBodySnapshot as aC, MemoryClaimKind as aD, MemoryContextIdentity as aE, MemoryController as aF, MemoryCuratorInput as aG, MemoryEpisodeReviewResult as aH, MemoryEvent as aI, MemoryGovernanceFinding as aJ, MemoryGovernanceFindingKind as aK, MemoryGovernanceReport as aL, MemoryItemRef as aM, MemoryLifecycle as aN, MemoryLifecycleOperationResult as aO, MemoryManagementController as aP, MemoryPack as aQ, MemoryPackHint as aR, MemoryPackInput as aS, MemoryPackTraceMetadata as aT, MemoryProposalAction as aU, MemoryRefFilter as aV, MemoryRefKind as aW, MemoryRejectResult as aX, MemoryRememberInput as aY, MemoryRememberResult as aZ, MemoryReviewCandidateRef as a_, KodaXSessionLabelEntry as aa, KodaXSessionLineage as ab, KodaXSessionMemoryOutcomeDigestEntry as ac, KodaXSessionMemoryReviewReceiptEntry as ad, KodaXSessionMessageEntry as ae, KodaXSessionMeta as af, KodaXSessionNavigationOptions as ag, KodaXSessionRewindMarkerEntry as ah, KodaXSessionRuntimeInfo as ai, KodaXSessionScope as aj, KodaXSessionStorage as ak, KodaXSessionTreeNode as al, KodaXSessionUiHistoryItem as am, KodaXSessionUiHistoryItemType as an, KodaXSessionUiTextHistoryItem as ao, KodaXSessionUiTextHistoryItemType as ap, KodaXSessionUiToolCall as aq, KodaXSessionUiToolCallStatus as ar, KodaXSessionUiToolGroupHistoryItem as as, KodaXSessionWorkspaceKind as at, MemoryActionProposal as au, MemoryApplicability as av, MemoryApplyPreview as aw, MemoryApplyResult as ax, MemoryApproval as ay, MemoryAuthority as az, AgentActorOwner as b, MemoryReviewInput as b0, MemoryReviewModelInput as b1, MemoryReviewPersistenceDecision as b2, MemoryReviewPersistenceKind as b3, MemoryReviewPlan as b4, MemoryReviewRunner as b5, MemoryReviewTrigger as b6, MemoryScope as b7, MemorySourceAdapter as b8, MemoryVisibility as b9, SessionErrorMetadata as ba, AgentActorSnapshot as c, AgentActorSnapshotV1 as d, AgentActorSnapshotV2 as e, AgentActorState as f, AgentActorStore as g, AgentArtifactDescriptor as h, AgentBudgetAdmission as i, AgentBudgetAdmissionInput as j, AgentBudgetExhausted as k, AgentBudgetPort as l, AgentCapabilities as m, AgentDataClassification as n, AgentDetail as o, AgentEvent as p, AgentEventKind as q, AgentExecutionInput as r, AgentExecutionKind as s, AgentExecutionResult as t, AgentFollowupResult as u, AgentForkTurns as v, AgentInterruptScope as w, AgentLimitReached as x, AgentListEntry as y, AgentMailboxMessage as z };
1087
+ export { hashMemoryIdentityComponent as bf, isMemoryManagementController as bg, matchesMemoryApplicability as bh, memoryApplicabilityFingerprint as bi };
1088
+ export type { MemoryApplicability as $, KodaXExtensionSessionRecord as A, KodaXExtensionSessionState as B, KodaXJsonValue as C, KodaXSessionBranchSummaryEntry as D, KodaXSessionCompactionEntry as E, KodaXSessionData as F, KodaXSessionEntry as G, KodaXSessionEntryBase as H, KodaXSessionLabelEntry as I, KodaXSessionMessageEntry as J, KodaXSessionLineage as K, KodaXSessionMeta as L, MemoryContextIdentity as M, KodaXSessionNavigationOptions as N, KodaXSessionRuntimeInfo as O, KodaXSessionScope as P, KodaXSessionStorage as Q, KodaXSessionTreeNode as R, KodaXSessionUiHistoryItem as S, KodaXSessionUiHistoryItemType as T, KodaXSessionUiTextHistoryItem as U, KodaXSessionUiTextHistoryItemType as V, KodaXSessionUiToolCall as W, KodaXSessionUiToolCallStatus as X, KodaXSessionUiToolGroupHistoryItem as Y, KodaXSessionWorkspaceKind as Z, SessionErrorMetadata as _, MemoryItemRef as a, MemoryClaimKind as a$, MemoryController as a0, KodaXExtensionStore as a1, AgentActorSnapshot as a2, AgentActorSaveAttempt as a3, AgentExecutionKind as a4, AgentTreeSnapshot as a5, AgentDetail as a6, AgentSpawnInput as a7, AgentTurnRef as a8, AgentDataClassification as a9, AgentActorSavePhase as aA, AgentActorSaveTiming as aB, AgentActorSnapshotV1 as aC, AgentActorSnapshotV2 as aD, AgentActorState as aE, AgentArtifactDescriptor as aF, AgentBudgetAdmission as aG, AgentBudgetAdmissionInput as aH, AgentEventKind as aI, AgentExecutionInput as aJ, AgentForkTurns as aK, AgentListEntry as aL, AgentProgressItem as aM, AgentProgressKind as aN, AgentProgressUpdate as aO, AgentTurn as aP, AgentTurnState as aQ, AgentTurnSummary as aR, KodaXGoalStatus as aS, KodaXHandledMemoryOperation as aT, KodaXMemoryInfluenceRef as aU, KodaXMemoryIntent as aV, KodaXMemoryOutcomeEvidence as aW, KodaXSessionArchiveMarkerEntry as aX, MemoryApplyPreview as aY, MemoryApproval as aZ, MemoryAuthority as a_, AgentFollowupResult as aa, AgentOutput as ab, AgentEvent as ac, KodaXSessionGoalEntry as ad, KodaXSessionClientNoticeEntry as ae, KodaXSessionRewindMarkerEntry as af, KodaXSessionMemoryOutcomeDigestEntry as ag, KodaXSessionMemoryReviewReceiptEntry as ah, KodaXGoalState as ai, AgentActorStore as aj, AgentTurnExecutor as ak, AgentBudgetPort as al, AgentActorOwner as am, AgentActorClient as an, AgentExecutionResult as ao, AgentCapabilities as ap, AgentMailboxMessage as aq, AgentMutationOptions as ar, AgentMetadataValue as as, AgentInterruptScope as at, KodaXGoalEventType as au, KodaXExtensionStoreEntry as av, AgentBudgetExhausted as aw, AgentLimitReached as ax, AgentActor as ay, AgentActorSaveDiagnostics as az, KodaXSessionArtifactLedgerEntry as b, MemoryGovernanceFinding as b0, MemoryGovernanceFindingKind as b1, MemoryLifecycle as b2, MemoryPackHint as b3, MemoryPackTraceMetadata as b4, MemoryProposalAction as b5, MemoryRefKind as b6, MemoryReviewCandidateRef as b7, MemoryReviewDraftAction as b8, MemoryReviewPersistenceDecision as b9, MemoryReviewPersistenceKind as ba, MemoryReviewTrigger as bb, MemoryScope as bc, MemorySourceAdapter as bd, MemoryVisibility as be, MemoryEvent as c, MemoryReviewRunner as d, MemoryManagementController as e, MemoryActionProposal as f, MemoryApplyResult as g, MemoryRejectResult as h, MemoryRefFilter as i, MemoryBodySnapshot as j, MemoryRememberInput as k, MemoryRememberResult as l, MemoryLifecycleOperationResult as m, MemoryCuratorInput as n, MemoryGovernanceReport as o, MemoryAutoCuratorInput as p, MemoryAutoCuratorResult as q, MemoryPackInput as r, MemoryPack as s, MemoryReviewInput as t, MemoryReviewPlan as u, KodaXMemoryOutcomeDigest as v, MemoryReviewModelInput as w, MemoryEpisodeReviewResult as x, KodaXCompactMemoryProgress as y, KodaXCompactMemorySeed as z };
@@ -1,10 +1,10 @@
1
- import { k as KodaXMessage, G as KodaXReasoningMode, d as KodaXCustomProviderConfig, q as KodaXProviderCapabilityProfile } from './types.d-CK9A9rpP.js';
2
- import { de as WorkflowProcessSource } from './controller.d-Dif9pbC9.js';
3
- import { Q as KodaXContextTokenSnapshot, aw as KodaXSkillDynamicContextPolicy, t as KodaXAgentMode, ab as KodaXRepoIntelligenceMode, a4 as KodaXOptions, ax as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-B36OQwNA.js';
4
- import { e as AgentsFile, t as AutoModeStats, T as KodaXMcpServersConfig } from './guardrail.d-DhpnJv4Y.js';
1
+ import { b as KodaXMessage, o as KodaXReasoningMode, r as KodaXCustomProviderConfig, k as KodaXProviderCapabilityProfile } from './types.d-Cv09EdJR.js';
2
+ import { N as WorkflowProcessSource } from './controller.d-1tydJm7c.js';
3
+ import { O as KodaXContextTokenSnapshot, au as KodaXSkillDynamicContextPolicy, s as KodaXAgentMode, a9 as KodaXRepoIntelligenceMode, a2 as KodaXOptions, av as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-BLlhCRI-.js';
4
+ import { f as AgentsFile, u as AutoModeStats, S as KodaXMcpServersConfig } from './guardrail.d-DqWHIgt6.js';
5
5
  import * as readline from 'readline';
6
- import { am as KodaXSessionUiHistoryItem, ab as KodaXSessionLineage, a2 as KodaXSessionArtifactLedgerEntry, R as KodaXExtensionSessionState, Q as KodaXExtensionSessionRecord, ai as KodaXSessionRuntimeInfo } from './types.d-sW-OqiFt.js';
7
- import { S as PermissionMode, L as LearningBinding, G as LearningSurfaceSnapshot } from './public-api.d-D4q3WxKq.js';
6
+ import { S as KodaXSessionUiHistoryItem, K as KodaXSessionLineage, b as KodaXSessionArtifactLedgerEntry, B as KodaXExtensionSessionState, A as KodaXExtensionSessionRecord, O as KodaXSessionRuntimeInfo } from './types.d-DeokRBs7.js';
7
+ import { b as PermissionMode, L as LearningBinding, c as LearningSurfaceSnapshot } from './public-api.d-CMZa4JPa.js';
8
8
  import { SpawnSyncReturns } from 'child_process';
9
9
 
10
10
  /**
@@ -720,5 +720,5 @@ declare function resolveRuntimeEffortSelection(input: {
720
720
  declare function getGitRoot(cwd?: string): Promise<string | null>;
721
721
  declare function rateLimitedCall<T>(fn: () => Promise<T>): Promise<T>;
722
722
 
723
- export { loadConfig as B, prepareRuntimeConfig as D, rateLimitedCall as E, registerConfiguredCustomProviders as F, resolveAutoModeSettings as G, resolveRuntimeEffortSelection as H, resolveRuntimeModelSelection as J, KODAX_CONFIG_FILE as K, resolveRuntimeProviderSelection as L, saveConfig as M, touchContext as N, PREVIEW_MAX_LENGTH as P, KODAX_DIR as i, KODAX_EXAMPLE_CONFIG_FILE as j, KODAX_INTEGRATION_EXAMPLE_FILES as k, KODAX_SESSIONS_DIR as l, KODAX_VERSION as m, createInteractiveContext as q, ensureExampleConfigFile as r, ensureExampleConfigFiles as s, getGitRoot as t, getProviderList as u, getProviderModel as v, getVersion as w, hydrateProcessEnvFromShell as x, isProviderConfigured as y, loadAutoModeSettings as z };
724
- export type { AutoModeSettings as A, Command as C, InteractiveContext as I, ResolveAutoModeSettingsInput as R, CommandCallbacks as a, CommandDefinition as b, CommandInfo as c, CommandInvocationRequest as d, CommandSource as e, CommandWorkflowInvocationRequest as f, CurrentConfig as g, InteractiveMode as h, ResolvedAutoModeSettings as n, RuntimeSurfaceMode as o, RuntimeSurfaceStatus as p };
723
+ export { KODAX_EXAMPLE_CONFIG_FILE as E, KODAX_INTEGRATION_EXAMPLE_FILES as F, ensureExampleConfigFile as H, ensureExampleConfigFiles as J, KODAX_CONFIG_FILE as K, resolveRuntimeEffortSelection as L, resolveRuntimeModelSelection as M, resolveRuntimeProviderSelection as N, PREVIEW_MAX_LENGTH as P, KODAX_DIR as b, KODAX_SESSIONS_DIR as c, KODAX_VERSION as d, createInteractiveContext as f, getGitRoot as g, getProviderList as h, getProviderModel as i, getVersion as j, hydrateProcessEnvFromShell as k, isProviderConfigured as l, loadAutoModeSettings as m, loadConfig as n, registerConfiguredCustomProviders as o, prepareRuntimeConfig as p, resolveAutoModeSettings as q, rateLimitedCall as r, saveConfig as s, touchContext as t };
724
+ export type { AutoModeSettings as A, RuntimeSurfaceStatus as B, CommandCallbacks as C, InteractiveMode as D, RuntimeSurfaceMode as G, InteractiveContext as I, ResolveAutoModeSettingsInput as R, CurrentConfig as a, ResolvedAutoModeSettings as e, CommandDefinition as u, CommandSource as v, CommandInfo as w, Command as x, CommandInvocationRequest as y, CommandWorkflowInvocationRequest as z };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kodax-ai/kodax",
3
- "version": "0.7.87",
3
+ "version": "0.7.89",
4
4
  "description": "KodaX lightweight coding agent - TypeScript implementation with 16 built-in LLM provider aliases, published as a Node-free single-file CLI and SDK",
5
5
  "type": "module",
6
6
  "private": false,
@@ -8,7 +8,7 @@
8
8
  "access": "public"
9
9
  },
10
10
  "kodaxRuntimeContracts": {
11
- "actorSettlementConvergence": 1,
11
+ "actorSettlementConvergence": 2,
12
12
  "daemonShutdownVerification": 1,
13
13
  "integrationConfigResilience": 1,
14
14
  "managedRunDurability": 1,
@@ -1,2 +0,0 @@
1
- // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
2
- import{Ka as g,Ma as h,Za as i,_a as j,a as c,sa as d,ta as e,ua as f,yc as k}from"./chunk-3PGNESV3.js";import"./chunk-JS4RSF4B.js";import"./chunk-DB4O33RR.js";import"./chunk-GRJ7NKWP.js";import"./chunk-SKELDH3G.js";import{Jb as a,Kb as b}from"./chunk-ITP7J5HX.js";import"./chunk-XH7UM4GO.js";import"./chunk-ONUPGMER.js";export{e as bucketProviderPayloadSize,g as buildAutoRepoIntelligenceContext,f as checkPromiseSignal,b as cleanupIncompleteToolCalls,h as describeTransientProviderRetry,c as emitResilienceDebug,d as estimateProviderPayloadBytes,k as runKodaX,j as saveRequiredSessionSnapshot,i as saveSessionSnapshot,a as validateAndFixToolHistory};
@@ -1,2 +0,0 @@
1
- // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
2
- import{Ea as a,Fa as b}from"./chunk-4OLXWSCQ.js";import"./chunk-ASFCAPIG.js";import"./chunk-U44C5STU.js";import"./chunk-BCYJIACJ.js";import"./chunk-3PGNESV3.js";import"./chunk-XKLVC7F6.js";import"./chunk-JS4RSF4B.js";import"./chunk-ZQNOEKOB.js";import"./chunk-DB4O33RR.js";import"./chunk-GRJ7NKWP.js";import"./chunk-SKELDH3G.js";import"./chunk-ITP7J5HX.js";import"./chunk-XH7UM4GO.js";import"./chunk-ONUPGMER.js";export{a as ArgumentCompleter,b as createArgumentCompleter};