@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
@@ -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 };
@@ -1,4 +1,5 @@
1
- import { z as Guardrail, aO as RunnerToolCall, e as Agent, g as AgentMessage, aR as RunnerToolResult, a_ as Span, _ as KodaXInputArtifact } from './process.d-BOrAxjvM.js';
1
+ import { z as Guardrail, aP as RunnerToolCall, e as Agent, g as AgentMessage, aS as RunnerToolResult, a$ as Span, _ as KodaXInputArtifact } from './process.d-C93UMgPK.js';
2
+ import { R as KodaXTaskResultMetadata } from './types.d-Bp4Lm1jv.js';
2
3
 
3
4
  /**
4
5
  * Guardrail Runtime — FEATURE_085 (v0.7.26).
@@ -185,6 +186,7 @@ interface QueuedMessage {
185
186
  readonly mode: MessageMode;
186
187
  readonly content: string;
187
188
  readonly inputArtifacts?: readonly QueuedInputArtifact[];
189
+ readonly taskResult?: KodaXTaskResultMetadata;
188
190
  /** Wall-clock timestamp (`Date.now()`) for tracing only — not used for ordering. */
189
191
  readonly enqueuedAt: number;
190
192
  }
@@ -271,6 +273,7 @@ interface EnqueueInput {
271
273
  readonly content: string;
272
274
  readonly agentId?: string;
273
275
  readonly inputArtifacts?: readonly QueuedInputArtifact[];
276
+ readonly taskResult?: KodaXTaskResultMetadata;
274
277
  }
275
278
 
276
279
  export { GuardrailBlockedError as G, GuardrailEscalateError as b, collectGuardrails as h, runOutputGuardrails as i, runToolAfterGuardrails as j, runToolBeforeGuardrails as k, runInputGuardrails as r };
@@ -1,8 +1,8 @@
1
- import { P as KodaXOptions, v as KodaXContextTokenSnapshot, a5 as KodaXSkillDynamicContextPolicy, m as KodaXAgentMode, U as KodaXRepoIntelligenceMode, a6 as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-BNdpV4Cf.js';
2
- import { c as SessionStorage$1, b as PermissionMode } from './storage.d-DHL3XpAL.js';
3
- import { ai as KodaXSessionUiHistoryItem, aa as KodaXSessionLineage, a2 as KodaXSessionArtifactLedgerEntry, R as KodaXExtensionSessionState, Q as KodaXExtensionSessionRecord, ae as KodaXSessionRuntimeInfo, ag as KodaXSessionStorage, a5 as KodaXSessionData, bM as WorkflowProcessSource } from './process.d-BOrAxjvM.js';
4
- import { j as KodaXMessage, E as KodaXReasoningMode, o as KodaXProviderCapabilityProfile, d as KodaXCustomProviderConfig } from './types.d-Ci5YPFEh.js';
5
- import { A as AgentsFile, f as AutoModeStats, l as KodaXMcpServersConfig } from './guardrail.d-CNdKuSD_.js';
1
+ import { Q as KodaXOptions, v as KodaXContextTokenSnapshot, a6 as KodaXSkillDynamicContextPolicy, m as KodaXAgentMode, V as KodaXRepoIntelligenceMode, a7 as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-e1LD2IRl.js';
2
+ import { c as SessionStorage$1, b as PermissionMode } from './storage.d-xiw7Vgx0.js';
3
+ import { aj as KodaXSessionUiHistoryItem, ab as KodaXSessionLineage, a2 as KodaXSessionArtifactLedgerEntry, R as KodaXExtensionSessionState, Q as KodaXExtensionSessionRecord, af as KodaXSessionRuntimeInfo, ah as KodaXSessionStorage, a6 as KodaXSessionData, bN as WorkflowProcessSource } from './process.d-C93UMgPK.js';
4
+ import { j as KodaXMessage, E as KodaXReasoningMode, o as KodaXProviderCapabilityProfile, d as KodaXCustomProviderConfig } from './types.d-Bp4Lm1jv.js';
5
+ import { A as AgentsFile, f as AutoModeStats, l as KodaXMcpServersConfig } from './guardrail.d-CdqJwwN7.js';
6
6
  import * as readline from 'readline';
7
7
  import { SpawnSyncReturns } from 'child_process';
8
8
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kodax-ai/kodax",
3
- "version": "0.7.59",
3
+ "version": "0.7.61",
4
4
  "description": "KodaX lightweight coding agent - TypeScript implementation with 15 built-in LLM provider aliases, published as a Node-free single-file CLI and SDK",
5
5
  "type": "module",
6
6
  "private": false,
@@ -1,2 +0,0 @@
1
- // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
2
- import{Aa as b,za as a}from"./chunk-UXQILGRX.js";import"./chunk-2UUOFT3Z.js";import"./chunk-TBXP7FEG.js";import"./chunk-5GPJ6MB5.js";import"./chunk-SDSLWDAZ.js";import"./chunk-Z3ZXV3DZ.js";import"./chunk-D7RENPQQ.js";import"./chunk-D6QVXQNI.js";import"./chunk-UA744TZM.js";import"./chunk-SVEJFERZ.js";import"./chunk-S4GVQO3W.js";import"./chunk-PRIBJN5E.js";import"./chunk-BEXLPFFB.js";import"./chunk-V4WSBIXB.js";export{a as ArgumentCompleter,b as createArgumentCompleter};