@kodax-ai/kodax 0.7.66 → 0.7.68

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 (82) hide show
  1. package/CHANGELOG.md +180 -3
  2. package/README.md +51 -16
  3. package/README_CN.md +34 -13
  4. package/dist/chunks/agent-DATNZOBK.js +2 -0
  5. package/dist/chunks/argument-completer-X7MMM7Y6.js +2 -0
  6. package/dist/chunks/chunk-5GL55MOH.js +36 -0
  7. package/dist/chunks/chunk-67XJ4YUA.js +703 -0
  8. package/dist/chunks/chunk-C4SBXBWH.js +346 -0
  9. package/dist/chunks/{chunk-ALS32RNZ.js → chunk-CC4BVVE7.js} +9 -9
  10. package/dist/chunks/{chunk-VS4CDDEF.js → chunk-CTHUX5ZH.js} +221 -221
  11. package/dist/chunks/{chunk-YRBNXFHY.js → chunk-HFM2D5BP.js} +1 -1
  12. package/dist/chunks/chunk-HLBHSA2B.js +325 -0
  13. package/dist/chunks/{chunk-O7N22GJ3.js → chunk-K2NCKRVY.js} +16 -14
  14. package/dist/chunks/chunk-KGAI32VS.js +22 -0
  15. package/dist/chunks/{chunk-QAQ2HNXD.js → chunk-KIQRCGVR.js} +126 -112
  16. package/dist/chunks/chunk-MP52BDK5.js +15 -0
  17. package/dist/chunks/chunk-O5OJQFPY.js +307 -0
  18. package/dist/chunks/chunk-OIELNE6Z.js +56 -0
  19. package/dist/chunks/chunk-PEGSHZAA.js +5 -0
  20. package/dist/chunks/chunk-TOGESFRN.js +2 -0
  21. package/dist/chunks/compaction-config-BXEDHIQP.js +2 -0
  22. package/dist/chunks/{construction-bootstrap-3XDS2D5K.js → construction-bootstrap-PYWJHO35.js} +1 -1
  23. package/dist/chunks/dist-76PJHNSG.js +2 -0
  24. package/dist/chunks/{dist-4PXB7U22.js → dist-HTDJRAD6.js} +1 -1
  25. package/dist/chunks/host-UAXIDZ6V.js +2 -0
  26. package/dist/chunks/run-manager-UCXB4G22.js +2 -0
  27. package/dist/chunks/utils-S63V5UCM.js +2 -0
  28. package/dist/index.d.ts +19 -16
  29. package/dist/index.js +6 -6
  30. package/dist/kodax_cli.js +1292 -1255
  31. package/dist/runtime-worker.js +1196 -1153
  32. package/dist/sdk-agent.d.ts +143 -18
  33. package/dist/sdk-agent.js +1 -1
  34. package/dist/sdk-coding.d.ts +281 -20
  35. package/dist/sdk-coding.js +1 -1
  36. package/dist/sdk-experimental-memory.d.ts +618 -0
  37. package/dist/sdk-experimental-memory.js +2 -0
  38. package/dist/sdk-llm.d.ts +6 -6
  39. package/dist/sdk-llm.js +1 -1
  40. package/dist/sdk-mcp.js +1 -1
  41. package/dist/sdk-media.d.ts +1 -1
  42. package/dist/sdk-repl.d.ts +26 -17
  43. package/dist/sdk-repl.js +2 -2
  44. package/dist/sdk-runtime.d.ts +102 -14
  45. package/dist/sdk-runtime.js +1 -1
  46. package/dist/sdk-session.d.ts +6 -6
  47. package/dist/sdk-session.js +1 -1
  48. package/dist/sdk-skills.js +1 -1
  49. package/dist/semantic-worker.js +12 -12
  50. package/dist/types-chunks/{base.d-DalIRhbb.d.ts → base.d-C8mXDhLL.d.ts} +1 -1
  51. package/dist/types-chunks/{bash-prefix-extractor.d-BjkITAva.d.ts → bash-prefix-extractor.d-Dm-T865v.d.ts} +67 -12
  52. package/dist/types-chunks/{capability-learning.d-BQB0M70w.d.ts → capability-learning.d-BLEmCib0.d.ts} +1 -1
  53. package/dist/types-chunks/{capsule.d-hVhPNkHd.d.ts → capsule.d-CzaamUUv.d.ts} +5 -5
  54. package/dist/types-chunks/{commands.d-C3B1TdGM.d.ts → commands.d-DxKjVSNU.d.ts} +4 -4
  55. package/dist/types-chunks/{guardrail.d-wk-s0psS.d.ts → guardrail.d-CPDfZyJp.d.ts} +3 -3
  56. package/dist/types-chunks/{guardrail.d-C_Siraua.d.ts → guardrail.d-D7r6zVSR.d.ts} +1 -1
  57. package/dist/types-chunks/{public-api.d-jtREVfEq.d.ts → public-api.d-BcKbBy1E.d.ts} +12 -7
  58. package/dist/types-chunks/{resolver.d-CGkfRULj.d.ts → resolver.d-DmBnoilY.d.ts} +2 -2
  59. package/dist/types-chunks/{run-manager.d-CFknOfo1.d.ts → run-manager.d-CSj7_kWk.d.ts} +1 -1
  60. package/dist/types-chunks/{sdk-session-CLqyfAmf.d.ts → sdk-session-C6nDgyh8.d.ts} +4 -4
  61. package/dist/types-chunks/{types.d-Bp4Lm1jv.d.ts → types.d-CO_ZkmOd.d.ts} +6 -1
  62. package/dist/types-chunks/{types.d-CUN_bZU7.d.ts → types.d-CzscbsG0.d.ts} +4 -4
  63. package/dist/types-chunks/{process.d-CY2g03Mb.d.ts → types.d-D2frCRaY.d.ts} +505 -10
  64. package/dist/types-chunks/{types.d-BMLxKV69.d.ts → types.d-D9FKbAmf.d.ts} +2 -2
  65. package/dist/types-chunks/{utils.d-C1rpoeDh.d.ts → utils.d-DOXxnOnI.d.ts} +9 -5
  66. package/docs/SDK_EMBEDDER_GUIDE.md +3179 -0
  67. package/package.json +6 -1
  68. package/dist/chunks/agent-KER4WDNO.js +0 -2
  69. package/dist/chunks/argument-completer-HK3MHA3K.js +0 -2
  70. package/dist/chunks/chunk-3HKBBY74.js +0 -339
  71. package/dist/chunks/chunk-AKBH2EEE.js +0 -8
  72. package/dist/chunks/chunk-MHRN2LQV.js +0 -328
  73. package/dist/chunks/chunk-NBQW7PNZ.js +0 -18
  74. package/dist/chunks/chunk-QJVZZSEO.js +0 -56
  75. package/dist/chunks/chunk-TLJGOKBT.js +0 -729
  76. package/dist/chunks/chunk-WBBEJIAY.js +0 -306
  77. package/dist/chunks/chunk-WMIZCY2J.js +0 -2
  78. package/dist/chunks/compaction-config-7GMUFNPB.js +0 -2
  79. package/dist/chunks/dist-4YAYT2TO.js +0 -2
  80. package/dist/chunks/host-KG3456QP.js +0 -2
  81. package/dist/chunks/run-manager-6CAH3KTA.js +0 -2
  82. package/dist/chunks/utils-OT5ENFUL.js +0 -2
