@kodax-ai/kodax 0.7.72 → 0.7.74

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 (91) hide show
  1. package/CHANGELOG.md +226 -0
  2. package/README.md +72 -18
  3. package/README_CN.md +55 -14
  4. package/config-templates/config.example.jsonc +7 -0
  5. package/dist/chunks/agent-2ABIG5NW.js +2 -0
  6. package/dist/chunks/argument-completer-C45DEO34.js +2 -0
  7. package/dist/chunks/chunk-5GH3SVI3.js +74 -0
  8. package/dist/chunks/{chunk-SQODXBLX.js → chunk-64M5HOCA.js} +1 -1
  9. package/dist/chunks/{chunk-PKQOEDHJ.js → chunk-7W6KYJU2.js} +224 -230
  10. package/dist/chunks/chunk-C7TZAT3S.js +369 -0
  11. package/dist/chunks/chunk-F7AIEHSS.js +46 -0
  12. package/dist/chunks/{chunk-E27LHEIP.js → chunk-GAFFYJU3.js} +1 -1
  13. package/dist/chunks/chunk-KPGVY6PF.js +321 -0
  14. package/dist/chunks/{chunk-44QXPEEE.js → chunk-MBAPT2R5.js} +1 -1
  15. package/dist/chunks/{chunk-IR5KIK7E.js → chunk-MVCAFD6M.js} +1 -1
  16. package/dist/chunks/chunk-PP53SIIL.js +5 -0
  17. package/dist/chunks/chunk-QH56WEHK.js +2 -0
  18. package/dist/chunks/chunk-UJS7JAO6.js +770 -0
  19. package/dist/chunks/{chunk-MVARIMQV.js → chunk-VK5QTHS6.js} +6 -6
  20. package/dist/chunks/chunk-VPURXE2F.js +427 -0
  21. package/dist/chunks/chunk-XM724XAA.js +329 -0
  22. package/dist/chunks/{chunk-WIBLZK4G.js → chunk-XMP66YWG.js} +11 -4
  23. package/dist/chunks/chunk-XXQLPTAN.js +78 -0
  24. package/dist/chunks/compaction-config-QYCDOW3Q.js +2 -0
  25. package/dist/chunks/{construction-bootstrap-ZJPXUPXQ.js → construction-bootstrap-BKNPJI7O.js} +1 -1
  26. package/dist/chunks/dist-6EK4H7TP.js +2 -0
  27. package/dist/chunks/{dist-GOUP4YVE.js → dist-EVEJAII2.js} +1 -1
  28. package/dist/chunks/host-KS4TJKWQ.js +2 -0
  29. package/dist/chunks/run-manager-L7MKGQNX.js +2 -0
  30. package/dist/chunks/{utils-OTT5CG5J.js → utils-GTJLL4GT.js} +1 -1
  31. package/dist/index.d.ts +17 -16
  32. package/dist/index.js +5 -5
  33. package/dist/kodax_cli.js +1357 -1294
  34. package/dist/provider-capabilities.json +184 -5
  35. package/dist/runtime-worker.js +1277 -1224
  36. package/dist/sdk-a2a.d.ts +11 -10
  37. package/dist/sdk-a2a.js +1 -1
  38. package/dist/sdk-agent.d.ts +110 -62
  39. package/dist/sdk-agent.js +1 -1
  40. package/dist/sdk-coding.d.ts +114 -32
  41. package/dist/sdk-coding.js +1 -1
  42. package/dist/sdk-experimental-memory.d.ts +1 -1
  43. package/dist/sdk-experimental-memory.js +1 -1
  44. package/dist/sdk-llm.d.ts +8 -49
  45. package/dist/sdk-llm.js +1 -1
  46. package/dist/sdk-mcp.js +1 -1
  47. package/dist/sdk-media.d.ts +1 -1
  48. package/dist/sdk-media.js +1 -1
  49. package/dist/sdk-repl.d.ts +153 -24
  50. package/dist/sdk-repl.js +2 -2
  51. package/dist/sdk-runtime.d.ts +238 -19
  52. package/dist/sdk-runtime.js +1 -1
  53. package/dist/sdk-session.d.ts +6 -6
  54. package/dist/sdk-session.js +1 -1
  55. package/dist/sdk-skills.js +1 -1
  56. package/dist/semantic-worker.js +16 -14
  57. package/dist/types-chunks/{base.d-Cz_rwpOi.d.ts → base.d-ChvpaKjZ.d.ts} +1 -1
  58. package/dist/types-chunks/{bash-prefix-extractor.d-CHJO5y94.d.ts → bash-prefix-extractor.d-r1beOESM.d.ts} +50 -14
  59. package/dist/types-chunks/{capability-learning.d-_lR0J4iR.d.ts → capability-learning.d-DPrYxRjF.d.ts} +1 -1
  60. package/dist/types-chunks/{capsule.d-DxtdE-GD.d.ts → capsule.d-zeqV4IQX.d.ts} +11 -3
  61. package/dist/types-chunks/{commands.d-DZxHzH5-.d.ts → commands.d-DUxnK2TU.d.ts} +67 -8
  62. package/dist/types-chunks/{guardrail.d-DlpMnd-Y.d.ts → guardrail.d-CWYD1bdL.d.ts} +2 -1
  63. package/dist/types-chunks/{guardrail.d-auV61_h5.d.ts → guardrail.d-qjuKJZ31.d.ts} +79 -18
  64. package/dist/types-chunks/history-retrieval.d-BKTJIrVd.d.ts +57 -0
  65. package/dist/types-chunks/{public-api.d--IDNJsu1.d.ts → public-api.d-CX4B11qY.d.ts} +19 -5
  66. package/dist/types-chunks/{run-manager.d-Bh50OdVl.d.ts → run-manager.d-B9fEIjZk.d.ts} +1 -1
  67. package/dist/types-chunks/{sdk-session-Cfw6NFu-.d.ts → sdk-session-B0fhAOPa.d.ts} +3 -3
  68. package/dist/types-chunks/{resolver.d-ssgNSlrh.d.ts → side-query.d-DWTMsndP.d.ts} +68 -5
  69. package/dist/types-chunks/{types.d-EqQmHztg.d.ts → types.d-Bm_y6YuM.d.ts} +16 -9
  70. package/dist/types-chunks/{types.d-Cqaw71Ax.d.ts → types.d-CSmF0t0n.d.ts} +6 -5
  71. package/dist/types-chunks/{types.d-CNZgY52F.d.ts → types.d-DEctY20M.d.ts} +10 -3
  72. package/dist/types-chunks/{types.d-DH1mvdcl.d.ts → types.d-sRLugmjy.d.ts} +64 -15
  73. package/dist/types-chunks/{utils.d-gmn3c5U4.d.ts → utils.d-D0wPxz8y.d.ts} +94 -10
  74. package/docs/SDK_EMBEDDER_GUIDE.md +1952 -1573
  75. package/package.json +9 -2
  76. package/dist/chunks/agent-YKGU4USA.js +0 -2
  77. package/dist/chunks/argument-completer-QZETLNAB.js +0 -2
  78. package/dist/chunks/chunk-23X6REO4.js +0 -46
  79. package/dist/chunks/chunk-2RI252RN.js +0 -2
  80. package/dist/chunks/chunk-CLFP6UGU.js +0 -71
  81. package/dist/chunks/chunk-EDZ5KJFT.js +0 -5
  82. package/dist/chunks/chunk-GIK4SGAT.js +0 -364
  83. package/dist/chunks/chunk-GVWPHE23.js +0 -310
  84. package/dist/chunks/chunk-JSDLBXME.js +0 -755
  85. package/dist/chunks/chunk-VDGCGOQH.js +0 -328
  86. package/dist/chunks/chunk-VVE3UM4F.js +0 -410
  87. package/dist/chunks/chunk-ZJIMT5I3.js +0 -78
  88. package/dist/chunks/compaction-config-TWCDFLX6.js +0 -2
  89. package/dist/chunks/dist-JT4ATXVM.js +0 -2
  90. package/dist/chunks/host-SVEDZUC5.js +0 -2
  91. package/dist/chunks/run-manager-RX42UNEM.js +0 -2
@@ -1,7 +1,7 @@
1
- import { a as BashPrefixExtractor, t as KodaXAgentMode } from './bash-prefix-extractor.d-CHJO5y94.js';
2
- import { F as KodaXReasoningMode, k as KodaXMessage, S as KodaXTaskResultMetadata } from './types.d-Cqaw71Ax.js';
1
+ import { a as BashPrefixExtractor, t as KodaXAgentMode } from './bash-prefix-extractor.d-r1beOESM.js';
2
+ import { F as KodaXReasoningMode, k as KodaXMessage, S as KodaXTaskResultMetadata } from './types.d-CSmF0t0n.js';
3
3
  import { p as LearningSurfaceSnapshot$1, n as LearningQuery, m as LearningPage, b as LearnedCapabilityRecord, j as LearningEvent, o as LearningSubscribeOptions } from './center-types.d-BBT122uJ.js';
