@kodax-ai/kodax 0.7.73 → 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 (69) hide show
  1. package/CHANGELOG.md +134 -0
  2. package/README.md +26 -6
  3. package/README_CN.md +23 -5
  4. package/config-templates/config.example.jsonc +7 -0
  5. package/dist/chunks/{agent-T6PGT6AU.js → agent-2ABIG5NW.js} +1 -1
  6. package/dist/chunks/argument-completer-C45DEO34.js +2 -0
  7. package/dist/chunks/chunk-5GH3SVI3.js +74 -0
  8. package/dist/chunks/{chunk-6JTWXGVU.js → chunk-7W6KYJU2.js} +225 -225
  9. package/dist/chunks/chunk-C7TZAT3S.js +369 -0
  10. package/dist/chunks/chunk-KPGVY6PF.js +321 -0
  11. package/dist/chunks/{chunk-6RI2RBTF.js → chunk-MVCAFD6M.js} +1 -1
  12. package/dist/chunks/{chunk-BUPJGG3C.js → chunk-PP53SIIL.js} +1 -1
  13. package/dist/chunks/chunk-QH56WEHK.js +2 -0
  14. package/dist/chunks/chunk-UJS7JAO6.js +770 -0
  15. package/dist/chunks/{chunk-M7FXNPWV.js → chunk-VK5QTHS6.js} +6 -6
  16. package/dist/chunks/chunk-VPURXE2F.js +427 -0
  17. package/dist/chunks/chunk-XM724XAA.js +329 -0
  18. package/dist/chunks/{chunk-MLEAQTCD.js → chunk-XMP66YWG.js} +11 -4
  19. package/dist/chunks/{compaction-config-IHJBP4GO.js → compaction-config-QYCDOW3Q.js} +1 -1
  20. package/dist/chunks/{construction-bootstrap-EGRUHKLP.js → construction-bootstrap-BKNPJI7O.js} +1 -1
  21. package/dist/chunks/dist-6EK4H7TP.js +2 -0
  22. package/dist/chunks/host-KS4TJKWQ.js +2 -0
  23. package/dist/chunks/{run-manager-AY7RQOWM.js → run-manager-L7MKGQNX.js} +1 -1
  24. package/dist/chunks/{utils-2GAE4XIM.js → utils-GTJLL4GT.js} +1 -1
  25. package/dist/index.d.ts +12 -11
  26. package/dist/index.js +5 -5
  27. package/dist/kodax_cli.js +1295 -1253
  28. package/dist/runtime-worker.js +1208 -1166
  29. package/dist/sdk-a2a.d.ts +9 -8
  30. package/dist/sdk-a2a.js +1 -1
  31. package/dist/sdk-agent.d.ts +107 -59
  32. package/dist/sdk-agent.js +1 -1
  33. package/dist/sdk-coding.d.ts +32 -16
  34. package/dist/sdk-coding.js +1 -1
  35. package/dist/sdk-mcp.js +1 -1
  36. package/dist/sdk-media.js +1 -1
  37. package/dist/sdk-repl.d.ts +27 -20
  38. package/dist/sdk-repl.js +2 -2
  39. package/dist/sdk-runtime.d.ts +151 -14
  40. package/dist/sdk-runtime.js +1 -1
  41. package/dist/sdk-session.d.ts +4 -4
  42. package/dist/sdk-session.js +1 -1
  43. package/dist/sdk-skills.js +1 -1
  44. package/dist/semantic-worker.js +16 -14
  45. package/dist/types-chunks/{bash-prefix-extractor.d-bApf5nGw.d.ts → bash-prefix-extractor.d-r1beOESM.d.ts} +48 -12
  46. package/dist/types-chunks/{capsule.d-CGWltwno.d.ts → capsule.d-zeqV4IQX.d.ts} +10 -2
  47. package/dist/types-chunks/{commands.d-CEHGwRok.d.ts → commands.d-DUxnK2TU.d.ts} +10 -7
  48. package/dist/types-chunks/{guardrail.d-CC4vAQl7.d.ts → guardrail.d-CWYD1bdL.d.ts} +1 -1
  49. package/dist/types-chunks/{guardrail.d-CXIPlWP3.d.ts → guardrail.d-qjuKJZ31.d.ts} +72 -11
  50. package/dist/types-chunks/history-retrieval.d-BKTJIrVd.d.ts +57 -0
  51. package/dist/types-chunks/{public-api.d-FBmX0kxo.d.ts → public-api.d-CX4B11qY.d.ts} +17 -4
  52. package/dist/types-chunks/{run-manager.d-DUNnJcpE.d.ts → run-manager.d-B9fEIjZk.d.ts} +1 -1
  53. package/dist/types-chunks/{sdk-session-XqacVOs8.d.ts → sdk-session-B0fhAOPa.d.ts} +2 -2
  54. package/dist/types-chunks/{types.d-DKr6TCXL.d.ts → types.d-Bm_y6YuM.d.ts} +2 -2
  55. package/dist/types-chunks/{types.d-DgciGHoG.d.ts → types.d-DEctY20M.d.ts} +9 -2
  56. package/dist/types-chunks/{types.d-BnPhGmar.d.ts → types.d-sRLugmjy.d.ts} +61 -14
  57. package/dist/types-chunks/{utils.d-BPYX7-KN.d.ts → utils.d-D0wPxz8y.d.ts} +5 -5
  58. package/docs/SDK_EMBEDDER_GUIDE.md +1956 -1684
  59. package/package.json +8 -1
  60. package/dist/chunks/argument-completer-QGMWA2C3.js +0 -2
  61. package/dist/chunks/chunk-AGDDM5AW.js +0 -329
  62. package/dist/chunks/chunk-EAD4SF3Z.js +0 -413
  63. package/dist/chunks/chunk-HVCNAZ52.js +0 -365
  64. package/dist/chunks/chunk-OG6DRNKV.js +0 -755
  65. package/dist/chunks/chunk-PFH53O4M.js +0 -2
  66. package/dist/chunks/chunk-V4F6IYNK.js +0 -73
  67. package/dist/chunks/chunk-WQ6PWGK5.js +0 -320
  68. package/dist/chunks/dist-5N3I2RTW.js +0 -2
  69. package/dist/chunks/host-MECITNE3.js +0 -2