@@ -1,4 +1,4 @@
1
- import { p as KodaXProviderConfig, j as KodaXMessage, a0 as KodaXToolDefinition, G as KodaXReasoningRequest, x as KodaXProviderStreamOptions, M as KodaXStreamResult, a6 as KodaXVerifyCredentialResult, k as KodaXModelDescriptor, o as KodaXProviderCapabilityProfile, A as KodaXReasoningCapability, F as KodaXReasoningProfile, m as KodaXNormalizedReasoningRequest, a8 as KodaXWireReasoningEffort } from './types.d-Bp4Lm1jv.js';
1
+ import { q as KodaXProviderConfig, k as KodaXMessage, a1 as KodaXToolDefinition, H as KodaXReasoningRequest, y as KodaXProviderStreamOptions, N as KodaXStreamResult, a7 as KodaXVerifyCredentialResult, l as KodaXModelDescriptor, p as KodaXProviderCapabilityProfile, B as KodaXReasoningCapability, G as KodaXReasoningProfile, n as KodaXNormalizedReasoningRequest, a9 as KodaXWireReasoningEffort } from './types.d-CO_ZkmOd.js';
2
2
 
3
3
  /**
4
4
  * Retry-After header parsing — FEATURE_130 (v0.7.36).
@@ -1,10 +1,10 @@
1
- import { _ as KodaXGoalState, h as AgentMessage, bM as StopHookFn, af as KodaXSessionLineage, a4 as KodaXJsonValue, U as KodaXExtensionSessionRecord, f as Agent, c8 as WorkflowIsolation, V as KodaXExtensionSessionState, a6 as KodaXSessionArtifactLedgerEntry, bx as SessionErrorMetadata, al as KodaXSessionScope, am as KodaXSessionStorage, a2 as KodaXInputArtifact, C as ChildTaskRegistry, c5 as WorkflowEventCorrelation, x as CompactionUpdate, ch as WorkflowProcessEvent, c4 as WorkflowEvent, q as AskUserQuestionOptions, m as AskUserAnswer, o as AskUserMultiOptions, b0 as MemoryReviewPlan, b1 as MemoryReviewRunner, J as Guardrail, B as DiscoveredInstance, bQ as TaskAbortRegistry } from './process.d-CY2g03Mb.js';
2
- import { $ as KodaXTokenUsage, j as KodaXMessage, a0 as KodaXToolDefinition, a8 as KodaXWireReasoningEffort, T as KodaXTaskRoutingDecision, U as KodaXTaskType, V as KodaXTaskWorkIntent, P as KodaXTaskComplexity, J as KodaXRiskLevel, g as KodaXHarnessProfile, e as KodaXExecutionMode, b as KodaXChildFanoutClass, E as KodaXReasoningMode, I as KodaXReviewScale } from './types.d-Bp4Lm1jv.js';
1
+ import { aN as KodaXGoalState, I as AgentMessage, cO as StopHookFn, b5 as KodaXSessionLineage, aT as KodaXJsonValue, aH as KodaXExtensionSessionRecord, f as Agent, da as WorkflowIsolation, aI as KodaXExtensionSessionState, aY as KodaXSessionArtifactLedgerEntry, cz as SessionErrorMetadata, bd as KodaXSessionScope, be as KodaXSessionStorage, bE as MemoryContextIdentity, bQ as MemoryPack, aR as KodaXInputArtifact, B as AgentExecutorPlaneBinding, a6 as ChildTaskRegistry, d7 as WorkflowEventCorrelation, ac as CompactionUpdate, dj as WorkflowProcessEvent, d6 as WorkflowEvent, a3 as AskUserQuestionOptions, $ as AskUserAnswer, a1 as AskUserMultiOptions, c2 as MemoryReviewPlan, aV as KodaXMemoryOutcomeDigest, c3 as MemoryReviewRunner, aw as Guardrail, ah as DiscoveredInstance, cS as TaskAbortRegistry } from './types.d-D2frCRaY.js';
2
+ import { a0 as KodaXTokenUsage, k as KodaXMessage, a1 as KodaXToolDefinition, a9 as KodaXWireReasoningEffort, U as KodaXTaskRoutingDecision, V as KodaXTaskType, W as KodaXTaskWorkIntent, Q as KodaXTaskComplexity, L as KodaXRiskLevel, h as KodaXHarnessProfile, f as KodaXExecutionMode, b as KodaXChildFanoutClass, F as KodaXReasoningMode, J as KodaXReviewScale } from './types.d-CO_ZkmOd.js';
3
3
  import { d as SkillDynamicContextExecutor } from './types.d-vJExiRje.js';
4
4
  import { Diagnostic, Position, Location, Hover, DocumentSymbol, SymbolInformation, WorkspaceSymbol, CallHierarchyItem, CallHierarchyIncomingCall, CallHierarchyOutgoingCall } from 'vscode-languageserver-protocol';
5
5
  import { K as KodaXLlmTimeoutConfig, a as CostTracker } from './cost-tracker.d-CBLk1fiD.js';
6
6
  import { C as CapabilityKind, b as CapabilityResult } from './capability.d-3C62G8Eq.js';
7
- import { K as KodaXBaseProvider } from './base.d-DalIRhbb.js';
7
+ import { K as KodaXBaseProvider } from './base.d-C8mXDhLL.js';
8
8
 
9
9
  /**
10
10
  * FEATURE_192 v0.7.44 Phase C — Goal-tools execution context.
@@ -910,7 +910,7 @@ declare function buildGoalRuntimeBinding(deps: GoalRuntimeBindingDeps): GoalRunt
910
910
  * configure / install / troubleshoot KodaX?" questions. Pure data + a
911
911
  * deterministic resolver — no RAG, no vector store, no network fetch.
912
912
  */
