@kodax-ai/kodax 0.7.59 → 0.7.60

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 (61) hide show
  1. package/CHANGELOG.md +33 -0
  2. package/README.md +1232 -1228
  3. package/README_CN.md +651 -647
  4. package/dist/chunks/{agent-QQCRBU4C.js → agent-L5FC3YOY.js} +1 -1
  5. package/dist/chunks/argument-completer-BQDAYT7W.js +2 -0
  6. package/dist/chunks/chunk-2RLIKZOZ.js +18 -0
  7. package/dist/chunks/{chunk-PRIBJN5E.js → chunk-4K5BDO7S.js} +112 -74
  8. package/dist/chunks/{chunk-TBXP7FEG.js → chunk-5TRQBMPR.js} +1 -1
  9. package/dist/chunks/{chunk-UXQILGRX.js → chunk-6DWXUZMO.js} +62 -62
  10. package/dist/chunks/{chunk-YADBB5GN.js → chunk-6OZ5KWG3.js} +1 -1
  11. package/dist/chunks/chunk-IJN6ZJVI.js +310 -0
  12. package/dist/chunks/{chunk-SVEJFERZ.js → chunk-QFCF3GNT.js} +153 -153
  13. package/dist/chunks/{chunk-2UUOFT3Z.js → chunk-SGNM3UP6.js} +1 -1
  14. package/dist/chunks/chunk-U6BNMGSK.js +17 -0
  15. package/dist/chunks/{chunk-5GPJ6MB5.js → chunk-XULI4U7I.js} +120 -120
  16. package/dist/chunks/{chunk-BEXLPFFB.js → chunk-ZL5CEANW.js} +3 -3
  17. package/dist/chunks/chunk-ZPD7IUKW.js +322 -0
  18. package/dist/chunks/compaction-config-E4LN3M53.js +2 -0
  19. package/dist/chunks/{construction-bootstrap-YON4ZEMO.js → construction-bootstrap-GIFDM4L5.js} +1 -1
  20. package/dist/chunks/{dist-EZXBR6NW.js → dist-7PXDYX2R.js} +1 -1
  21. package/dist/chunks/host-FLG7FJZT.js +2 -0
  22. package/dist/chunks/{paste-4THGP5XW.js → paste-FDYM7SZX.js} +1 -1
  23. package/dist/chunks/run-manager-IU5COC6X.js +2 -0
  24. package/dist/chunks/{utils-5XVW33SY.js → utils-NP42DKL3.js} +1 -1
  25. package/dist/index.d.ts +11 -11
  26. package/dist/index.js +1 -1
  27. package/dist/kodax_cli.js +1008 -970
  28. package/dist/sdk-agent.d.ts +24 -13
  29. package/dist/sdk-agent.js +1 -1
  30. package/dist/sdk-coding.d.ts +15 -13
  31. package/dist/sdk-coding.js +1 -1
  32. package/dist/sdk-llm.d.ts +6 -6
  33. package/dist/sdk-mcp.js +1 -1
  34. package/dist/sdk-media.d.ts +1 -1
  35. package/dist/sdk-media.js +1 -1
  36. package/dist/sdk-repl.d.ts +12 -11
  37. package/dist/sdk-repl.js +2 -2
  38. package/dist/sdk-session.d.ts +6 -6
  39. package/dist/sdk-session.js +1 -1
  40. package/dist/sdk-skills.js +1 -1
  41. package/dist/types-chunks/{base.d-BA9Doaj_.d.ts → base.d-DalIRhbb.d.ts} +1 -1
  42. package/dist/types-chunks/{bash-prefix-extractor.d-BNdpV4Cf.d.ts → bash-prefix-extractor.d-Ds1THKeH.d.ts} +63 -27
  43. package/dist/types-chunks/{capability-learning.d-DRV80ISB.d.ts → capability-learning.d-BQB0M70w.d.ts} +1 -1
  44. package/dist/types-chunks/{guardrail.d-CNdKuSD_.d.ts → guardrail.d-CdqJwwN7.d.ts} +3 -3
  45. package/dist/types-chunks/{process.d-BOrAxjvM.d.ts → process.d-C93UMgPK.d.ts} +20 -5
  46. package/dist/types-chunks/{resolver.d-DFAKKUvt.d.ts → resolver.d-CGkfRULj.d.ts} +2 -2
  47. package/dist/types-chunks/{run-manager.d-CsJC9zYf.d.ts → run-manager.d-DLK3ed-T.d.ts} +4 -4
  48. package/dist/types-chunks/{sdk-session-ByZlwgdM.d.ts → sdk-session-CtwN7iBO.d.ts} +47 -10
  49. package/dist/types-chunks/{storage.d-DHL3XpAL.d.ts → storage.d-DlZS0g8w.d.ts} +2 -2
  50. package/dist/types-chunks/{types.d-Ci5YPFEh.d.ts → types.d-Bp4Lm1jv.d.ts} +37 -3
  51. package/dist/types-chunks/{types.d-CE_Ter29.d.ts → types.d-CSZAMmU-.d.ts} +4 -1
  52. package/dist/types-chunks/{utils.d-D9FHU4wB.d.ts → utils.d-Boz9k2HB.d.ts} +5 -5
  53. package/package.json +1 -1
  54. package/dist/chunks/argument-completer-7Q2T4YWA.js +0 -2
  55. package/dist/chunks/chunk-D7RENPQQ.js +0 -322
  56. package/dist/chunks/chunk-SDSLWDAZ.js +0 -17
  57. package/dist/chunks/chunk-Z23LK3IV.js +0 -310
  58. package/dist/chunks/chunk-Z3ZXV3DZ.js +0 -18
  59. package/dist/chunks/compaction-config-GQIPCVFD.js +0 -2
  60. package/dist/chunks/host-LO6ZNTMV.js +0 -2
  61. package/dist/chunks/run-manager-HTLXKU66.js +0 -2
@@ -1,10 +1,10 @@
1
- export { c as CreatableHistoryItem, e as DeleteSessionResult, F as FullTranscriptSessionData, s as HistorySeedSourceMessage, w as ListSessionsOptions, R as RestoreHistoryItemsFromSessionInput, z as RestoredHistorySeed, B as RunningSessionInfo, S as SessionManager, E as SessionSummary, G as SessionTranscriptEntry, J as SessionTranscriptEntryType, a4 as WatchSessionsCallback, a5 as archiveSession, a6 as createSessionManager, a7 as deleteSession, a8 as extractHistorySeedsFromMessage, a9 as extractHistorySeedsFromMessages, ac as forkSession, ae as listRunningSessions, af as listSessions, ag as loadFullTranscript, ah as loadSession, ai as restoreHistoryItemsFromSession, aj as rewindSession, al as setActiveEntry, ao as unarchiveSession, ap as watchSessions } from './types-chunks/sdk-session-ByZlwgdM.js';
2
- export { ai as KodaXSessionUiHistoryItem, aj as KodaXSessionUiHistoryItemType, ak as KodaXSessionUiTextHistoryItem, al as KodaXSessionUiTextHistoryItemType, am as KodaXSessionUiToolCall, an as KodaXSessionUiToolCallStatus, ao as KodaXSessionUiToolGroupHistoryItem } from './types-chunks/process.d-BOrAxjvM.js';
3
- import './types-chunks/storage.d-DHL3XpAL.js';
4
- import './types-chunks/bash-prefix-extractor.d-BNdpV4Cf.js';
5
- import './types-chunks/types.d-Ci5YPFEh.js';
1
+ export { b as AppendClientNoticeOptions, d as CreatableHistoryItem, f as DeleteSessionResult, F as FullTranscriptSessionData, t as HistorySeedSourceMessage, x as ListSessionsOptions, R as RestoreHistoryItemsFromSessionInput, B as RestoredHistorySeed, E as RunningSessionInfo, S as SessionManager, G as SessionSummary, J as SessionTranscriptEntry, N as SessionTranscriptEntryType, a5 as WatchSessionsCallback, a6 as appendClientNotice, a7 as archiveSession, a8 as createSessionManager, a9 as deleteSession, aa as extractHistorySeedsFromMessage, ab as extractHistorySeedsFromMessages, ae as forkSession, ag as listRunningSessions, ah as listSessions, ai as loadFullTranscript, aj as loadSession, ak as restoreHistoryItemsFromSession, al as rewindSession, an as setActiveEntry, aq as unarchiveSession, ar as watchSessions } from './types-chunks/sdk-session-CtwN7iBO.js';
2
+ export { R as KodaXTaskResultMetadata, S as KodaXTaskResultSource } from './types-chunks/types.d-Bp4Lm1jv.js';
3
+ export { aj as KodaXSessionUiHistoryItem, ak as KodaXSessionUiHistoryItemType, al as KodaXSessionUiTextHistoryItem, am as KodaXSessionUiTextHistoryItemType, an as KodaXSessionUiToolCall, ao as KodaXSessionUiToolCallStatus, ap as KodaXSessionUiToolGroupHistoryItem } from './types-chunks/process.d-C93UMgPK.js';
4
+ import './types-chunks/storage.d-DlZS0g8w.js';
5
+ import './types-chunks/bash-prefix-extractor.d-Ds1THKeH.js';
6
6
  import './types-chunks/types.d-vJExiRje.js';
7
7
  import 'vscode-languageserver-protocol';
8
8
  import './types-chunks/cost-tracker.d-CBLk1fiD.js';
9
9
  import './types-chunks/capability.d-3C62G8Eq.js';
10
- import './types-chunks/base.d-BA9Doaj_.js';
10
+ import './types-chunks/base.d-DalIRhbb.js';
@@ -1,2 +1,2 @@
1
1
  // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
