@kody-ade/kody-engine 0.4.55 → 0.4.56

package/dist/bin/kody.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.55",
+  version: "0.4.56",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -472,7 +472,19 @@ async function runAgent(opts) {
       queryOptions.maxThinkingTokens = opts.maxThinkingTokens;
     }
     if (typeof opts.systemPromptAppend === "string" && opts.systemPromptAppend.length > 0) {
-      queryOptions.systemPrompt = { type: "preset", preset: "claude_code", append: opts.systemPromptAppend };
+      const systemPrompt = {
+        type: "preset",
+        preset: "claude_code",
+        append: opts.systemPromptAppend
+      };
+      if (opts.cacheable) systemPrompt.excludeDynamicSections = true;
+      queryOptions.systemPrompt = systemPrompt;
+    } else if (opts.cacheable) {
+      queryOptions.systemPrompt = {
+        type: "preset",
+        preset: "claude_code",
+        excludeDynamicSections: true
+      };
     }
     queryOptions.settingSources = opts.settingSources ?? ["project", "local"];
     const result = query({
@@ -1779,6 +1791,7 @@ function parseClaudeCode(p, raw) {
     maxThinkingTokens: typeof r.maxThinkingTokens === "number" ? r.maxThinkingTokens : null,
     maxTurnTimeoutSec: typeof r.maxTurnTimeoutSec === "number" ? r.maxTurnTimeoutSec : null,
     systemPromptAppend: typeof r.systemPromptAppend === "string" ? r.systemPromptAppend : null,
+    cacheable: r.cacheable === true,
     tools,
     hooks: Array.isArray(r.hooks) ? r.hooks : [],
     skills: Array.isArray(r.skills) ? r.skills : [],
@@ -9273,6 +9286,7 @@ async function runExecutable(profileName, input) {
       maxThinkingTokens: profile.claudeCode.maxThinkingTokens,
       maxTurnTimeoutMs: typeof profile.claudeCode.maxTurnTimeoutSec === "number" ? Math.floor(profile.claudeCode.maxTurnTimeoutSec * 1e3) : void 0,
       systemPromptAppend: profile.claudeCode.systemPromptAppend,
+      cacheable: profile.claudeCode.cacheable,
       settingSources: profile.claudeCode.settingSources
     });
   };

package/dist/executables/classify/profile.json

@@ -24,6 +24,7 @@
     "maxTurns": null,
     "maxThinkingTokens": null,
     "systemPromptAppend": null,
+    "cacheable": true,
     "tools": [
       "Read",
       "Bash"

package/dist/executables/fix/profile.json

@@ -25,6 +25,7 @@
     "maxTurns": null,
     "maxTurnTimeoutSec": 1200,
     "systemPromptAppend": null,
+    "cacheable": true,
     "tools": [
       "Read",
       "Write",

package/dist/executables/fix-ci/profile.json

@@ -24,6 +24,7 @@
     "maxTurns": null,
     "maxTurnTimeoutSec": 1200,
     "systemPromptAppend": null,
+    "cacheable": true,
     "tools": [
       "Read",
       "Write",

package/dist/executables/run/profile.json

@@ -24,6 +24,7 @@
     "maxTurns": null,
     "maxTurnTimeoutSec": 1200,
     "systemPromptAppend": null,
+    "cacheable": true,
     "tools": [
       "Read",
       "Write",

package/dist/executables/types.ts

@@ -163,6 +163,20 @@ export interface ClaudeCodeSpec {
   maxTurnTimeoutSec?: number | null
   /** Text appended on top of Claude Code's baseline system prompt. */
   systemPromptAppend: string | null
+  /**
+   * Cross-process prompt caching opt-in. When true, the agent invocation
+   * sets `systemPrompt.excludeDynamicSections: true` so per-user dynamic
+   * content (cwd, git status, auto-memory) is stripped from the preset
+   * and re-injected as the first user message. The remaining preset
+   * becomes byte-identical across runs and benefits from Anthropic's
+   * 5-min server-side prompt cache. Recommended for hot-path stages
+   * (`run`, `fix`, `classify`) where the same workflow fires many
+   * times in a short window.
+   *
+   * Default: false (preserves legacy behaviour). No-op if the SDK does
+   * not support `excludeDynamicSections` (forward-compatible).
+   */
+  cacheable?: boolean
   /** SDK built-in tools this executable is allowed to use (capability pack). */
   tools: string[]
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.55",
+  "version": "0.4.56",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",