4
- import { bG as KodaXSessionData, bL as KodaXSessionLineage, bQ as KodaXSessionNavigationOptions, bS as KodaXSessionRuntimeInfo, bU as KodaXSessionStorage, i as AgentActorSnapshot, bx as KodaXJsonValue } from './types.d-DH1mvdcl.js';
4
+ import { bH as KodaXSessionData, bM as KodaXSessionLineage, bR as KodaXSessionNavigationOptions, bT as KodaXSessionRuntimeInfo, bV as KodaXSessionStorage, i as AgentActorSnapshot, aQ as CompactionReport, by as KodaXJsonValue } from './types.d-sRLugmjy.js';
5
5
 
6
6
  /**
7
7
  * TextBuffer - Text buffer management class - 文本缓冲区管理类
@@ -265,6 +265,7 @@ declare function permissionModeDisplayName(mode: PermissionMode): string;
265
265
  interface ConfirmResult {
266
266
  confirmed: boolean;
267
267
  always?: boolean;
268
+ runtimeGrantKind?: 'session' | 'persistent';
268
269
  }
269
270
  /**
270
271
  * Tools that mutate the local filesystem AND accept a `path` input.
@@ -542,6 +543,8 @@ interface StatusBarProps {
542
543
  contextWindow: number;
543
544
  /** Compaction trigger percentage (0-100) */
544
545
  triggerPercent: number;
546
+ /** Optional absolute threshold; zero/undefined is inactive. */
547
+ triggerTokens?: number;
545
548
  /** Provider output capacity reserved from the physical context window. */
546
549
  reservedResponseTokens?: number;
547
550
  };
@@ -571,8 +574,8 @@ interface StatusBarProps {
571
574
  /**
572
575
  * FEATURE_092 phase 2b.8: classifier engine indicator. Only renders when
573
576
  * permissionMode is in the auto family. `'llm'` shows green `auto[LLM]`
574
- * (healthy), `'rules'` shows yellow `auto[RULES]` (downgraded — every
575
- * non-Tier-1 tool call escalates to user confirm).
577
+ * (healthy), `'rules'` shows yellow `auto[RULES]` (deterministic
578
+ * workspace/temp rules; unresolved calls escalate to user confirmation).
576
579
  */
577
580
  autoModeEngine?: 'llm' | 'rules';
578
581
  }