2
- import{$a as o,Jb as i,Kb as t,Lb as r,Mb as n,Nb as a,Ob as S,Pb as l,Qb as y,Rb as d,Sb as m,Tb as p,Ub as c}from"./chunks/chunk-Z23LK3IV.js";import{K as s,L as e}from"./chunks/chunk-UXQILGRX.js";import"./chunks/chunk-2UUOFT3Z.js";import"./chunks/chunk-YADBB5GN.js";import"./chunks/chunk-TBXP7FEG.js";import"./chunks/chunk-5GPJ6MB5.js";import"./chunks/chunk-SDSLWDAZ.js";import"./chunks/chunk-Z3ZXV3DZ.js";import"./chunks/chunk-D7RENPQQ.js";import"./chunks/chunk-D6QVXQNI.js";import"./chunks/chunk-UA744TZM.js";import"./chunks/chunk-SVEJFERZ.js";import"./chunks/chunk-S4GVQO3W.js";import"./chunks/chunk-PRIBJN5E.js";import"./chunks/chunk-BEXLPFFB.js";import"./chunks/chunk-V4WSBIXB.js";export{d as archiveSession,c as createSessionManager,y as deleteSession,s as extractHistorySeedsFromMessage,e as extractHistorySeedsFromMessages,n as forkSession,l as listRunningSessions,i as listSessions,r as loadFullTranscript,t as loadSession,o as restoreHistoryItemsFromSession,a as rewindSession,S as setActiveEntry,m as unarchiveSession,p as watchSessions};
2
+ import{$a as o,Jb as i,Kb as t,Lb as n,Mb as r,Nb as a,Ob as S,Pb as l,Qb as d,Rb as p,Sb as y,Tb as c,Ub as m,Vb as u}from"./chunks/chunk-IJN6ZJVI.js";import{K as s,L as e}from"./chunks/chunk-6DWXUZMO.js";import"./chunks/chunk-SGNM3UP6.js";import"./chunks/chunk-6OZ5KWG3.js";import"./chunks/chunk-5TRQBMPR.js";import"./chunks/chunk-XULI4U7I.js";import"./chunks/chunk-U6BNMGSK.js";import"./chunks/chunk-2RLIKZOZ.js";import"./chunks/chunk-ZPD7IUKW.js";import"./chunks/chunk-D6QVXQNI.js";import"./chunks/chunk-UA744TZM.js";import"./chunks/chunk-QFCF3GNT.js";import"./chunks/chunk-S4GVQO3W.js";import"./chunks/chunk-4K5BDO7S.js";import"./chunks/chunk-ZL5CEANW.js";import"./chunks/chunk-V4WSBIXB.js";export{r as appendClientNotice,y as archiveSession,u as createSessionManager,p as deleteSession,s as extractHistorySeedsFromMessage,e as extractHistorySeedsFromMessages,a as forkSession,d as listRunningSessions,i as listSessions,n as loadFullTranscript,t as loadSession,o as restoreHistoryItemsFromSession,S as rewindSession,l as setActiveEntry,c as unarchiveSession,m as watchSessions};
@@ -1,2 +1,2 @@
1
1
  // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
2
- import{Ac as o,Ec as k,Fc as r,Gc as S,Hc as s,Ic as n,Jc as g,Kc as u,Lc as c,Mc as x,Nc as d,Oc as P,Pc as R,Qc as h,Rc as p,Sc as v,Tc as y,Uc as M,Vc as f,Wc as m,Xc as E,vc as l,wc as e,xc as i,yc as t,zc as a}from"./chunks/chunk-PRIBJN5E.js";import"./chunks/chunk-BEXLPFFB.js";import"./chunks/chunk-V4WSBIXB.js";export{y as SkillExecutor,R as SkillRegistry,x as VariableResolver,t as clearPluginSkillPaths,M as createExecutor,d as createResolver,n as discoverSkills,u as discoverSkillsWithMonorepo,f as executeSkill,m as expandSkillForLLM,E as formatSkillActivationMessage,a as getDefaultSkillPaths,g as getNestedSkillPaths,o as getSkillPathsFlat,h as getSkillRegistry,p as initializeSkillRegistry,i as listPluginSkillPaths,S as loadFullSkill,s as loadSkillFileContent,r as loadSkillMetadata,c as parseArguments,k as parseSkillMarkdown,l as registerPluginSkillPath,v as resetSkillRegistry,P as resolveSkillContent,e as unregisterPluginSkillPath};
2
+ import{Ac as o,Ec as k,Fc as r,Gc as S,Hc as s,Ic as n,Jc as g,Kc as u,Lc as c,Mc as x,Nc as d,Oc as P,Pc as R,Qc as h,Rc as p,Sc as v,Tc as y,Uc as M,Vc as f,Wc as m,Xc as E,vc as l,wc as e,xc as i,yc as t,zc as a}from"./chunks/chunk-4K5BDO7S.js";import"./chunks/chunk-ZL5CEANW.js";import"./chunks/chunk-V4WSBIXB.js";export{y as SkillExecutor,R as SkillRegistry,x as VariableResolver,t as clearPluginSkillPaths,M as createExecutor,d as createResolver,n as discoverSkills,u as discoverSkillsWithMonorepo,f as executeSkill,m as expandSkillForLLM,E as formatSkillActivationMessage,a as getDefaultSkillPaths,g as getNestedSkillPaths,o as getSkillPathsFlat,h as getSkillRegistry,p as initializeSkillRegistry,i as listPluginSkillPaths,S as loadFullSkill,s as loadSkillFileContent,r as loadSkillMetadata,c as parseArguments,k as parseSkillMarkdown,l as registerPluginSkillPath,v as resetSkillRegistry,P as resolveSkillContent,e as unregisterPluginSkillPath};
@@ -1,4 +1,4 @@
1
- import { p as KodaXProviderConfig, j as KodaXMessage, _ as KodaXToolDefinition, G as KodaXReasoningRequest, x as KodaXProviderStreamOptions, M as KodaXStreamResult, a4 as KodaXVerifyCredentialResult, k as KodaXModelDescriptor, o as KodaXProviderCapabilityProfile, A as KodaXReasoningCapability, F as KodaXReasoningProfile, m as KodaXNormalizedReasoningRequest, a6 as KodaXWireReasoningEffort } from './types.d-Ci5YPFEh.js';
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';
2
2
 
3
3
  /**
4
4
  * Retry-After header parsing — FEATURE_130 (v0.7.36).
@@ -1,10 +1,10 @@
1
- import { W as KodaXGoalState, g as AgentMessage, b8 as StopHookFn, aa as KodaXSessionLineage, a0 as KodaXJsonValue, Q as KodaXExtensionSessionRecord, bw as WorkflowIsolation, R as KodaXExtensionSessionState, a2 as KodaXSessionArtifactLedgerEntry, aV as SessionErrorMetadata, af as KodaXSessionScope, ag as KodaXSessionStorage, _ as KodaXInputArtifact, C as ChildTaskRegistry, bt as WorkflowEventCorrelation, t as CompactionUpdate, bF as WorkflowProcessEvent, bs as WorkflowEvent, n as AskUserQuestionOptions, l as AskUserMultiOptions, z as Guardrail, w as DiscoveredInstance, bc as TaskAbortRegistry } from './process.d-BOrAxjvM.js';
2
- import { Z as KodaXTokenUsage, j as KodaXMessage, a6 as KodaXWireReasoningEffort, R as KodaXTaskRoutingDecision, S as KodaXTaskType, T 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-Ci5YPFEh.js';
1
+ import { W as KodaXGoalState, g as AgentMessage, b9 as StopHookFn, ab as KodaXSessionLineage, a0 as KodaXJsonValue, Q as KodaXExtensionSessionRecord, bx as WorkflowIsolation, R as KodaXExtensionSessionState, a2 as KodaXSessionArtifactLedgerEntry, aW as SessionErrorMetadata, ag as KodaXSessionScope, ah as KodaXSessionStorage, _ as KodaXInputArtifact, C as ChildTaskRegistry, bu as WorkflowEventCorrelation, t as CompactionUpdate, bG as WorkflowProcessEvent, bt as WorkflowEvent, n as AskUserQuestionOptions, l as AskUserMultiOptions, z as Guardrail, w as DiscoveredInstance, bd as TaskAbortRegistry } from './process.d-C93UMgPK.js';
2
+ import { $ as KodaXTokenUsage, j as KodaXMessage, 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';
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-BA9Doaj_.js';
7
+ import { K as KodaXBaseProvider } from './base.d-DalIRhbb.js';
8
8
 
9
9
  /**
10
10
  * FEATURE_192 v0.7.44 Phase C — Goal-tools execution context.
@@ -1383,7 +1383,29 @@ interface KodaXRepoIntelligenceTraceEvent {
1383
1383
  interface KodaXWorkflowEventMeta {
1384
1384
  readonly workflowCorrelation?: WorkflowEventCorrelation;
1385
1385
  }
1386
- interface KodaXActivityEventMeta extends KodaXWorkflowEventMeta {
1386
+ type KodaXTurnDeliveryKind = 'initial' | 'queued' | 'interrupt' | 'resume';
1387
+ interface KodaXLiveEventMeta {
1388
+ readonly sessionId: string;
1389
+ readonly seq: number;
1390
+ readonly turnId: string;
1391
+ readonly deliveryId?: string;
1392
+ readonly timestamp?: string;
1393
+ }
1394
+ interface KodaXTurnStartedEvent extends KodaXLiveEventMeta {
1395
+ readonly promptId?: string;
1396
+ readonly deliveryKind: KodaXTurnDeliveryKind;
1397
+ }
1398
+ interface KodaXTurnCompletedEvent extends KodaXLiveEventMeta {
1399
+ readonly status: 'completed' | 'cancelled' | 'interrupted';
1400
+ }
1401
+ interface KodaXTurnFailedEvent extends KodaXLiveEventMeta {
1402
+ readonly error: {
1403
+ readonly name: string;
1404
+ readonly message: string;
1405
+ readonly stack?: string;
1406
+ };
1407
+ }
1408
+ interface KodaXActivityEventMeta extends KodaXWorkflowEventMeta, Partial<KodaXLiveEventMeta> {
1387
1409
  readonly childAgentId?: string;
1388
1410
  readonly childAgentName?: string;
1389
1411
  readonly parentToolId?: string;
@@ -1473,8 +1495,11 @@ interface KodaXEvents {
1473
1495
  onSessionStart?: (info: {
1474
1496
  provider: string;
1475
1497
  sessionId: string;
1476
- }) => void;
1477
- onIterationStart?: (iter: number, maxIter: number) => void;
1498
+ } & Partial<KodaXLiveEventMeta>) => void;
1499
+ onTurnStarted?: (event: KodaXTurnStartedEvent) => void;
1500
+ onTurnCompleted?: (event: KodaXTurnCompletedEvent) => void;
1501
+ onTurnFailed?: (event: KodaXTurnFailedEvent) => void;
1502
+ onIterationStart?: (iter: number, maxIter: number, meta?: KodaXActivityEventMeta) => void;
1478
1503
  /** Called after each iteration with current token count for UI updates */
