@kodax-ai/kodax 0.7.93 → 0.7.95

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 (103) hide show
  1. package/CHANGELOG.md +162 -0
  2. package/README.md +88 -18
  3. package/README_CN.md +51 -0
  4. package/dist/builtin/skill-creator/SKILL.md +5 -0
  5. package/dist/builtin/skill-creator/scripts/init-skill.js +5 -4
  6. package/dist/chunks/agent-XXZMXKKA.js +2 -0
  7. package/dist/chunks/argument-completer-KCYDGTQW.js +2 -0
  8. package/dist/chunks/{chunk-YVG6OKN7.js → chunk-2PEDBGKN.js} +1 -1
  9. package/dist/chunks/{chunk-XTWIGVUL.js → chunk-2TM3W3GK.js} +10 -10
  10. package/dist/chunks/{chunk-3YOZIFSJ.js → chunk-6ABQJUK6.js} +252 -251
  11. package/dist/chunks/chunk-77PNP27P.js +92 -0
  12. package/dist/chunks/{chunk-JTZKC4TV.js → chunk-7JXA3533.js} +232 -233
  13. package/dist/chunks/{chunk-7XSZVOG7.js → chunk-BNVSKIAB.js} +340 -142
  14. package/dist/chunks/chunk-BR2OSB2I.js +722 -0
  15. package/dist/chunks/{chunk-HLZWPB32.js → chunk-C4DTUKTR.js} +2 -2
  16. package/dist/chunks/{chunk-4BY53JTF.js → chunk-DSMONSVB.js} +121 -122
  17. package/dist/chunks/{chunk-PRASABCC.js → chunk-JS452J2F.js} +2 -2
  18. package/dist/chunks/chunk-O743AJ5V.js +323 -0
  19. package/dist/chunks/{chunk-GRWUC6H7.js → chunk-OK4AXDC5.js} +1 -1
  20. package/dist/chunks/chunk-Q5VRWSKG.js +418 -0
  21. package/dist/chunks/{chunk-GH3KBC2H.js → chunk-SRIJX5ZP.js} +1 -1
  22. package/dist/chunks/chunk-XWRPOGJN.js +4 -0
  23. package/dist/chunks/chunk-Y5VIQBT6.js +383 -0
  24. package/dist/chunks/{client-OVYKC3ND.js → client-JDOS3YJR.js} +1 -1
  25. package/dist/chunks/compaction-config-EGS4577X.js +2 -0
  26. package/dist/chunks/{construction-bootstrap-474QPSYB.js → construction-bootstrap-YCWHHUYO.js} +1 -1
  27. package/dist/chunks/dist-KFYN3OKD.js +2 -0
  28. package/dist/chunks/host-VAYADIPW.js +2 -0
  29. package/dist/chunks/run-manager-52IJZMZJ.js +2 -0
  30. package/dist/chunks/utils-P7PBSL3R.js +2 -0
  31. package/dist/index.d.ts +26 -26
  32. package/dist/index.js +2 -2
  33. package/dist/kodax_bootstrap.js +1 -1
  34. package/dist/kodax_cli.js +1869 -1461
  35. package/dist/kodax_resume.js +35 -35
  36. package/dist/runtime-worker.js +1819 -1411
  37. package/dist/sandbox-workspace-session.js +481 -638
  38. package/dist/sdk-a2a.d.ts +18 -18
  39. package/dist/sdk-a2a.js +1 -1
  40. package/dist/sdk-agent.d.ts +47 -26
  41. package/dist/sdk-agent.js +1 -1
  42. package/dist/sdk-coding.d.ts +54 -39
  43. package/dist/sdk-coding.js +1 -1
  44. package/dist/sdk-experimental-memory.d.ts +6 -6
  45. package/dist/sdk-experimental-memory.js +1 -1
  46. package/dist/sdk-llm.d.ts +8 -8
  47. package/dist/sdk-mcp.d.ts +4 -4
  48. package/dist/sdk-mcp.js +1 -1
  49. package/dist/sdk-media.d.ts +1 -1
  50. package/dist/sdk-media.js +1 -1
  51. package/dist/sdk-repl.d.ts +43 -25
  52. package/dist/sdk-repl.js +2 -2
  53. package/dist/sdk-runtime.d.ts +57 -32
  54. package/dist/sdk-runtime.js +1 -1
  55. package/dist/sdk-sandbox.d.ts +10 -1
  56. package/dist/sdk-sandbox.js +1 -1
  57. package/dist/sdk-session.d.ts +10 -10
  58. package/dist/sdk-session.js +1 -1
  59. package/dist/sdk-skills.d.ts +2 -333
  60. package/dist/sdk-skills.js +1 -1
  61. package/dist/semantic-worker.js +279 -81
  62. package/dist/types-chunks/{base.d-JjF6aKsh.d.ts → base.d-vopO1rml.d.ts} +1 -1
  63. package/dist/types-chunks/{bash-prefix-extractor.d-BMi_TJIY.d.ts → bash-prefix-extractor.d-B2rxNI4L.d.ts} +70 -9
  64. package/dist/types-chunks/{capability-learning.d-BAxy0mfx.d.ts → capability-learning.d-CE1tm29C.d.ts} +1 -1
  65. package/dist/types-chunks/{capsule.d-nYbM4MNL.d.ts → capsule.d-Y7QRS4J2.d.ts} +5 -5
  66. package/dist/types-chunks/{config.d-CTPaqsD-.d.ts → config.d-CJy1WENT.d.ts} +1 -1
  67. package/dist/types-chunks/{controller.d-CTvvOy_V.d.ts → controller.d-BR-UVeUR.d.ts} +1 -1
  68. package/dist/types-chunks/{controller.d-Bm1i9RVj.d.ts → controller.d-C5noq5-w.d.ts} +4 -4
  69. package/dist/types-chunks/{cost-tracker.d-MTAt6N7b.d.ts → cost-tracker.d-BeaenODW.d.ts} +1 -1
  70. package/dist/types-chunks/{guardrail.d-CKkoea7y.d.ts → guardrail.d-DqHD-61O.d.ts} +9 -9
  71. package/dist/types-chunks/{history-retrieval.d-D0LNyBED.d.ts → history-retrieval.d-CKU8zmt_.d.ts} +2 -2
  72. package/dist/types-chunks/{integration-config.d-BHoiz-WZ.d.ts → integration-config.d-BNowXE8k.d.ts} +3 -3
  73. package/dist/types-chunks/{manager.d-D_1fqveb.d.ts → manager.d-B67TmPO1.d.ts} +3 -3
  74. package/dist/types-chunks/{oauth-login.d-Cz9OpSmz.d.ts → oauth-login.d-6i-vidxv.d.ts} +3 -3
  75. package/dist/types-chunks/{public-api.d-BsZWOq3P.d.ts → public-api.d-D7fXaWW8.d.ts} +7 -6
  76. package/dist/types-chunks/{repl.d-DxD0Olm0.d.ts → repl.d-BYDb14s6.d.ts} +8 -8
  77. package/dist/types-chunks/{resolver.d-DparsV6Y.d.ts → resolver.d-CwHUwbdE.d.ts} +4 -4
  78. package/dist/types-chunks/{review-inbox.d-dAtGH3g2.d.ts → review-inbox.d-BSgFewyj.d.ts} +3 -3
  79. package/dist/types-chunks/{run-manager.d-BeSEc2OL.d.ts → run-manager.d-BVJSntpS.d.ts} +2 -2
  80. package/dist/types-chunks/{sdk-session-BTzblJTQ.d.ts → sdk-session-CqEG84oP.d.ts} +3 -3
  81. package/dist/types-chunks/sdk-skills-DokfOoJF.d.ts +335 -0
  82. package/dist/types-chunks/{shell-command-sets.d-C2cc9Hwi.d.ts → shell-command-sets.d-DqaaBwhU.d.ts} +1 -1
  83. package/dist/types-chunks/{side-query.d-DNes6rHA.d.ts → side-query.d-iH0P9ASy.d.ts} +3 -3
  84. package/dist/types-chunks/{types-D8OiIEwA.d.ts → types-PHjfwebT.d.ts} +1 -1
  85. package/dist/types-chunks/{types.d-DrtP1ceI.d.ts → types.d-C5xQEFcj.d.ts} +6 -6
  86. package/dist/types-chunks/{types.d-Cv09EdJR.d.ts → types.d-CK9A9rpP.d.ts} +1 -1
  87. package/dist/types-chunks/{types.d-Dc3kwcjC.d.ts → types.d-CaTXAW_Q.d.ts} +14 -3
  88. package/dist/types-chunks/{types.d-BEMcUOng.d.ts → types.d-Cb8RdrjU.d.ts} +5 -4
  89. package/dist/types-chunks/{types.d-EjZTEEVu.d.ts → types.d-rUOjXych.d.ts} +6 -2
  90. package/dist/types-chunks/{utils.d-50Q24Few.d.ts → utils.d-CWUyLiXo.d.ts} +8 -8
  91. package/package.json +2 -2
  92. package/dist/chunks/agent-R7HVNARP.js +0 -2
  93. package/dist/chunks/argument-completer-JHXUJWHC.js +0 -2
  94. package/dist/chunks/chunk-A3ZQE2BX.js +0 -519
  95. package/dist/chunks/chunk-D27EY4XC.js +0 -383
  96. package/dist/chunks/chunk-JJ2YDBSN.js +0 -415
  97. package/dist/chunks/chunk-QFV6YCIH.js +0 -92
  98. package/dist/chunks/chunk-SMVC3Q3U.js +0 -320
  99. package/dist/chunks/compaction-config-2TVSYSB4.js +0 -2
  100. package/dist/chunks/dist-H4PT2QAV.js +0 -2
  101. package/dist/chunks/host-OR3IO2A4.js +0 -2
  102. package/dist/chunks/run-manager-MNOTWIFX.js +0 -2
  103. package/dist/chunks/utils-5J4BHNBV.js +0 -2