@@ -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;
@@ -1946,6 +1956,13 @@ interface RunOptions {
1946
1956
  * supplied, each generated message is appended as a `message` entry.
1947
1957
  */
1948
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>;
1949
1966
  /**
1950
1967
  * Abort signal forwarded to preset dispatchers that honor it.
1951
1968
  */
@@ -2103,6 +2120,8 @@ interface RunOptions {
2103
2120
  readonly agent: Agent;
2104
2121
  readonly transcript: readonly AgentMessage[];
2105
2122
  readonly iteration: number;
2123
+ /** Executed tool names from the iteration that reached this boundary. */
2124
+ readonly lastTurnToolNames: readonly string[];
2106
2125
  }) => Promise<readonly AgentMessage[]>;
2107
2126
  /**
2108
2127
  * FEATURE_166 (v0.7.41 follow-up) — agent-switch hook.
@@ -3038,30 +3057,38 @@ type MemoryEvent = {
3038
3057
  */
3039
3058
 
3040
3059
  interface CompactionConfig {
3041
- /** Whether automatic compaction is enabled. */
3060
+ /** @deprecated Automatic large compaction is always enabled. */
3042
3061
  enabled: boolean;
3043
3062
  /**
3044
- * Optional early trigger percentage. `100` means capacity-only; values below
3045
- * 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.
3046
3065
  */
3047
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;
3048
3072
  /**
3049
3073
  * @deprecated V2 compaction no longer uses this option.
3050
- *
3051
- * The system now combines protected recent context, lightweight pruning, and
3052
- * rolling summaries automatically.
3074
+ * FEATURE_272 derives protection from the effective trigger and covers the
3075
+ * complete eligible prefix in one logical wave.
3053
3076
  */
3054
3077
  keepRecentPercent?: number;
3055
- /** 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
+ */
3056
3082
  protectionPercent?: number;
3057
3083
  /**
3058
- * Percentage of the context window used as the chunk size for each rolling
3059
- * summary pass. Defaults to 10.
3084
+ * @deprecated FEATURE_272 replaces rolling summary passes with one complete
3085
+ * eligible-prefix wave. Retained for source compatibility.
3060
3086
  */
3061
3087
  rollingSummaryPercent?: number;
3062
3088
  /**
3063
- * Explicit legacy opt-in for destructive pre-summary tool-result pruning.
3064
- * 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.
3065
3092
  */
3066
3093
  pruningThresholdTokens?: number;
3067
3094
  /**
@@ -3087,6 +3114,12 @@ interface CompactionAnchor {
3087
3114
  memorySeed?: KodaXCompactMemorySeed;
3088
3115
  }
3089
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[];
3090
3123
  anchor?: CompactionAnchor;
3091
3124
  artifactLedger?: KodaXSessionArtifactLedgerEntry[];
3092
3125
  memorySeed?: KodaXCompactMemorySeed;
@@ -3101,6 +3134,19 @@ interface CompactionUpdate {
3101
3134
  * is the persistence source of truth.
3102
3135
  */
3103
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;
3104
3150
  }
