@kodax-ai/kodax 0.7.59 → 0.7.61

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 (62) hide show
  1. package/CHANGELOG.md +58 -0
  2. package/README.md +1234 -1228
  3. package/README_CN.md +653 -647
  4. package/dist/chunks/{agent-QQCRBU4C.js → agent-E74WVAFR.js} +1 -1
  5. package/dist/chunks/argument-completer-BBFYCVTM.js +2 -0
  6. package/dist/chunks/{chunk-TBXP7FEG.js → chunk-2OEKUAV4.js} +1 -1
  7. package/dist/chunks/chunk-4NSOBQCU.js +322 -0
  8. package/dist/chunks/{chunk-YADBB5GN.js → chunk-6OZ5KWG3.js} +1 -1
  9. package/dist/chunks/{chunk-SVEJFERZ.js → chunk-7COB3EKF.js} +176 -161
  10. package/dist/chunks/chunk-CGGX3FXE.js +19 -0
  11. package/dist/chunks/{chunk-UXQILGRX.js → chunk-D7CC6YZC.js} +198 -198
  12. package/dist/chunks/{chunk-2UUOFT3Z.js → chunk-KIVYMSRH.js} +1 -1
  13. package/dist/chunks/chunk-NJW2LQOP.js +722 -0
  14. package/dist/chunks/chunk-PJXKBM3Y.js +310 -0
  15. package/dist/chunks/chunk-QCBKLNN5.js +18 -0
  16. package/dist/chunks/{chunk-5GPJ6MB5.js → chunk-XHOPSZVL.js} +120 -120
  17. package/dist/chunks/{chunk-BEXLPFFB.js → chunk-ZL5CEANW.js} +3 -3
  18. package/dist/chunks/compaction-config-GESEZQVA.js +2 -0
  19. package/dist/chunks/{construction-bootstrap-YON4ZEMO.js → construction-bootstrap-OSXHEIBB.js} +1 -1
  20. package/dist/chunks/{dist-EZXBR6NW.js → dist-W3OOJP66.js} +1 -1
  21. package/dist/chunks/host-FRQXOEHH.js +2 -0
  22. package/dist/chunks/{paste-4THGP5XW.js → paste-FDYM7SZX.js} +1 -1
  23. package/dist/chunks/run-manager-FGCG7DFF.js +2 -0
  24. package/dist/chunks/{utils-5XVW33SY.js → utils-47QI5MSP.js} +1 -1
  25. package/dist/index.d.ts +11 -11
  26. package/dist/index.js +1 -1
  27. package/dist/kodax_cli.js +1028 -972
  28. package/dist/sdk-agent.d.ts +24 -13
  29. package/dist/sdk-agent.js +1 -1
  30. package/dist/sdk-coding.d.ts +17 -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-e1LD2IRl.d.ts} +70 -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-DHPlNYkK.d.ts} +20 -6
  48. package/dist/types-chunks/{sdk-session-ByZlwgdM.d.ts → sdk-session-DINrM1pF.d.ts} +47 -10
  49. package/dist/types-chunks/{storage.d-DHL3XpAL.d.ts → storage.d-xiw7Vgx0.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-Dy19-1XR.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-PRIBJN5E.js +0 -683
  57. package/dist/chunks/chunk-SDSLWDAZ.js +0 -17
  58. package/dist/chunks/chunk-Z23LK3IV.js +0 -310
  59. package/dist/chunks/chunk-Z3ZXV3DZ.js +0 -18
  60. package/dist/chunks/compaction-config-GQIPCVFD.js +0 -2
  61. package/dist/chunks/host-LO6ZNTMV.js +0 -2
  62. 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-DINrM1pF.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-xiw7Vgx0.js';
5
+ import './types-chunks/bash-prefix-extractor.d-e1LD2IRl.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-PJXKBM3Y.js";import{K as s,L as e}from"./chunks/chunk-D7CC6YZC.js";import"./chunks/chunk-KIVYMSRH.js";import"./chunks/chunk-6OZ5KWG3.js";import"./chunks/chunk-2OEKUAV4.js";import"./chunks/chunk-XHOPSZVL.js";import"./chunks/chunk-CGGX3FXE.js";import"./chunks/chunk-QCBKLNN5.js";import"./chunks/chunk-4NSOBQCU.js";import"./chunks/chunk-D6QVXQNI.js";import"./chunks/chunk-UA744TZM.js";import"./chunks/chunk-7COB3EKF.js";import"./chunks/chunk-S4GVQO3W.js";import"./chunks/chunk-NJW2LQOP.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-NJW2LQOP.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. */
@@ -3154,6 +3190,11 @@ interface WorkflowToolHostResult {
3154
3190
  * the result unaware that some verification failed. Empty/omitted = all
3155
3191
  * completed children verified (or none were verified). */
3156
3192
  readonly verificationWarnings?: readonly string[];
3193
+ /** Diagnostic workflow-quality warnings found before the run started.
3194
+ * These are non-blocking and are not rendered into model-visible
3195
+ * `run_workflow` text by default; uncertain quality heuristics must not
3196
+ * pressure the Worker into rewriting otherwise-valid workflows. */
3197
+ readonly workflowQualityWarnings?: readonly string[];
3157
3198
  }
3158
3199
  /**
3159
3200
  * Narrow ctx capability for launching workflows from a tool. Intentionally free
@@ -3206,6 +3247,8 @@ type WorkflowToolHostStartResult = {
3206
3247
  readonly kind: 'started';
3207
3248
  readonly runId: string;
3208
3249
  readonly done: Promise<WorkflowToolHostResult>;
3250
+ /** Non-blocking diagnostic preflight warnings available immediately at start. */
3251
+ readonly workflowQualityWarnings?: readonly string[];
3209
3252
  /** Gap A: on-demand live progress for a `task_output(runId)` peek while the
3210
3253
  * run is in flight. Absent when the host cannot snapshot the run. */
3211
3254
  readonly getProgress?: () => WorkflowRunProgressView | undefined;
@@ -3370,5 +3413,5 @@ interface CreateBashPrefixExtractorOptions {
3370
3413
  */
3371
3414
  declare function createBashPrefixExtractor(opts: CreateBashPrefixExtractorOptions): BashPrefixExtractor;
3372
3415
 
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 };
3416
+ 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 };
3417
+ 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
  *
