@kody-ade/kody-engine 0.4.54 → 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.54",
+  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 : [],
@@ -5471,6 +5484,12 @@ function extractIssueNumber(pr) {
 
 // src/scripts/finishFlow.ts
 import { execFileSync as execFileSync14 } from "child_process";
+var TERMINAL_PHASE = {
+  "review-passed": { phase: "shipped", status: "succeeded" },
+  "fix-applied": { phase: "shipped", status: "succeeded" },
+  "review-failed": { phase: "failed", status: "failed" },
+  aborted: { phase: "failed", status: "failed" }
+};
 var API_TIMEOUT_MS6 = 3e4;
 var STATUS_ICON = {
   "review-passed": "\u2705",
@@ -5515,6 +5534,22 @@ var finishFlow = async (ctx, profile, _agentResult, args) => {
 `
     );
   }
+  const terminal = TERMINAL_PHASE[reason];
+  if (terminal && state) {
+    state.core.phase = terminal.phase;
+    state.core.status = terminal.status;
+    state.core.currentExecutable = null;
+    const target = ctx.data.commentTargetType ?? "issue";
+    const targetNumber = ctx.data.commentTargetNumber ?? issueNumber;
+    try {
+      writeTaskState(target, targetNumber, state, ctx.cwd);
+    } catch (err) {
+      process.stderr.write(
+        `[kody finishFlow] failed to update state mirror: ${err instanceof Error ? err.message : String(err)}
+`
+      );
+    }
+  }
 };
 
 // src/branch.ts
@@ -9251,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.54",
+  "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",
@@ -12,18 +12,6 @@
     "templates",
     "kody.config.schema.json"
   ],
-  "scripts": {
-    "kody": "tsx bin/kody.ts",
-    "build": "tsup && node scripts/copy-assets.cjs",
-    "test": "vitest run tests/unit tests/int --no-coverage",
-    "test:e2e": "vitest run tests/e2e --no-coverage",
-    "test:all": "vitest run tests --no-coverage",
-    "typecheck": "tsc --noEmit",
-    "lint": "biome check",
-    "lint:fix": "biome check --write",
-    "format": "biome format --write",
-    "prepublishOnly": "pnpm build"
-  },
   "dependencies": {
     "@actions/cache": "^6.0.0",
     "@anthropic-ai/claude-agent-sdk": "0.2.119"
@@ -44,5 +32,16 @@
     "url": "git+https://github.com/aharonyaircohen/kody-engine.git"
   },
   "homepage": "https://github.com/aharonyaircohen/kody-engine",
-  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues"
-}
+  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues",
+  "scripts": {
+    "kody": "tsx bin/kody.ts",
+    "build": "tsup && node scripts/copy-assets.cjs",
+    "test": "vitest run tests/unit tests/int --no-coverage",
+    "test:e2e": "vitest run tests/e2e --no-coverage",
+    "test:all": "vitest run tests --no-coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check",
+    "lint:fix": "biome check --write",
+    "format": "biome format --write"
+  }
+}