3105
3151
  interface CompactionResult {
3106
3152
  compacted: boolean;
@@ -3113,6 +3159,7 @@ interface CompactionResult {
3113
3159
  artifactLedger?: KodaXSessionArtifactLedgerEntry[];
3114
3160
  anchor?: CompactionAnchor;
3115
3161
  memorySeed?: KodaXCompactMemorySeed;
3162
+ report?: CompactionReport;
3116
3163
  }
3117
3164
  interface FileOperations {
3118
3165
  readFiles: string[];
@@ -4050,5 +4097,5 @@ interface CreateAgentExecutorPlaneOptions {
4050
4097
  readonly closeTimeoutMs?: number;
4051
4098
  }
4052
4099
 
4053
- 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 };
4054
- 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 };
@@ -1,9 +1,9 @@
1
1
  import { k as KodaXMessage, F as KodaXReasoningMode, d as KodaXCustomProviderConfig, p as KodaXProviderCapabilityProfile } from './types.d-CSmF0t0n.js';
2
- import { M as KodaXContextTokenSnapshot, ah as KodaXSkillDynamicContextPolicy, t as KodaXAgentMode, a4 as KodaXRepoIntelligenceMode, $ as KodaXOptions, ai as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-bApf5nGw.js';
3
- import { bW as KodaXSessionUiHistoryItem, bL as KodaXSessionLineage, bC as KodaXSessionArtifactLedgerEntry, bm as KodaXExtensionSessionState, bl as KodaXExtensionSessionRecord, bS as KodaXSessionRuntimeInfo, ea as WorkflowProcessSource } from './types.d-BnPhGmar.js';
4
- import { d as AgentsFile, j as AutoModeStats, p as KodaXMcpServersConfig } from './guardrail.d-CXIPlWP3.js';
2
+ import { O as KodaXContextTokenSnapshot, aj as KodaXSkillDynamicContextPolicy, t as KodaXAgentMode, a6 as KodaXRepoIntelligenceMode, a1 as KodaXOptions, ak as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-r1beOESM.js';
3
+ import { bX as KodaXSessionUiHistoryItem, bM as KodaXSessionLineage, bD as KodaXSessionArtifactLedgerEntry, bn as KodaXExtensionSessionState, bm as KodaXExtensionSessionRecord, bT as KodaXSessionRuntimeInfo, eb as WorkflowProcessSource } from './types.d-sRLugmjy.js';
4
+ import { d as AgentsFile, r as AutoModeStats, x as KodaXMcpServersConfig } from './guardrail.d-qjuKJZ31.js';
5
5
  import * as readline from 'readline';
6
- import { R as PermissionMode, L as LearningBinding, E as LearningSurfaceSnapshot } from './public-api.d-FBmX0kxo.js';
6
+ import { R as PermissionMode, L as LearningBinding, E as LearningSurfaceSnapshot } from './public-api.d-CX4B11qY.js';
7
7
  import { SpawnSyncReturns } from 'child_process';
8
8
 
9
9
  /**
@@ -32,7 +32,7 @@ interface AutoModeSettings {
32
32
  /**
33
33
  * Starting engine for the session.
34
34
  * - `'llm'` (default): classifier runs on every non-Tier-1 tool call
35
- * - `'rules'`: classifier skipped; every non-Tier-1 call escalates to askUser
35
+ * - `'rules'`: classifier skipped; deterministic workspace/temp Tier 2 applies
36
36
  * Engine downgrades stay sticky within the session regardless of this value.
37
37
  */
38
38
  engine?: 'llm' | 'rules';