1479
1504
  onIterationEnd?: (info: {
1480
1505
  iter: number;
@@ -1493,19 +1518,19 @@ interface KodaXEvents {
1493
1518
  * for backward compatibility.
1494
1519
  */
1495
1520
  scope?: 'parent' | 'worker';
1496
- }) => void;
1497
- onCompactStart?: () => void;
1521
+ } & Partial<KodaXLiveEventMeta>) => void;
1522
+ onCompactStart?: (meta?: KodaXActivityEventMeta) => void;
1498
1523
  /** Emitted when compaction finishes and actually changed the context */
1499
- onCompact?: (estimatedTokens: number) => void;
1524
+ onCompact?: (estimatedTokens: number, meta?: KodaXActivityEventMeta) => void;
1500
1525
  /** Emitted when compaction changes the context so UI can refresh token usage immediately */
1501
1526
  onCompactStats?: (info: {
1502
1527
  tokensBefore: number;
1503
1528
  tokensAfter: number;
1504
- }) => void;
1529
+ } & Partial<KodaXLiveEventMeta>) => void;
1505
1530
  /** Emitted with the rewritten message history when automatic compaction changes the context. */
1506
- onCompactedMessages?: (messages: KodaXMessage[], update?: CompactionUpdate) => void;
1531
+ onCompactedMessages?: (messages: KodaXMessage[], update?: CompactionUpdate, meta?: KodaXActivityEventMeta) => void;
1507
1532
  /** Emitted to silently dismiss the compaction UI if compaction aborted or completed without changes */
1508
- onCompactEnd?: () => void;
1533
+ onCompactEnd?: (meta?: KodaXActivityEventMeta) => void;
1509
1534
  /** Whether the caller has queued follow-up input waiting for the next round */
1510
1535
  hasPendingInputs?: () => boolean;
1511
1536
  /**
@@ -1530,7 +1555,7 @@ interface KodaXEvents {
1530
1555
  * Fires once per Runner iteration boundary, with the array of
1531
1556
  * prompt contents in queue order. Empty arrays are not surfaced.
1532
1557
  */
1533
- onMidTurnUserMessages?: (contents: readonly string[]) => void;
1558
+ onMidTurnUserMessages?: (contents: readonly string[], meta?: KodaXActivityEventMeta) => void;
1534
1559
  onRetry?: (reason: string, attempt: number, maxAttempts: number, meta?: KodaXActivityEventMeta) => void;
1535
1560
  onProviderRateLimit?: (attempt: number, maxRetries: number, delayMs: number, meta?: KodaXActivityEventMeta) => void;
1536
1561
  /**
@@ -1567,8 +1592,8 @@ interface KodaXEvents {
1567
1592
  provider: string;
1568
1593
  model: string;
1569
1594
  effort: string;
1570
- }) => void;
1571
- onRepoIntelligenceTrace?: (event: KodaXRepoIntelligenceTraceEvent) => void;
1595
+ } & Partial<KodaXLiveEventMeta>) => void;
1596
+ onRepoIntelligenceTrace?: (event: KodaXRepoIntelligenceTraceEvent & Partial<KodaXLiveEventMeta>) => void;
1572
1597
  /**
1573
1598
  * Fired when the Sidecar Verifier produces an actionable message.
1574
1599
  *
@@ -1578,7 +1603,7 @@ interface KodaXEvents {
1578
1603
  * `blocked` is surfaced terminally to the user. Accept remains silent here
1579
1604
  * because there is no sidecar-to-agent reply to show.
1580
1605
  */
1581
- onSidecarMessage?: (event: KodaXSidecarMessageEvent) => void;
1606
+ onSidecarMessage?: (event: KodaXSidecarMessageEvent & Partial<KodaXLiveEventMeta>) => void;
1582
1607
  /**
1583
1608
  * FEATURE_097 (v0.7.34): emitted whenever the Scout-seeded todo list
1584
1609
  * changes — initial seed at `emit_scout_verdict`, per-item updates from
@@ -1588,28 +1613,28 @@ interface KodaXEvents {
1588
1613
  * in one event loop, so subscriber lag is not a real failure mode
1589
1614
  * (FEATURE_086 onRepoIntelligenceTrace single-rail precedent).
1590
1615
  */
1591
- onTodoUpdate?: (items: TodoList) => void;
1616
+ onTodoUpdate?: (items: TodoList, meta?: KodaXActivityEventMeta) => void;
1592
1617
  /**
1593
1618
  * Warn-only telemetry: a successful real work tool completed while the
1594
1619
  * visible todo list had pending items but no item marked in_progress.
1595
1620
  * The runner does not mutate the todo list for this signal; it only
1596
1621
  * nudges the next model turn to call todo_update explicitly.
1597
1622
  */
1598
- onTodoDriftWarning?: (event: KodaXTodoDriftWarningEvent) => void;
1623
+ onTodoDriftWarning?: (event: KodaXTodoDriftWarningEvent & Partial<KodaXLiveEventMeta>) => void;
1599
1624
  /** Structured provider recovery event (Feature 045) */
1600
1625
  onProviderRecovery?: (event: ProviderRecoveryEvent, meta?: KodaXActivityEventMeta) => void;
1601
- onComplete?: () => void;
1602
- onError?: (error: Error) => void;
1603
- onManagedTaskStatus?: (status: KodaXManagedTaskStatusEvent) => void;
1626
+ onComplete?: (meta?: KodaXActivityEventMeta) => void;
1627
+ onError?: (error: Error, meta?: KodaXActivityEventMeta) => void;
1628
+ onManagedTaskStatus?: (status: KodaXManagedTaskStatusEvent & Partial<KodaXLiveEventMeta>) => void;
1604
1629
  /**
1605
1630
  * FEATURE_247 (R4) — fired once at managed-task start with the effective
1606
1631
  * profile / tool scope / verification snapshot. Lets an SDK embedder confirm
1607
1632
  * the intended profile (e.g. Partner) actually entered the SDK managed task
1608
1633
  * and diagnose the tools + verification constraints it was given.
1609
1634
  */
1610
- onEffectiveConfig?: (config: KodaXEffectiveTaskConfig) => void;
1635
+ onEffectiveConfig?: (config: KodaXEffectiveTaskConfig & Partial<KodaXLiveEventMeta>) => void;
1611
1636
  /** FEATURE_229: workflow process snapshot stream for SDK/host panels. */
1612
- onWorkflowProcessEvent?: (event: WorkflowProcessEvent) => void;
1637
+ onWorkflowProcessEvent?: (event: WorkflowProcessEvent & Partial<KodaXLiveEventMeta>) => void;
1613
1638
  /**
1614
1639
  * ADR-049: per-agent digest stream for the inline `run_workflow` path. Fires
1615
1640
  * once per workflow child agent reaching a terminal/summary state
@@ -1618,7 +1643,7 @@ interface KodaXEvents {
1618
1643
  * and writes it to the transcript — matching the slash `/workflow` path and
1619
1644
  * `dispatch_child_task` children, whose summaries persist in scrollback.
1620
1645
  */
1621
- onWorkflowAgentDigest?: (event: KodaXWorkflowAgentDigestEvent) => void;
1646
+ onWorkflowAgentDigest?: (event: KodaXWorkflowAgentDigestEvent & Partial<KodaXLiveEventMeta>) => void;
1622
1647
  /**
1623
1648
  * Fired when Scout's managed-task completion is inferred but the harness
1624
1649
  * detected suspicious signals (mutation expected but none happened, budget
@@ -1632,7 +1657,7 @@ interface KodaXEvents {
1632
1657
  signals: KodaXScoutSuspiciousSignal[];
1633
1658
  sessionId?: string;
1634
1659
  lastTextPreview: string;
1635
- }) => void;
1660
+ } & Partial<KodaXLiveEventMeta>) => void;
1636
1661
  /**
1637
1662
  * FEATURE_167 (v0.7.41) — Evaluator terminal-verdict fallback.
1638
1663
  *
@@ -2277,6 +2302,17 @@ interface KodaXContextOptions {
2277
2302
  promptOverlay?: string;
2278
2303
  /** Optional task-engine surface label used to track managed tasks across UX entry points. */
2279
2304
  taskSurface?: KodaXTaskSurface;
2305
+ /**
2306
+ * Host-provided live-turn attribution for this invocation. Embedders that
2307
+ * resume, interrupt, or deliver queued prompts outside KodaX's own queue can
2308
+ * preserve the real delivery kind without the SDK guessing from event order.
2309
+ */
2310
+ liveTurn?: {
2311
+ deliveryKind?: KodaXTurnDeliveryKind;
2312
+ turnId?: string;
2313
+ deliveryId?: string;
2314
+ promptId?: string;
2315
+ };
2280
2316
  /** Optional directory where managed task artifacts should be written. */
2281
2317
  managedTaskWorkspaceDir?: string;
2282
2318
  /** Internal managed-worker protocol emission configuration. */