@@ -1,4 +1,4 @@
1
- import { W as WorkflowProcessTrackerOptions, a as WorkflowEvent, b as WorkflowProcessSnapshot, c as WorkflowProcessEvent } from './controller.d-Bm1i9RVj.js';
1
+ import { dk as WorkflowProcessTrackerOptions, cS as WorkflowEvent, de as WorkflowProcessSnapshot, d8 as WorkflowProcessEvent } from './controller.d-C5noq5-w.js';
2
2
 
3
3
  /**
4
4
  * FEATURE_246 Part A0 (ADR-046) — neutral workflow run lifecycle manager.
@@ -88,4 +88,4 @@ declare function createWorkflowRunManager(deps?: {
88
88
  declare function getDefaultWorkflowRunManager(): WorkflowRunManager;
89
89
 
90
90
  export { createWorkflowRunManager as f, getDefaultWorkflowRunManager as g };
91
- export type { ManagedWorkflowStatus as M, StartManagedRunInput as S, WorkflowProcessMetadata as W, ManagedWorkflowSnapshot as a, ManagedRunClassification as b, ManagedRunHooks as c, ManagedWorkflowRun as d, WorkflowRunManager as e };
91
+ export type { ManagedRunClassification as M, StartManagedRunInput as S, WorkflowProcessMetadata as W, ManagedRunHooks as a, ManagedWorkflowRun as b, ManagedWorkflowSnapshot as c, ManagedWorkflowStatus as d, WorkflowRunManager as e };
@@ -1,6 +1,6 @@
1
- import { j as CreatableHistoryItem, T as ToolCall } from './public-api.d-BsZWOq3P.js';
2
- import { b as KodaXMessage, q as KodaXContentBlock } from './types.d-Cv09EdJR.js';
3
- import { S as KodaXSessionUiHistoryItem, W as KodaXSessionUiToolCall } from './types.d-EjZTEEVu.js';
1
+ import { h as CreatableHistoryItem, ar as ToolCall } from './public-api.d-D7fXaWW8.js';
2
+ import { k as KodaXMessage, c as KodaXContentBlock } from './types.d-CK9A9rpP.js';
3
+ import { aq as KodaXSessionUiHistoryItem, au as KodaXSessionUiToolCall } from './types.d-rUOjXych.js';
4
4
 
5
5
  interface RestoreHistoryItemsFromSessionInput {
6
6
  messages: readonly KodaXMessage[];
@@ -0,0 +1,335 @@
1
+ import { R as ResolvedSkillSource, S as Skill, e as SkillFile, i as SkillMetadata, f as SkillFrontmatter, j as SkillPathsConfig, a as IVariableResolver, c as SkillContext, I as ISkillRegistry, k as SkillResult } from './types.d-Cb8RdrjU.js';
2
+
3
+ declare function registerPluginSkillPath(skillPath: string): () => void;
4
+ declare function unregisterPluginSkillPath(skillPath: string): boolean;
5
+ declare function listPluginSkillPaths(): string[];
6
+ declare function clearPluginSkillPaths(): void;
7
+
8
+ /**
9
+ * Skill Loader - YAML Frontmatter Parsing and Skill Loading
10
+ *
11
+ * Parses SKILL.md files with YAML frontmatter and loads skill content.
12
+ * Implements fallback sanitization for non-standard YAML formats.
13
+ */
14
+
15
+ /**
16
+ * Parse SKILL.md file with YAML frontmatter
17
+ */
18
+ declare function parseSkillMarkdown(content: string): {
19
+ frontmatter: SkillFrontmatter;
20
+ body: string;
21
+ };
22
+ /**
23
+ * Load skill metadata from SKILL.md file
24
+ */
25
+ declare function loadSkillMetadata(skillDir: string, source: ResolvedSkillSource): Promise<SkillMetadata | null>;
26
+ /**
27
+ * Load full skill content
28
+ */
29
+ declare function loadFullSkill(skillDir: string, source: ResolvedSkillSource): Promise<Skill | null>;
30
+ /**
31
+ * Load a specific support file's content
32
+ */
33
+ declare function loadSkillFileContent(file: SkillFile): Promise<string>;
34
+
35
+ /**
36
+ * Skill Discovery - Multi-path skill scanning
37
+ *
38
+ * Discovers skills from multiple paths with priority handling.
39
+ * Supports nested directory discovery for monorepos.
40
+ */
41
+
42
+ /**
43
+ * Result of skill discovery
44
+ */
45
+ interface DiscoveryResult {
46
+ skills: Map<string, SkillMetadata>;
47
+ errors: Array<{
48
+ path: string;
49
+ error: string;
50
+ }>;
51
+ }
52
+ /**
53
+ * Discover all skills from configured paths
54
+ */
55
+ declare function discoverSkills(projectRoot?: string, customPaths?: Partial<SkillPathsConfig>): Promise<DiscoveryResult>;
56
+ /**
57
+ * Get nested skill paths for monorepo support
58
+ * When in a subdirectory, also check parent directories for skills
59
+ */
60
+ declare function getNestedSkillPaths(currentDir: string, projectRoot: string): string[];
61
+ /**
62
+ * Discover skills with monorepo support
63
+ */
64
+ declare function discoverSkillsWithMonorepo(currentDir: string, projectRoot: string): Promise<DiscoveryResult>;
65
+
66
+ /**
67
+ * Skill Resolver - Variable Replacement System
68
+ *
69
+ * Handles variable replacement in skill content:
70
+ * - $ARGUMENTS - All arguments
71
+ * - $0, $1, $2... - Positional arguments
72
+ * - ${VAR_NAME} - Environment variables
73
+ * - !`command` - Dynamic context injection
74
+ */
75
+
76
+ /**
77
+ * Split arguments string into positional arguments
78
+ * Handles quoted strings correctly
79
+ */
80
+ declare function parseArguments(args: string): string[];
81
+ /**
82
+ * Variable resolver implementation
83
+ */
84
+ declare class VariableResolver implements IVariableResolver {
85
+ private context;
86
+ constructor(context: SkillContext);
87
+ /**
88
+ * Resolve all variables in content
89
+ */
90
+ resolve(content: string, args: string): Promise<string>;
91
+ /**
92
+ * Replace $0, $1, $2... with positional arguments
93
+ */
94
+ private resolvePositionalArgs;
95
+ /**
96
+ * Replace $ARGUMENTS with all arguments
97
+ */
98
+ private resolveArguments;
99
+ /**
100
+ * Replace ${VAR_NAME} with environment variables
101
+ */
102
+ private resolveEnvVars;
103
+ /**
104
+ * Replace !`command` with command output (dynamic context).
105
+ *
106
+ * Three-tier dispatch (v0.7.42):
107
+ * 1. `context.disableDynamicContext === true` → throw immediately,
108
+ * surfaced to the LLM as `[Error: …]`. Host-level kill switch.
109
+ * 2. `context.executeDynamicContext` provided → route there. Embedder
110
+ * mediates shell execution (broker, audit, deny).
111
+ * 3. else → legacy built-in path (`isSafeDynamicContextCommand`
112
+ * whitelist + `execSync` with 5s timeout).
113
+ *
114
+ * The resolver inlines an `[Error: …]` placeholder for any thrown
115
+ * exception so a single bad token doesn't poison the whole skill load.
116
+ */
117
+ private resolveDynamicContext;
118
+ /**
119
+ * Execute a dynamic context command via the appropriate dispatch tier.
120
+ * See `resolveDynamicContext` JSDoc for the 3-tier ordering rationale.
121
+ */
122
+ private executeDynamicCommand;
123
+ }
124
+ /**
125
+ * Create a variable resolver for a given context
126
+ */
127
+ declare function createResolver(context: SkillContext): IVariableResolver;
128
+ /**
129
+ * Resolve skill content with arguments and context
130
+ */
131
+ declare function resolveSkillContent(content: string, args: string, context: SkillContext): Promise<string>;
132
+
133
+ /**
134
+ * Skill Registry - Progressive Disclosure and Skill Management
135
+ *
136
+ * Manages skill discovery, loading, and invocation with progressive disclosure:
137
+ * - Level 1: Metadata preloaded at startup (name, description)
138
+ * - Level 2: Full content loaded on invoke
139
+ * - Level 3: Support files loaded on demand
140
+ */
141
+
142
+ /** Format the model-visible Skill catalog from an arbitrary trusted registry. */
143
+ declare function formatSkillsSystemPrompt(skills: readonly SkillMetadata[]): string;
144
+ /**
145
+ * Skill Registry implementation
146
+ */
147
+ declare class SkillRegistry implements ISkillRegistry {
148
+ private readonly skillsByName;
149
+ private readonly fullSkillsByName;
150
+ private readonly projectRoot?;
151
+ private readonly customPaths?;
152
+ constructor(projectRoot?: string, customPaths?: Partial<SkillPathsConfig>);
153
+ /**
154
+ * Discover skills from all configured paths
155
+ */
156
+ discover(): Promise<void>;
157
+ /**
158
+ * Get skill metadata by name
159
+ */
160
+ get skills(): ReadonlyMap<string, SkillMetadata>;
161
+ /**
162
+ * Get skill metadata by name
163
+ */
164
+ get(name: string): SkillMetadata | undefined;
165
+ /**
166
+ * Load full skill content
167
+ */
168
+ loadFull(name: string): Promise<Skill>;
169
+ /**
170
+ * Explicitly invoke a skill with arguments. Model tool admission is enforced
171
+ * by the coding-layer `skill` tool before it reaches this SDK primitive.
172
+ */
173
+ invoke(name: string, args: string, context: SkillContext): Promise<SkillResult>;
174
+ /**
175
+ * Reload skills from disk
176
+ */
177
+ reload(): Promise<void>;
178
+ /**
179
+ * List all available skills
180
+ */
181
+ list(): SkillMetadata[];
182
+ /**
183
+ * List user-invocable skills (for / menu)
184
+ */
185
+ listUserInvocable(): SkillMetadata[];
186
+ /**
187
+ * Get skills formatted for system prompt injection.
188
+ *
189
+ * FEATURE_143 (v0.7.36): manifest wording hardened toward Claude
190
+ * Code-style strong constraints. The previous wording ("when a user
191
+ * request matches a skill description, use read to load the skill")
192
+ * was too soft — the LLM treated skill invocation as one option among
193
+ * many and frequently authored its own answer instead of loading the
194
+ * SKILL.md instructions. Aligns with the
195
+ * `c:/Works/claudecode/src/tools/SkillTool/prompt.ts` ruleset:
196
+ * BLOCKING REQUIREMENT to load the relevant skill BEFORE generating
197
+ * any other response when a skill matches.
198
+ *
199
+ * Filters out skills with disableModelInvocation=true (Issue 056).
200
+ */
201
+ getSystemPromptSnippet(): string;
202
+ /**
203
+ * Check if a name is a valid skill
204
+ */
205
+ has(name: string): boolean;
206
+ /**
207
+ * Get the count of discovered skills
208
+ */
209
+ get size(): number;
210
+ }
211
+ /**
212
+ * Get the global skill registry instance
213
+ *
214
+ * IMPORTANT: If projectRoot is undefined, returns existing instance without reset.
215
+ * This prevents accidental singleton reset when called without arguments.
216
+ */
217
+ declare function getSkillRegistry(projectRoot?: string, customPaths?: Partial<SkillPathsConfig>): SkillRegistry;
218
+ /**
219
+ * Initialize the skill registry and discover skills
220
+ */
221
+ declare function initializeSkillRegistry(projectRoot?: string, customPaths?: Partial<SkillPathsConfig>): Promise<SkillRegistry>;
222
+ /**
223
+ * Reset the global registry (for testing or hot reload)
224
+ */
225
+ declare function resetSkillRegistry(): void;
226
+
227
+ /**
228
+ * Skill Executor - Execution Engine
229
+ *
230
+ * Handles skill execution with support for:
231
+ * - Inline execution (default)
232
+ * - Fork execution (sub-agent)
233
+ * - Tool restrictions
234
+ */
235
+
236
+ /**
237
+ * Execution mode
238
+ */
239
+ type ExecutionMode = 'inline' | 'fork';
240
+ /**
241
+ * Execution options
242
+ */
243
+ interface ExecutionOptions {
244
+ /** Force a specific execution mode */
245
+ mode?: ExecutionMode;
246
+ /** Override model */
247
+ model?: string;
248
+ /** Override agent type (for fork mode) */
249
+ agent?: string;
250
+ /** Override allowed tools */
251
+ allowedTools?: string[];
252
+ /** Callback for inline execution */
253
+ onExecute?: (content: string, skill: Skill) => Promise<string>;
254
+ }
255
+ /**
256
+ * Skill executor class
257
+ */
258
+ declare class SkillExecutor {
259
+ private context;
260
+ constructor(context: SkillContext);
261
+ /**
262
+ * Execute a skill
263
+ */
264
+ execute(skillName: string, args: string, options?: ExecutionOptions): Promise<SkillResult>;
265
+ /**
266
+ * Execute skill inline (in current context)
267
+ */
268
+ private executeInline;
269
+ /**
270
+ * Execute skill in fork mode (sub-agent)
271
+ */
272
+ private executeFork;
273
+ /**
274
+ * Build the execution prompt
275
+ */
276
+ private buildPrompt;
277
+ /**
278
+ * Parse allowed tools string into array
279
+ */
280
+ private parseAllowedTools;
281
+ }
282
+ /**
283
+ * Create a skill executor
284
+ */
285
+ declare function createExecutor(context: SkillContext): SkillExecutor;
286
+ /**
287
+ * Execute a skill with default context
288
+ */
289
+ declare function executeSkill(skillName: string, args: string, context: SkillContext, options?: ExecutionOptions): Promise<SkillResult>;
290
+
291
+ /**
292
+ * Skill Expander - Expand skill commands for LLM context injection
293
+ *
294
+ * Takes a skill invocation and produces content that can be injected
295
+ * into the user message for LLM execution.
296
+ *
297
+ * Design based on pi-mono's _expandSkillCommand:
298
+ * - Wraps content in XML blocks for clear context
299
+ * - Includes skill metadata (name, location)
300
+ * - Resolves all variables ($ARGUMENTS, $0, etc.)
301
+ * - Handles dynamic context (!`command`)
302
+ */
303
+
304
+ /**
305
+ * Result of skill expansion
306
+ */
307
+ interface SkillExpansionResult {
308
+ /** The expanded skill content ready for LLM injection */
309
+ content: string;
310
+ /** Whether the skill has model invocation disabled */
311
+ disableModelInvocation: boolean;
312
+ /** Original skill metadata */
313
+ skill: Skill;
314
+ }
315
+ /**
316
+ * Expand a skill into LLM-ready content
317
+ *
318
+ * This function:
319
+ * 1. Resolves all variables in the skill content ($ARGUMENTS, $0, $1, etc.)
320
+ * 2. Executes dynamic context commands (!`command`)
321
+ * 3. Wraps the content in an XML block for clear context boundaries
322
+ *
323
+ * @param skill - The full skill object with content
324
+ * @param args - Raw arguments string from user input
325
+ * @param context - Execution context (working directory, session ID, etc.)
326
+ * @returns Expansion result with content ready for LLM injection
327
+ */
328
+ declare function expandSkillForLLM(skill: Skill, args: string, context: SkillContext): Promise<SkillExpansionResult>;
329
+ /**
330
+ * Format skill activation message for user display
331
+ */
332
+ declare function formatSkillActivationMessage(skillName: string, args: string): string;
333
+
334
+ export { SkillExecutor as S, VariableResolver as V, SkillRegistry as c, clearPluginSkillPaths as d, createExecutor as e, createResolver as f, discoverSkills as g, discoverSkillsWithMonorepo as h, executeSkill as i, expandSkillForLLM as j, formatSkillActivationMessage as k, formatSkillsSystemPrompt as l, getNestedSkillPaths as m, getSkillRegistry as n, initializeSkillRegistry as o, listPluginSkillPaths as p, loadFullSkill as q, loadSkillFileContent as r, loadSkillMetadata as s, parseArguments as t, parseSkillMarkdown as u, registerPluginSkillPath as v, resetSkillRegistry as w, resolveSkillContent as x, unregisterPluginSkillPath as y };
335
+ export type { DiscoveryResult as D, ExecutionMode as E, ExecutionOptions as a, SkillExpansionResult as b };
@@ -1,4 +1,4 @@
1
- import { R as RunScopedToolDefinition, B as BashPrefixExtractor } from './bash-prefix-extractor.d-BMi_TJIY.js';
1
+ import { bx as RunScopedToolDefinition, a as BashPrefixExtractor } from './bash-prefix-extractor.d-B2rxNI4L.js';
2
2
 