913
- type KodaXManualTopicId = 'overview' | 'install' | 'quickstart' | 'providers' | 'custom-providers' | 'config' | 'permissions' | 'commands' | 'tools' | 'agents' | 'skills' | 'extensions' | 'mcp' | 'repo-intelligence' | 'sessions' | 'doctor' | 'sdk' | 'troubleshooting';
913
+ type KodaXManualTopicId = 'overview' | 'install' | 'quickstart' | 'providers' | 'custom-providers' | 'config' | 'permissions' | 'commands' | 'tools' | 'agents' | 'skills' | 'extensions' | 'mcp' | 'repo-intelligence' | 'sessions' | 'memory' | 'doctor' | 'sdk' | 'troubleshooting';
914
914
  /** A pointer to the code/doc the topic is derived from (for traceability). */
915
915
  interface KodaXManualSource {
916
916
  readonly label: string;
@@ -1952,6 +1952,17 @@ interface KodaXEvents {
1952
1952
  exitPlanMode?: (plan: string) => Promise<boolean | 'not-in-plan-mode'>;
1953
1953
  /** Semantic memory review plan produced from explicit user feedback. */
1954
1954
  onMemoryReview?: (plan: MemoryReviewPlan) => void;
1955
+ onMemoryNotice?: (notice: {
1956
+ readonly episodeId: string;
1957
+ readonly summaries: readonly string[];
1958
+ readonly proposalIds: readonly string[];
1959
+ }) => void;
1960
+ onMemoryOutcomeDigest?: (digest: KodaXMemoryOutcomeDigest) => void;
1961
+ onMemoryReviewReceipt?: (receipt: {
1962
+ readonly reviewKey: string;
1963
+ readonly proposalIds: readonly string[];
1964
+ readonly completedAt: string;
1965
+ }) => void;
1955
1966
  }
1956
1967
  /**
1957
1968
  * Structured event emitted during provider recovery.
@@ -2173,14 +2184,9 @@ interface KodaXChildContextBundle {
2173
2184
  constraints: string[];
2174
2185
  readOnly: boolean;
2175
2186
  /**
2176
- * FEATURE_120 v0.7.39 Phase 4 optional model tier hint that the
2177
- * dispatching agent provides as a UX signal. Routing is a **no-op**
2178
- * for now: every child runs on the parent's model regardless of
2179
- * hint. FEATURE_102 (v0.7.45 capability profile) is the planned
2180
- * consumer that will translate `'fast' | 'balanced' | 'deep'` to a
2181
- * concrete provider/model selection. The field is surfaced + parsed
2182
- * now so prompt-eval data starts accumulating; the routing wire-up
2183
- * lands separately.
2187
+ * FEATURE_102 / FEATURE_259semantic model tier intent. The runtime maps
2188
+ * configured `fast`/`deep` tiers to concrete routes and safely inherits the
2189
+ * parent when a tier is unavailable or ineligible.
2184
2190
  */
2185
2191
  modelHint?: KodaXChildModelHint;
2186
2192
  /**
@@ -2216,6 +2222,11 @@ interface KodaXChildContextBundle {
2216
2222
  * one bounded repair turn) and surfaces it on `KodaXChildAgentResult.structured`.
2217
2223
  */
2218
2224
  outputSchema?: unknown;
2225
+ /** Trusted host provenance plus the generated script's terse-result declaration. */
2226
+ workflowOutputContract?: {
2227
+ readonly kodaxAuthored: boolean;
2228
+ readonly terseResult: boolean;
2229
+ };
2219
2230
  }