@@ -844,6 +847,7 @@ interface SessionStorage {
844
847
  save(id: string, data: SessionData): Promise<void>;
845
848
  load(id: string): Promise<SessionData | null>;
846
849
  getLineage?(id: string): Promise<KodaXSessionLineage | null>;
850
+ loadFullLineage?(id: string): Promise<KodaXSessionLineage | null>;
847
851
  setActiveEntry?(id: string, selector: string, options?: KodaXSessionNavigationOptions): Promise<SessionData | null>;
848
852
  setLabel?(id: string, selector: string, label?: string): Promise<SessionData | null>;
849
853
  rewind?(id: string, selector?: string): Promise<SessionData | null>;
@@ -872,6 +876,7 @@ declare class MemorySessionStorage implements SessionStorage {
872
876
  save(id: string, data: SessionData): Promise<void>;
873
877
  load(id: string): Promise<SessionData | null>;
874
878
  getLineage(id: string): Promise<KodaXSessionLineage | null>;
879
+ loadFullLineage(id: string): Promise<KodaXSessionLineage | null>;
875
880
  setActiveEntry(id: string, selector: string, options?: KodaXSessionNavigationOptions): Promise<SessionData | null>;
876
881
  setLabel(id: string, selector: string, label?: string): Promise<SessionData | null>;
877
882
  fork(id: string, selector?: string, options?: {
@@ -954,6 +959,8 @@ declare class FileSessionStorage implements KodaXSessionStorage {
954
959
  */
955
960
  private resolveSessionLocation;
956
961
  private readSession;
962
+ private readArchivedEntries;
963
+ private appendIslandArchive;
957
964
  /** Write `<dir>/project.json` once per process per directory (best-effort). */
958
965
  private ensureProjectJson;
959
966
  private writeSessionInternal;
@@ -966,6 +973,7 @@ declare class FileSessionStorage implements KodaXSessionStorage {
966
973
  saveActorSnapshot(id: string, snapshot: AgentActorSnapshot, expectedRevision: number): Promise<void>;
967
974
  load(id: string): Promise<SessionData | null>;
968
975
  getLineage(id: string): Promise<KodaXSessionLineage | null>;
976
+ loadFullLineage(id: string): Promise<KodaXSessionLineage | null>;
969
977
  setActiveEntry(id: string, selector: string, options?: {
970
978
  summarizeCurrentBranch?: boolean;
971
979
  }): Promise<SessionData | null>;
@@ -1055,6 +1063,10 @@ interface CompactSessionOptions {
1055
1063
  readonly customInstructions?: string;
1056
1064
  /** Provider context-window override (tokens). Otherwise resolved from the provider/model. */
1057
1065
  readonly contextWindow?: number;
1066
+ /** Percentage threshold used to derive the protected tail (normalized to 15-90). */
1067
+ readonly triggerPercent?: number;
1068
+ /** Optional absolute threshold used to derive the protected tail; zero is inactive. */
1069
+ readonly triggerTokens?: number;
1058
1070
  /** Sessions directory (mirrors createSessionManager's override). */
1059
1071
  readonly sessionsDir?: string;
1060
1072
  /** Injected storage instance (takes precedence over sessionsDir). */
@@ -1067,6 +1079,8 @@ interface CompactSessionResult {
1067
1079
  readonly tokensAfter: number;
1068
1080
  /** The rewritten (or unchanged) message list. */
1069
1081
  readonly messages: KodaXMessage[];
1082
+ /** Canonical component accounting for a committed compaction. */
1083
+ readonly report?: CompactionReport;
1070
1084
  /** Populated when `compacted` is false to explain why (not-found / no-op / error). */
1071
1085
  readonly reason?: string;
1072
1086
  }
@@ -1,4 +1,4 @@
1
- import { ef as WorkflowProcessTrackerOptions, dN as WorkflowEvent, e9 as WorkflowProcessSnapshot, e3 as WorkflowProcessEvent } from './types.d-DH1mvdcl.js';
1
+ import { eg as WorkflowProcessTrackerOptions, dO as WorkflowEvent, ea as WorkflowProcessSnapshot, e4 as WorkflowProcessEvent } from './types.d-sRLugmjy.js';
2
2
 
3
3
  /**
4
4
  * FEATURE_246 Part A0 (ADR-046) — neutral workflow run lifecycle manager.
@@ -1,6 +1,6 @@
1
- import { g as CreatableHistoryItem, a8 as ToolCall } from './public-api.d--IDNJsu1.js';
2
- import { k as KodaXMessage, c as KodaXContentBlock } from './types.d-Cqaw71Ax.js';
3
- import { bW as KodaXSessionUiHistoryItem, b_ as KodaXSessionUiToolCall } from './types.d-DH1mvdcl.js';
1
+ import { g as CreatableHistoryItem, a8 as ToolCall } from './public-api.d-CX4B11qY.js';
2
+ import { k as KodaXMessage, c as KodaXContentBlock } from './types.d-CSmF0t0n.js';
3
+ import { bX as KodaXSessionUiHistoryItem, b$ as KodaXSessionUiToolCall } from './types.d-sRLugmjy.js';
4
4
 
5
5
  interface RestoreHistoryItemsFromSessionInput {
6
6
  messages: readonly KodaXMessage[];
@@ -1,7 +1,8 @@
1
- import { F as KodaXReasoningMode, M as KodaXStableEffortIntent, a9 as KodaXWireReasoningEffort, G as KodaXReasoningProfile, Z as KodaXThinkingBudgetMap, _ as KodaXThinkingDepth, q as KodaXProviderConfig, B as KodaXReasoningCapability, H as KodaXReasoningRequest, n as KodaXNormalizedReasoningRequest, V as KodaXTaskType, a7 as KodaXVerifyCredentialResult, a1 as KodaXToolDefinition, k as KodaXMessage, y as KodaXProviderStreamOptions, N as KodaXStreamResult, l as KodaXModelDescriptor, p as KodaXProviderCapabilityProfile, a8 as KodaXVerifyStrategy, d as KodaXCustomProviderConfig, j as KodaXListModelsResult } from './types.d-Cqaw71Ax.js';
1
+ import { F as KodaXReasoningMode, M as KodaXStableEffortIntent, a9 as KodaXWireReasoningEffort, G as KodaXReasoningProfile, Z as KodaXThinkingBudgetMap, _ as KodaXThinkingDepth, q as KodaXProviderConfig, B as KodaXReasoningCapability, H as KodaXReasoningRequest, n as KodaXNormalizedReasoningRequest, V as KodaXTaskType, a7 as KodaXVerifyCredentialResult, a1 as KodaXToolDefinition, k as KodaXMessage, y as KodaXProviderStreamOptions, N as KodaXStreamResult, l as KodaXModelDescriptor, p as KodaXProviderCapabilityProfile, a8 as KodaXVerifyStrategy, d as KodaXCustomProviderConfig, j as KodaXListModelsResult, a0 as KodaXTokenUsage } from './types.d-CSmF0t0n.js';
2
2
  import Anthropic from '@anthropic-ai/sdk';
3
- import { K as KodaXBaseProvider } from './base.d-Cz_rwpOi.js';
3
+ import { K as KodaXBaseProvider } from './base.d-ChvpaKjZ.js';
4
4
  import OpenAI from 'openai';
5
+ import { a as CostTracker } from './cost-tracker.d-BeaenODW.js';
5
6
 
6
7
  /**
7
8
  * KodaX AI Errors
@@ -352,7 +353,7 @@ declare abstract class KodaXOpenAICompatProvider extends KodaXBaseProvider {
352
353
  * Provider 注册表 - 统一管理所有 Provider
353
354
  */
354
355
 
355
- type ProviderName = 'anthropic' | 'openai' | 'deepseek' | 'kimi' | 'kimi-code' | 'qwen' | 'zhipu' | 'zhipu-coding' | 'zai-coding' | 'minimax-coding' | 'mimo-coding' | 'mimo' | 'ark-coding' | 'gemini-cli' | 'codex-cli';
356
+ type ProviderName = 'anthropic' | 'openai' | 'deepseek' | 'kimi' | 'kimi-code' | 'qwen' | 'qwen-token-plan' | 'zhipu' | 'zhipu-coding' | 'zai-coding' | 'minimax-coding' | 'mimo-coding' | 'mimo' | 'ark-coding' | 'gemini-cli' | 'codex-cli';
356
357
  /**
357
358
  * Per-provider static metadata. v0.7.43 promoted this from a partial
358
359
  * descriptor (`models: string[]`) to the full capability surface so
@@ -648,5 +649,67 @@ declare function listProviderModels(name: string, _opts?: {
648
649
  signal?: AbortSignal;
649
650
  }): Promise<KodaXListModelsResult>;
650
651
 
651
- export { normalizeReasoningEffortValue as $, getDefaultThinkingDepthForMode as A, getModelCapabilities as B, getProvider as C, getProviderConfiguredCapabilityProfile as D, getProviderConfiguredReasoningCapability as E, getProviderList as F, getProviderModel as G, getProviderModelDescriptors as H, getProviderModels as I, getReasoningCapability as J, KODAX_DEFAULT_PROVIDER as K, getRuntimeModelProvider as L, getRuntimeModelProviderNames as M, isCustomProviderName as N, isKnownProvider as O, isProviderConfigured as Q, isProviderName as S, isReasoningEnabled as T, isRuntimeModelProviderName as U, listAllModelCapabilities as V, listBuiltinModelCapabilities as W, listCustomProviderModelCapabilities as X, listProviderModels as Y, mapDepthToOpenAIReasoningEffort as Z, mapLegacyReasoningModeToEffortIntent as _, KODAX_DEFAULT_THINKING_BUDGETS as a, normalizeReasoningRequest as a0, parseReasoningEffortEnv as a1, registerCustomProviders as a2, registerModelProvider as a3, resolveModelCapabilities as a4, resolveProvider as a5, resolveProviderModelDescriptors as a6, resolveReasoningEffort as a7, resolveReasoningEffortForModelSwitch as a8, resolveThinkingBudget as a9, resolveWireEffort as aa, validateCustomProviderConfig as ab, verifyProviderCredential as ac, KODAX_PROVIDERS as b, KODAX_PROVIDER_SNAPSHOTS as c, KODAX_REASONING_MODE_SEQUENCE as d, KODAX_REASONING_SAFETY_RESERVE as e, KODAX_STABLE_EFFORT_INTENTS as f, KodaXAnthropicCompatProvider as g, KodaXError as h, KodaXNetworkError as j, KodaXOpenAICompatProvider as k, KodaXProviderError as l, KodaXRateLimitError as m, KodaXToolCallIdError as n, clampThinkingBudget as p, clearRuntimeModelProviders as q, createCustomProvider as r, effortToLegacyReasoningMode as s, getAvailableProviderNames as t, getCustomModelCapabilities as u, getCustomProvider as v, getCustomProviderList as w, getCustomProviderModelDescriptors as x, getCustomProviderModels as y, getCustomProviderNames as z };
652
- export type { ProviderName as P, ResolveWireEffortInput as R, KodaXModelCapabilities as i, ResolvedWireEffort as o };
652
+ /**
653
+ * sideQuery — independent one-shot LLM invocation.
654
+ *
655
+ * Used by features that need a clean LLM call outside the main agent loop.
656
+ * The auto mode classifier (FEATURE_092) is the first consumer; future
657
+ * users include compaction, title generation, and SA mutation reflection.
658
+ *
659
+ * Constraints (deliberate):
660
+ * - tools=[] hardcoded — sideQuery is single-turn, no tool loop
661
+ * - text-only output — tool_use blocks from the model produce stopReason='error'
662
+ * - independent timeout (default 30s; callers may supply a bounded deadline)
663
+ * - independent cost bucket via querySource (mapped to TokenUsageRecord.role)
664
+ *
665
+ * Failure handling: never throws. Timeout, abort, provider error, and
666
+ * unexpected tool_use all produce a result with stopReason='timeout' /
667
+ * 'aborted' / 'error' so callers implement their own degradation.
668
+ */
669
+
670
+ type SideQueryStopReason = 'end_turn' | 'max_tokens' | 'timeout' | 'aborted' | 'error';
671
+ interface SideQueryRequest {
672
+ readonly provider: KodaXBaseProvider;
673
+ readonly model: string;
674
+ readonly system: string;
675
+ readonly messages: readonly KodaXMessage[];
676
+ readonly reasoning?: KodaXReasoningRequest;
677
+ /** Optional per-request cap for small structured sidecar responses. */
678
+ readonly maxOutputTokens?: number;
679
+ readonly timeoutMs?: number;
680
+ readonly abortSignal?: AbortSignal;
681
+ readonly querySource: string;
682
+ readonly costTracker?: CostTracker;
683
+ }
684
+ interface SideQueryResult {
685
+ readonly text: string;
686
+ readonly usage: KodaXTokenUsage;
687
+ readonly costTracker?: CostTracker;
688
+ readonly stopReason: SideQueryStopReason;
689
+ /**
690
+ * Bounded request metadata only; prompts and response text are never copied.
691
+ * The built-in `sideQuery()` always supplies it. Optionality preserves source
692
+ * compatibility for existing SDK mocks and structural result adapters.
693
+ */
694
+ readonly diagnostics?: SideQueryDiagnostics;
695
+ readonly error?: Error;
696
+ }
697
+ type SideQueryTerminalPhase = 'completed' | 'pre_output' | 'streaming' | 'contract_error';
698
+ interface SideQueryDiagnostics {
699
+ readonly provider: string;
700
+ readonly model: string;
701
+ readonly timeoutMs: number;
702
+ readonly elapsedMs: number;
703
+ readonly retryCount: number;
704
+ readonly retryWaitMs: number;
705
+ /** Time until the first non-empty text delta, when the adapter exposes it. */
706
+ readonly firstOutputMs?: number;
707
+ /** Time from the first observed text delta until termination. */
708
+ readonly streamMs?: number;
709
+ /** Honest coarse phase; provider adapters cannot split DNS/connect/remote queue. */
710
+ readonly terminalPhase: SideQueryTerminalPhase;
711
+ }
712
+ declare function sideQuery(req: SideQueryRequest): Promise<SideQueryResult>;
713
+
714
+ export { listBuiltinModelCapabilities as $, getCustomProviderList as A, getCustomProviderModelDescriptors as B, getCustomProviderModels as C, getCustomProviderNames as D, getDefaultThinkingDepthForMode as E, getModelCapabilities as F, getProvider as G, getProviderConfiguredCapabilityProfile as H, getProviderConfiguredReasoningCapability as I, getProviderList as J, KODAX_DEFAULT_PROVIDER as K, getProviderModel as L, getProviderModelDescriptors as M, getProviderModels as N, getReasoningCapability as O, getRuntimeModelProvider as Q, getRuntimeModelProviderNames as T, isCustomProviderName as U, isKnownProvider as V, isProviderConfigured as W, isProviderName as X, isReasoningEnabled as Y, isRuntimeModelProviderName as Z, listAllModelCapabilities as _, KODAX_DEFAULT_THINKING_BUDGETS as a, listCustomProviderModelCapabilities as a0, listProviderModels as a1, mapDepthToOpenAIReasoningEffort as a2, mapLegacyReasoningModeToEffortIntent as a3, normalizeReasoningEffortValue as a4, normalizeReasoningRequest as a5, parseReasoningEffortEnv as a6, registerCustomProviders as a7, registerModelProvider as a8, resolveModelCapabilities as a9, resolveProvider as aa, resolveProviderModelDescriptors as ab, resolveReasoningEffort as ac, resolveReasoningEffortForModelSwitch as ad, resolveThinkingBudget as ae, resolveWireEffort as af, sideQuery as ag, validateCustomProviderConfig as ah, verifyProviderCredential as ai, KODAX_PROVIDERS as b, KODAX_PROVIDER_SNAPSHOTS as c, KODAX_REASONING_MODE_SEQUENCE as d, KODAX_REASONING_SAFETY_RESERVE as e, KODAX_STABLE_EFFORT_INTENTS as f, KodaXAnthropicCompatProvider as g, KodaXError as h, KodaXNetworkError as j, KodaXOpenAICompatProvider as k, KodaXProviderError as l, KodaXRateLimitError as m, KodaXToolCallIdError as n, clampThinkingBudget as t, clearRuntimeModelProviders as u, createCustomProvider as v, effortToLegacyReasoningMode as w, getAvailableProviderNames as x, getCustomModelCapabilities as y, getCustomProvider as z };
715
+ export type { ProviderName as P, ResolveWireEffortInput as R, SideQueryDiagnostics as S, KodaXModelCapabilities as i, ResolvedWireEffort as o, SideQueryRequest as p, SideQueryResult as q, SideQueryStopReason as r, SideQueryTerminalPhase as s };
@@ -1,8 +1,8 @@
1
- import { a9 as KodaXWireReasoningEffort, a1 as KodaXToolDefinition, a3 as KodaXToolResultContentItem, k as KodaXMessage } from './types.d-Cqaw71Ax.js';
2
- import { K as KodaXBaseProvider } from './base.d-Cz_rwpOi.js';
1
+ import { a9 as KodaXWireReasoningEffort, a1 as KodaXToolDefinition, a3 as KodaXToolResultContentItem, k as KodaXMessage } from './types.d-CSmF0t0n.js';
2
+ import { K as KodaXBaseProvider } from './base.d-ChvpaKjZ.js';
3
3
  import { C as CapabilityKind, a as CapabilityProvider } from './capability.d-K664nHOS.js';
4
- import { bx as KodaXJsonValue, bl as KodaXExtensionSessionRecord, bn as KodaXExtensionStore } from './types.d-DH1mvdcl.js';
5
- import { aE as KodaXToolExecutionContext, bl as ToolSideEffect } from './bash-prefix-extractor.d-CHJO5y94.js';
4
+ import { by as KodaXJsonValue, bm as KodaXExtensionSessionRecord, bo as KodaXExtensionStore } from './types.d-sRLugmjy.js';
5
+ import { aG as KodaXToolExecutionContext, bn as ToolSideEffect } from './bash-prefix-extractor.d-r1beOESM.js';
6
6
 
7
7
  /**
8
8
  * KodaX Constructed-World types (FEATURE_087, v0.7.28).
@@ -438,17 +438,18 @@ interface LocalToolDefinition extends KodaXToolDefinition {
438
438
  * THREE-TIER STRATEGY (pick by tool's risk profile):
439
439
  *
440
440
  * 1. ZERO RISK (read-only, structural):
441
- * → return '' (Tier 1 — classifier is skipped entirely, zero token cost)
442
- * Examples: read, grep, glob, ask_user_question, exit_plan_mode
441
+ * → return '' (Tier 1; classifier is skipped, zero token cost)
442
+ * Non-readonly tools need an explicit `classifierExemptReason`.
443
+ * Examples: read, grep, glob, ask_user_question
443
444
  *
444
445
  * 2. HIGH RISK (mutates state, network, exec, spawn):
445
446
  * → write a CUSTOM projection that surfaces the risk-bearing fields
446
447
  * Examples: bash (`Bash: ${i.command}`), web_fetch (`WebFetch ${i.url}`)
447
448
  * See `classifier-projection.ts` for examples by category.
448
449
  *
449
- * 3. LOW RISK (structured input, side-effect-capable):
450
- * → return defaultToClassifierInput(name, input) (one-line helper)
451
- * Examples: semantic_lookup (refresh: true rebuilds index)
450
+ * 3. UNKNOWN / EXTENSION INPUT:
451
+ * → use `safeFallbackToClassifierInput(name, input)`. It retains
452
+ * operational metadata and body sizes without serializing raw JSON.
452
453
  *
453
454
  * KEEP IT SHORT: ≤ 100 chars typical. Variable-length user-provided fields
454
455
  * (bash command, URL, `spawn_agent` objective) may legitimately
@@ -462,6 +463,12 @@ interface LocalToolDefinition extends KodaXToolDefinition {
462
463
  * See `docs/features/v0.7.33.md` "Tool 接口扩展" for design rationale.
463
464
  */
464
465
  toClassifierInput: (input: unknown) => string;
466
+ /**
467
+ * Required justification when a non-readonly tool intentionally returns
468
+ * an empty classifier projection. This makes classifier bypasses auditable
469
+ * instead of allowing an accidental `() => ''` to fail open.
470
+ */
471
+ classifierExemptReason?: string;
465
472
  }
466
473
  interface ToolDefinitionSource {
467
474
  /**
@@ -138,14 +138,15 @@ interface KodaXMessage {
138
138
  * Identifies which subsystem injected a synthetic message so consumers can
139
139
  * render/attribute it distinctly instead of treating it like a user query.
140
140
  * Absent on genuine user/assistant/system messages. Known values include
141
- * `'sidecar-verifier'` (Sidecar Verifier revise feedback) and `'task-completed'`
142
- * (a dispatch_child_task / run_workflow `<task-completed>` result banner spliced
143
- * into the transcript; a rare same-wake mix with a system-reminder shares this
144
- * one label, content preserved). Exposed verbatim through `KodaXResult.messages`
141
+ * `'sidecar-verifier'` (Sidecar Verifier revise feedback),
142
+ * `'agent-completed'` (an Actor `<agent-completed>` result banner), and the
143
+ * legacy `'task-completed'` workflow banner. A rare same-wake mix with a
144
+ * system-reminder shares the completion label, content preserved. Exposed
145
+ * verbatim through `KodaXResult.messages`
145
146
  * and session-load APIs for SDK consumers.
146
147
  */
147
148
  _source?: string;
148
- /** Structured task/workflow result metadata for synthetic task-completed messages. */
149
+ /** Structured task/workflow result metadata for synthetic completion messages. */
149
150
  _taskResult?: KodaXTaskResultMetadata;
150
151
  /** Multiple task results when one synthetic wake message contains several banners. */
151
152
  _taskResults?: KodaXTaskResultMetadata[];
@@ -1,5 +1,5 @@
1
- import { bv as KodaXInputArtifact } from './types.d-DH1mvdcl.js';
2
- import { S as KodaXTaskResultMetadata } from './types.d-Cqaw71Ax.js';
1
+ import { bw as KodaXInputArtifact } from './types.d-sRLugmjy.js';
2
+ import { S as KodaXTaskResultMetadata } from './types.d-CSmF0t0n.js';
3
3
 
4
4
  /**
5
5
  * @kodax-ai/agent/messaging — Message queue types
@@ -17,7 +17,14 @@ import { S as KodaXTaskResultMetadata } from './types.d-Cqaw71Ax.js';
17
17
  */
18
18
 
19
19
  type MessagePriority = 'user' | 'background';
20
- type MessageMode = 'prompt' | 'task-notification' | 'system-reminder';
20
+ /**
21
+ * Delivery semantics, independent of priority:
22
+ * - `prompt`: user-authored input; delivered as a real user turn.
23
+ * - `agent-message`: Runtime-authenticated Agent communication.
24
+ * - `task-notification`: structured Agent completion evidence.
25
+ * - `system-reminder`: Runtime-authored synthetic guidance.
26
+ */
27
+ type MessageMode = 'prompt' | 'agent-message' | 'task-notification' | 'system-reminder';
21
28
  type QueuedInputArtifact = KodaXInputArtifact;
22
29
  interface QueuedMessage {
23
30
  /** Stable id for tracing / dedup. Format: `msg-<sequence>`. */
@@ -1,4 +1,4 @@
1
- import { k as KodaXMessage, a1 as KodaXToolDefinition, F as KodaXReasoningMode, a9 as KodaXWireReasoningEffort, a3 as KodaXToolResultContentItem, Y as KodaXThinkingBlock, I as KodaXRedactedThinkingBlock } from './types.d-Cqaw71Ax.js';
1
+ import { k as KodaXMessage, a1 as KodaXToolDefinition, F as KodaXReasoningMode, a9 as KodaXWireReasoningEffort, a3 as KodaXToolResultContentItem, Y as KodaXThinkingBlock, I as KodaXRedactedThinkingBlock } from './types.d-CSmF0t0n.js';
2
2
 
3
3
  type AgentActorState = 'running' | 'idle' | 'closed';
4
4
  type AgentTurnState = 'accepted' | 'running' | 'completed' | 'failed' | 'interrupted';
@@ -210,6 +210,10 @@ interface AgentActorSnapshot {
210
210
  readonly actors: readonly AgentActor[];
211
211
  readonly turns: readonly AgentTurn[];
212
212
  readonly mailboxes: Readonly<Record<string, readonly AgentMailboxMessage[]>>;
213
+ /** Terminal child turns explicitly observed by their direct parent. */
214
+ readonly acknowledgedCompletionTurnIds?: readonly string[];
215
+ /** Root completion notifications that must survive process-local queue loss. */
216
+ readonly pendingRootCompletionTurnIds?: readonly string[];
213
217
  readonly events: readonly AgentEvent[];
214
218
  }
215
219
  interface AgentActorStore {
@@ -223,6 +227,7 @@ interface AgentActorClient {
223
227
  send(targetPath: string, content: string, classification?: AgentDataClassification, forwardedMessageId?: string): Promise<AgentMailboxMessage>;
224
228
  followup(targetPath: string, objective: string, metadata?: Readonly<Record<string, AgentMetadataValue>>, options?: AgentMutationOptions): Promise<AgentFollowupResult>;
225
229
  interrupt(targetPath: string, reason?: string, scope?: AgentInterruptScope): Promise<void>;
230
+ acknowledgeCompletions(turnIds: readonly string[]): Promise<number>;
226
231
  list(): AgentTreeSnapshot;
227
232
  get(targetPath: string): AgentDetail;
228
233
  output(targetPath: string, turnId?: string): AgentOutput;
@@ -609,6 +614,8 @@ interface KodaXSessionStorage {
609
614
  save(id: string, data: KodaXSessionData): Promise<void>;
610
615
  load(id: string): Promise<KodaXSessionData | null>;
611
616
  getLineage?(id: string): Promise<KodaXSessionLineage | null>;
617
+ /** Exact lineage merged from the active session file and island sidecars. */
618
+ loadFullLineage?(id: string): Promise<KodaXSessionLineage | null>;
612
619
  setActiveEntry?(id: string, selector: string, options?: KodaXSessionNavigationOptions): Promise<KodaXSessionData | null>;
613
620
  setLabel?(id: string, selector: string, label?: string): Promise<KodaXSessionData | null>;
614
621
  rewind?(id: string, selector?: string): Promise<KodaXSessionData | null>;
@@ -619,7 +626,10 @@ interface KodaXSessionStorage {
619
626
  sessionId: string;
620
627
  data: KodaXSessionData;
621
628
  } | null>;
622
- list?(gitRoot?: string): Promise<Array<{
629
+ list?(gitRoot?: string, options?: {
630
+ limit?: number;
631
+ includeArchived?: boolean;
632
+ }): Promise<Array<{
623
633
  id: string;
624
634
  title: string;
625
635
  msgCount: number;
@@ -1001,6 +1011,8 @@ interface GuardrailSpanData {
1001
1011
  readonly kind: 'guardrail';
1002
1012
  readonly guardrailName: string;
1003
1013
  readonly hookPoint: 'input' | 'output' | 'tool';
1014
+ /** True between span start and the guardrail callback settling. */
1015
+ readonly pending?: boolean;
1004
1016
  readonly decision: 'pass' | 'veto' | 'rewrite' | 'error';
1005
1017
  readonly reason?: string;
1006
1018
  readonly error?: string;
@@ -1944,6 +1956,13 @@ interface RunOptions {
1944
1956
  * supplied, each generated message is appended as a `message` entry.
1945
1957
  */
1946
1958
  readonly session?: Session;
1959
+ /**
1960
+ * Fires after a message has entered the authoritative transcript and, when
1961
+ * a Session is configured, only after its atomic append succeeds. Hosts use
1962
+ * this boundary for delivery receipts that must remain replayable on a
1963
+ * persistence failure.
1964
+ */
1965
+ readonly onMessageCommitted?: (message: AgentMessage) => void | Promise<void>;
1947
1966
  /**
1948
1967
  * Abort signal forwarded to preset dispatchers that honor it.
1949
1968
  */
@@ -2101,6 +2120,8 @@ interface RunOptions {
2101
2120
  readonly agent: Agent;
2102
2121
  readonly transcript: readonly AgentMessage[];
2103
2122
  readonly iteration: number;
2123
+ /** Executed tool names from the iteration that reached this boundary. */
2124
+ readonly lastTurnToolNames: readonly string[];
2104
2125
  }) => Promise<readonly AgentMessage[]>;
2105
2126
  /**
2106
2127
  * FEATURE_166 (v0.7.41 follow-up) — agent-switch hook.
@@ -3036,30 +3057,38 @@ type MemoryEvent = {
3036
3057
  */
3037
3058
 
3038
3059
  interface CompactionConfig {
3039
- /** Whether automatic compaction is enabled. */
3060
+ /** @deprecated Automatic large compaction is always enabled. */
3040
3061
  enabled: boolean;
3041
3062
  /**
3042
- * Optional early trigger percentage. `100` means capacity-only; values below
3043
- * 100 explicitly opt in to semantic compaction before physical pressure.
3063
+ * Automatic large-compaction threshold percentage. Defaults to 75 and is
3064
+ * normalized to the inclusive 15-90 range.
3044
3065
  */
3045
3066
  triggerPercent: number;
3067
+ /**
3068
+ * Optional absolute token threshold. Missing or zero is inactive; otherwise
3069
+ * the smaller percentage/absolute/physical threshold wins.
3070
+ */
3071
+ triggerTokens?: number;
3046
3072
  /**
3047
3073
  * @deprecated V2 compaction no longer uses this option.
3048
- *
3049
- * The system now combines protected recent context, lightweight pruning, and
3050
- * rolling summaries automatically.
3074
+ * FEATURE_272 derives protection from the effective trigger and covers the
3075
+ * complete eligible prefix in one logical wave.
3051
3076
  */
3052
3077
  keepRecentPercent?: number;
3053
- /** Percentage of the most recent context that is never compacted or pruned. Defaults to 20. */
3078
+ /**
3079
+ * @deprecated Large compaction protects 20% of its effective trigger.
3080
+ * Retained only for source compatibility with v0.7.x callers.
3081
+ */
3054
3082
  protectionPercent?: number;
3055
3083
  /**
3056
- * Percentage of the context window used as the chunk size for each rolling
3057
- * summary pass. Defaults to 10.
3084
+ * @deprecated FEATURE_272 replaces rolling summary passes with one complete
3085
+ * eligible-prefix wave. Retained for source compatibility.
3058
3086
  */
3059
3087
  rollingSummaryPercent?: number;
3060
3088
  /**
3061
- * Explicit legacy opt-in for destructive pre-summary tool-result pruning.
3062
- * Undefined keeps the complete evidence for semantic summarization.
3089
+ * Explicit legacy opt-in for destructive emergency pruning after semantic
3090
+ * compaction cannot restore a physically valid request. Undefined keeps the
3091
+ * fallback disabled.
3063
3092
  */
3064
3093
  pruningThresholdTokens?: number;
3065
3094
  /**
@@ -3085,6 +3114,12 @@ interface CompactionAnchor {
3085
3114
  memorySeed?: KodaXCompactMemorySeed;
3086
3115
  }
3087
3116
  interface CompactionUpdate {
3117
+ /**
3118
+ * Exact host-only snapshot used to reconcile lineage before durable commit.
3119
+ * It is intentionally not part of the persisted CompactionEntry or provider
3120
+ * context. Hosts may evict old message bodies only after saving this state.
3121
+ */
3122
+ preCompactionMessages?: readonly KodaXMessage[];
3088
3123
  anchor?: CompactionAnchor;
3089
3124
  artifactLedger?: KodaXSessionArtifactLedgerEntry[];
3090
3125
  memorySeed?: KodaXCompactMemorySeed;
@@ -3099,6 +3134,19 @@ interface CompactionUpdate {
3099
3134
  * is the persistence source of truth.
3100
3135
  */
3101
3136
  postCompactAttachments?: readonly KodaXMessage[];
3137
+ /** Canonical metrics for one committed large-compaction transaction. */
3138
+ report?: CompactionReport;
3139
+ }
3140
+ interface CompactionReport {
3141
+ readonly strategy: 'full_prefix' | 'map_reduce';
3142
+ readonly triggerSource: 'percentage' | 'absolute' | 'physical_capacity';
3143
+ readonly effectiveTriggerTokens: number;
3144
+ readonly protectedBudgetTokens: number;
3145
+ readonly fixedInputTokens: number;
3146
+ readonly eligibleTokens: number;
3147
+ readonly rawTailTokens: number;
3148
+ readonly summaryTokens: number;
3149
+ readonly queryLedgerTokens: number;
3102
3150
  }
3103
3151
  interface CompactionResult {
3104
3152
  compacted: boolean;
@@ -3111,6 +3159,7 @@ interface CompactionResult {
3111
3159
  artifactLedger?: KodaXSessionArtifactLedgerEntry[];
3112
3160
  anchor?: CompactionAnchor;
3113
3161
  memorySeed?: KodaXCompactMemorySeed;
3162
+ report?: CompactionReport;
3114
3163
  }
3115
3164
  interface FileOperations {
3116
3165
  readFiles: string[];
@@ -4048,5 +4097,5 @@ interface CreateAgentExecutorPlaneOptions {
4048
4097
  readonly closeTimeoutMs?: number;
4049
4098
  }
4050
4099
 
4051
- export { ASK_USER_BACK_SIGNAL as A, ASK_USER_CUSTOM_INPUT_SIGNAL as a, DEFAULT_SYSTEM_CAP as aV, InvariantSession as bi, MAX_TOOL_LOOP_ITERATIONS as c6, Runner as d0, Tracer as dE, WorkflowEventRecorder as dP, SpanImpl as dm, registerPresetDispatcher as e$, attachRunnerRecoveryTranscript as eA, buildAssistantMessageFromLlmResult as eB, buildSystemPrompt as eC, buildToolResultMessage as eD, createAgent as eE, createHandoff as eF, createInMemorySession as eG, createInvariantSessionForAgent as eH, createStateWriter as eI, createTrace as eJ, createWorkflowProcessTracker as eK, defaultTracer as eL, detectInstructionsInjection as eM, discoverInstances as eN, executeRunnerToolCall as eO, extractAssistantTextFromMessage as eP, getActiveUserInteraction as eQ, getAdmittedAgentBindings as eR, hashMemoryIdentityComponent as eS, isAskUserCustomInputAnswer as eT, isFinalWorkflowProcessStatus as eU, isRunnableTool as eV, isRunnerLlmResult as eW, matchesMemoryApplicability as eX, memoryApplicabilityFingerprint as eY, normalizeHostMetadata as eZ, readRunnerRecoveryTranscript as e_, _resetAdmittedAgentBindings as ex, _resetPresetDispatchers as ey, asSingleSelection as ez, runAdmissionAudit as f0, setActiveUserInteraction as f1, setAdmittedAgentBindings as f2 };
4052
- export type { AgentFollowupResult as $, AgentDetail as B, AgentDispatchContext as C, AgentDispatchPolicy as D, AgentDispatchPolicyDecision as E, AgentDispatchPolicyInput as F, AgentDispatchabilitySnapshot as G, AgentDispatchabilityStatus as H, AgentEffectDeclaration as I, AgentEvent as J, AgentEventKind as K, AgentExecutionInput as L, AgentExecutionKind as M, AgentExecutionResult as N, AgentExecutor as O, AgentExecutorEvent as P, AgentExecutorFactory as Q, AgentExecutorFactoryContext as R, AgentExecutorPlane as S, AgentExecutorPlaneBackgroundErrorContext as T, AgentExecutorPlaneBackgroundErrorHandler as U, AgentExecutorPlaneBinding as V, AgentExecutorPlaneStore as W, AgentExecutorPreflightResult as X, AgentExecutorProtocol as Y, AgentExecutorTaskReference as Z, AgentExecutorTaskSnapshot as _, DispatchableAgentOrigin as a$, AgentForkTurns as a0, AgentInterruptScope as a1, AgentJsonObject as a2, AgentJsonValue as a3, AgentLimitReached as a4, AgentListEntry as a5, AgentMailboxMessage as a6, AgentManifest as a7, AgentMessage as a8, AgentMetadataValue as a9, AgentTreeSnapshot as aA, AgentTurn as aB, AgentTurnExecutor as aC, AgentTurnRef as aD, AgentTurnState as aE, AgentTurnSummary as aF, AskUserAnswer as aG, AskUserCustomInputAnswer as aH, AskUserMultiOptions as aI, AskUserQuestionItem as aJ, AskUserQuestionOptions as aK, AskUserSelectionAnswer as aL, CapabilitySupport as aM, CompactionAnchor as aN, CompactionConfig as aO, CompactionDetails as aP, CompactionResult as aQ, CompactionSpanData as aR, CompactionUpdate as aS, CreateAgentExecutorPlaneOptions as aT, CurrentTodoSummary as aU, Deliverable as aW, DiscoveredInstance as aX, DiscoveryOptions as aY, DispatchableAgentDescriptor as aZ, DispatchableAgentListing as a_, AgentMiddlewareDeclaration as aa, AgentMutationOptions as ab, AgentOutput as ac, AgentPreflightInput as ad, AgentPreflightResult as ae, AgentProgressItem as af, AgentProgressKind as ag, AgentProgressUpdate as ah, AgentReasoningProfile as ai, AgentRegistrationEnabledMutationOptions as aj, AgentRegistrationMutationOptions as ak, AgentRegistrationService as al, AgentSpanData as am, AgentSpawnInput as an, AgentTaskCancellation as ao, AgentTaskCorrelation as ap, AgentTaskEvent as aq, AgentTaskFilter as ar, AgentTaskProgress as as, AgentTaskRegistrationSnapshot as at, AgentTaskService as au, AgentTaskSnapshot as av, AgentTaskStartInput as aw, AgentTaskState as ax, AgentTaskUsage as ay, AgentTool as az, AdmissionAuditOptions as b, KodaXSessionUiToolCallStatus as b$, DispatchableAgentQuery as b0, EvidenceSpanData as b1, ExternalAgentEffectDeclaration as b2, ExternalAgentHealth as b3, ExternalAgentProtocol as b4, ExternalAgentRegistration as b5, ExternalAgentRegistrationSummary as b6, FanoutSpanData as b7, FileOperations as b8, GenerationSpanData as b9, KodaXMemoryOutcomeEvidence as bA, KodaXSessionArchiveMarkerEntry as bB, KodaXSessionArtifactLedgerEntry as bC, KodaXSessionBranchSummaryEntry as bD, KodaXSessionClientNoticeEntry as bE, KodaXSessionCompactionEntry as bF, KodaXSessionData as bG, KodaXSessionEntry as bH, KodaXSessionEntryBase as bI, KodaXSessionGoalEntry as bJ, KodaXSessionLabelEntry as bK, KodaXSessionLineage as bL, KodaXSessionMemoryOutcomeDigestEntry as bM, KodaXSessionMemoryReviewReceiptEntry as bN, KodaXSessionMessageEntry as bO, KodaXSessionMeta as bP, KodaXSessionNavigationOptions as bQ, KodaXSessionRewindMarkerEntry as bR, KodaXSessionRuntimeInfo as bS, KodaXSessionScope as bT, KodaXSessionStorage as bU, KodaXSessionTreeNode as bV, KodaXSessionUiHistoryItem as bW, KodaXSessionUiHistoryItemType as bX, KodaXSessionUiTextHistoryItem as bY, KodaXSessionUiTextHistoryItemType as bZ, KodaXSessionUiToolCall as b_, Guardrail as ba, GuardrailSpanData as bb, Handoff as bc, HandoffSpanData as bd, InMemorySessionOptions as be, InstanceDiscoveryFs as bf, InvariantId as bg, InvariantResult as bh, KodaXCompactMemoryProgress as bj, KodaXCompactMemorySeed as bk, KodaXExtensionSessionRecord as bl, KodaXExtensionSessionState as bm, KodaXExtensionStore as bn, KodaXExtensionStoreEntry as bo, KodaXFileInputArtifact as bp, KodaXGoalEventType as bq, KodaXGoalState as br, KodaXGoalStatus as bs, KodaXImageInputArtifact as bt, KodaXImageMediaType as bu, KodaXInputArtifact as bv, KodaXInputArtifactSource as bw, KodaXJsonValue as bx, KodaXMemoryInfluenceRef as by, KodaXMemoryOutcomeDigest as bz, AdmissionCtx as c, RunnableTool as c$, KodaXSessionUiToolGroupHistoryItem as c0, KodaXSessionWorkspaceKind as c1, KodaXVideoInputArtifact as c2, KodaXVideoMediaType as c3, LocalAgentTaskInput as c4, LocalAgentTaskUpdate as c5, ManifestPatch as c7, MemoryActionProposal as c8, MemoryApplicability as c9, MemoryRefKind as cA, MemoryRejectResult as cB, MemoryReviewCandidateRef as cC, MemoryReviewDraftAction as cD, MemoryReviewInput as cE, MemoryReviewModelInput as cF, MemoryReviewPersistenceDecision as cG, MemoryReviewPersistenceKind as cH, MemoryReviewPlan as cI, MemoryReviewRunner as cJ, MemoryReviewTrigger as cK, MemoryScope as cL, MemorySourceAdapter as cM, MemoryVisibility as cN, MessageEntry as cO, ObserveCtx as cP, PersistedSessionState as cQ, PresetDispatcher as cR, PresetTracingContext as cS, QualityInvariant as cT, ReadonlyMutationTracker as cU, ReadonlyRecorder as cV, ReasoningDepth as cW, RecentlyModifiedFile as cX, RunEvent as cY, RunOptions as cZ, RunResult as c_, MemoryApplyPreview as ca, MemoryApplyResult as cb, MemoryApproval as cc, MemoryAuthority as cd, MemoryAutoCuratorInput as ce, MemoryAutoCuratorResult as cf, MemoryBodySnapshot as cg, MemoryClaimKind as ch, MemoryContextIdentity as ci, MemoryController as cj, MemoryCuratorInput as ck, MemoryDecisionTraceReceipt as cl, MemoryEpisodeReviewResult as cm, MemoryEvent as cn, MemoryGovernanceFinding as co, MemoryGovernanceFindingKind as cp, MemoryGovernanceReport as cq, MemoryItemRef as cr, MemoryLifecycle as cs, MemoryLifecycleOperationResult as ct, MemoryPack as cu, MemoryPackHint as cv, MemoryPackInput as cw, MemoryPackTraceMetadata as cx, MemoryProposalAction as cy, MemoryRefFilter as cz, AdmissionVerdict as d, WorkflowOutcomeUsage as d$, RunnerEvent as d1, RunnerLlmResult as d2, RunnerLlmReturn as d3, RunnerRecoveryTranscriptCarrier as d4, RunnerToolCall as d5, RunnerToolContext as d6, RunnerToolObserver as d7, RunnerToolResult as d8, RunnerToolResultBatch as d9, ToolCapability as dA, ToolPermission as dB, Trace as dC, TraceOptions as dD, TracerOptions as dF, UserInteraction as dG, WorkflowAgentBackend as dH, WorkflowApi as dI, WorkflowApproval as dJ, WorkflowApprovalSummary as dK, WorkflowArtifactRef as dL, WorkflowBudget as dM, WorkflowEvent as dN, WorkflowEventCorrelation as dO, WorkflowEventType as dQ, WorkflowIsolation as dR, WorkflowLimits as dS, WorkflowLogEvent as dT, WorkflowMeta as dU, WorkflowModelHint as dV, WorkflowModule as dW, WorkflowOutcome as dX, WorkflowOutcomeError as dY, WorkflowOutcomeResult as dZ, WorkflowOutcomeStatus as d_, RunnerToolResultBatchTransform as da, Session as db, SessionDispatchResult as dc, SessionEntry as dd, SessionErrorMetadata as de, SessionExtension as df, SessionForkOptions as dg, SessionMeta as dh, SessionStateSnapshot as di, Span as dj, SpanData as dk, SpanError as dl, SpanImplOptions as dn, StartTraceOptions as dp, StateWriter as dq, StateWriterFs as dr, StateWriterOptions as ds, StopHookContext as dt, StopHookFn as du, StopHookResult as dv, StopHookSpanData as dw, SystemCap as dx, TerminalCtx as dy, ToolCallSpanData as dz, AdmittedHandle as e, WorkflowParallelOptions as e0, WorkflowProcessArtifact as e1, WorkflowProcessCounts as e2, WorkflowProcessEvent as e3, WorkflowProcessItem as e4, WorkflowProcessItemKind as e5, WorkflowProcessItemOrigin as e6, WorkflowProcessItemStatus as e7, WorkflowProcessProgress as e8, WorkflowProcessSnapshot as e9, WorkflowProcessSource as ea, WorkflowProcessStatus as eb, WorkflowProcessSummaryStatus as ec, WorkflowProcessTokenUsage as ed, WorkflowProcessTracker as ee, WorkflowProcessTrackerOptions as ef, WorkflowRun as eg, WorkflowRunState as eh, WorkflowRunStatus as ei, WorkflowSpawnAgentInput as ej, WorkflowSynthesis as ek, WorkflowSynthesizeInput as el, WorkflowTaskHandle as em, WorkflowTaskResult as en, WorkflowTaskSnapshot as eo, WorkflowTaskStatus as ep, WorkflowTaskSummaryEventUpdate as eq, WorkflowTaskSummaryKind as er, WorkflowTaskSummaryUpdate as es, WorkflowTaskUsage as et, WorkflowTaskVerification as eu, WorkflowTaskVerificationResult as ev, WorkflowWaitOptions as ew, Agent as f, AgentActor as g, AgentActorClient as h, AgentActorSnapshot as i, AgentActorState as j, AgentActorStore as k, AgentArtifactDescriptor as l, AgentArtifactPolicy as m, AgentArtifactPolicyDecision as n, AgentArtifactPolicyInput as o, AgentArtifactReference as p, AgentBudgetAdmission as q, AgentBudgetAdmissionInput as r, AgentBudgetExhausted as s, AgentBudgetPort as t, AgentCapabilities as u, AgentCapabilityDeclaration as v, AgentCapabilityRequirements as w, AgentContinuationInput as x, AgentCredentialBroker as y, AgentDataClassification as z };
4100
+ export { ASK_USER_BACK_SIGNAL as A, ASK_USER_CUSTOM_INPUT_SIGNAL as a, DEFAULT_SYSTEM_CAP as aW, InvariantSession as bj, MAX_TOOL_LOOP_ITERATIONS as c7, Runner as d1, Tracer as dF, WorkflowEventRecorder as dQ, SpanImpl as dn, readRunnerRecoveryTranscript as e$, asSingleSelection as eA, attachRunnerRecoveryTranscript as eB, buildAssistantMessageFromLlmResult as eC, buildSystemPrompt as eD, buildToolResultMessage as eE, createAgent as eF, createHandoff as eG, createInMemorySession as eH, createInvariantSessionForAgent as eI, createStateWriter as eJ, createTrace as eK, createWorkflowProcessTracker as eL, defaultTracer as eM, detectInstructionsInjection as eN, discoverInstances as eO, executeRunnerToolCall as eP, extractAssistantTextFromMessage as eQ, getActiveUserInteraction as eR, getAdmittedAgentBindings as eS, hashMemoryIdentityComponent as eT, isAskUserCustomInputAnswer as eU, isFinalWorkflowProcessStatus as eV, isRunnableTool as eW, isRunnerLlmResult as eX, matchesMemoryApplicability as eY, memoryApplicabilityFingerprint as eZ, normalizeHostMetadata as e_, _resetAdmittedAgentBindings as ey, _resetPresetDispatchers as ez, registerPresetDispatcher as f0, runAdmissionAudit as f1, setActiveUserInteraction as f2, setAdmittedAgentBindings as f3 };
4101
+ export type { AgentFollowupResult as $, AgentDetail as B, AgentDispatchContext as C, AgentDispatchPolicy as D, AgentDispatchPolicyDecision as E, AgentDispatchPolicyInput as F, AgentDispatchabilitySnapshot as G, AgentDispatchabilityStatus as H, AgentEffectDeclaration as I, AgentEvent as J, AgentEventKind as K, AgentExecutionInput as L, AgentExecutionKind as M, AgentExecutionResult as N, AgentExecutor as O, AgentExecutorEvent as P, AgentExecutorFactory as Q, AgentExecutorFactoryContext as R, AgentExecutorPlane as S, AgentExecutorPlaneBackgroundErrorContext as T, AgentExecutorPlaneBackgroundErrorHandler as U, AgentExecutorPlaneBinding as V, AgentExecutorPlaneStore as W, AgentExecutorPreflightResult as X, AgentExecutorProtocol as Y, AgentExecutorTaskReference as Z, AgentExecutorTaskSnapshot as _, DispatchableAgentListing as a$, AgentForkTurns as a0, AgentInterruptScope as a1, AgentJsonObject as a2, AgentJsonValue as a3, AgentLimitReached as a4, AgentListEntry as a5, AgentMailboxMessage as a6, AgentManifest as a7, AgentMessage as a8, AgentMetadataValue as a9, AgentTreeSnapshot as aA, AgentTurn as aB, AgentTurnExecutor as aC, AgentTurnRef as aD, AgentTurnState as aE, AgentTurnSummary as aF, AskUserAnswer as aG, AskUserCustomInputAnswer as aH, AskUserMultiOptions as aI, AskUserQuestionItem as aJ, AskUserQuestionOptions as aK, AskUserSelectionAnswer as aL, CapabilitySupport as aM, CompactionAnchor as aN, CompactionConfig as aO, CompactionDetails as aP, CompactionReport as aQ, CompactionResult as aR, CompactionSpanData as aS, CompactionUpdate as aT, CreateAgentExecutorPlaneOptions as aU, CurrentTodoSummary as aV, Deliverable as aX, DiscoveredInstance as aY, DiscoveryOptions as aZ, DispatchableAgentDescriptor as a_, AgentMiddlewareDeclaration as aa, AgentMutationOptions as ab, AgentOutput as ac, AgentPreflightInput as ad, AgentPreflightResult as ae, AgentProgressItem as af, AgentProgressKind as ag, AgentProgressUpdate as ah, AgentReasoningProfile as ai, AgentRegistrationEnabledMutationOptions as aj, AgentRegistrationMutationOptions as ak, AgentRegistrationService as al, AgentSpanData as am, AgentSpawnInput as an, AgentTaskCancellation as ao, AgentTaskCorrelation as ap, AgentTaskEvent as aq, AgentTaskFilter as ar, AgentTaskProgress as as, AgentTaskRegistrationSnapshot as at, AgentTaskService as au, AgentTaskSnapshot as av, AgentTaskStartInput as aw, AgentTaskState as ax, AgentTaskUsage as ay, AgentTool as az, AdmissionAuditOptions as b, KodaXSessionUiToolCall as b$, DispatchableAgentOrigin as b0, DispatchableAgentQuery as b1, EvidenceSpanData as b2, ExternalAgentEffectDeclaration as b3, ExternalAgentHealth as b4, ExternalAgentProtocol as b5, ExternalAgentRegistration as b6, ExternalAgentRegistrationSummary as b7, FanoutSpanData as b8, FileOperations as b9, KodaXMemoryOutcomeDigest as bA, KodaXMemoryOutcomeEvidence as bB, KodaXSessionArchiveMarkerEntry as bC, KodaXSessionArtifactLedgerEntry as bD, KodaXSessionBranchSummaryEntry as bE, KodaXSessionClientNoticeEntry as bF, KodaXSessionCompactionEntry as bG, KodaXSessionData as bH, KodaXSessionEntry as bI, KodaXSessionEntryBase as bJ, KodaXSessionGoalEntry as bK, KodaXSessionLabelEntry as bL, KodaXSessionLineage as bM, KodaXSessionMemoryOutcomeDigestEntry as bN, KodaXSessionMemoryReviewReceiptEntry as bO, KodaXSessionMessageEntry as bP, KodaXSessionMeta as bQ, KodaXSessionNavigationOptions as bR, KodaXSessionRewindMarkerEntry as bS, KodaXSessionRuntimeInfo as bT, KodaXSessionScope as bU, KodaXSessionStorage as bV, KodaXSessionTreeNode as bW, KodaXSessionUiHistoryItem as bX, KodaXSessionUiHistoryItemType as bY, KodaXSessionUiTextHistoryItem as bZ, KodaXSessionUiTextHistoryItemType as b_, GenerationSpanData as ba, Guardrail as bb, GuardrailSpanData as bc, Handoff as bd, HandoffSpanData as be, InMemorySessionOptions as bf, InstanceDiscoveryFs as bg, InvariantId as bh, InvariantResult as bi, KodaXCompactMemoryProgress as bk, KodaXCompactMemorySeed as bl, KodaXExtensionSessionRecord as bm, KodaXExtensionSessionState as bn, KodaXExtensionStore as bo, KodaXExtensionStoreEntry as bp, KodaXFileInputArtifact as bq, KodaXGoalEventType as br, KodaXGoalState as bs, KodaXGoalStatus as bt, KodaXImageInputArtifact as bu, KodaXImageMediaType as bv, KodaXInputArtifact as bw, KodaXInputArtifactSource as bx, KodaXJsonValue as by, KodaXMemoryInfluenceRef as bz, AdmissionCtx as c, RunResult as c$, KodaXSessionUiToolCallStatus as c0, KodaXSessionUiToolGroupHistoryItem as c1, KodaXSessionWorkspaceKind as c2, KodaXVideoInputArtifact as c3, KodaXVideoMediaType as c4, LocalAgentTaskInput as c5, LocalAgentTaskUpdate as c6, ManifestPatch as c8, MemoryActionProposal as c9, MemoryRefFilter as cA, MemoryRefKind as cB, MemoryRejectResult as cC, MemoryReviewCandidateRef as cD, MemoryReviewDraftAction as cE, MemoryReviewInput as cF, MemoryReviewModelInput as cG, MemoryReviewPersistenceDecision as cH, MemoryReviewPersistenceKind as cI, MemoryReviewPlan as cJ, MemoryReviewRunner as cK, MemoryReviewTrigger as cL, MemoryScope as cM, MemorySourceAdapter as cN, MemoryVisibility as cO, MessageEntry as cP, ObserveCtx as cQ, PersistedSessionState as cR, PresetDispatcher as cS, PresetTracingContext as cT, QualityInvariant as cU, ReadonlyMutationTracker as cV, ReadonlyRecorder as cW, ReasoningDepth as cX, RecentlyModifiedFile as cY, RunEvent as cZ, RunOptions as c_, MemoryApplicability as ca, MemoryApplyPreview as cb, MemoryApplyResult as cc, MemoryApproval as cd, MemoryAuthority as ce, MemoryAutoCuratorInput as cf, MemoryAutoCuratorResult as cg, MemoryBodySnapshot as ch, MemoryClaimKind as ci, MemoryContextIdentity as cj, MemoryController as ck, MemoryCuratorInput as cl, MemoryDecisionTraceReceipt as cm, MemoryEpisodeReviewResult as cn, MemoryEvent as co, MemoryGovernanceFinding as cp, MemoryGovernanceFindingKind as cq, MemoryGovernanceReport as cr, MemoryItemRef as cs, MemoryLifecycle as ct, MemoryLifecycleOperationResult as cu, MemoryPack as cv, MemoryPackHint as cw, MemoryPackInput as cx, MemoryPackTraceMetadata as cy, MemoryProposalAction as cz, AdmissionVerdict as d, WorkflowOutcomeStatus as d$, RunnableTool as d0, RunnerEvent as d2, RunnerLlmResult as d3, RunnerLlmReturn as d4, RunnerRecoveryTranscriptCarrier as d5, RunnerToolCall as d6, RunnerToolContext as d7, RunnerToolObserver as d8, RunnerToolResult as d9, ToolCallSpanData as dA, ToolCapability as dB, ToolPermission as dC, Trace as dD, TraceOptions as dE, TracerOptions as dG, UserInteraction as dH, WorkflowAgentBackend as dI, WorkflowApi as dJ, WorkflowApproval as dK, WorkflowApprovalSummary as dL, WorkflowArtifactRef as dM, WorkflowBudget as dN, WorkflowEvent as dO, WorkflowEventCorrelation as dP, WorkflowEventType as dR, WorkflowIsolation as dS, WorkflowLimits as dT, WorkflowLogEvent as dU, WorkflowMeta as dV, WorkflowModelHint as dW, WorkflowModule as dX, WorkflowOutcome as dY, WorkflowOutcomeError as dZ, WorkflowOutcomeResult as d_, RunnerToolResultBatch as da, RunnerToolResultBatchTransform as db, Session as dc, SessionDispatchResult as dd, SessionEntry as de, SessionErrorMetadata as df, SessionExtension as dg, SessionForkOptions as dh, SessionMeta as di, SessionStateSnapshot as dj, Span as dk, SpanData as dl, SpanError as dm, SpanImplOptions as dp, StartTraceOptions as dq, StateWriter as dr, StateWriterFs as ds, StateWriterOptions as dt, StopHookContext as du, StopHookFn as dv, StopHookResult as dw, StopHookSpanData as dx, SystemCap as dy, TerminalCtx as dz, AdmittedHandle as e, WorkflowOutcomeUsage as e0, WorkflowParallelOptions as e1, WorkflowProcessArtifact as e2, WorkflowProcessCounts as e3, WorkflowProcessEvent as e4, WorkflowProcessItem as e5, WorkflowProcessItemKind as e6, WorkflowProcessItemOrigin as e7, WorkflowProcessItemStatus as e8, WorkflowProcessProgress as e9, WorkflowProcessSnapshot as ea, WorkflowProcessSource as eb, WorkflowProcessStatus as ec, WorkflowProcessSummaryStatus as ed, WorkflowProcessTokenUsage as ee, WorkflowProcessTracker as ef, WorkflowProcessTrackerOptions as eg, WorkflowRun as eh, WorkflowRunState as ei, WorkflowRunStatus as ej, WorkflowSpawnAgentInput as ek, WorkflowSynthesis as el, WorkflowSynthesizeInput as em, WorkflowTaskHandle as en, WorkflowTaskResult as eo, WorkflowTaskSnapshot as ep, WorkflowTaskStatus as eq, WorkflowTaskSummaryEventUpdate as er, WorkflowTaskSummaryKind as es, WorkflowTaskSummaryUpdate as et, WorkflowTaskUsage as eu, WorkflowTaskVerification as ev, WorkflowTaskVerificationResult as ew, WorkflowWaitOptions as ex, Agent as f, AgentActor as g, AgentActorClient as h, AgentActorSnapshot as i, AgentActorState as j, AgentActorStore as k, AgentArtifactDescriptor as l, AgentArtifactPolicy as m, AgentArtifactPolicyDecision as n, AgentArtifactPolicyInput as o, AgentArtifactReference as p, AgentBudgetAdmission as q, AgentBudgetAdmissionInput as r, AgentBudgetExhausted as s, AgentBudgetPort as t, AgentCapabilities as u, AgentCapabilityDeclaration as v, AgentCapabilityRequirements as w, AgentContinuationInput as x, AgentCredentialBroker as y, AgentDataClassification as z };