3
3
  /**
4
4
  * Permission Utilities
@@ -1,6 +1,6 @@
1
- import { b as KodaXMessage, c as KodaXReasoningRequest, d as KodaXTokenUsage } from './types.d-Cv09EdJR.js';
2
- import { K as KodaXBaseProvider } from './base.d-JjF6aKsh.js';
3
- import { C as CostTracker } from './cost-tracker.d-MTAt6N7b.js';
1
+ import { k as KodaXMessage, I as KodaXReasoningRequest, a1 as KodaXTokenUsage } from './types.d-CK9A9rpP.js';
2
+ import { K as KodaXBaseProvider } from './base.d-vopO1rml.js';
3
+ import { a as CostTracker } from './cost-tracker.d-BeaenODW.js';
4
4
 
5
5
  /**
6
6
  * sideQuery — independent one-shot LLM invocation.
@@ -531,4 +531,4 @@ interface CreateMemoryManagementAgentOptions extends Omit<CreateMemoryAgentOptio
531
531
  readonly controlPlane: MemoryManagementController;
532
532
  }
533
533
 
534
- export type { AcceptedMemoryView as A, CreateMemoryManagementAgentOptions as C, KodaXHandledMemoryOperation as K, MemoryManagementAgent as M, PersistedOutcomeDigest as P, CreateMemoryAgentOptions as a, MemoryAgent as b, MemoryAgentTraceEvent as c, MemoryDecisionReceipt as d, MemoryEpisodeOutcome as e, MemoryEvidenceGrade as f, MemoryEvidenceRef as g, MemoryInterventionInput as h, MemoryInterventionTrigger as i, MemoryListFilter as j, MemoryObservation as k, MemoryObservationKind as l, MemoryQueryInput as m, MemoryRecallCandidate as n, MemoryRecallInput as o, MemoryRecallRunner as p, MemoryRecallRunnerInput as q, MemoryReminder as r, MemorySelectionMode as s, MemorySession as t, MemorySessionInput as u, MemorySourcePolicy as v };
534
+ export type { AcceptedMemoryView as A, CreateMemoryAgentOptions as C, KodaXHandledMemoryOperation as K, MemoryAgent as M, PersistedOutcomeDigest as P, CreateMemoryManagementAgentOptions as a, MemoryAgentTraceEvent as b, MemoryDecisionReceipt as c, MemoryEpisodeOutcome as d, MemoryEvidenceGrade as e, MemoryEvidenceRef as f, MemoryInterventionInput as g, MemoryInterventionTrigger as h, MemoryListFilter as i, MemoryManagementAgent as j, MemoryObservation as k, MemoryObservationKind as l, MemoryQueryInput as m, MemoryRecallCandidate as n, MemoryRecallInput as o, MemoryRecallRunner as p, MemoryRecallRunnerInput as q, MemoryReminder as r, MemorySelectionMode as s, MemorySession as t, MemorySessionInput as u, MemorySourcePolicy as v };
@@ -1,8 +1,8 @@
1
- import { n as KodaXWireReasoningEffort, f as KodaXToolDefinition, R as KodaXToolResultContentItem, b as KodaXMessage } from './types.d-Cv09EdJR.js';
2
- import { K as KodaXBaseProvider } from './base.d-JjF6aKsh.js';
1
+ import { aa as KodaXWireReasoningEffort, a2 as KodaXToolDefinition, a4 as KodaXToolResultContentItem, k as KodaXMessage } from './types.d-CK9A9rpP.js';
2
+ import { K as KodaXBaseProvider } from './base.d-vopO1rml.js';
3
3
  import { C as CapabilityKind, a as CapabilityProvider } from './capability.d-K664nHOS.js';
4
- import { C as KodaXJsonValue, A as KodaXExtensionSessionRecord, a1 as KodaXExtensionStore } from './types.d-EjZTEEVu.js';
5
- import { aY as KodaXToolExecutionContext, bH as ToolSideEffect } from './bash-prefix-extractor.d-BMi_TJIY.js';
4
+ import { a0 as KodaXJsonValue, U as KodaXExtensionSessionRecord, W as KodaXExtensionStore } from './types.d-rUOjXych.js';
5
+ import { b1 as KodaXToolExecutionContext, bO as ToolSideEffect } from './bash-prefix-extractor.d-B2rxNI4L.js';
6
6
 
7
7
  /**
8
8
  * KodaX Constructed-World types (FEATURE_087, v0.7.28).
@@ -1008,5 +1008,5 @@ interface KodaXExtensionModule {
1008
1008
  activate?: (api: KodaXExtensionAPI) => KodaXExtensionActivationResult;
1009
1009
  }
1010
1010
 
1011
- export { DEFAULT_HANDLER_TIMEOUT_MS as D, defaultPolicy as a3, exec as a4, webhook as a5, CapabilityDeniedError as b, ConstructionManifestError as d };
1012
- export type { ToolRegistrationOptions as $, AgentArtifact as A, KodaXRetrievalResult as B, Capabilities as C, ExecOptions as E, KodaXRetrievalScope as F, KodaXRetrievalToolName as G, KodaXRetrievalTrust as H, LocalToolDefinition as I, RegisteredCommandDiagnostic as J, KodaXExtensionAPI as K, LoadedExtensionDiagnostic as L, ModelProviderRegistration as M, RegisteredHookDiagnostic as N, RegisteredToolDefinition as O, RegisteredToolDiagnostic as P, RuntimeRemoteToolContext as Q, RegisteredCapabilityProviderDiagnostic as R, RuntimeRemoteToolContract as S, RuntimeRemoteToolDecision as T, RuntimeRemoteWorkspaceBroker as U, ScriptSource as V, StagedHandle as W, TestResult as X, ToolContent as Y, ToolDefinitionSource as Z, ToolHandler as _, ArtifactStatus as a, ToolRegistry as a0, WebhookOptions as a1, WebhookResult as a2, AgentContent as a6, ToolHandlerSync as a7, ConstructionArtifact as c, ConstructionPolicy as e, ConstructionPolicyVerdict as f, ExecResult as g, ExtensionCommandContext as h, ExtensionCommandDefinition as i, ExtensionCommandInvocation as j, ExtensionCommandResult as k, ExtensionContributionSource as l, ExtensionEventMap as m, ExtensionFailureDiagnostic as n, ExtensionFailureStage as o, ExtensionHookMap as p, ExtensionLoadSource as q, ExtensionLogger as r, ExtensionRuntimeController as s, ExtensionRuntimeDiagnostics as t, ExtensionToolBeforeHookContext as u, KodaXExtensionActivationResult as v, KodaXExtensionModule as w, KodaXRetrievalArtifact as x, KodaXRetrievalFreshness as y, KodaXRetrievalItem as z };
1011
+ export { DEFAULT_HANDLER_TIMEOUT_MS as D, defaultPolicy as a5, exec as a6, webhook as a7, CapabilityDeniedError as c, ConstructionManifestError as e };
1012
+ export type { ToolHandler as $, AgentArtifact as A, KodaXRetrievalItem as B, Capabilities as C, ExecOptions as E, KodaXRetrievalResult as F, KodaXRetrievalScope as G, KodaXRetrievalToolName as H, KodaXRetrievalTrust as I, LocalToolDefinition as J, KodaXExtensionAPI as K, LoadedExtensionDiagnostic as L, ModelProviderRegistration as M, RegisteredCommandDiagnostic as N, RegisteredHookDiagnostic as O, RegisteredToolDefinition as P, RegisteredToolDiagnostic as Q, RegisteredCapabilityProviderDiagnostic as R, RuntimeRemoteToolContext as S, RuntimeRemoteToolContract as T, RuntimeRemoteToolDecision as U, RuntimeRemoteWorkspaceBroker as V, ScriptSource as W, StagedHandle as X, TestResult as Y, ToolContent as Z, ToolDefinitionSource as _, AgentContent as a, ToolHandlerSync as a0, ToolRegistrationOptions as a1, ToolRegistry as a2, WebhookOptions as a3, WebhookResult as a4, ArtifactStatus as b, ConstructionArtifact as d, ConstructionPolicy as f, ConstructionPolicyVerdict as g, ExecResult as h, ExtensionCommandContext as i, ExtensionCommandDefinition as j, ExtensionCommandInvocation as k, ExtensionCommandResult as l, ExtensionContributionSource as m, ExtensionEventMap as n, ExtensionFailureDiagnostic as o, ExtensionFailureStage as p, ExtensionHookMap as q, ExtensionLoadSource as r, ExtensionLogger as s, ExtensionRuntimeController as t, ExtensionRuntimeDiagnostics as u, ExtensionToolBeforeHookContext as v, KodaXExtensionActivationResult as w, KodaXExtensionModule as x, KodaXRetrievalArtifact as y, KodaXRetrievalFreshness as z };
@@ -671,4 +671,4 @@ interface KodaXProviderStreamOptions {
671
671
  signal?: AbortSignal;
672
672
  }
673
673
 
674
- export type { KodaXProviderContextFidelity as $, KodaXReasoningEffortWireStrategy as A, KodaXRedactedThinkingBlock as B, KodaXReviewScale as C, KodaXRiskLevel as D, KodaXStableEffortIntent as E, KodaXTaskBudgetOverrides as F, KodaXTaskResultSource as G, KodaXTaskRoutingDecision as H, KodaXTaskType as I, KodaXTextBlock as J, KodaXReasoningProfile as K, KodaXThinkingBlock as L, KodaXThinkingBudgetMap as M, KodaXThinkingDepth as N, KodaXThinkingWireStrategy as O, KodaXToolResultBlock as P, KodaXToolUseBlock as Q, KodaXToolResultContentItem as R, KodaXOpenAICompatMaxOutputTokensField as S, KodaXVerifyStrategy as T, KodaXListModelsResult as U, KodaXCacheBoundary as V, KodaXAssuranceIntent as W, KodaXEphemeralSuffix as X, KodaXExecutionPattern as Y, KodaXHarnessProfile as Z, KodaXMutationSurface as _, KodaXTaskResultMetadata as a, KodaXProviderEvidenceSupport as a0, KodaXProviderLongRunningSupport as a1, KodaXProviderMultimodalSupport as a2, KodaXProviderSessionSupport as a3, KodaXProviderToolCallingFidelity as a4, KodaXTaskActionability as a5, KodaXTaskComplexity as a6, KodaXTaskFamily as a7, KodaXTaskWorkIntent as a8, KodaXToolResultImageItem as a9, KodaXToolResultTextItem as aa, KodaXMessage as b, KodaXReasoningRequest as c, KodaXTokenUsage as d, KodaXProviderConfig as e, KodaXToolDefinition as f, KodaXProviderStreamOptions as g, KodaXStreamResult as h, KodaXVerifyCredentialResult as i, KodaXModelDescriptor as j, KodaXProviderCapabilityProfile as k, KodaXReasoningCapability as l, KodaXNormalizedReasoningRequest as m, KodaXWireReasoningEffort as n, KodaXReasoningMode as o, KodaXChildFanoutClass as p, KodaXContentBlock as q, KodaXCustomProviderConfig as r, KodaXExecutionMode as s, KodaXImageBlock as t, KodaXProtocolFamily as u, KodaXProviderConversationSemantics as v, KodaXProviderMcpSupport as w, KodaXProviderTransport as x, KodaXReasoningEffortPreset as y, KodaXReasoningEffortRequest as z };
674
+ export type { KodaXThinkingDepth as $, KodaXProviderToolCallingFidelity as A, KodaXProviderTransport as B, KodaXReasoningCapability as C, KodaXReasoningEffortPreset as D, KodaXReasoningEffortRequest as E, KodaXReasoningEffortWireStrategy as F, KodaXReasoningMode as G, KodaXReasoningProfile as H, KodaXReasoningRequest as I, KodaXRedactedThinkingBlock as J, KodaXAssuranceIntent as K, KodaXReviewScale as L, KodaXRiskLevel as M, KodaXStableEffortIntent as N, KodaXStreamResult as O, KodaXTaskActionability as P, KodaXTaskBudgetOverrides as Q, KodaXTaskComplexity as R, KodaXTaskFamily as S, KodaXTaskResultMetadata as T, KodaXTaskResultSource as U, KodaXTaskRoutingDecision as V, KodaXTaskType as W, KodaXTaskWorkIntent as X, KodaXTextBlock as Y, KodaXThinkingBlock as Z, KodaXThinkingBudgetMap as _, KodaXCacheBoundary as a, KodaXThinkingWireStrategy as a0, KodaXTokenUsage as a1, KodaXToolDefinition as a2, KodaXToolResultBlock as a3, KodaXToolResultContentItem as a4, KodaXToolResultImageItem as a5, KodaXToolResultTextItem as a6, KodaXToolUseBlock as a7, KodaXVerifyCredentialResult as a8, KodaXVerifyStrategy as a9, KodaXWireReasoningEffort as aa, KodaXChildFanoutClass as b, KodaXContentBlock as c, KodaXCustomProviderConfig as d, KodaXEphemeralSuffix as e, KodaXExecutionMode as f, KodaXExecutionPattern as g, KodaXHarnessProfile as h, KodaXImageBlock as i, KodaXListModelsResult as j, KodaXMessage as k, KodaXModelDescriptor as l, KodaXMutationSurface as m, KodaXNormalizedReasoningRequest as n, KodaXOpenAICompatMaxOutputTokensField as o, KodaXProtocolFamily as p, KodaXProviderCapabilityProfile as q, KodaXProviderConfig as r, KodaXProviderContextFidelity as s, KodaXProviderConversationSemantics as t, KodaXProviderEvidenceSupport as u, KodaXProviderLongRunningSupport as v, KodaXProviderMcpSupport as w, KodaXProviderMultimodalSupport as x, KodaXProviderSessionSupport as y, KodaXProviderStreamOptions as z };
@@ -1,5 +1,5 @@
1
- import { K as KodaXInputArtifact } from './controller.d-Bm1i9RVj.js';
2
- import { a as KodaXTaskResultMetadata } from './types.d-Cv09EdJR.js';
1
+ import { a$ as KodaXInputArtifact } from './controller.d-C5noq5-w.js';
2
+ import { T as KodaXTaskResultMetadata } from './types.d-CK9A9rpP.js';
3
3
 
4
4
  /**
5
5
  * @kodax-ai/agent/messaging — Message queue types
@@ -17,6 +17,13 @@ import { a as KodaXTaskResultMetadata } from './types.d-Cv09EdJR.js';
17
17
  */
