@kody-ade/kody-engine 0.4.382 → 0.4.383

package/dist/bin/kody.js

@@ -15,7 +15,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@kody-ade/kody-engine",
-      version: "0.4.382",
+      version: "0.4.383",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -3777,6 +3777,108 @@ var init_agents = __esm({
   }
 });
 
+// src/chat/convex-client.ts
+import { ConvexHttpClient } from "convex/browser";
+function isPlainObject2(value) {
+  if (value === null || typeof value !== "object") return false;
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}
+function deepMapKeys(value, mapKey) {
+  if (Array.isArray(value)) return value.map((item) => deepMapKeys(item, mapKey));
+  if (isPlainObject2(value)) {
+    return Object.fromEntries(Object.entries(value).map(([key, item]) => [mapKey(key), deepMapKeys(item, mapKey)]));
+  }
+  return value;
+}
+function deepEscapeKeys(value) {
+  return deepMapKeys(value, (k) => NEEDS_ESCAPE.test(k) ? `${ESCAPE_CHAR}${k}` : k);
+}
+function deepUnescapeKeys(value) {
+  return deepMapKeys(value, (k) => k.startsWith(ESCAPE_CHAR) ? k.slice(1) : k);
+}
+function injectServiceKey(args, serviceKey = process.env.KODY_SERVICE_KEY) {
+  if (!serviceKey) return args;
+  if (args === void 0) return { serviceKey };
+  if (typeof args !== "object" || args === null || Array.isArray(args)) return args;
+  return { ...args, serviceKey };
+}
+function withEscapedKeys(client, serviceKey = process.env.KODY_SERVICE_KEY) {
+  return new Proxy(client, {
+    get(target, prop, receiver) {
+      if (CALL_METHODS.includes(prop)) {
+        const method = Reflect.get(target, prop, target);
+        return async (fn, args) => {
+          const authed = injectServiceKey(args, serviceKey);
+          const result = await method.call(target, fn, authed === void 0 ? void 0 : deepEscapeKeys(authed));
+          return deepUnescapeKeys(result);
+        };
+      }
+      const value = Reflect.get(target, prop, receiver);
+      return typeof value === "function" ? value.bind(target) : value;
+    }
+  });
+}
+function createConvexClientFromEnv(env = process.env) {
+  const url = env.CONVEX_URL?.trim();
+  if (!url) return null;
+  return withEscapedKeys(new ConvexHttpClient(url), env.KODY_SERVICE_KEY);
+}
+var ESCAPE_CHAR, NEEDS_ESCAPE, CALL_METHODS;
+var init_convex_client = __esm({
+  "src/chat/convex-client.ts"() {
+    "use strict";
+    ESCAPE_CHAR = "~";
+    NEEDS_ESCAPE = /^[$_~]/;
+    CALL_METHODS = ["query", "mutation", "action"];
+  }
+});
+
+// src/state-backend.ts
+import { anyApi } from "convex/server";
+function requireTenant(tenantId) {
+  const value = tenantId.trim();
+  if (!/^[^/\s]+\/[^/\s]+$/.test(value)) throw new Error("tenantId must be an owner/repository pair");
+  return value;
+}
+function requireNonEmpty(value, name) {
+  const normalized = value.trim();
+  if (!normalized) throw new Error(`${name} must not be empty`);
+  return normalized;
+}
+function createStateBackendFromEnv(env = process.env, client) {
+  const url = env.CONVEX_URL?.trim();
+  const serviceKey = env.KODY_SERVICE_KEY?.trim();
+  if (!url || !serviceKey) throw new Error("CONVEX_URL and KODY_SERVICE_KEY are required");
+  const transport = client ?? createConvexClientFromEnv(env);
+  return {
+    async get(tenantId, taskKey, kind) {
+      const result = await transport.query(anyApi.taskState.get, {
+        tenantId: requireTenant(tenantId),
+        taskKey: requireNonEmpty(taskKey, "taskKey"),
+        kind: requireNonEmpty(kind, "kind")
+      });
+      return result ?? null;
+    },
+    async save(tenantId, taskKey, kind, doc, expectedUpdatedAt) {
+      await transport.mutation(anyApi.taskState.save, {
+        tenantId: requireTenant(tenantId),
+        taskKey: requireNonEmpty(taskKey, "taskKey"),
+        kind: requireNonEmpty(kind, "kind"),
+        doc,
+        updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        ...expectedUpdatedAt ? { expectedUpdatedAt } : {}
+      });
+    }
+  };
+}
+var init_state_backend = __esm({
+  "src/state-backend.ts"() {
+    "use strict";
+    init_convex_client();
+  }
+});
+
 // src/task-artifacts.ts
 import fs10 from "fs";
 import path12 from "path";