@@ -3370,5 +3406,5 @@ interface CreateBashPrefixExtractorOptions {
3370
3406
  */
3371
3407
  declare function createBashPrefixExtractor(opts: CreateBashPrefixExtractorOptions): BashPrefixExtractor;
3372
3408
 
3373
- export { BASH_POLICY_SPEC as B, LSP_SERVERS as aw, LspService as ay, buildGoalRuntimeBinding as b1, createBashPrefixExtractor as b2, decideWorkflowInvocation as b3, extractCommandPrefix as b4, getDefaultLspService as b5, makeDisabledGoalToolsContext as b6, providerResilienceConfigFromTimeouts as b7, shutdownDefaultLspService as b8, withGoalBeforeNextTurn as b9, withGoalStopHook as ba, workflowStartOutcomeConsumesTurn as bb };
3374
- export type { KodaXRuntimeVerificationContract as $, KodaXManagedTask as A, CapabilityRuntimeContract as C, DiagnosticsRequest as D, ExtensionRuntimeContract as E, FailureStage as F, GoalBlockedResult as G, KodaXManagedTaskRuntimeState as H, KodaXManagedTaskStatusEvent as I, KodaXManualSource as J, KodaXActivityEventMeta as K, KodaXManualTopic as L, KodaXManualTopicId as M, KodaXManualTopicInput as N, KodaXMemoryStrategy as O, KodaXOptions as P, KodaXOrchestrationVerdict as Q, KodaXParentReductionContract as R, KodaXProviderPolicyHints as S, KodaXRepoIntelligenceCapability as T, KodaXRepoIntelligenceMode as U, KodaXRepoIntelligenceResolvedMode as V, KodaXRepoIntelligenceTrace as W, KodaXRepoIntelligenceTraceEvent as X, KodaXRepoRoutingSignals as Y, KodaXResult as Z, KodaXRoleRoundSummary as _, BashPrefixExtractor as a, WorkflowToolHostResult as a$, KodaXSelfManualConfig as a0, KodaXSessionControl as a1, KodaXSessionMutators as a2, KodaXSessionOptions as a3, KodaXSidecarMessageEvent as a4, KodaXSkillDynamicContextPolicy as a5, KodaXSkillInvocationContext as a6, KodaXSkillMap as a7, KodaXSkillProjectionConfidence as a8, KodaXTaskCapabilityHint as a9, ProviderExecutionState as aA, ProviderRecoveryEvent as aB, ProviderResilienceConfig as aC, ProviderResiliencePolicy as aD, RecoveryAction as aE, RecoveryDecision as aF, RecoveryLadderStep as aG, RecoveryResult as aH, ResilienceClassification as aI, ResilienceErrorClass as aJ, ResolveKodaXManualInput as aK, ResolveKodaXManualOptions as aL, ResolveKodaXManualResult as aM, RuntimeDefaultsSnapshot as aN, TodoItem as aO, TodoList as aP, TodoStatus as aQ, ToolSideEffect as aR, WorkflowHostPolicy as aS, WorkflowInvocationAction as aT, WorkflowInvocationPolicyDecision as aU, WorkflowInvocationPolicyInput as aV, WorkflowInvocationSource as aW, WorkflowRunProgressView as aX, WorkflowStartOutcome as aY, WorkflowToolHost as aZ, WorkflowToolHostInlineInput as a_, KodaXTaskContract as aa, KodaXTaskEvidenceArtifact as ab, KodaXTaskEvidenceBundle as ac, KodaXTaskEvidenceEntry as ad, KodaXTaskRole as ae, KodaXTaskRoleAssignment as af, KodaXTaskStatus as ag, KodaXTaskSurface as ah, KodaXTaskToolPolicy as ai, KodaXTaskVerificationContract as aj, KodaXTaskVerificationCriterion as ak, KodaXTaskWorkItem as al, KodaXTimeoutConfig as am, KodaXToolEventMeta as an, KodaXToolExecutionContext as ao, KodaXToolVisibilityMeta as ap, KodaXToolVisibilityPolicy as aq, KodaXVerificationScorecard as ar, KodaXVerificationScorecardCriterion as as, KodaXWorkflowAgentDigestEvent as at, KodaXWorkflowEventMeta as au, KodaXWorkflowTimeoutConfig as av, LspServerInfo as ax, LspServiceConfig as az, BashPrefixResult as b, WorkflowToolHostStartResult as b0, BoundExtensionRuntimeController as c, ChildSnapshotEvent as d, CreateBashPrefixExtractorOptions as e, ExtractCommandPrefixOptions as f, GoalCompleteResult as g, GoalCreateInput as h, GoalLifecycleContext as i, GoalRuntimeBinding as j, GoalRuntimeBindingDeps as k, GoalToolsContext as l, KodaXAgentMode as m, KodaXAgentProfile as n, KodaXBudgetDisclosureZone as o, KodaXBudgetExtensionRequest as p, KodaXChildAgentResult as q, KodaXChildContextBundle as r, KodaXChildExecutionResult as s, KodaXCompactionOverride as t, KodaXContextOptions as u, KodaXContextTokenSnapshot as v, KodaXEffectiveTaskConfig as w, KodaXEvents as x, KodaXManagedBudgetSnapshot as y, KodaXManagedProtocolPayload as z };
3409
+ export { BASH_POLICY_SPEC as B, LSP_SERVERS as aB, LspService as aD, buildGoalRuntimeBinding as b6, createBashPrefixExtractor as b7, decideWorkflowInvocation as b8, extractCommandPrefix as b9, getDefaultLspService as ba, makeDisabledGoalToolsContext as bb, providerResilienceConfigFromTimeouts as bc, shutdownDefaultLspService as bd, withGoalBeforeNextTurn as be, withGoalStopHook as bf, workflowStartOutcomeConsumesTurn as bg };
3410
+ export type { KodaXRoleRoundSummary as $, KodaXManagedProtocolPayload as A, CapabilityRuntimeContract as C, DiagnosticsRequest as D, ExtensionRuntimeContract as E, FailureStage as F, GoalBlockedResult as G, KodaXManagedTask as H, KodaXManagedTaskRuntimeState as I, KodaXManagedTaskStatusEvent as J, KodaXActivityEventMeta as K, KodaXManualSource as L, KodaXManualTopic as M, KodaXManualTopicId as N, KodaXManualTopicInput as O, KodaXMemoryStrategy as P, KodaXOptions as Q, KodaXOrchestrationVerdict as R, KodaXParentReductionContract as S, KodaXProviderPolicyHints as T, KodaXRepoIntelligenceCapability as U, KodaXRepoIntelligenceMode as V, KodaXRepoIntelligenceResolvedMode as W, KodaXRepoIntelligenceTrace as X, KodaXRepoIntelligenceTraceEvent as Y, KodaXRepoRoutingSignals as Z, KodaXResult as _, BashPrefixExtractor as a, WorkflowInvocationSource as a$, KodaXRuntimeVerificationContract as a0, KodaXSelfManualConfig as a1, KodaXSessionControl as a2, KodaXSessionMutators as a3, KodaXSessionOptions as a4, KodaXSidecarMessageEvent as a5, KodaXSkillDynamicContextPolicy as a6, KodaXSkillInvocationContext as a7, KodaXSkillMap as a8, KodaXSkillProjectionConfidence as a9, KodaXWorkflowTimeoutConfig as aA, LspServerInfo as aC, LspServiceConfig as aE, ProviderExecutionState as aF, ProviderRecoveryEvent as aG, ProviderResilienceConfig as aH, ProviderResiliencePolicy as aI, RecoveryAction as aJ, RecoveryDecision as aK, RecoveryLadderStep as aL, RecoveryResult as aM, ResilienceClassification as aN, ResilienceErrorClass as aO, ResolveKodaXManualInput as aP, ResolveKodaXManualOptions as aQ, ResolveKodaXManualResult as aR, RuntimeDefaultsSnapshot as aS, TodoItem as aT, TodoList as aU, TodoStatus as aV, ToolSideEffect as aW, WorkflowHostPolicy as aX, WorkflowInvocationAction as aY, WorkflowInvocationPolicyDecision as aZ, WorkflowInvocationPolicyInput as a_, KodaXTaskCapabilityHint as aa, KodaXTaskContract as ab, KodaXTaskEvidenceArtifact as ac, KodaXTaskEvidenceBundle as ad, KodaXTaskEvidenceEntry as ae, KodaXTaskRole as af, KodaXTaskRoleAssignment as ag, KodaXTaskStatus as ah, KodaXTaskSurface as ai, KodaXTaskToolPolicy as aj, KodaXTaskVerificationContract as ak, KodaXTaskVerificationCriterion as al, KodaXTaskWorkItem as am, KodaXTimeoutConfig as an, KodaXToolEventMeta as ao, KodaXToolExecutionContext as ap, KodaXToolVisibilityMeta as aq, KodaXToolVisibilityPolicy as ar, KodaXTurnCompletedEvent as as, KodaXTurnDeliveryKind as at, KodaXTurnFailedEvent as au, KodaXTurnStartedEvent as av, KodaXVerificationScorecard as aw, KodaXVerificationScorecardCriterion as ax, KodaXWorkflowAgentDigestEvent as ay, KodaXWorkflowEventMeta as az, BashPrefixResult as b, WorkflowRunProgressView as b0, WorkflowStartOutcome as b1, WorkflowToolHost as b2, WorkflowToolHostInlineInput as b3, WorkflowToolHostResult as b4, WorkflowToolHostStartResult as b5, BoundExtensionRuntimeController as c, ChildSnapshotEvent as d, CreateBashPrefixExtractorOptions as e, ExtractCommandPrefixOptions as f, GoalCompleteResult as g, GoalCreateInput as h, GoalLifecycleContext as i, GoalRuntimeBinding as j, GoalRuntimeBindingDeps as k, GoalToolsContext as l, KodaXAgentMode as m, KodaXAgentProfile as n, KodaXBudgetDisclosureZone as o, KodaXBudgetExtensionRequest as p, KodaXChildAgentResult as q, KodaXChildContextBundle as r, KodaXChildExecutionResult as s, KodaXCompactionOverride as t, KodaXContextOptions as u, KodaXContextTokenSnapshot as v, KodaXEffectiveTaskConfig as w, KodaXEvents as x, KodaXLiveEventMeta as y, KodaXManagedBudgetSnapshot as z };
@@ -1,4 +1,4 @@
1
- import { F as KodaXReasoningProfile } from './types.d-Ci5YPFEh.js';
1
+ import { F as KodaXReasoningProfile } from './types.d-Bp4Lm1jv.js';
2
2
 
3
3
  type CapabilityCacheSource = 'observed' | 'probed';
4
4
  interface CapabilityCacheEntry {
@@ -1,8 +1,8 @@
1
1
  import { M as McpConnectMode, a as McpServerConfig, b as McpServersConfig, c as McpTransportKind } from './config.d-CJy1WENT.js';
2
- import { K as KodaXBaseProvider } from './base.d-BA9Doaj_.js';
2
+ import { K as KodaXBaseProvider } from './base.d-DalIRhbb.js';
3
3
  import { a as CostTracker } from './cost-tracker.d-CBLk1fiD.js';
4
- import { aO as RunnerToolCall } from './process.d-BOrAxjvM.js';
5
- import { g as ToolGuardrail } from './types.d-CE_Ter29.js';
4
+ import { aP as RunnerToolCall } from './process.d-C93UMgPK.js';
5
+ import { g as ToolGuardrail } from './types.d-CSZAMmU-.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 KodaXMessage, _ as KodaXToolDefinition, E as KodaXReasoningMode, a6 as KodaXWireReasoningEffort, a0 as KodaXToolResultContentItem, V as KodaXThinkingBlock, H as KodaXRedactedThinkingBlock } from './types.d-Ci5YPFEh.js';
1
+ import { j as KodaXMessage, a0 as KodaXToolDefinition, E as KodaXReasoningMode, a8 as KodaXWireReasoningEffort, a2 as KodaXToolResultContentItem, X as KodaXThinkingBlock, H as KodaXRedactedThinkingBlock } from './types.d-Bp4Lm1jv.js';
2
2
 
3
3
  /**
4
4
  * @kodax-ai/agent Types
@@ -35,6 +35,14 @@ interface KodaXSessionEntryBase {
35
35
  id: string;
36
36
  parentId: string | null;
37
37
  timestamp: string;
38
+ /**
39
+ * Stable logical identity for this transcript item. Cloned/forked entries get
40
+ * a fresh physical `id` but keep their source entry's `logicalId`, allowing
41
+ * SDK hosts to group or fold cloned history without comparing content.
42
+ */
43
+ logicalId?: string;
44
+ /** Root physical entry id this item was cloned from, when it is a clone. */
45
+ sourceEntryId?: string;
38
46
  }
39
47
  interface KodaXSessionMessageEntry extends KodaXSessionEntryBase {
40
48
  type: 'message';
@@ -82,6 +90,13 @@ interface KodaXSessionArchiveMarkerEntry extends KodaXSessionEntryBase {
82
90
  /** Brief summary of the archived content */
83
91
  summary: string;
84
92
  }
93
+ interface KodaXSessionClientNoticeEntry extends KodaXSessionEntryBase {
94
+ type: 'client_notice';
95
+ source: string;
96
+ content: string;
97
+ turnId?: string;
98
+ payload?: KodaXJsonValue;
99
+ }
85
100
  type KodaXGoalStatus = 'active' | 'paused' | 'budget_limited' | 'blocked' | 'complete';
86
101
  /**
87
102
  * Persistent user-set goal state. v0.7.44 FEATURE_192 — backs the
@@ -120,7 +135,7 @@ interface KodaXSessionGoalEntry extends KodaXSessionEntryBase {
120
135
  goal: KodaXGoalState | null;
121
136
  event: KodaXGoalEventType;
122
137
  }
123
- type KodaXSessionEntry = KodaXSessionMessageEntry | KodaXSessionCompactionEntry | KodaXSessionBranchSummaryEntry | KodaXSessionLabelEntry | KodaXSessionArchiveMarkerEntry | KodaXSessionGoalEntry;
138
+ type KodaXSessionEntry = KodaXSessionMessageEntry | KodaXSessionCompactionEntry | KodaXSessionBranchSummaryEntry | KodaXSessionLabelEntry | KodaXSessionArchiveMarkerEntry | KodaXSessionClientNoticeEntry | KodaXSessionGoalEntry;
124
139
  interface KodaXSessionArtifactLedgerEntry {
125
140
  id: string;
126
141
  kind: 'file_read' | 'file_modified' | 'file_created' | 'file_deleted' | 'path_scope' | 'search_scope' | 'command_scope' | 'check_result' | 'decision' | 'image_input' | 'tombstone';
@@ -157,7 +172,7 @@ interface KodaXSessionNavigationOptions {
157
172
  summarizeCurrentBranch?: boolean;
158
173
  }
159
174
  interface KodaXSessionTreeNode {
160
- entry: Exclude<KodaXSessionEntry, KodaXSessionLabelEntry | KodaXSessionGoalEntry>;
175
+ entry: Exclude<KodaXSessionEntry, KodaXSessionLabelEntry | KodaXSessionGoalEntry | KodaXSessionClientNoticeEntry>;
161
176
  children: KodaXSessionTreeNode[];
162
177
  label?: string;
163
178
  active: boolean;
@@ -3084,5 +3099,5 @@ declare function isFinalWorkflowProcessStatus(status: WorkflowProcessStatus): bo
3084
3099
  declare function normalizeHostMetadata(value: unknown): Record<string, string> | undefined;
3085
3100
  declare function createWorkflowProcessTracker(options: WorkflowProcessTrackerOptions): WorkflowProcessTracker;
3086
3101
 
3087
- export { ASK_USER_BACK_SIGNAL as A, DEFAULT_SYSTEM_CAP as D, InvariantSession as N, Runner as aK, MAX_TOOL_LOOP_ITERATIONS as as, SpanImpl as b1, Tracer as bj, WorkflowEventRecorder as bu, _resetAdmittedAgentBindings as c7, _resetPresetDispatchers as c8, asSingleSelection as c9, setAdmittedAgentBindings as cA, buildAssistantMessageFromLlmResult as ca, buildSystemPrompt as cb, buildToolResultMessage as cc, createAgent as cd, createHandoff as ce, createInMemorySession as cf, createInvariantSessionForAgent as cg, createStateWriter as ch, createTrace as ci, createWorkflowProcessTracker as cj, defaultTracer as ck, detectInstructionsInjection as cl, discoverInstances as cm, executeRunnerToolCall as cn, extractAssistantTextFromMessage as co, getActiveUserInteraction as cp, getAdmittedAgentBindings as cq, isFinalWorkflowProcessStatus as cr, isRunnableTool as cs, isRunnerLlmResult as ct, normalizeHostMetadata as cu, registerChildTask as cv, registerPresetDispatcher as cw, requestTaskStop as cx, runAdmissionAudit as cy, setActiveUserInteraction as cz };
3088
- export type { KodaXInputArtifactSource as $, GuardrailSpanData as B, ChildTaskRegistry as C, EvidenceSpanData as E, FanoutSpanData as F, GenerationSpanData as G, Handoff as H, HandoffSpanData as I, InMemorySessionOptions as J, InstanceDiscoveryFs as K, InvariantId as L, InvariantResult as M, KodaXCompactMemoryProgress as O, KodaXCompactMemorySeed as P, KodaXExtensionSessionRecord as Q, KodaXExtensionSessionState as R, KodaXExtensionStore as S, KodaXExtensionStoreEntry as T, KodaXFileInputArtifact as U, KodaXGoalEventType as V, KodaXGoalState as W, KodaXGoalStatus as X, KodaXImageInputArtifact as Y, KodaXImageMediaType as Z, KodaXInputArtifact as _, AdmissionAuditOptions as a, SpanData as a$, KodaXJsonValue as a0, KodaXSessionArchiveMarkerEntry as a1, KodaXSessionArtifactLedgerEntry as a2, KodaXSessionBranchSummaryEntry as a3, KodaXSessionCompactionEntry as a4, KodaXSessionData as a5, KodaXSessionEntry as a6, KodaXSessionEntryBase as a7, KodaXSessionGoalEntry as a8, KodaXSessionLabelEntry as a9, ReadonlyMutationTracker as aA, ReadonlyRecorder as aB, ReasoningDepth as aC, RecentlyModifiedFile as aD, RequestTaskStopOptions as aE, RequestTaskStopResult as aF, RunEvent as aG, RunOptions as aH, RunResult as aI, RunnableTool as aJ, RunnerEvent as aL, RunnerLlmResult as aM, RunnerLlmReturn as aN, RunnerToolCall as aO, RunnerToolContext as aP, RunnerToolObserver as aQ, RunnerToolResult as aR, Session as aS, SessionDispatchResult as aT, SessionEntry as aU, SessionErrorMetadata as aV, SessionExtension as aW, SessionForkOptions as aX, SessionMeta as aY, SessionStateSnapshot as aZ, Span as a_, KodaXSessionLineage as aa, KodaXSessionMessageEntry as ab, KodaXSessionMeta as ac, KodaXSessionNavigationOptions as ad, KodaXSessionRuntimeInfo as ae, KodaXSessionScope as af, KodaXSessionStorage as ag, KodaXSessionTreeNode as ah, KodaXSessionUiHistoryItem as ai, KodaXSessionUiHistoryItemType as aj, KodaXSessionUiTextHistoryItem as ak, KodaXSessionUiTextHistoryItemType as al, KodaXSessionUiToolCall as am, KodaXSessionUiToolCallStatus as an, KodaXSessionUiToolGroupHistoryItem as ao, KodaXSessionWorkspaceKind as ap, KodaXVideoInputArtifact as aq, KodaXVideoMediaType as ar, ManifestPatch as at, MessageEntry as au, ObserveCtx as av, PersistedSessionState as aw, PresetDispatcher as ax, PresetTracingContext as ay, QualityInvariant as az, AdmissionCtx as b, WorkflowTaskStatus as b$, SpanError as b0, SpanImplOptions as b2, StartTraceOptions as b3, StateWriter as b4, StateWriterFs as b5, StateWriterOptions as b6, StopHookContext as b7, StopHookFn as b8, StopHookResult as b9, WorkflowModelHint as bA, WorkflowModule as bB, WorkflowParallelOptions as bC, WorkflowProcessArtifact as bD, WorkflowProcessCounts as bE, WorkflowProcessEvent as bF, WorkflowProcessItem as bG, WorkflowProcessItemKind as bH, WorkflowProcessItemOrigin as bI, WorkflowProcessItemStatus as bJ, WorkflowProcessProgress as bK, WorkflowProcessSnapshot as bL, WorkflowProcessSource as bM, WorkflowProcessStatus as bN, WorkflowProcessSummaryStatus as bO, WorkflowProcessTokenUsage as bP, WorkflowProcessTracker as bQ, WorkflowProcessTrackerOptions as bR, WorkflowRun as bS, WorkflowRunState as bT, WorkflowRunStatus as bU, WorkflowSpawnAgentInput as bV, WorkflowSynthesis as bW, WorkflowSynthesizeInput as bX, WorkflowTaskHandle as bY, WorkflowTaskResult as bZ, WorkflowTaskSnapshot as b_, StopHookSpanData as ba, SystemCap as bb, TaskAbortRegistry as bc, TerminalCtx as bd, ToolCallSpanData as be, ToolCapability as bf, ToolPermission as bg, Trace as bh, TraceOptions as bi, TracerOptions as bk, UserInteraction as bl, WorkflowAgentBackend as bm, WorkflowApi as bn, WorkflowApproval as bo, WorkflowApprovalSummary as bp, WorkflowArtifactRef as bq, WorkflowBudget as br, WorkflowEvent as bs, WorkflowEventCorrelation as bt, WorkflowEventType as bv, WorkflowIsolation as bw, WorkflowLimits as bx, WorkflowLogEvent as by, WorkflowMeta as bz, AdmissionVerdict as c, WorkflowTaskSummaryEventUpdate as c0, WorkflowTaskSummaryKind as c1, WorkflowTaskSummaryUpdate as c2, WorkflowTaskUsage as c3, WorkflowTaskVerification as c4, WorkflowTaskVerificationResult as c5, WorkflowWaitOptions as c6, AdmittedHandle as d, Agent as e, AgentManifest as f, AgentMessage as g, AgentMiddlewareDeclaration as h, AgentReasoningProfile as i, AgentSpanData as j, AgentTool as k, AskUserMultiOptions as l, AskUserQuestionItem as m, AskUserQuestionOptions as n, CompactionAnchor as o, CompactionConfig as p, CompactionDetails as q, CompactionResult as r, CompactionSpanData as s, CompactionUpdate as t, CurrentTodoSummary as u, Deliverable as v, DiscoveredInstance as w, DiscoveryOptions as x, FileOperations as y, Guardrail as z };
3102
+ export { ASK_USER_BACK_SIGNAL as A, DEFAULT_SYSTEM_CAP as D, InvariantSession as N, Runner as aL, MAX_TOOL_LOOP_ITERATIONS as at, SpanImpl as b2, Tracer as bk, WorkflowEventRecorder as bv, _resetAdmittedAgentBindings as c8, _resetPresetDispatchers as c9, setActiveUserInteraction as cA, setAdmittedAgentBindings as cB, asSingleSelection as ca, buildAssistantMessageFromLlmResult as cb, buildSystemPrompt as cc, buildToolResultMessage as cd, createAgent as ce, createHandoff as cf, createInMemorySession as cg, createInvariantSessionForAgent as ch, createStateWriter as ci, createTrace as cj, createWorkflowProcessTracker as ck, defaultTracer as cl, detectInstructionsInjection as cm, discoverInstances as cn, executeRunnerToolCall as co, extractAssistantTextFromMessage as cp, getActiveUserInteraction as cq, getAdmittedAgentBindings as cr, isFinalWorkflowProcessStatus as cs, isRunnableTool as ct, isRunnerLlmResult as cu, normalizeHostMetadata as cv, registerChildTask as cw, registerPresetDispatcher as cx, requestTaskStop as cy, runAdmissionAudit as cz };
3103
+ export type { KodaXInputArtifactSource as $, GuardrailSpanData as B, ChildTaskRegistry as C, EvidenceSpanData as E, FanoutSpanData as F, GenerationSpanData as G, Handoff as H, HandoffSpanData as I, InMemorySessionOptions as J, InstanceDiscoveryFs as K, InvariantId as L, InvariantResult as M, KodaXCompactMemoryProgress as O, KodaXCompactMemorySeed as P, KodaXExtensionSessionRecord as Q, KodaXExtensionSessionState as R, KodaXExtensionStore as S, KodaXExtensionStoreEntry as T, KodaXFileInputArtifact as U, KodaXGoalEventType as V, KodaXGoalState as W, KodaXGoalStatus as X, KodaXImageInputArtifact as Y, KodaXImageMediaType as Z, KodaXInputArtifact as _, AdmissionAuditOptions as a, Span as a$, KodaXJsonValue as a0, KodaXSessionArchiveMarkerEntry as a1, KodaXSessionArtifactLedgerEntry as a2, KodaXSessionBranchSummaryEntry as a3, KodaXSessionClientNoticeEntry as a4, KodaXSessionCompactionEntry as a5, KodaXSessionData as a6, KodaXSessionEntry as a7, KodaXSessionEntryBase as a8, KodaXSessionGoalEntry as a9, QualityInvariant as aA, ReadonlyMutationTracker as aB, ReadonlyRecorder as aC, ReasoningDepth as aD, RecentlyModifiedFile as aE, RequestTaskStopOptions as aF, RequestTaskStopResult as aG, RunEvent as aH, RunOptions as aI, RunResult as aJ, RunnableTool as aK, RunnerEvent as aM, RunnerLlmResult as aN, RunnerLlmReturn as aO, RunnerToolCall as aP, RunnerToolContext as aQ, RunnerToolObserver as aR, RunnerToolResult as aS, Session as aT, SessionDispatchResult as aU, SessionEntry as aV, SessionErrorMetadata as aW, SessionExtension as aX, SessionForkOptions as aY, SessionMeta as aZ, SessionStateSnapshot as a_, KodaXSessionLabelEntry as aa, KodaXSessionLineage as ab, KodaXSessionMessageEntry as ac, KodaXSessionMeta as ad, KodaXSessionNavigationOptions as ae, KodaXSessionRuntimeInfo as af, KodaXSessionScope as ag, KodaXSessionStorage as ah, KodaXSessionTreeNode as ai, KodaXSessionUiHistoryItem as aj, KodaXSessionUiHistoryItemType as ak, KodaXSessionUiTextHistoryItem as al, KodaXSessionUiTextHistoryItemType as am, KodaXSessionUiToolCall as an, KodaXSessionUiToolCallStatus as ao, KodaXSessionUiToolGroupHistoryItem as ap, KodaXSessionWorkspaceKind as aq, KodaXVideoInputArtifact as ar, KodaXVideoMediaType as as, ManifestPatch as au, MessageEntry as av, ObserveCtx as aw, PersistedSessionState as ax, PresetDispatcher as ay, PresetTracingContext as az, AdmissionCtx as b, WorkflowTaskSnapshot as b$, SpanData as b0, SpanError as b1, SpanImplOptions as b3, StartTraceOptions as b4, StateWriter as b5, StateWriterFs as b6, StateWriterOptions as b7, StopHookContext as b8, StopHookFn as b9, WorkflowMeta as bA, WorkflowModelHint as bB, WorkflowModule as bC, WorkflowParallelOptions as bD, WorkflowProcessArtifact as bE, WorkflowProcessCounts as bF, WorkflowProcessEvent as bG, WorkflowProcessItem as bH, WorkflowProcessItemKind as bI, WorkflowProcessItemOrigin as bJ, WorkflowProcessItemStatus as bK, WorkflowProcessProgress as bL, WorkflowProcessSnapshot as bM, WorkflowProcessSource as bN, WorkflowProcessStatus as bO, WorkflowProcessSummaryStatus as bP, WorkflowProcessTokenUsage as bQ, WorkflowProcessTracker as bR, WorkflowProcessTrackerOptions as bS, WorkflowRun as bT, WorkflowRunState as bU, WorkflowRunStatus as bV, WorkflowSpawnAgentInput as bW, WorkflowSynthesis as bX, WorkflowSynthesizeInput as bY, WorkflowTaskHandle as bZ, WorkflowTaskResult as b_, StopHookResult as ba, StopHookSpanData as bb, SystemCap as bc, TaskAbortRegistry as bd, TerminalCtx as be, ToolCallSpanData as bf, ToolCapability as bg, ToolPermission as bh, Trace as bi, TraceOptions as bj, TracerOptions as bl, UserInteraction as bm, WorkflowAgentBackend as bn, WorkflowApi as bo, WorkflowApproval as bp, WorkflowApprovalSummary as bq, WorkflowArtifactRef as br, WorkflowBudget as bs, WorkflowEvent as bt, WorkflowEventCorrelation as bu, WorkflowEventType as bw, WorkflowIsolation as bx, WorkflowLimits as by, WorkflowLogEvent as bz, AdmissionVerdict as c, WorkflowTaskStatus as c0, WorkflowTaskSummaryEventUpdate as c1, WorkflowTaskSummaryKind as c2, WorkflowTaskSummaryUpdate as c3, WorkflowTaskUsage as c4, WorkflowTaskVerification as c5, WorkflowTaskVerificationResult as c6, WorkflowWaitOptions as c7, AdmittedHandle as d, Agent as e, AgentManifest as f, AgentMessage as g, AgentMiddlewareDeclaration as h, AgentReasoningProfile as i, AgentSpanData as j, AgentTool as k, AskUserMultiOptions as l, AskUserQuestionItem as m, AskUserQuestionOptions as n, CompactionAnchor as o, CompactionConfig as p, CompactionDetails as q, CompactionResult as r, CompactionSpanData as s, CompactionUpdate as t, CurrentTodoSummary as u, Deliverable as v, DiscoveredInstance as w, DiscoveryOptions as x, FileOperations as y, Guardrail as z };
@@ -1,6 +1,6 @@
1
- import { E as KodaXReasoningMode, L as KodaXStableEffortIntent, a6 as KodaXWireReasoningEffort, F as KodaXReasoningProfile, W as KodaXThinkingBudgetMap, X as KodaXThinkingDepth, p as KodaXProviderConfig, A as KodaXReasoningCapability, G as KodaXReasoningRequest, m as KodaXNormalizedReasoningRequest, S as KodaXTaskType, a4 as KodaXVerifyCredentialResult, _ as KodaXToolDefinition, j as KodaXMessage, x as KodaXProviderStreamOptions, M as KodaXStreamResult, k as KodaXModelDescriptor, o as KodaXProviderCapabilityProfile, a5 as KodaXVerifyStrategy, d as KodaXCustomProviderConfig, i as KodaXListModelsResult } from './types.d-Ci5YPFEh.js';
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';
2
2
  import Anthropic from '@anthropic-ai/sdk';
3
- import { K as KodaXBaseProvider } from './base.d-BA9Doaj_.js';
3
+ import { K as KodaXBaseProvider } from './base.d-DalIRhbb.js';
4
4
  import OpenAI from 'openai';
5
5
 
6
6
  /**
@@ -1,6 +1,6 @@
1
- import { j as KodaXMessage } from './types.d-Ci5YPFEh.js';
2
- import { Q as QueueEventListener, f as QueuedMessage, E as EnqueueInput, D as DequeueFilter } from './types.d-CE_Ter29.js';
3
- import { g as AgentMessage, aU as SessionEntry, aS as Session, aW as SessionExtension, aa as KodaXSessionLineage, a0 as KodaXJsonValue, q as CompactionDetails, P as KodaXCompactMemorySeed, a6 as KodaXSessionEntry, ah as KodaXSessionTreeNode, a9 as KodaXSessionLabelEntry, a8 as KodaXSessionGoalEntry, ad as KodaXSessionNavigationOptions, a2 as KodaXSessionArtifactLedgerEntry, y as FileOperations, bz as WorkflowMeta, bA as WorkflowModelHint, bB as WorkflowModule, bR as WorkflowProcessTrackerOptions, bs as WorkflowEvent, bL as WorkflowProcessSnapshot, bF as WorkflowProcessEvent } from './process.d-BOrAxjvM.js';
1
+ import { j as KodaXMessage } from './types.d-Bp4Lm1jv.js';
2
+ import { Q as QueueEventListener, f as QueuedMessage, E as EnqueueInput, D as DequeueFilter } from './types.d-CSZAMmU-.js';
3
+ import { g as AgentMessage, aV as SessionEntry, aT as Session, aX as SessionExtension, ab as KodaXSessionLineage, a0 as KodaXJsonValue, q as CompactionDetails, P as KodaXCompactMemorySeed, a7 as KodaXSessionEntry, ai as KodaXSessionTreeNode, aa as KodaXSessionLabelEntry, a9 as KodaXSessionGoalEntry, a4 as KodaXSessionClientNoticeEntry, ae as KodaXSessionNavigationOptions, a2 as KodaXSessionArtifactLedgerEntry, y as FileOperations, bA as WorkflowMeta, bB as WorkflowModelHint, bC as WorkflowModule, bS as WorkflowProcessTrackerOptions, bt as WorkflowEvent, bM as WorkflowProcessSnapshot, bG as WorkflowProcessEvent } from './process.d-C93UMgPK.js';
4
4
 
5
5
  /**
6
6
  * @kodax-ai/agent Constants
@@ -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>;
571
+ type NavigableSessionEntry = Exclude<KodaXSessionEntry, KodaXSessionLabelEntry | KodaXSessionGoalEntry | KodaXSessionClientNoticeEntry>;
572
572
  /**
573
573
  * Reconcile a linear message list against an existing lineage tree.
574
574
  *
@@ -1,7 +1,7 @@
1
- import { b as PermissionMode, F as FileSessionStorage, S as SessionData } from './storage.d-DHL3XpAL.js';
2
- import { E as KodaXReasoningMode, j as KodaXMessage, c as KodaXContentBlock } from './types.d-Ci5YPFEh.js';
3
- import { m as KodaXAgentMode } from './bash-prefix-extractor.d-BNdpV4Cf.js';
4
- import { ai as KodaXSessionUiHistoryItem, am as KodaXSessionUiToolCall } from './process.d-BOrAxjvM.js';
1
+ import { b as PermissionMode, F as FileSessionStorage, S as SessionData } from './storage.d-DlZS0g8w.js';
2
+ import { E as KodaXReasoningMode, j as KodaXMessage, c as KodaXContentBlock, R as KodaXTaskResultMetadata } from './types.d-Bp4Lm1jv.js';
3
+ import { m as KodaXAgentMode } from './bash-prefix-extractor.d-Ds1THKeH.js';
4
+ import { aj as KodaXSessionUiHistoryItem, an as KodaXSessionUiToolCall, a0 as KodaXJsonValue } from './process.d-C93UMgPK.js';
5
5
 
6
6
  /**
7
7
  * TextBuffer - Text buffer management class - 文本缓冲区管理类
@@ -742,6 +742,9 @@ type RestoredHistorySeed = {
742
742
  type: "sidecar";
743
743
  text: string;
744
744
  verdict?: "revise" | "blocked";
745
+ } | {
746
+ type: "task_completed";
747
+ text: string;
745
748
  } | {
746
749
  type: "tool_summary";
747
750
  text: string;
@@ -749,7 +752,7 @@ type RestoredHistorySeed = {
749
752
  type: "tool_group";
750
753
  tools: KodaXSessionUiToolCall[];
751
754
  };
752
- /** Convert a RestoredHistorySeed to a CreatableHistoryItem. tool_summary → event with icon. */
755
+ /** Convert a RestoredHistorySeed to a CreatableHistoryItem. tool_summary / task_completed → event with icon. */
753
756
  declare function seedToHistoryItem(seed: RestoredHistorySeed): CreatableHistoryItem;
754
757
  declare function toolCallSeedToHistoryToolCall(tool: KodaXSessionUiToolCall): ToolCall;
755
758
  /**
@@ -762,8 +765,10 @@ interface HistorySeedSourceMessage {
762
765
  /**
763
766
  * Provenance marker persisted on host-injected messages. `'sidecar-verifier'`
764
767
  * tags the synthetic user message the Sidecar Verifier injects on a `revise`
765
- * verdict, so restore can render it under the Sidecar identity instead of
766
- * swallowing it with the generic `_synthetic` skip.
768
+ * verdict; `'task-completed'` tags the synthetic user message carrying a
769
+ * dispatch_child_task / run_workflow `<task-completed>` result banner. Both are
770
+ * rendered under their own identity on restore instead of being swallowed by
771
+ * the generic `_synthetic` skip.
767
772
  */
768
773
  _source?: string;
769
774
  }
@@ -860,21 +865,44 @@ interface SessionSummary {
860
865
  * surfaced when `includeArchived` is set). */
861
866
  readonly archived?: boolean;
862
867
  }