18
18
 
19
19
  type MessagePriority = 'user' | 'background';
20
+ /**
21
+ * Delivery owner for user prompts. Ordinary messages are runtime-deliverable.
22
+ * `host` is reserved for prompts that must re-enter a trusted host command
23
+ * pipeline (for example an explicit user Skill invocation) before any model
24
+ * can observe them.
25
+ */
26
+ type MessageDelivery = 'runtime' | 'host';
20
27
  /**
21
28
  * Delivery semantics, independent of priority:
22
29
  * - `prompt`: user-authored input; delivered as a real user turn.
@@ -40,6 +47,8 @@ interface QueuedMessage {
40
47
  */
41
48
  readonly agentId?: string;
42
49
  readonly mode: MessageMode;
50
+ /** Omitted means `runtime`; `host` messages must not be spliced into a model turn. */
51
+ readonly delivery?: MessageDelivery;
43
52
  readonly content: string;
44
53
  readonly inputArtifacts?: readonly QueuedInputArtifact[];
45
54
  readonly taskResult?: KodaXTaskResultMetadata;
@@ -126,10 +135,12 @@ type QueueEventListener = (event: QueueEvent) => void;
126
135
  interface EnqueueInput {
127
136
  readonly priority: MessagePriority;
128
137
  readonly mode: MessageMode;
138
+ /** Omitted means `runtime`; use `host` for command-pipeline-owned prompts. */
139
+ readonly delivery?: MessageDelivery;
129
140
  readonly content: string;
130
141
  readonly agentId?: string;
131
142
  readonly inputArtifacts?: readonly QueuedInputArtifact[];
132
143
  readonly taskResult?: KodaXTaskResultMetadata;
133
144
  }