@@ -745,6 +745,20 @@ interface WorkflowScriptManifest extends WorkflowMeta {
745
745
  }
746
746
  declare function validateWorkflowScriptManifest(value: unknown): WorkflowScriptManifest;
747
747
 
748
+ type WorkflowQualityLintSeverity = 'error' | 'warning';
749
+ interface WorkflowQualityLintFinding {
750
+ readonly code: string;
751
+ readonly severity: WorkflowQualityLintSeverity;
752
+ readonly message: string;
753
+ }
754
+ interface WorkflowQualityLintOptions {
755
+ readonly manifest?: WorkflowScriptManifest;
756
+ readonly filename?: string;
757
+ readonly hostMaxAgents?: number;
758
+ }
759
+ declare function lintRestrictedWorkflowSource(source: string, options?: WorkflowQualityLintOptions): readonly WorkflowQualityLintFinding[];
760
+ declare function assertRestrictedWorkflowQuality(source: string, options?: WorkflowQualityLintOptions): void;
761
+
748
762
  /**
749
763
  * FEATURE_217 (v0.7.49) Phase M — reusable generated workflow capsule.
750
764
  *
@@ -915,5 +929,5 @@ declare function createWorkflowRunManager(deps?: {
915
929
  }): WorkflowRunManager;
916
930
  declare function getDefaultWorkflowRunManager(): WorkflowRunManager;
917
931
 
918
- export { buildWorkflowCapsuleIntent as $, WORKFLOW_CAPSULE_FORMAT as A, WORKFLOW_CAPSULE_VERSION as B, DefaultSummaryCompaction as D, WORKFLOW_PATTERN_IDS as E, KODAX_API_MIN_INTERVAL as K, LINEAGE_ENTRY_TYPES as L, PROMISE_PATTERN as P, appendSessionLineageLabel as U, applyLineageTruncation as V, WORKFLOW_CAPSULE_API_VERSION as W, applySessionCompaction as X, archiveOldIslands as Y, buildSessionTree as Z, _resetMessageQueueForTests as _, cleanupIncompleteToolCalls as a0, countActiveLineageMessages as a1, countTokens as a2, createSessionLineage as a3, createWorkflowCapsule as a4, createWorkflowModuleFromCapsule as a5, createWorkflowRunManager as a6, estimateTokens as a7, extractArtifactLedger as a8, extractFileOps as a9, extractTitleFromMessages as aa, findPreviousUserEntryId as ab, forkSessionLineage as ac, generateSessionId as ad, getAgentConfigHome as ae, getAgentConfigPath as af, getAppDataDir as ag, getDefaultWorkflowRunManager as ah, getMessageQueue as ai, getSessionLineagePath as aj, getSessionMessagesFromLineage as ak, mergeArtifactLedger as al, mergeFileOps as am, resolveSessionLineageTarget as an, rewindSessionLineage as ao, setAgentConfigHome as ap, setSessionLineageActiveEntry as aq, validateAndFixToolHistory as ar, validateWorkflowCapsule as as, validateWorkflowScriptManifest as at, KODAX_DEFAULT_TIMEOUT as f, KODAX_HARD_TIMEOUT as g, KODAX_MAX_INCOMPLETE_RETRIES as h, KODAX_MAX_MAXTOKENS_RETRIES as i, KODAX_MAX_RETRIES as j, KODAX_MAX_TOKENS as k, KODAX_RETRY_BASE_DELAY as l, KODAX_STAGGER_DELAY as m, LineageCompaction as o, LineageExtension as r, MessageQueue as y };
919
- export type { CompactionContext as C, WorkflowCapsule as F, WorkflowCapsuleEnvironmentRequirement as G, WorkflowCapsuleInputs as H, WorkflowCapsuleIntent as I, WorkflowCapsuleProvenance as J, ManagedRunClassification as M, WorkflowCapsuleRequirements as N, WorkflowPatternId as O, WorkflowProcessMetadata as Q, WorkflowRunManager as R, StartManagedRunInput as S, WorkflowScriptManifest as T, CompactionEntry as a, CompactionEntryPayload as b, CompactionPolicy as c, CreateWorkflowCapsuleInput as d, DefaultSummaryCompactionOptions as e, LineageArtifactLedgerPayload as n, LineageCompactionDelegates as p, LineageEntryType as q, LineageLabelPayload as s, LineageTreeNode as t, ManagedRunHooks as u, ManagedWorkflowRun as v, ManagedWorkflowSnapshot as w, ManagedWorkflowStatus as x, PolicyCompactionResult as z };
932
+ export { applySessionCompaction as $, WORKFLOW_CAPSULE_FORMAT as A, WORKFLOW_CAPSULE_VERSION as B, DefaultSummaryCompaction as D, WORKFLOW_PATTERN_IDS as E, KODAX_API_MIN_INTERVAL as K, LINEAGE_ENTRY_TYPES as L, PROMISE_PATTERN as P, WORKFLOW_CAPSULE_API_VERSION as W, appendSessionLineageLabel as Y, applyLineageTruncation as Z, _resetMessageQueueForTests as _, archiveOldIslands as a0, assertRestrictedWorkflowQuality as a1, buildSessionTree as a2, buildWorkflowCapsuleIntent as a3, cleanupIncompleteToolCalls as a4, countActiveLineageMessages as a5, countTokens as a6, createSessionLineage as a7, createWorkflowCapsule as a8, createWorkflowModuleFromCapsule as a9, createWorkflowRunManager as aa, estimateTokens as ab, extractArtifactLedger as ac, extractFileOps as ad, extractTitleFromMessages as ae, findPreviousUserEntryId as af, forkSessionLineage as ag, generateSessionId as ah, getAgentConfigHome as ai, getAgentConfigPath as aj, getAppDataDir as ak, getDefaultWorkflowRunManager as al, getMessageQueue as am, getSessionLineagePath as an, getSessionMessagesFromLineage as ao, lintRestrictedWorkflowSource as ap, mergeArtifactLedger as aq, mergeFileOps as ar, resolveSessionLineageTarget as as, rewindSessionLineage as at, setAgentConfigHome as au, setSessionLineageActiveEntry as av, validateAndFixToolHistory as aw, validateWorkflowCapsule as ax, validateWorkflowScriptManifest as ay, KODAX_DEFAULT_TIMEOUT as f, KODAX_HARD_TIMEOUT as g, KODAX_MAX_INCOMPLETE_RETRIES as h, KODAX_MAX_MAXTOKENS_RETRIES as i, KODAX_MAX_RETRIES as j, KODAX_MAX_TOKENS as k, KODAX_RETRY_BASE_DELAY as l, KODAX_STAGGER_DELAY as m, LineageCompaction as o, LineageExtension as r, MessageQueue as y };
933
+ export type { CompactionContext as C, WorkflowCapsule as F, WorkflowCapsuleEnvironmentRequirement as G, WorkflowCapsuleInputs as H, WorkflowCapsuleIntent as I, WorkflowCapsuleProvenance as J, ManagedRunClassification as M, WorkflowCapsuleRequirements as N, WorkflowPatternId as O, WorkflowProcessMetadata as Q, WorkflowQualityLintFinding as R, StartManagedRunInput as S, WorkflowQualityLintOptions as T, WorkflowQualityLintSeverity as U, WorkflowRunManager as V, WorkflowScriptManifest as X, CompactionEntry as a, CompactionEntryPayload as b, CompactionPolicy as c, CreateWorkflowCapsuleInput as d, DefaultSummaryCompactionOptions as e, LineageArtifactLedgerPayload as n, LineageCompactionDelegates as p, LineageEntryType as q, LineageLabelPayload as s, LineageTreeNode as t, ManagedRunHooks as u, ManagedWorkflowRun as v, ManagedWorkflowSnapshot as w, ManagedWorkflowStatus as x, PolicyCompactionResult as z };
@@ -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-xiw7Vgx0.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-e1LD2IRl.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-e1LD2IRl.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