2220
2231
  /**
2221
2232
  * FEATURE_120 v0.7.39 Phase 4 — model tier hint. Tier semantics:
@@ -2228,6 +2239,26 @@ interface KodaXChildContextBundle {
2228
2239
  * unknown values silently with a tolerant fallback to `undefined`).
2229
2240
  */
2230
2241
  type KodaXChildModelHint = 'fast' | 'balanced' | 'deep';
2242
+ type KodaXChildTierOutcome = 'applied' | 'balanced-parent' | 'fast-write-ineligible' | 'unconfigured' | 'shadowed-by-selector' | 'inherited';
2243
+ type KodaXChildRouteSource = 'explicit' | 'specialist' | 'tier' | 'parent' | 'default';
2244
+ interface KodaXChildRouteFacts {
2245
+ readonly requestedTier: KodaXChildModelHint | 'inherited';
2246
+ readonly tierOutcome: KodaXChildTierOutcome;
2247
+ readonly providerSource: KodaXChildRouteSource;
2248
+ readonly modelSource?: Exclude<KodaXChildRouteSource, 'default'>;
2249
+ readonly initialProvider?: string;
2250
+ readonly initialModel?: string;
2251
+ readonly finalProvider?: string;
2252
+ readonly finalModel?: string;
2253
+ readonly resolvedEffort?: string;
2254
+ readonly fallbackReason?: string;
2255
+ readonly iterations?: number;
2256
+ readonly inputTokens?: number;
2257
+ readonly cacheReadTokens?: number;
2258
+ readonly outputTokens?: number;
2259
+ readonly digestTokens?: number;
2260
+ readonly durationMs?: number;
2261
+ }
2231
2262
  interface KodaXChildAgentResult {
2232
2263
  childId: string;
2233
2264
  fanoutClass: KodaXChildFanoutClass;
@@ -2251,6 +2282,17 @@ interface KodaXChildAgentResult {
2251
2282
  actualIterations?: number;
2252
2283
  /** Best-known token usage for this child run. Used by workflow budget accounting. */
2253
2284
  totalTokensUsed?: number;
2285
+ /** Token usage attributable only to the optional presentation digest call. */
2286
+ digestTokensUsed?: number;
2287
+ /** Provider-reported usage for the optional digest call (diagnostic subset of totalTokensUsed). */
2288
+ digestUsage?: {
2289
+ readonly inputTokens?: number;
2290
+ readonly outputTokens?: number;
2291
+ readonly totalTokens?: number;
2292
+ readonly cacheReadTokens?: number;
2293
+ };
2294
+ /** Correlated model-tier and fallback facts for cost/quality reporting. */
2295
+ routeFacts?: KodaXChildRouteFacts;
2254
2296
  /** True when the child exhausted its iteration budget before completing. */
2255
2297
  limitReached?: boolean;
2256
2298
  /**
@@ -2505,6 +2547,10 @@ interface KodaXToolVisibilityMeta {
2505
2547
  */
2506
2548
  type KodaXToolVisibilityPolicy = (tool: KodaXToolVisibilityMeta) => boolean;
2507
2549
  interface KodaXContextOptions {
2550
+ /** FEATURE_260 runtime-owned identity used for scoped memory reads. */
2551
+ memoryIdentity?: MemoryContextIdentity;
2552
+ /** Runtime-built F228 pack reused by prompt rendering and MemorySession. */
2553
+ memoryPack?: MemoryPack;
2508
2554
  /** Project root used for project-scoped prompts, permissions, and path policy. */
2509
2555
  gitRoot?: string | null;
2510
2556
  /**
@@ -2562,6 +2608,8 @@ interface KodaXContextOptions {
2562
2608
  * lookups use the legacy process-global registry.
2563
2609
  */
2564
2610
  agentScope?: KodaXAgentScope;
2611
+ /** FEATURE_258: host-bound external-agent plane and non-model dispatch context. */
2612
+ agentExecutorPlane?: AgentExecutorPlaneBinding;
2565
2613
  /** Optional task-engine surface label used to track managed tasks across UX entry points. */
2566
2614
  taskSurface?: KodaXTaskSurface;
2567
2615
  /**
@@ -3084,6 +3132,11 @@ interface KodaXResult {
3084
3132
  interface KodaXToolExecutionContext {
3085
3133
  /** File backups for undo functionality - 文件备份用于撤销功能 */
3086
3134
  backups: Map<string, string>;
3135
+ /** FEATURE_260: current exactly-scoped read-only MemorySession query binding. */
3136
+ memoryRecall?: (need: string) => Promise<{
3137
+ readonly content: string;
3138
+ readonly evidenceRefs: readonly string[];
3139
+ } | undefined>;
3087
3140
  /** Git root directory - Git 鏍圭洰褰?*/
3088
3141
  gitRoot?: string;
3089
3142
  /**
@@ -3113,6 +3166,8 @@ interface KodaXToolExecutionContext {
3113
3166
  agentProfile?: KodaXAgentProfile;
3114
3167
  /** Scoped specialist-agent resolver inherited from KodaXOptions.context. */
3115
3168
  agentScope?: KodaXAgentScope;
3169
+ /** FEATURE_258: external dispatch capability; absent keeps the tool surface unchanged. */
3170
+ agentExecutorPlane?: AgentExecutorPlaneBinding;
3116
3171
  /** FEATURE_221: SDK-consumer self-manual injection, forwarded from KodaXOptions. */
3117
3172
  selfManual?: KodaXSelfManualConfig;
3118
3173
  /** FEATURE_222 skill security — host policy for skill `!`cmd`` dynamic-context,
@@ -1,4 +1,4 @@
1
- import { F as KodaXReasoningProfile } from './types.d-Bp4Lm1jv.js';
1
+ import { G as KodaXReasoningProfile } from './types.d-CO_ZkmOd.js';
2
2
 
3
3
  type CapabilityCacheSource = 'observed' | 'probed';
4
4
  interface CapabilityCacheEntry {
@@ -1,6 +1,6 @@
1
- import { j as KodaXMessage } from './types.d-Bp4Lm1jv.js';
2
- import { Q as QueueEventListener, c as QueuedMessage, E as EnqueueInput, D as DequeueFilter } from './types.d-BMLxKV69.js';
3
- import { h as AgentMessage, bw as SessionEntry, bu as Session, by as SessionExtension, af as KodaXSessionLineage, a4 as KodaXJsonValue, u as CompactionDetails, T as KodaXCompactMemorySeed, ab as KodaXSessionEntry, an as KodaXSessionTreeNode, ae as KodaXSessionLabelEntry, ad as KodaXSessionGoalEntry, a8 as KodaXSessionClientNoticeEntry, aj as KodaXSessionRewindMarkerEntry, ai as KodaXSessionNavigationOptions, a6 as KodaXSessionArtifactLedgerEntry, H as FileOperations, cb as WorkflowMeta, cc as WorkflowModelHint, cd as WorkflowModule } from './process.d-CY2g03Mb.js';
1
+ import { k as KodaXMessage } from './types.d-CO_ZkmOd.js';
2
+ import { Q as QueueEventListener, c as QueuedMessage, E as EnqueueInput, D as DequeueFilter } from './types.d-D9FKbAmf.js';
3
+ import { I as AgentMessage, cy as SessionEntry, cw as Session, cA as SessionExtension, b5 as KodaXSessionLineage, aT as KodaXJsonValue, a9 as CompactionDetails, aG as KodaXCompactMemorySeed, b1 as KodaXSessionEntry, bf as KodaXSessionTreeNode, b4 as KodaXSessionLabelEntry, b3 as KodaXSessionGoalEntry, a_ as KodaXSessionClientNoticeEntry, bb as KodaXSessionRewindMarkerEntry, b6 as KodaXSessionMemoryOutcomeDigestEntry, b7 as KodaXSessionMemoryReviewReceiptEntry, ba as KodaXSessionNavigationOptions, aY as KodaXSessionArtifactLedgerEntry, au as FileOperations, dd as WorkflowMeta, de as WorkflowModelHint, df as WorkflowModule } from './types.d-D2frCRaY.js';
4
4
 
5
5
  /**
6
6
  * @kodax-ai/agent Constants
@@ -456,7 +456,7 @@ declare function cleanupIncompleteToolCalls(messages: KodaXMessage[]): KodaXMess
456
456
  * legacy lineage records rewinds via `activeEntryId` mutation; Session is
457
457
  * linear, so a marker entry is the equivalent).
458
458
  */
459
- declare const LINEAGE_ENTRY_TYPES: readonly ["message", "label", "compaction", "branch_summary", "archive_marker", "rewind_marker", "artifact_ledger"];
459
+ declare const LINEAGE_ENTRY_TYPES: readonly ["message", "label", "compaction", "branch_summary", "archive_marker", "rewind_marker", "artifact_ledger", "memory_outcome_digest", "memory_review_receipt"];
460
460
  type LineageEntryType = (typeof LINEAGE_ENTRY_TYPES)[number];
461
461
  /**
462
462
  * Payload shape for a `label` entry. Mirrors
@@ -568,7 +568,7 @@ declare function generateSessionId(): Promise<string>;
568
568
  */
569
569
  declare function extractTitleFromMessages(messages: KodaXMessage[]): string;
570
570
 
571
- type NavigableSessionEntry = Exclude<KodaXSessionEntry, KodaXSessionLabelEntry | KodaXSessionGoalEntry | KodaXSessionClientNoticeEntry | KodaXSessionRewindMarkerEntry>;
571
+ type NavigableSessionEntry = Exclude<KodaXSessionEntry, KodaXSessionLabelEntry | KodaXSessionGoalEntry | KodaXSessionClientNoticeEntry | KodaXSessionRewindMarkerEntry | KodaXSessionMemoryOutcomeDigestEntry | KodaXSessionMemoryReviewReceiptEntry>;
572
572
  /**
573
573
  * Reconcile a linear message list against an existing lineage tree.
574
574
  *
@@ -1,7 +1,7 @@
1
- import { h as SessionStorage$1, f as PermissionMode } from './public-api.d-jtREVfEq.js';
2
- import { X as KodaXOptions, a5 as KodaXResult } from './bash-prefix-extractor.d-BjkITAva.js';
3
- import { m as RuntimeSurfaceStatus, b as CommandDefinition, e as CommandSource, c as CommandInfo, C as Command$1, I as InteractiveContext, a as CommandCallbacks, g as CurrentConfig, d as CommandInvocationRequest, f as CommandWorkflowInvocationRequest } from './utils.d-C1rpoeDh.js';
4
- import { am as KodaXSessionStorage, aa as KodaXSessionData } from './process.d-CY2g03Mb.js';
1
+ import { h as SessionStorage$1, f as PermissionMode } from './public-api.d-BcKbBy1E.js';
2
+ import { X as KodaXOptions, a5 as KodaXResult } from './bash-prefix-extractor.d-Dm-T865v.js';
3
+ import { m as RuntimeSurfaceStatus, b as CommandDefinition, e as CommandSource, c as CommandInfo, C as Command$1, I as InteractiveContext, a as CommandCallbacks, g as CurrentConfig, d as CommandInvocationRequest, f as CommandWorkflowInvocationRequest } from './utils.d-DOXxnOnI.js';
4
+ import { be as KodaXSessionStorage, b0 as KodaXSessionData } from './types.d-D2frCRaY.js';
5
5
 
6
6
  /**
7
7
  * InkREPL - Ink-based REPL Adapter
@@ -1,8 +1,8 @@
1
1
  import { b as McpServersConfig, M as McpConnectMode, a as McpServerConfig, c as McpTransportKind } from './config.d-CJy1WENT.js';
2
- import { K as KodaXBaseProvider } from './base.d-DalIRhbb.js';
2
+ import { K as KodaXBaseProvider } from './base.d-C8mXDhLL.js';
3
3
  import { a as CostTracker } from './cost-tracker.d-CBLk1fiD.js';
4
- import { bq as RunnerToolCall } from './process.d-CY2g03Mb.js';
5
- import { d as ToolGuardrail } from './guardrail.d-C_Siraua.js';
4
+ import { cs as RunnerToolCall } from './types.d-D2frCRaY.js';
5
+ import { d as ToolGuardrail } from './guardrail.d-D7r6zVSR.js';
6
6
 
7
7
  /**
8
8
  * FEATURE_200 Phase F (v0.7.45) — MCP domain types extracted from types.ts.
@@ -1,4 +1,4 @@
1
- import { J as Guardrail, bq as RunnerToolCall, f as Agent, h as AgentMessage, bt as RunnerToolResult, bC as Span } from './process.d-CY2g03Mb.js';
1
+ import { aw as Guardrail, cs as RunnerToolCall, f as Agent, I as AgentMessage, cv as RunnerToolResult, cE as Span } from './types.d-D2frCRaY.js';
2
2
 
3
3
  /**
4
4
  * Guardrail Runtime — FEATURE_085 (v0.7.26).
@@ -1,6 +1,6 @@
1
- import { a as BashPrefixExtractor } from './bash-prefix-extractor.d-BjkITAva.js';
2
- import { aa as KodaXSessionData, af as KodaXSessionLineage, ai as KodaXSessionNavigationOptions, ak as KodaXSessionRuntimeInfo, am as KodaXSessionStorage, a4 as KodaXJsonValue } from './process.d-CY2g03Mb.js';
3
- import { j as KodaXMessage, R as KodaXTaskResultMetadata } from './types.d-Bp4Lm1jv.js';
1
+ import { a as BashPrefixExtractor } from './bash-prefix-extractor.d-Dm-T865v.js';
2
+ import { b0 as KodaXSessionData, b5 as KodaXSessionLineage, ba as KodaXSessionNavigationOptions, bc as KodaXSessionRuntimeInfo, be as KodaXSessionStorage, aT as KodaXJsonValue } from './types.d-D2frCRaY.js';
3
+ import { k as KodaXMessage, S as KodaXTaskResultMetadata } from './types.d-CO_ZkmOd.js';
4
4
 
5
5
  /**
6
6
  * Permission Types
@@ -30,10 +30,9 @@ declare const PERMISSION_MODES: PermissionMode[];
30
30
  * display name; the deprecation notice
31
31
  * surfaces once per session at startup)
32
32
  *
33
- * Single source of truth both the readline status-bar
34
- * (`packages/repl/src/interactive/status-bar.ts`) and the Ink view-model
35
- * (`packages/repl/src/ui/view-models/status-bar.ts`) consume this so the two
36
- * surfaces never drift on capitalization or short-form choice.
33
+ * Single source of truth for command output, startup summaries, and the live
34
+ * Ink status-bar view-model. The former write-only readline StatusBar was
35
+ * removed; Classic continues to use the same display helper in text surfaces.
37
36
  */
38
37
  declare function permissionModeDisplayName(mode: PermissionMode): string;
39
38
  interface ConfirmResult {
@@ -349,6 +348,8 @@ declare function compactSession(sessionId: string, options?: CompactSessionOptio
349
348
 
350
349
  interface SessionSummary {
351
350
  readonly id: string;
351
+ /** Opaque continuation token; pass the last item cursor back to listSessions(). */
352
+ readonly cursor?: string;
352
353
  readonly title: string;
353
354
  readonly msgCount: number;
354
355
  readonly tag?: string;
@@ -437,6 +438,10 @@ interface ListSessionsOptions {
437
438
  readonly before?: string;
438
439
  /** Exact match. Omitted means no tag filter. */
439
440
  readonly tag?: string;
441
+ /** Exact runtime surface match, for example `repl`, `cli`, `acp`, or `partner`. */
442
+ readonly surface?: string;
443
+ /** Opaque cursor returned on a previous page's last SessionSummary. */
444
+ readonly cursor?: string;
440
445
  }
441
446
  type WatchSessionsCallback = (event: {
442
447
  kind: 'change' | 'add' | 'remove';
@@ -1,6 +1,6 @@
1
- import { E as KodaXReasoningMode, L as KodaXStableEffortIntent, a8 as KodaXWireReasoningEffort, F as KodaXReasoningProfile, Y as KodaXThinkingBudgetMap, Z as KodaXThinkingDepth, p as KodaXProviderConfig, A as KodaXReasoningCapability, G as KodaXReasoningRequest, m as KodaXNormalizedReasoningRequest, U as KodaXTaskType, a6 as KodaXVerifyCredentialResult, a0 as KodaXToolDefinition, j as KodaXMessage, x as KodaXProviderStreamOptions, M as KodaXStreamResult, k as KodaXModelDescriptor, o as KodaXProviderCapabilityProfile, a7 as KodaXVerifyStrategy, d as KodaXCustomProviderConfig, i as KodaXListModelsResult } from './types.d-Bp4Lm1jv.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 } from './types.d-CO_ZkmOd.js';
2
2
  import Anthropic from '@anthropic-ai/sdk';
3
- import { K as KodaXBaseProvider } from './base.d-DalIRhbb.js';
3
+ import { K as KodaXBaseProvider } from './base.d-C8mXDhLL.js';
4
4
  import OpenAI from 'openai';
5
5
 
6
6
  /**
@@ -1,4 +1,4 @@
1
- import { ct as WorkflowProcessTrackerOptions, c4 as WorkflowEvent, cn as WorkflowProcessSnapshot, ch as WorkflowProcessEvent } from './process.d-CY2g03Mb.js';
1
+ import { dw as WorkflowProcessTrackerOptions, d6 as WorkflowEvent, dq as WorkflowProcessSnapshot, dj as WorkflowProcessEvent } from './types.d-D2frCRaY.js';
2
2
 
3
3
  /**
4
4
  * FEATURE_246 Part A0 (ADR-046) — neutral workflow run lifecycle manager.
@@ -1,7 +1,7 @@
1
- import { f as PermissionMode } from './public-api.d-jtREVfEq.js';
2
- import { E as KodaXReasoningMode, j as KodaXMessage, c as KodaXContentBlock } from './types.d-Bp4Lm1jv.js';
3
- import { r as KodaXAgentMode } from './bash-prefix-extractor.d-BjkITAva.js';
4
- import { ao as KodaXSessionUiHistoryItem, as as KodaXSessionUiToolCall } from './process.d-CY2g03Mb.js';
1
+ import { f as PermissionMode } from './public-api.d-BcKbBy1E.js';
2
+ import { F as KodaXReasoningMode, k as KodaXMessage, c as KodaXContentBlock } from './types.d-CO_ZkmOd.js';
3
+ import { r as KodaXAgentMode } from './bash-prefix-extractor.d-Dm-T865v.js';
4
+ import { bg as KodaXSessionUiHistoryItem, bk as KodaXSessionUiToolCall } from './types.d-D2frCRaY.js';
5
5
 
6
6
  /**
7
7
  * TextBuffer - Text buffer management class - 文本缓冲区管理类
@@ -161,6 +161,9 @@ interface KodaXMessage {
161
161
  */
162
162
  timestamp?: string;
163
163
  }
164
+ interface KodaXEphemeralSuffix {
165
+ readonly content: string;
166
+ }
164
167
  interface KodaXTokenUsage {
165
168
  inputTokens: number;
166
169
  outputTokens: number;
@@ -567,6 +570,8 @@ interface KodaXProviderConfig {
567
570
  verifyStrategy?: KodaXVerifyStrategy;
568
571
  }
569
572
  interface KodaXProviderStreamOptions {
573
+ /** Request-only tail context. Providers must not mutate persisted messages. */
574
+ ephemeralSuffix?: KodaXEphemeralSuffix;
570
575
  onTextDelta?: (text: string) => void;
571
576
  onThinkingDelta?: (text: string) => void;
572
577
  onThinkingEnd?: (thinking: string) => void;
@@ -629,4 +634,4 @@ interface KodaXProviderStreamOptions {
629
634
  signal?: AbortSignal;
630
635
  }
631
636
 
632
- export type { KodaXTokenUsage as $, KodaXReasoningCapability as A, KodaXReasoningEffortPreset as B, KodaXReasoningEffortRequest as C, KodaXReasoningEffortWireStrategy as D, KodaXReasoningMode as E, KodaXReasoningProfile as F, KodaXReasoningRequest as G, KodaXRedactedThinkingBlock as H, KodaXReviewScale as I, KodaXRiskLevel as J, KodaXAssuranceIntent as K, KodaXStableEffortIntent as L, KodaXStreamResult as M, KodaXTaskActionability as N, KodaXTaskBudgetOverrides as O, KodaXTaskComplexity as P, KodaXTaskFamily as Q, KodaXTaskResultMetadata as R, KodaXTaskResultSource as S, KodaXTaskRoutingDecision as T, KodaXTaskType as U, KodaXTaskWorkIntent as V, KodaXTextBlock as W, KodaXThinkingBlock as X, KodaXThinkingBudgetMap as Y, KodaXThinkingDepth as Z, KodaXThinkingWireStrategy as _, KodaXCacheBoundary as a, KodaXToolDefinition as a0, KodaXToolResultBlock as a1, KodaXToolResultContentItem as a2, KodaXToolResultImageItem as a3, KodaXToolResultTextItem as a4, KodaXToolUseBlock as a5, KodaXVerifyCredentialResult as a6, KodaXVerifyStrategy as a7, KodaXWireReasoningEffort as a8, KodaXChildFanoutClass as b, KodaXContentBlock as c, KodaXCustomProviderConfig as d, KodaXExecutionMode as e, KodaXExecutionPattern as f, KodaXHarnessProfile as g, KodaXImageBlock as h, KodaXListModelsResult as i, KodaXMessage as j, KodaXModelDescriptor as k, KodaXMutationSurface as l, KodaXNormalizedReasoningRequest as m, KodaXProtocolFamily as n, KodaXProviderCapabilityProfile as o, KodaXProviderConfig as p, KodaXProviderContextFidelity as q, KodaXProviderConversationSemantics as r, KodaXProviderEvidenceSupport as s, KodaXProviderLongRunningSupport as t, KodaXProviderMcpSupport as u, KodaXProviderMultimodalSupport as v, KodaXProviderSessionSupport as w, KodaXProviderStreamOptions as x, KodaXProviderToolCallingFidelity as y, KodaXProviderTransport as z };
637
+ export type { KodaXThinkingWireStrategy as $, KodaXProviderTransport as A, KodaXReasoningCapability as B, KodaXReasoningEffortPreset as C, KodaXReasoningEffortRequest as D, KodaXReasoningEffortWireStrategy as E, KodaXReasoningMode as F, KodaXReasoningProfile as G, KodaXReasoningRequest as H, KodaXRedactedThinkingBlock as I, KodaXReviewScale as J, KodaXAssuranceIntent as K, KodaXRiskLevel as L, KodaXStableEffortIntent as M, KodaXStreamResult as N, KodaXTaskActionability as O, KodaXTaskBudgetOverrides as P, KodaXTaskComplexity as Q, KodaXTaskFamily as R, KodaXTaskResultMetadata as S, KodaXTaskResultSource as T, KodaXTaskRoutingDecision as U, KodaXTaskType as V, KodaXTaskWorkIntent as W, KodaXTextBlock as X, KodaXThinkingBlock as Y, KodaXThinkingBudgetMap as Z, KodaXThinkingDepth as _, KodaXCacheBoundary as a, KodaXTokenUsage as a0, KodaXToolDefinition as a1, KodaXToolResultBlock as a2, KodaXToolResultContentItem as a3, KodaXToolResultImageItem as a4, KodaXToolResultTextItem as a5, KodaXToolUseBlock as a6, KodaXVerifyCredentialResult as a7, KodaXVerifyStrategy as a8, KodaXWireReasoningEffort as a9, KodaXChildFanoutClass as b, KodaXContentBlock as c, KodaXCustomProviderConfig as d, KodaXEphemeralSuffix as e, KodaXExecutionMode as f, KodaXExecutionPattern as g, KodaXHarnessProfile as h, KodaXImageBlock as i, KodaXListModelsResult as j, KodaXMessage as k, KodaXModelDescriptor as l, KodaXMutationSurface as m, KodaXNormalizedReasoningRequest as n, KodaXProtocolFamily as o, KodaXProviderCapabilityProfile as p, KodaXProviderConfig as q, KodaXProviderContextFidelity as r, KodaXProviderConversationSemantics as s, KodaXProviderEvidenceSupport as t, KodaXProviderLongRunningSupport as u, KodaXProviderMcpSupport as v, KodaXProviderMultimodalSupport as w, KodaXProviderSessionSupport as x, KodaXProviderStreamOptions as y, KodaXProviderToolCallingFidelity as z };
@@ -1,8 +1,8 @@
1
- import { a8 as KodaXWireReasoningEffort, a0 as KodaXToolDefinition, a2 as KodaXToolResultContentItem, j as KodaXMessage } from './types.d-Bp4Lm1jv.js';
2
- import { K as KodaXBaseProvider } from './base.d-DalIRhbb.js';
1
+ import { a9 as KodaXWireReasoningEffort, a1 as KodaXToolDefinition, a3 as KodaXToolResultContentItem, k as KodaXMessage } from './types.d-CO_ZkmOd.js';
2
+ import { K as KodaXBaseProvider } from './base.d-C8mXDhLL.js';
3
3
  import { C as CapabilityKind, a as CapabilityProvider } from './capability.d-3C62G8Eq.js';
4
- import { a4 as KodaXJsonValue, U as KodaXExtensionSessionRecord, W as KodaXExtensionStore } from './process.d-CY2g03Mb.js';
5
- import { aw as KodaXToolExecutionContext, bd as ToolSideEffect } from './bash-prefix-extractor.d-BjkITAva.js';
4
+ import { aT as KodaXJsonValue, aH as KodaXExtensionSessionRecord, aJ as KodaXExtensionStore } from './types.d-D2frCRaY.js';
5
+ import { aw as KodaXToolExecutionContext, bd as ToolSideEffect } from './bash-prefix-extractor.d-Dm-T865v.js';
6
6
 
7
7
  /**
8
8
  * KodaX Constructed-World types (FEATURE_087, v0.7.28).