134
145
 
135
- export type { DequeueFilter as D, EnqueueInput as E, MessagePriority as M, QueuedMessage as Q, QueueEventListener as a, QueuedInputArtifact as b, MessageMode as c };
146
+ export type { DequeueFilter as D, EnqueueInput as E, MessageDelivery as M, QueueEventListener as Q, MessageMode as a, MessagePriority as b, QueuedInputArtifact as c, QueuedMessage as d };
@@ -14,7 +14,7 @@ interface SkillFrontmatter {
14
14
  description: string;
15
15
  /** Whether to disable automatic model invocation (default: false) */
16
16
  disableModelInvocation?: boolean;
17
- /** Whether skill appears in / menu (default: true) */
17
+ /** @deprecated Enabled skills are always explicitly user-invocable. */
18
18
  userInvocable?: boolean;
19
19
  /** Tool restrictions, e.g., "Read, Grep, Bash(python:*)" */
20
20
  allowedTools?: string;
@@ -52,6 +52,7 @@ interface SkillHooks {
52
52
  interface SkillMetadata {
53
53
  name: string;
54
54
  description: string;
55
+ /** @deprecated Enabled skills always report true and support explicit invocation. */
55
56
  userInvocable: boolean;
56
57
  argumentHint?: string;
57
58
  path: string;
@@ -110,13 +111,13 @@ interface ISkillRegistry {
110
111
  get(name: string): SkillMetadata | undefined;
111
112
  /** Load full skill content */
112
113
  loadFull(name: string): Promise<Skill>;
113
- /** Invoke a skill with arguments */
114
+ /** Explicitly invoke a skill with arguments; model admission is a caller concern. */
114
115
  invoke(name: string, args: string, context: SkillContext): Promise<SkillResult>;
115
116
  /** Reload skills from disk */
116
117
  reload(): Promise<void>;
117
118
  /** List all discovered skills */
118
119
  list(): ReadonlyArray<SkillMetadata>;
119
- /** List skills that can be invoked directly by users */
120
+ /** List enabled skills available for explicit user invocation. */
120
121
  listUserInvocable(): ReadonlyArray<SkillMetadata>;
121
122
  /** Check whether a skill exists */
122
123
  has(name: string): boolean;
@@ -275,4 +276,4 @@ declare function getSkillPathsFlat(config: SkillPathsConfig): Array<{
275
276
  }>;
276
277
 
277
278
  export { getDefaultSkillPaths as m, getSkillPathsFlat as n };
278
- export type { ISkillRegistry as I, LearnedSkillDiscoveryConfig as L, ResolvedSkillSource as R, SkillMetadata as S, SkillDynamicContextExecutor as a, IVariableResolver as b, Skill as c, SkillArtifact as d, SkillContext as e, SkillFile as f, SkillFrontmatter as g, SkillHook as h, SkillHooks as i, SkillPathsConfig as j, SkillResult as k, SkillSource as l };
279
+ export type { ISkillRegistry as I, LearnedSkillDiscoveryConfig as L, ResolvedSkillSource as R, Skill as S, IVariableResolver as a, SkillArtifact as b, SkillContext as c, SkillDynamicContextExecutor as d, SkillFile as e, SkillFrontmatter as f, SkillHook as g, SkillHooks as h, SkillMetadata as i, SkillPathsConfig as j, SkillResult as k, SkillSource as l };
@@ -1,4 +1,4 @@
1
- import { b as KodaXMessage } from './types.d-Cv09EdJR.js';
1
+ import { k as KodaXMessage } from './types.d-CK9A9rpP.js';
2
2
 
3
3
  type AgentActorState = 'running' | 'idle' | 'closed';
4
4
  type AgentTurnState = 'accepted' | 'running' | 'completed' | 'failed' | 'interrupted';
@@ -611,6 +611,8 @@ interface KodaXSessionRuntimeInfo {
611
611
  permissionMode?: string;
612
612
  /** Agent mode active at session start, e.g. `'sa'` | `'ama'`. */
613
613
  agentMode?: string;
614
+ /** Runtime-owned exact linked-worktree roots admitted for this Session. */
615
+ sandboxWorktreeRoots?: string[];
614
616
  }
615
617
  interface KodaXSessionData {
616
618
  messages: KodaXMessage[];
@@ -710,6 +712,8 @@ interface KodaXExtensionStore {
710
712
  interface KodaXSessionStorage {
711
713
  save(id: string, data: KodaXSessionData): Promise<void>;
712
714
  load(id: string): Promise<KodaXSessionData | null>;
715
+ /** Atomically updates Runtime-owned Session metadata without replacing transcript state. */
716
+ mutateRuntimeInfo?(id: string, mutation: (runtimeInfo: KodaXSessionRuntimeInfo | undefined) => KodaXSessionRuntimeInfo | undefined): Promise<boolean>;
713
717
  /**
714
718
  * Atomically mutates context-silent lineage state against the latest
715
719
  * persisted session. Hosts that own session persistence may expose this
@@ -1086,4 +1090,4 @@ type MemoryEvent = {
1086
1090
  };
1087
1091
 
1088
1092
  export { hashMemoryIdentityComponent as bf, isMemoryManagementController as bg, matchesMemoryApplicability as bh, memoryApplicabilityFingerprint as bi };
1089
- export type { MemoryApplicability as $, KodaXExtensionSessionRecord as A, KodaXExtensionSessionState as B, KodaXJsonValue as C, KodaXSessionBranchSummaryEntry as D, KodaXSessionCompactionEntry as E, KodaXSessionData as F, KodaXSessionEntry as G, KodaXSessionEntryBase as H, KodaXSessionLabelEntry as I, KodaXSessionMessageEntry as J, KodaXSessionLineage as K, KodaXSessionMeta as L, MemoryContextIdentity as M, KodaXSessionNavigationOptions as N, KodaXSessionRuntimeInfo as O, KodaXSessionScope as P, KodaXSessionStorage as Q, KodaXSessionTreeNode as R, KodaXSessionUiHistoryItem as S, KodaXSessionUiHistoryItemType as T, KodaXSessionUiTextHistoryItem as U, KodaXSessionUiTextHistoryItemType as V, KodaXSessionUiToolCall as W, KodaXSessionUiToolCallStatus as X, KodaXSessionUiToolGroupHistoryItem as Y, KodaXSessionWorkspaceKind as Z, SessionErrorMetadata as _, MemoryItemRef as a, MemoryClaimKind as a$, MemoryController as a0, KodaXExtensionStore as a1, AgentActorSnapshot as a2, AgentActorSaveAttempt as a3, AgentExecutionKind as a4, AgentTreeSnapshot as a5, AgentDetail as a6, AgentSpawnInput as a7, AgentTurnRef as a8, AgentDataClassification as a9, AgentActorSavePhase as aA, AgentActorSaveTiming as aB, AgentActorSnapshotV1 as aC, AgentActorSnapshotV2 as aD, AgentActorState as aE, AgentArtifactDescriptor as aF, AgentBudgetAdmission as aG, AgentBudgetAdmissionInput as aH, AgentEventKind as aI, AgentExecutionInput as aJ, AgentForkTurns as aK, AgentListEntry as aL, AgentProgressItem as aM, AgentProgressKind as aN, AgentProgressUpdate as aO, AgentTurn as aP, AgentTurnState as aQ, AgentTurnSummary as aR, KodaXGoalStatus as aS, KodaXHandledMemoryOperation as aT, KodaXMemoryInfluenceRef as aU, KodaXMemoryIntent as aV, KodaXMemoryOutcomeEvidence as aW, KodaXSessionArchiveMarkerEntry as aX, MemoryApplyPreview as aY, MemoryApproval as aZ, MemoryAuthority as a_, AgentFollowupResult as aa, AgentOutput as ab, AgentEvent as ac, KodaXSessionGoalEntry as ad, KodaXSessionClientNoticeEntry as ae, KodaXSessionRewindMarkerEntry as af, KodaXSessionMemoryOutcomeDigestEntry as ag, KodaXSessionMemoryReviewReceiptEntry as ah, KodaXGoalState as ai, AgentActorStore as aj, AgentTurnExecutor as ak, AgentBudgetPort as al, AgentActorOwner as am, AgentActorClient as an, AgentExecutionResult as ao, AgentCapabilities as ap, AgentMailboxMessage as aq, AgentMutationOptions as ar, AgentMetadataValue as as, AgentInterruptScope as at, KodaXGoalEventType as au, KodaXExtensionStoreEntry as av, AgentBudgetExhausted as aw, AgentLimitReached as ax, AgentActor as ay, AgentActorSaveDiagnostics as az, KodaXSessionArtifactLedgerEntry as b, MemoryGovernanceFinding as b0, MemoryGovernanceFindingKind as b1, MemoryLifecycle as b2, MemoryPackHint as b3, MemoryPackTraceMetadata as b4, MemoryProposalAction as b5, MemoryRefKind as b6, MemoryReviewCandidateRef as b7, MemoryReviewDraftAction as b8, MemoryReviewPersistenceDecision as b9, MemoryReviewPersistenceKind as ba, MemoryReviewTrigger as bb, MemoryScope as bc, MemorySourceAdapter as bd, MemoryVisibility as be, MemoryEvent as c, MemoryReviewRunner as d, MemoryManagementController as e, MemoryActionProposal as f, MemoryApplyResult as g, MemoryRejectResult as h, MemoryRefFilter as i, MemoryBodySnapshot as j, MemoryRememberInput as k, MemoryRememberResult as l, MemoryLifecycleOperationResult as m, MemoryCuratorInput as n, MemoryGovernanceReport as o, MemoryAutoCuratorInput as p, MemoryAutoCuratorResult as q, MemoryPackInput as r, MemoryPack as s, MemoryReviewInput as t, MemoryReviewPlan as u, KodaXMemoryOutcomeDigest as v, MemoryReviewModelInput as w, MemoryEpisodeReviewResult as x, KodaXCompactMemoryProgress as y, KodaXCompactMemorySeed as z };
1093
+ export type { KodaXHandledMemoryOperation as $, AgentActor as A, AgentInterruptScope as B, AgentLimitReached as C, AgentListEntry as D, AgentMailboxMessage as E, AgentMetadataValue as F, AgentMutationOptions as G, AgentOutput as H, AgentProgressItem as I, AgentProgressKind as J, AgentProgressUpdate as K, AgentSpawnInput as L, AgentTreeSnapshot as M, AgentTurn as N, AgentTurnExecutor as O, AgentTurnRef as P, AgentTurnState as Q, AgentTurnSummary as R, KodaXCompactMemoryProgress as S, KodaXCompactMemorySeed as T, KodaXExtensionSessionRecord as U, KodaXExtensionSessionState as V, KodaXExtensionStore as W, KodaXExtensionStoreEntry as X, KodaXGoalEventType as Y, KodaXGoalState as Z, KodaXGoalStatus as _, AgentActorClient as a, MemoryRejectResult as a$, KodaXJsonValue as a0, KodaXMemoryInfluenceRef as a1, KodaXMemoryIntent as a2, KodaXMemoryOutcomeDigest as a3, KodaXMemoryOutcomeEvidence as a4, KodaXSessionArchiveMarkerEntry as a5, KodaXSessionArtifactLedgerEntry as a6, KodaXSessionBranchSummaryEntry as a7, KodaXSessionClientNoticeEntry as a8, KodaXSessionCompactionEntry as a9, MemoryApplyPreview as aA, MemoryApplyResult as aB, MemoryApproval as aC, MemoryAuthority as aD, MemoryAutoCuratorInput as aE, MemoryAutoCuratorResult as aF, MemoryBodySnapshot as aG, MemoryClaimKind as aH, MemoryContextIdentity as aI, MemoryController as aJ, MemoryCuratorInput as aK, MemoryEpisodeReviewResult as aL, MemoryEvent as aM, MemoryGovernanceFinding as aN, MemoryGovernanceFindingKind as aO, MemoryGovernanceReport as aP, MemoryItemRef as aQ, MemoryLifecycle as aR, MemoryLifecycleOperationResult as aS, MemoryManagementController as aT, MemoryPack as aU, MemoryPackHint as aV, MemoryPackInput as aW, MemoryPackTraceMetadata as aX, MemoryProposalAction as aY, MemoryRefFilter as aZ, MemoryRefKind as a_, KodaXSessionData as aa, KodaXSessionEntry as ab, KodaXSessionEntryBase as ac, KodaXSessionGoalEntry as ad, KodaXSessionLabelEntry as ae, KodaXSessionLineage as af, KodaXSessionMemoryOutcomeDigestEntry as ag, KodaXSessionMemoryReviewReceiptEntry as ah, KodaXSessionMessageEntry as ai, KodaXSessionMeta as aj, KodaXSessionNavigationOptions as ak, KodaXSessionRewindMarkerEntry as al, KodaXSessionRuntimeInfo as am, KodaXSessionScope as an, KodaXSessionStorage as ao, KodaXSessionTreeNode as ap, KodaXSessionUiHistoryItem as aq, KodaXSessionUiHistoryItemType as ar, KodaXSessionUiTextHistoryItem as as, KodaXSessionUiTextHistoryItemType as at, KodaXSessionUiToolCall as au, KodaXSessionUiToolCallStatus as av, KodaXSessionUiToolGroupHistoryItem as aw, KodaXSessionWorkspaceKind as ax, MemoryActionProposal as ay, MemoryApplicability as az, AgentActorOwner as b, MemoryRememberInput as b0, MemoryRememberResult as b1, MemoryReviewCandidateRef as b2, MemoryReviewDraftAction as b3, MemoryReviewInput as b4, MemoryReviewModelInput as b5, MemoryReviewPersistenceDecision as b6, MemoryReviewPersistenceKind as b7, MemoryReviewPlan as b8, MemoryReviewRunner as b9, MemoryReviewTrigger as ba, MemoryScope as bb, MemorySourceAdapter as bc, MemoryVisibility as bd, SessionErrorMetadata as be, AgentActorSaveAttempt as c, AgentActorSaveDiagnostics as d, AgentActorSavePhase as e, AgentActorSaveTiming as f, AgentActorSnapshot as g, AgentActorSnapshotV1 as h, AgentActorSnapshotV2 as i, AgentActorState as j, AgentActorStore as k, AgentArtifactDescriptor as l, AgentBudgetAdmission as m, AgentBudgetAdmissionInput as n, AgentBudgetExhausted as o, AgentBudgetPort as p, AgentCapabilities as q, AgentDataClassification as r, AgentDetail as s, AgentEvent as t, AgentEventKind as u, AgentExecutionInput as v, AgentExecutionKind as w, AgentExecutionResult as x, AgentFollowupResult as y, AgentForkTurns as z };
@@ -1,10 +1,10 @@
1
- import { b as KodaXMessage, o as KodaXReasoningMode, r as KodaXCustomProviderConfig, k as KodaXProviderCapabilityProfile } from './types.d-Cv09EdJR.js';
2
- import { N as WorkflowProcessSource } from './controller.d-Bm1i9RVj.js';
3
- import { O as KodaXContextTokenSnapshot, aB as KodaXSkillDynamicContextPolicy, s as KodaXAgentMode, ag as KodaXRepoIntelligenceMode, a2 as KodaXOptions, aC as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-BMi_TJIY.js';
4
- import { f as AgentsFile, u as AutoModeStats, S as KodaXMcpServersConfig } from './guardrail.d-CKkoea7y.js';
1
+ import { k as KodaXMessage, G as KodaXReasoningMode, d as KodaXCustomProviderConfig, q as KodaXProviderCapabilityProfile } from './types.d-CK9A9rpP.js';
2
+ import { df as WorkflowProcessSource } from './controller.d-C5noq5-w.js';
3
+ import { Q as KodaXContextTokenSnapshot, aD as KodaXSkillDynamicContextPolicy, t as KodaXAgentMode, ai as KodaXRepoIntelligenceMode, a4 as KodaXOptions, aE as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-B2rxNI4L.js';
4
+ import { e as AgentsFile, t as AutoModeStats, T as KodaXMcpServersConfig } from './guardrail.d-DqHD-61O.js';
5
5
  import * as readline from 'readline';
6
- import { S as KodaXSessionUiHistoryItem, K as KodaXSessionLineage, b as KodaXSessionArtifactLedgerEntry, B as KodaXExtensionSessionState, A as KodaXExtensionSessionRecord, O as KodaXSessionRuntimeInfo } from './types.d-EjZTEEVu.js';
7
- import { b as PermissionMode, L as LearningBinding, c as LearningSurfaceSnapshot } from './public-api.d-BsZWOq3P.js';
6
+ import { aq as KodaXSessionUiHistoryItem, af as KodaXSessionLineage, a6 as KodaXSessionArtifactLedgerEntry, V as KodaXExtensionSessionState, U as KodaXExtensionSessionRecord, am as KodaXSessionRuntimeInfo } from './types.d-rUOjXych.js';
7
+ import { S as PermissionMode, L as LearningBinding, G as LearningSurfaceSnapshot } from './public-api.d-D7fXaWW8.js';
8
8
  import { SpawnSyncReturns } from 'child_process';
9
9
 
10
10
  /**
@@ -720,5 +720,5 @@ declare function resolveRuntimeEffortSelection(input: {
720
720
  declare function getGitRoot(cwd?: string): Promise<string | null>;
721
721
  declare function rateLimitedCall<T>(fn: () => Promise<T>): Promise<T>;
722
722
 
723
- export { KODAX_EXAMPLE_CONFIG_FILE as E, KODAX_INTEGRATION_EXAMPLE_FILES as F, ensureExampleConfigFile as H, ensureExampleConfigFiles as J, KODAX_CONFIG_FILE as K, resolveRuntimeEffortSelection as L, resolveRuntimeModelSelection as M, resolveRuntimeProviderSelection as N, PREVIEW_MAX_LENGTH as P, KODAX_DIR as b, KODAX_SESSIONS_DIR as c, KODAX_VERSION as d, createInteractiveContext as f, getGitRoot as g, getProviderList as h, getProviderModel as i, getVersion as j, hydrateProcessEnvFromShell as k, isProviderConfigured as l, loadAutoModeSettings as m, loadConfig as n, registerConfiguredCustomProviders as o, prepareRuntimeConfig as p, resolveAutoModeSettings as q, rateLimitedCall as r, saveConfig as s, touchContext as t };
724
- export type { AutoModeSettings as A, RuntimeSurfaceStatus as B, CommandCallbacks as C, InteractiveMode as D, RuntimeSurfaceMode as G, InteractiveContext as I, ResolveAutoModeSettingsInput as R, CurrentConfig as a, ResolvedAutoModeSettings as e, CommandDefinition as u, CommandSource as v, CommandInfo as w, Command as x, CommandInvocationRequest as y, CommandWorkflowInvocationRequest as z };
723
+ export { loadConfig as B, prepareRuntimeConfig as D, rateLimitedCall as E, registerConfiguredCustomProviders as F, resolveAutoModeSettings as G, resolveRuntimeEffortSelection as H, resolveRuntimeModelSelection as J, KODAX_CONFIG_FILE as K, resolveRuntimeProviderSelection as L, saveConfig as M, touchContext as N, PREVIEW_MAX_LENGTH as P, KODAX_DIR as i, KODAX_EXAMPLE_CONFIG_FILE as j, KODAX_INTEGRATION_EXAMPLE_FILES as k, KODAX_SESSIONS_DIR as l, KODAX_VERSION as m, createInteractiveContext as q, ensureExampleConfigFile as r, ensureExampleConfigFiles as s, getGitRoot as t, getProviderList as u, getProviderModel as v, getVersion as w, hydrateProcessEnvFromShell as x, isProviderConfigured as y, loadAutoModeSettings as z };
724
+ export type { AutoModeSettings as A, Command as C, InteractiveContext as I, ResolveAutoModeSettingsInput as R, CommandCallbacks as a, CommandDefinition as b, CommandInfo as c, CommandInvocationRequest as d, CommandSource as e, CommandWorkflowInvocationRequest as f, CurrentConfig as g, InteractiveMode as h, ResolvedAutoModeSettings as n, RuntimeSurfaceMode as o, RuntimeSurfaceStatus as p };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kodax-ai/kodax",
3
- "version": "0.7.93",
3
+ "version": "0.7.95",
4
4
  "description": "KodaX lightweight coding agent - TypeScript implementation with 16 built-in LLM provider aliases, published as a Node-free single-file CLI and SDK",
5
5
  "type": "module",
6
6
  "private": false,
@@ -13,7 +13,7 @@
13
13
  "daemonShutdownVerification": 1,
14
14
  "integrationConfigResilience": 1,
15
15
  "managedRunDurability": 1,
16
- "runtimeExitSettlement": 1,
16
+ "runtimeExitSettlement": 2,
17
17
  "sessionEventJournal": 1,
18
18
  "liveOutputSegments": 1
19
19
  },
@@ -1,2 +0,0 @@
1
- // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
2
- import{Ka as g,Ma as h,Za as i,_a as j,a as c,sa as d,ta as e,ua as f,yc as k}from"./chunk-JJ2YDBSN.js";import"./chunk-7QBWHCIZ.js";import"./chunk-JTZKC4TV.js";import"./chunk-GH3KBC2H.js";import"./chunk-YVG6OKN7.js";import"./chunk-BHE66SP3.js";import{Jb as a,Kb as b}from"./chunk-7XSZVOG7.js";import"./chunk-QFV6YCIH.js";import"./chunk-ONUPGMER.js";export{e as bucketProviderPayloadSize,g as buildAutoRepoIntelligenceContext,f as checkPromiseSignal,b as cleanupIncompleteToolCalls,h as describeTransientProviderRetry,c as emitResilienceDebug,d as estimateProviderPayloadBytes,k as runKodaX,j as saveRequiredSessionSnapshot,i as saveSessionSnapshot,a as validateAndFixToolHistory};
@@ -1,2 +0,0 @@
1
- // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
2
- import{Ha as a,Ia as b}from"./chunk-3YOZIFSJ.js";import"./chunk-HLZWPB32.js";import"./chunk-GRWUC6H7.js";import"./chunk-4BY53JTF.js";import"./chunk-XTWIGVUL.js";import"./chunk-JJ2YDBSN.js";import"./chunk-7QBWHCIZ.js";import"./chunk-PRASABCC.js";import"./chunk-JTZKC4TV.js";import"./chunk-GH3KBC2H.js";import"./chunk-YVG6OKN7.js";import"./chunk-BHE66SP3.js";import"./chunk-7XSZVOG7.js";import"./chunk-QFV6YCIH.js";import"./chunk-ONUPGMER.js";export{a as ArgumentCompleter,b as createArgumentCompleter};