863
- type SessionTranscriptEntryType = 'message' | 'compaction' | 'branch_summary';
868
+ type SessionTranscriptEntryType = 'message' | 'compaction' | 'branch_summary' | 'client_notice'
869
+ /**
870
+ * Synthetic task/workflow completion entry derived from `_taskResult`,
871
+ * `_taskResults`, or legacy `<task-completed>` banners. The original
872
+ * `KodaXMessage` is still exposed on `message`, but consumers that want a
873
+ * complete transcript should not filter only `type === 'message'`.
874
+ */
875
+ | 'task_result';
876
+ type SessionTranscriptEntrySource = 'user' | 'assistant' | 'workflow' | 'child_task' | 'system' | 'client';
864
877
  interface SessionTranscriptEntry {
865
878
  readonly entryId: string;
866
879
  readonly parentId: string | null;
880
+ /** Stable logical identity shared by cloned/forked copies of the same entry. */
881
+ readonly logicalId: string;
882
+ /** Root source physical entry id when this transcript entry was cloned/forked. */
883
+ readonly sourceEntryId?: string;
867
884
  readonly timestamp: string;
868
885
  readonly type: SessionTranscriptEntryType;
886
+ readonly source?: SessionTranscriptEntrySource;
887
+ readonly turnId?: string;
869
888
  readonly message: KodaXMessage;
870
889
  readonly active: boolean;
871
890
  readonly summary?: string;
891
+ readonly payload?: unknown;
892
+ readonly taskResults?: readonly KodaXTaskResultMetadata[];
872
893
  }