@@ -3804,7 +3906,29 @@ function verifyTaskArtifacts(absDir) {
 function taskArtifactStatePath(taskId, file) {
   return posixPath.join("tasks", taskId, file);
 }
-function persistTaskArtifactsToState(config, cwd, artifacts) {
+async function persistTaskArtifactsToState(config, cwd, artifacts) {
+  const tenantId = config.github?.owner && config.github.repo ? `${config.github.owner}/${config.github.repo}` : process.env.GITHUB_REPOSITORY?.trim();
+  if (process.env.CONVEX_URL && process.env.KODY_SERVICE_KEY && tenantId) {
+    const backend = createStateBackendFromEnv();
+    for (const file of TASK_ARTIFACT_FILES) {
+      const full = path12.join(artifacts.absDir, file);
+      if (!fs10.existsSync(full)) continue;
+      const stat = fs10.statSync(full);
+      if (!stat.isFile() || stat.size === 0) continue;
+      const content = fs10.readFileSync(full, "utf-8");
+      const kind = file.replace(/\.(json|md)$/, "");
+      let doc = content;
+      if (file.endsWith(".json")) {
+        try {
+          doc = JSON.parse(content);
+        } catch (err) {
+          throw new Error(`task artifact ${file} is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
+        }
+      }
+      await backend.save(tenantId, artifacts.taskId, kind, doc);
+    }
+    return;
+  }
   for (const file of TASK_ARTIFACT_FILES) {
     const full = path12.join(artifacts.absDir, file);
     if (!fs10.existsSync(full)) continue;
@@ -3883,6 +4007,7 @@ var init_task_artifacts = __esm({
   "src/task-artifacts.ts"() {
     "use strict";
     init_runtimePaths();
+    init_state_backend();
     init_stateRepo();
     TASK_ARTIFACT_FILES = ["context.json", "memory-recs.json", "followups.json", "handoff-notes.md"];
   }
@@ -5498,7 +5623,7 @@ function renderStateComment(state) {
   lines.push("</details>");
   return lines.join("\n");
 }
-function readTaskState(target, number, cwd, config) {
+function readTaskStateLegacy(target, number, cwd, config) {
   const stateConfig = taskStateConfig(cwd, config);
   const loaded = readStateText(stateConfig, cwd, taskStatePath(target, number));
   if (!loaded) return emptyState();
@@ -5512,13 +5637,34 @@ function readTaskState(target, number, cwd, config) {
   }
   return normalizeTaskState(parsed);
 }
+function backendScope(config) {
+  const tenantId = config?.github?.owner && config.github.repo ? `${config.github.owner}/${config.github.repo}` : process.env.GITHUB_REPOSITORY?.trim();
+  if (!process.env.CONVEX_URL || !process.env.KODY_SERVICE_KEY || !tenantId) return null;
+  return { tenantId };
+}
+async function readTaskState(target, number, cwd, config) {
+  const scope = backendScope(config);
+  if (!scope) return readTaskStateLegacy(target, number, cwd, config);
+  const backend = createStateBackendFromEnv();
+  const kind = "state";
+  const taskKey = `${target === "issue" ? "issues" : "prs"}/${number}`;
+  const record = await backend.get(scope.tenantId, taskKey, kind);
+  if (!record) return emptyState();
+  try {
+    return normalizeTaskState(record.doc);
+  } catch (err) {
+    throw new CorruptStateError(
+      `backend task state unparseable for ${taskKey}: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+}
 function setArtifact(state, name, artifact) {
   return {
     ...state,
     artifacts: { ...state.artifacts ?? {}, [name]: artifact }
   };
 }
-function writeTaskState(target, number, state, cwd, config) {
+function writeTaskStateLegacy(target, number, state, cwd, config) {
   const stateConfig = taskStateConfig(cwd, config);
   upsertStateText(
     stateConfig,
@@ -5529,11 +5675,21 @@ function writeTaskState(target, number, state, cwd, config) {
     `chore(tasks): update ${target} ${number} state`
   );
 }
-var STATE_BEGIN, STATE_END, HISTORY_MAX_ENTRIES, JOB_RUNS_MAX_ENTRIES, CorruptStateError;
+async function writeTaskState(target, number, state, cwd, config) {
+  const scope = backendScope(config);
+  if (!scope) {
+    writeTaskStateLegacy(target, number, state, cwd, config);
+    return;
+  }
+  const backend = createStateBackendFromEnv();
+  await backend.save(scope.tenantId, `${target === "issue" ? "issues" : "prs"}/${number}`, "state", state);
+}
+var STATE_BEGIN, STATE_END, HISTORY_MAX_ENTRIES, JOB_RUNS_MAX_ENTRIES, CorruptStateError, readTaskStateAsync;
 var init_state = __esm({
   "src/state.ts"() {
     "use strict";
     init_config();
+    init_state_backend();
     init_stateRepo();
     STATE_BEGIN = "<!-- kody:state:v1:begin -->";
     STATE_END = "<!-- kody:state:v1:end -->";
@@ -5545,6 +5701,7 @@ var init_state = __esm({
         this.name = "CorruptStateError";
       }
     };
+    readTaskStateAsync = readTaskState;
   }
 });
 
@@ -5979,7 +6136,7 @@ async function runContainerLoop(profile, ctx, input) {
     return;
   }
   const runChild = input.__runChild ?? ((name, opts) => runImplementation(name, opts));
-  const reader = input.__readTaskState ?? readTaskState;
+  const reader = input.__readTaskState ?? readTaskStateAsync;
   const issueNumber = ctx.args.issue;
   let preloadedSnapshot;
   if (profile.preloadContext) {
@@ -6029,7 +6186,7 @@ async function runContainerLoop(profile, ctx, input) {
       process.stderr.write(`[kody container] resetBetweenChildren=false; preserving tracked tree
 `);
     }
-    const priorState = readContainerState(ctx, child, reader);
+    const priorState = await readContainerState(ctx, child, reader);
     if (priorState.core?.prUrl) knownPrUrl = priorState.core.prUrl;
     const priorAction = priorState.implementations?.[child.implementation]?.lastAction;
     let actionType2;
@@ -6123,7 +6280,7 @@ async function runContainerLoop(profile, ctx, input) {
         else process.env.KODY_CONTAINER_PARENT = priorParent;
       }
       const priorAttempts = priorState.core?.attempts?.[child.implementation] ?? 0;
-      const next = readContainerState(ctx, child, reader);
+      const next = await readContainerState(ctx, child, reader);
       if (next.core?.prUrl) knownPrUrl = next.core.prUrl;
       const nextAttempts = next.core?.attempts?.[child.implementation] ?? 0;
       const nextChildAction = next.implementations?.[child.implementation]?.lastAction;
@@ -6210,20 +6367,20 @@ function resetWorkingTree(cwd) {
 `);
   }
 }
-function readContainerState(ctx, child, reader) {
+async function readContainerState(ctx, child, reader) {
   const issueNumber = ctx.args.issue;
   const cached2 = ctx.data.taskState;
   const prUrl = cached2?.core?.prUrl;
   const prNumber = prUrl ? parsePrNumber2(prUrl) : null;
   if (child.target === "pr" && prNumber) {
     try {
-      return reader("pr", prNumber, ctx.cwd);
+      return await reader("pr", prNumber, ctx.cwd);
     } catch {
     }
   }
   if (issueNumber !== void 0) {
     try {
-      return reader("issue", issueNumber, ctx.cwd);
+      return await reader("issue", issueNumber, ctx.cwd);
     } catch {
     }
   }
@@ -7381,7 +7538,7 @@ var init_saveTaskState = __esm({
       if (ctx.output.prUrl) next.core.prUrl = ctx.output.prUrl;
       if (typeof ctx.data.runUrl === "string") next.core.runUrl = ctx.data.runUrl;
       applyStandaloneFinalState(next, ctx, profile);
-      writeTaskState(target, number, next, ctx.cwd, ctx.config);
+      await writeTaskState(target, number, next, ctx.cwd, ctx.config);
       ctx.data.taskState = next;
       ctx.data.taskStateRendered = renderStateComment(next);
     };
@@ -7419,7 +7576,7 @@ var init_advanceFlow = __esm({
       const curState = state;
       let issueState;
       try {
-        issueState = readTaskState("issue", flow.issueNumber, ctx.cwd, ctx.config);
+        issueState = await readTaskState("issue", flow.issueNumber, ctx.cwd, ctx.config);
       } catch {
         issueState = curState;
       }
@@ -7435,7 +7592,7 @@ var init_advanceFlow = __esm({
       if (hops > FLOW_HOP_CAP) {
         nextIssueState.flow = void 0;
         try {
-          writeTaskState("issue", flow.issueNumber, nextIssueState, ctx.cwd, ctx.config);
+          await writeTaskState("issue", flow.issueNumber, nextIssueState, ctx.cwd, ctx.config);
         } catch (err) {
           process.stderr.write(
             `[kody advanceFlow] failed to clear looping flow on issue #${flow.issueNumber}: ${err instanceof Error ? err.message : String(err)}
@@ -7456,7 +7613,7 @@ var init_advanceFlow = __esm({
       }
       nextIssueState.flow = { ...flow, hops };
       try {
-        writeTaskState("issue", flow.issueNumber, nextIssueState, ctx.cwd, ctx.config);
+        await writeTaskState("issue", flow.issueNumber, nextIssueState, ctx.cwd, ctx.config);
       } catch (err) {
         process.stderr.write(
           `[kody advanceFlow] failed to persist hop count on issue #${flow.issueNumber}: ${err instanceof Error ? err.message : String(err)}
@@ -13168,7 +13325,7 @@ var init_dispatchClassified = __esm({
       const nextState = reduce(state, "classify", action, void 0, profile.agent, jobMetaFromData(ctx.data));
       ctx.data.taskState = nextState;
       ctx.data.taskStateRendered = renderStateComment(nextState);
-      writeTaskState("issue", issueNumber, nextState, ctx.cwd, ctx.config);
+      await writeTaskState("issue", issueNumber, nextState, ctx.cwd, ctx.config);
       const cliArgs = { issue: issueNumber };
       if (base && getProfileInputs(classification)?.some((i) => i.name === "base")) {
         cliArgs.base = base;
@@ -13681,7 +13838,7 @@ var init_finalizeTerminal = __esm({
       if (prNumber && prNumber !== issueNumber) setKodyLabel(prNumber, spec, ctx.cwd);
       if (!state) {
         try {
-          state = readTaskState(target, targetNumber, ctx.cwd, ctx.config);
+          state = await readTaskState(target, targetNumber, ctx.cwd, ctx.config);
         } catch {
           state = void 0;
         }
@@ -13700,7 +13857,7 @@ var init_finalizeTerminal = __esm({
       };
       ctx.data.taskState = next;
       try {
-        writeTaskState(target, targetNumber, next, ctx.cwd, ctx.config);
+        await writeTaskState(target, targetNumber, next, ctx.cwd, ctx.config);
       } catch (err) {
         process.stderr.write(
           `[kody finalizeTerminal] failed to write terminal state on ${target} #${targetNumber}: ${err instanceof Error ? err.message : String(err)}
@@ -13778,7 +13935,7 @@ var init_finishFlow = __esm({
         const target = ctx.data.commentTargetType ?? "issue";
         const targetNumber = ctx.data.commentTargetNumber ?? issueNumber;
         try {
-          writeTaskState(target, targetNumber, state, ctx.cwd, ctx.config);
+          await writeTaskState(target, targetNumber, state, ctx.cwd, ctx.config);
         } catch (err) {
           process.stderr.write(
             `[kody finishFlow] failed to update state mirror: ${err instanceof Error ? err.message : String(err)}
@@ -15582,7 +15739,7 @@ var init_loadTaskState = __esm({
         return;
       }
       try {
-        ctx.data.taskState = readTaskState(target, number, ctx.cwd, ctx.config);
+        ctx.data.taskState = await readTaskState(target, number, ctx.cwd, ctx.config);
       } catch (err) {
         if (err instanceof CorruptStateError) {
           process.stderr.write(
@@ -15590,7 +15747,7 @@ var init_loadTaskState = __esm({
 `
           );
           try {
-            writeTaskState(target, number, emptyState(), ctx.cwd, ctx.config);
+            await writeTaskState(target, number, emptyState(), ctx.cwd, ctx.config);
           } catch {
           }
           ctx.skipAgent = true;
@@ -15847,7 +16004,7 @@ var init_mirrorStateToPr = __esm({
       if (!prNumber) return;
       if (!state) {
         try {
-          state = readTaskState("issue", issueNumber, ctx.cwd, ctx.config);
+          state = await readTaskState("issue", issueNumber, ctx.cwd, ctx.config);
         } catch {
           return;
         }
@@ -15857,7 +16014,7 @@ var init_mirrorStateToPr = __esm({
         ctx.data.taskState = state;
       }
       try {
-        writeTaskState("pr", prNumber, state, ctx.cwd, ctx.config);
+        await writeTaskState("pr", prNumber, state, ctx.cwd, ctx.config);
       } catch (err) {
         process.stderr.write(
           `[kody mirrorStateToPr] failed to mirror state to PR #${prNumber}: ${err instanceof Error ? err.message : String(err)}
@@ -16620,7 +16777,7 @@ var init_persistFlowState = __esm({
       const issueNumber = ctx.args.issue ?? state.flow?.issueNumber;
       if (!issueNumber) return;
       try {
-        writeTaskState("issue", issueNumber, state, ctx.cwd, ctx.config);
+        await writeTaskState("issue", issueNumber, state, ctx.cwd, ctx.config);
       } catch (err) {
         process.stderr.write(
           `[kody persistFlowState] failed to write state on issue #${issueNumber}: ${err instanceof Error ? err.message : String(err)}
@@ -16740,7 +16897,7 @@ var init_planTaskJobs = __esm({
       ctx.data.plannedTaskJobIds = planned.map((job) => job.id);
       const target = ctx.data.commentTargetType;
       const number = ctx.data.commentTargetNumber;
-      if (target && number) writeTaskState(target, number, next, ctx.cwd, ctx.config);
+      if (target && number) await writeTaskState(target, number, next, ctx.cwd, ctx.config);
     };
   }
 });
@@ -21063,7 +21220,7 @@ async function runImplementation(profileName, input) {
 `);
         }
         if (!input.skipConfig && (config.state || config.github.owner && config.github.repo)) {
-          persistTaskArtifactsToState(config, input.cwd, taskArtifacts);
+          await persistTaskArtifactsToState(config, input.cwd, taskArtifacts);
         }
       } catch (err) {
         process.stderr.write(
@@ -22535,59 +22692,8 @@ function makeRunId(sessionId, suffix) {
 }
 
 // src/chat/session-store.ts
-import { anyApi } from "convex/server";
-
-// src/chat/convex-client.ts
-import { ConvexHttpClient } from "convex/browser";
-var ESCAPE_CHAR = "~";
-var NEEDS_ESCAPE = /^[$_~]/;
-function isPlainObject2(value) {
-  if (value === null || typeof value !== "object") return false;
-  const proto = Object.getPrototypeOf(value);
-  return proto === Object.prototype || proto === null;
-}
-function deepMapKeys(value, mapKey) {
-  if (Array.isArray(value)) return value.map((item) => deepMapKeys(item, mapKey));
-  if (isPlainObject2(value)) {
-    return Object.fromEntries(Object.entries(value).map(([key, item]) => [mapKey(key), deepMapKeys(item, mapKey)]));
-  }
-  return value;
-}
-function deepEscapeKeys(value) {
-  return deepMapKeys(value, (k) => NEEDS_ESCAPE.test(k) ? `${ESCAPE_CHAR}${k}` : k);
-}
-function deepUnescapeKeys(value) {
-  return deepMapKeys(value, (k) => k.startsWith(ESCAPE_CHAR) ? k.slice(1) : k);
-}
-var CALL_METHODS = ["query", "mutation", "action"];
-function injectServiceKey(args) {
-  const serviceKey = process.env.KODY_SERVICE_KEY;
-  if (!serviceKey) return args;
-  if (args === void 0) return { serviceKey };
-  if (typeof args !== "object" || args === null || Array.isArray(args)) return args;
-  return { ...args, serviceKey };
-}
-function withEscapedKeys(client) {
-  return new Proxy(client, {
-    get(target, prop, receiver) {
-      if (CALL_METHODS.includes(prop)) {
-        const method = Reflect.get(target, prop, target);
-        return async (fn, args) => {
-          const authed = injectServiceKey(args);
-          const result = await method.call(target, fn, authed === void 0 ? void 0 : deepEscapeKeys(authed));
-          return deepUnescapeKeys(result);
-        };
-      }
-      const value = Reflect.get(target, prop, receiver);
-      return typeof value === "function" ? value.bind(target) : value;
-    }
-  });
-}
-function createConvexClientFromEnv(env = process.env) {
-  const url = env.CONVEX_URL?.trim();
-  if (!url) return null;
-  return withEscapedKeys(new ConvexHttpClient(url));
-}
+init_convex_client();
+import { anyApi as anyApi2 } from "convex/server";
 
 // src/chat/session.ts
 import * as fs13 from "fs";
@@ -22710,7 +22816,7 @@ function createConvexStore(args) {
     if (!sessionUpserted) {
       try {
         const meta = readMeta(sessionFile) ?? { type: "meta", mode: "one-shot" };
-        await client.mutation(anyApi.chatSessions.upsert, {
+        await client.mutation(anyApi2.chatSessions.upsert, {
           tenantId,
           sessionId,
           meta,
@@ -22721,12 +22827,12 @@ function createConvexStore(args) {
         logger.warn(`session ${sessionId}: chatSessions.upsert failed: ${err instanceof Error ? err.message : String(err)}`);
       }
     }
-    await client.mutation(anyApi.chatTurns.append, { tenantId, sessionId, turn });
+    await client.mutation(anyApi2.chatTurns.append, { tenantId, sessionId, turn });
   };
   return {
     backend: "convex",
     readTurns: async () => {
-      const docs = await client.query(anyApi.chatTurns.list, { tenantId, sessionId });
+      const docs = await client.query(anyApi2.chatTurns.list, { tenantId, sessionId });
       const convexTurns = [...docs].sort((a, b) => a.seq - b.seq).map((doc) => doc.turn).filter(isChatTurn);
       const localTurns = readSession(sessionFile);
       if (localTurns.length <= convexTurns.length) return convexTurns;
@@ -23045,7 +23151,7 @@ async function runChatTurn(opts) {
 `
       );
     }
-    if (opts.stateConfig) persistTaskArtifactsToState(opts.stateConfig, opts.cwd, taskArtifactsPaths);
+    if (opts.stateConfig) await persistTaskArtifactsToState(opts.stateConfig, opts.cwd, taskArtifactsPaths);
   } catch (err) {
     process.stderr.write(
       `[task-artifacts] chat session ${taskArtifactsPaths.taskId} persist failed: ${err instanceof Error ? err.message : String(err)}

package/package.json

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