873
894
  interface FullTranscriptSessionData extends Omit<SessionData, 'messages'> {
874
895
  readonly messages: KodaXMessage[];
875
896
  readonly activeMessages: KodaXMessage[];
876
897
  readonly transcriptEntries: SessionTranscriptEntry[];
877
898
  }
899
+ interface AppendClientNoticeOptions {
900
+ readonly source?: string;
901
+ readonly content: string;
902
+ readonly timestamp?: string;
903
+ readonly turnId?: string;
904
+ readonly payload?: KodaXJsonValue;
905
+ }
878
906
  interface ListSessionsOptions {
879
907
  /**
880
908
  * Alias for gitRoot; backwards-compat with KodaX Space terminology.
@@ -912,6 +940,7 @@ interface SessionManager {
912
940
  listSessions: typeof listSessions;
913
941
  loadSession: typeof loadSession;
914
942
  loadFullTranscript: typeof loadFullTranscript;
943
+ appendClientNotice: typeof appendClientNotice;
915
944
  forkSession: typeof forkSession;
916
945
  rewindSession: typeof rewindSession;
917
946
  setActiveEntry: typeof setActiveEntry;
@@ -952,6 +981,14 @@ declare function loadSession(id: string): Promise<SessionData | null>;
952
981
  * append order and keeps the active branch in `activeMessages`.
953
982
  */
954
983
  declare function loadFullTranscript(id: string): Promise<FullTranscriptSessionData | null>;
984
+ /**
985
+ * Append a host-owned transcript notice that never enters model context.
986
+ *
987
+ * Use this for local slash-command output such as `/doctor`, `/mcp status`,
988
+ * or host-side status panes. It is visible through `loadFullTranscript()` but
989
+ * `loadSession()` keeps returning only the active model messages.
990
+ */
991
+ declare function appendClientNotice(id: string, options: AppendClientNoticeOptions): Promise<SessionTranscriptEntry | null>;
955
992
  /**
956
993
  * Fork a session at an optional selector.
957
994
  * Returns null for a missing session. NEVER throws.
@@ -1049,5 +1086,5 @@ declare function createSessionManager(opts?: {
1049
1086
  sessionsDir?: string;
1050
1087
  }): SessionManager;
1051
1088
 
1052
- export { DEFAULT_UI_STATE as D, StreamingState as O, TOOL_STATUS_ICONS as T, TextBuffer as U, ToolCallStatus as _, archiveSession as a5, createSessionManager as a6, deleteSession as a7, extractHistorySeedsFromMessage as a8, extractHistorySeedsFromMessages as a9, extractTextContent as aa, extractTitle as ab, forkSession as ac, formatMessagePreview as ad, listRunningSessions as ae, listSessions as af, loadFullTranscript as ag, loadSession as ah, restoreHistoryItemsFromSession as ai, rewindSession as aj, seedToHistoryItem as ak, setActiveEntry as al, toolCallSeedToHistoryToolCall as am, trimPersistedUiHistorySnapshot as an, unarchiveSession as ao, watchSessions as ap, KeypressHandlerPriority as v };
1053
- export type { UIActions as $, AppProps as A, RunningSessionInfo as B, Completer as C, SessionSummary as E, FullTranscriptSessionData as F, SessionTranscriptEntry as G, HistoryEntry as H, InputPromptProps as I, SessionTranscriptEntryType as J, KeyInfo as K, LegacyMessageListProps as L, Message as M, StatusBarProps as N, PastedContent as P, Suggestion as Q, RestoreHistoryItemsFromSessionInput as R, SessionManager as S, TextBufferOptions as V, Theme as W, ThemeColors as X, ThemeSymbols as Y, ToolCall as Z, AppState as a, UIState as a0, UseTextBufferReturn as a1, VisualCursor as a2, VisualLayout as a3, WatchSessionsCallback as a4, Completion as b, CreatableHistoryItem as c, CursorPosition as d, DeleteSessionResult as e, HistoryItem as f, HistoryItemAssistant as g, HistoryItemBase as h, HistoryItemError as i, HistoryItemEvent as j, HistoryItemHint as k, HistoryItemInfo as l, HistoryItemSidecar as m, HistoryItemSystem as n, HistoryItemThinking as o, HistoryItemToolGroup as p, HistoryItemType as q, HistoryItemUser as r, HistorySeedSourceMessage as s, KeypressEvent as t, KeypressHandler as u, ListSessionsOptions as w, PromptEditingMode as x, PromptSubmitPayload as y, RestoredHistorySeed as z };
1089
+ export { ToolCallStatus as $, DEFAULT_UI_STATE as D, StreamingState as Q, TOOL_STATUS_ICONS as U, TextBuffer as V, appendClientNotice as a6, archiveSession as a7, createSessionManager as a8, deleteSession as a9, extractHistorySeedsFromMessage as aa, extractHistorySeedsFromMessages as ab, extractTextContent as ac, extractTitle as ad, forkSession as ae, formatMessagePreview as af, listRunningSessions as ag, listSessions as ah, loadFullTranscript as ai, loadSession as aj, restoreHistoryItemsFromSession as ak, rewindSession as al, seedToHistoryItem as am, setActiveEntry as an, toolCallSeedToHistoryToolCall as ao, trimPersistedUiHistorySnapshot as ap, unarchiveSession as aq, watchSessions as ar, KeypressHandlerPriority as w };
1090
+ export type { AppProps as A, RestoredHistorySeed as B, Completer as C, RunningSessionInfo as E, FullTranscriptSessionData as F, SessionSummary as G, HistoryEntry as H, InputPromptProps as I, SessionTranscriptEntry as J, KeyInfo as K, LegacyMessageListProps as L, Message as M, SessionTranscriptEntryType as N, StatusBarProps as O, PastedContent as P, RestoreHistoryItemsFromSessionInput as R, SessionManager as S, Suggestion as T, TextBufferOptions as W, Theme as X, ThemeColors as Y, ThemeSymbols as Z, ToolCall as _, AppState as a, UIActions as a0, UIState as a1, UseTextBufferReturn as a2, VisualCursor as a3, VisualLayout as a4, WatchSessionsCallback as a5, AppendClientNoticeOptions as b, Completion as c, CreatableHistoryItem as d, CursorPosition as e, DeleteSessionResult as f, HistoryItem as g, HistoryItemAssistant as h, HistoryItemBase as i, HistoryItemError as j, HistoryItemEvent as k, HistoryItemHint as l, HistoryItemInfo as m, HistoryItemSidecar as n, HistoryItemSystem as o, HistoryItemThinking as p, HistoryItemToolGroup as q, HistoryItemType as r, HistoryItemUser as s, HistorySeedSourceMessage as t, KeypressEvent as u, KeypressHandler as v, ListSessionsOptions as x, PromptEditingMode as y, PromptSubmitPayload as z };
@@ -1,5 +1,5 @@
1
- import { a as BashPrefixExtractor } from './bash-prefix-extractor.d-BNdpV4Cf.js';
2
- import { a5 as KodaXSessionData, aa as KodaXSessionLineage, ad as KodaXSessionNavigationOptions, ae as KodaXSessionRuntimeInfo, ag as KodaXSessionStorage } from './process.d-BOrAxjvM.js';
1
+ import { a as BashPrefixExtractor } from './bash-prefix-extractor.d-Ds1THKeH.js';
2
+ import { a6 as KodaXSessionData, ab as KodaXSessionLineage, ae as KodaXSessionNavigationOptions, af as KodaXSessionRuntimeInfo, ah as KodaXSessionStorage } from './process.d-C93UMgPK.js';
3
3
 
4
4
  /**
5
5
  * Permission Types
@@ -113,6 +113,17 @@ interface KodaXCacheBoundary {
113
113
  hint?: 'system' | 'tools' | 'role-prompt';
114
114
  }
115
115
  type KodaXContentBlock = KodaXTextBlock | KodaXToolUseBlock | KodaXToolResultBlock | KodaXImageBlock | KodaXThinkingBlock | KodaXRedactedThinkingBlock | KodaXCacheBoundary;
116
+ type KodaXTaskResultSource = 'workflow' | 'child_task';
117
+ interface KodaXTaskResultMetadata {
118
+ type: 'task_result';
119
+ source: KodaXTaskResultSource;
120
+ taskId: string;
121
+ runId?: string;
122
+ status: 'completed' | 'failed' | 'cancelled';
123
+ title?: string;
124
+ summary?: string;
125
+ artifactRefs?: string[];
126
+ }
116
127
  interface KodaXMessage {
117
128
  role: 'user' | 'assistant' | 'system';
118
129
  content: string | KodaXContentBlock[];
@@ -122,10 +133,33 @@ interface KodaXMessage {
122
133
  * Identifies which subsystem injected a synthetic message so consumers can
123
134
  * render/attribute it distinctly instead of treating it like a user query.
124
135
  * Absent on genuine user/assistant/system messages. Known values include
125
- * `'sidecar-verifier'` (Sidecar Verifier revise feedback). Exposed verbatim
126
- * through `KodaXResult.messages` and session-load APIs for SDK consumers.
136
+ * `'sidecar-verifier'` (Sidecar Verifier revise feedback) and `'task-completed'`
137
+ * (a dispatch_child_task / run_workflow `<task-completed>` result banner spliced
138
+ * into the transcript; a rare same-wake mix with a system-reminder shares this
139
+ * one label, content preserved). Exposed verbatim through `KodaXResult.messages`
140
+ * and session-load APIs for SDK consumers.
127
141
  */
128
142
  _source?: string;
143
+ /** Structured task/workflow result metadata for synthetic task-completed messages. */
144
+ _taskResult?: KodaXTaskResultMetadata;
145
+ /** Multiple task results when one synthetic wake message contains several banners. */
146
+ _taskResults?: KodaXTaskResultMetadata[];
147
+ /**
148
+ * Stable SDK turn id that owns this transcript message. Optional for older
149
+ * sessions and provider-internal synthetic messages.
150
+ */
151
+ turnId?: string;
152
+ /**
153
+ * ISO-8601 timestamp of when this message was finalized (assistant: when the
154
+ * LLM stream completed; user: when submitted/injected). Optional and
155
+ * best-effort: messages persisted before this field existed, or produced by a
156
+ * path not yet updated to stamp it, will not carry it. `createSessionLineage`
157
+ * prefers this value for the session entry's timestamp and falls back to the
158
+ * accounting-time clock when absent, so a whole managed task no longer
159
+ * collapses to a single save-time millisecond. Not authoritative for ordering
160
+ * (array order is) — treat as display metadata (e.g. per-message "N ago").
161
+ */
162
+ timestamp?: string;
129
163
  }
130
164
  interface KodaXTokenUsage {
131
165
  inputTokens: number;
@@ -595,4 +629,4 @@ interface KodaXProviderStreamOptions {
595
629
  signal?: AbortSignal;
596
630
  }
597
631
 
598
- export type { KodaXToolResultBlock 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, KodaXTaskRoutingDecision as R, KodaXTaskType as S, KodaXTaskWorkIntent as T, KodaXTextBlock as U, KodaXThinkingBlock as V, KodaXThinkingBudgetMap as W, KodaXThinkingDepth as X, KodaXThinkingWireStrategy as Y, KodaXTokenUsage as Z, KodaXToolDefinition as _, KodaXCacheBoundary as a, KodaXToolResultContentItem as a0, KodaXToolResultImageItem as a1, KodaXToolResultTextItem as a2, KodaXToolUseBlock as a3, KodaXVerifyCredentialResult as a4, KodaXVerifyStrategy as a5, KodaXWireReasoningEffort as a6, 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 };
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 };