@kody-ade/kody-engine 0.4.402 → 0.4.403

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.402",
+      version: "0.4.403",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -21590,8 +21590,8 @@ init_agents();
 init_config();
 init_registry();
 init_task_artifacts();
-import * as fs15 from "fs";
-import * as path16 from "path";
+import * as fs14 from "fs";
+import * as path15 from "path";
 
 // src/chat/attachments.ts
 init_runtimePaths();
@@ -21999,163 +21999,69 @@ function makeRunId(sessionId, suffix) {
 // src/chat/session-store.ts
 init_convex_client();
 import { anyApi as anyApi2 } from "convex/server";
-
-// src/chat/session.ts
-import * as fs14 from "fs";
-import * as path15 from "path";
-import posixPath3 from "path/posix";
-function sessionFilePath(cwd, sessionId) {
-  return path15.join(cwd, ".kody-engine", "runtime", "sessions", `${sessionId}.jsonl`);
-}
-function readMeta(file) {
-  if (!fs14.existsSync(file)) return null;
-  const raw = fs14.readFileSync(file, "utf-8");
-  const firstLine2 = raw.split("\n", 1)[0]?.trim();
-  if (!firstLine2) return null;
-  try {
-    const parsed = JSON.parse(firstLine2);
-    if (parsed.type !== "meta") return null;
-    if (parsed.mode !== "one-shot" && parsed.mode !== "interactive") return null;
-    return parsed;
-  } catch {
-    return null;
-  }
-}
-function readSession(file) {
-  if (!fs14.existsSync(file)) return [];
-  const raw = fs14.readFileSync(file, "utf-8").trim();
-  if (!raw) return [];
-  const turns = [];
-  for (const line of raw.split("\n")) {
-    if (!line.trim()) continue;
-    try {
-      const parsed = JSON.parse(line);
-      if (parsed.role !== "user" && parsed.role !== "assistant") continue;
-      if (typeof parsed.content !== "string") continue;
-      turns.push(parsed);
-    } catch {
-    }
-  }
-  return turns;
-}
-function appendTurn(file, turn) {
-  fs14.mkdirSync(path15.dirname(file), { recursive: true });
-  const line = JSON.stringify({
-    role: turn.role,
-    content: turn.content,
-    timestamp: turn.timestamp,
-    toolCalls: turn.toolCalls ?? []
-  });
-  fs14.appendFileSync(file, `${line}
-`);
-}
-function seedInitialMessage(file, message) {
-  if (!message.trim()) return false;
-  const turns = readSession(file);
-  const lastUser = [...turns].reverse().find((t) => t.role === "user");
-  if (lastUser && lastUser.content === message) return false;
-  appendTurn(file, {
-    role: "user",
-    content: message,
-    timestamp: (/* @__PURE__ */ new Date()).toISOString()
-  });
-  return true;
+function currentEpochTurns(result) {
+  const ordered = [...result.entries].sort((left, right) => left.seq - right.seq);
+  const lastHandoffSeq = ordered.filter((item) => item.entry.kind === "agent-handoff").at(-1)?.seq ?? -1;
+  return ordered.flatMap(
+    (item) => item.seq > lastHandoffSeq && item.entry.kind === "message" && (item.entry.status === "committed" || item.entry.status === "pending") ? [
+      {
+        role: item.entry.role,
+        content: item.entry.content,
+        timestamp: item.entry.createdAt,
+        toolCalls: []
+      }
+    ] : []
+  );
 }
-
-// src/chat/session-store.ts
-function isChatTurn(value) {
-  if (!value || typeof value !== "object") return false;
-  const t = value;
-  return (t.role === "user" || t.role === "assistant") && typeof t.content === "string";
+function entryKey(sessionId, turn) {
+  const safeTime = turn.timestamp.replace(/[^a-zA-Z0-9._-]/g, "-");
+  return `engine-${sessionId}-${turn.role}-${safeTime}`;
 }
 function createSessionStore(opts) {
   const logger = opts.logger ?? {
-    info: (m) => process.stdout.write(`[kody:chat:store] ${m}
+    info: (message) => process.stdout.write(`[kody:chat:store] ${message}
 `),
-    warn: (m) => process.stderr.write(`[kody:chat:store] ${m}
+    warn: (message) => process.stderr.write(`[kody:chat:store] ${message}
 `)
   };
   const client = opts.client !== void 0 ? opts.client : createConvexClientFromEnv();
   const tenantId2 = opts.tenantId ?? process.env.GITHUB_REPOSITORY ?? "";
-  if (client && tenantId2) {
-    logger.info(`session ${opts.sessionId}: using Convex transcript store (tenant ${tenantId2})`);
-    return createConvexStore({
-      client,
+  if (!client || !tenantId2) {
+    throw new Error(
+      "Canonical Convex conversation storage is required (CONVEX_URL, KODY_SERVICE_KEY, and GITHUB_REPOSITORY)"
+    );
+  }
+  logger.info(`conversation ${opts.sessionId}: using canonical Convex store (tenant ${tenantId2})`);
+  const read = async () => {
+    const result = await client.query(anyApi2.conversations.get, {
       tenantId: tenantId2,
-      sessionId: opts.sessionId,
-      sessionFile: opts.sessionFile,
-      logger
+      conversationId: opts.sessionId
     });
-  }
-  if (client && !tenantId2) {
-    if (process.env.GITHUB_ACTIONS === "true") {
-      throw new Error("Convex chat backend requires GITHUB_REPOSITORY in GitHub Actions");
-    }
-    logger.warn(`session ${opts.sessionId}: Convex configured without a tenant; using local runtime storage`);
-  } else {
-    if (process.env.GITHUB_ACTIONS === "true") {
-      throw new Error("Convex chat backend is required in GitHub Actions (CONVEX_URL and KODY_SERVICE_KEY)");
-    }
-    logger.info(`session ${opts.sessionId}: backend unavailable; using local runtime storage`);
-  }
-  return createLocalStore(opts.sessionFile);
-}
-function createLocalStore(sessionFile) {
-  return {
-    backend: "local",
-    readTurns: async () => readSession(sessionFile),
-    appendTurn: async (turn) => {
-      appendTurn(sessionFile, turn);
-    }
-  };
-}
-function normalizeTurn(turn) {
-  return {
-    role: turn.role,
-    content: turn.content,
-    timestamp: turn.timestamp,
-    toolCalls: turn.toolCalls ?? []
-  };
-}
-function createConvexStore(args) {
-  const { client, tenantId: tenantId2, sessionId, sessionFile, logger } = args;
-  let sessionUpserted = false;
-  const appendToConvex = async (turn) => {
-    if (!sessionUpserted) {
-      try {
-        const meta = readMeta(sessionFile) ?? { type: "meta", mode: "one-shot" };
-        await client.mutation(anyApi2.chatSessions.upsert, {
-          tenantId: tenantId2,
-          sessionId,
-          meta,
-          updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-        });
-        sessionUpserted = true;
-      } catch (err) {
-        logger.warn(
-          `session ${sessionId}: chatSessions.upsert failed: ${err instanceof Error ? err.message : String(err)}`
-        );
-      }
-    }
-    await client.mutation(anyApi2.chatTurns.append, { tenantId: tenantId2, sessionId, turn });
+    if (!result) throw new Error(`Conversation not found: ${opts.sessionId}`);
+    return result;
   };
   return {
     backend: "convex",
-    readTurns: async () => {
-      const docs = await client.query(anyApi2.chatTurns.list, { tenantId: tenantId2, sessionId });
-      const convexTurns = [...docs].sort((a, b) => a.seq - b.seq).map((doc) => doc.turn).filter(isChatTurn);
-      if (convexTurns.length > 0) return convexTurns;
-      const tail = readSession(sessionFile).map(normalizeTurn);
-      if (tail.length === 0) return convexTurns;
-      logger.info(`session ${sessionId}: importing ${tail.length} runtime turn(s) into Convex`);
-      for (const turn of tail) {
-        await appendToConvex(turn);
-      }
-      return tail;
-    },
+    readActiveAgent: async () => (await read()).conversation.activeAgent,
+    readTurns: async () => currentEpochTurns(await read()),
     appendTurn: async (turn) => {
-      const normalized = normalizeTurn(turn);
-      await appendToConvex(normalized);
+      const result = await read();
+      const id = entryKey(opts.sessionId, turn);
+      await client.mutation(anyApi2.conversations.appendEntry, {
+        tenantId: tenantId2,
+        conversationId: opts.sessionId,
+        entryId: id,
+        idempotencyKey: id,
+        entry: {
+          kind: "message",
+          role: turn.role,
+          author: turn.role === "assistant" ? { kind: "agent", ...result.conversation.activeAgent } : { kind: "user", actorId: "engine-runtime" },
+          content: turn.content,
+          status: "committed",
+          turnId: id,
+          createdAt: turn.timestamp
+        }
+      });
     }
   };
 }
@@ -22279,7 +22185,7 @@ function buildImplementationCatalog() {
   const entries = [];
   for (const { name, profilePath } of discovered) {
     try {
-      const raw = JSON.parse(fs15.readFileSync(profilePath, "utf-8"));
+      const raw = JSON.parse(fs14.readFileSync(profilePath, "utf-8"));
       const describe = typeof raw.describe === "string" ? raw.describe : "";
       const firstSentence = describe.split(/(?<=[.!?])\s+/, 1)[0] ?? "";
       entries.push({ name, describe: firstSentence.trim() });
@@ -22320,7 +22226,8 @@ async function runChatTurn(opts) {
   }
   const { turns: promptTurns, imagePaths } = prepareAttachments(turns, opts.cwd, opts.sessionId);
   const basePrompt = opts.systemPrompt ?? readSystemPromptOverride(opts.cwd) ?? (opts.model.protocol === "openai" ? OPENAI_CHAT_SYSTEM_PROMPT : CHAT_SYSTEM_PROMPT);
-  const agentIdentityBlock = readAgentIdentityBlock(opts.cwd, opts.agentIdentity);
+  const activeAgent = await store.readActiveAgent();
+  const agentIdentityBlock = readAgentIdentityBlock(opts.cwd, opts.agentIdentity ?? { slug: activeAgent.slug });
   const catalog = buildImplementationCatalog();
   const taskArtifactsPaths = {
     ...prepareTaskArtifactsDir(opts.cwd, opts.sessionId),
@@ -22386,7 +22293,7 @@ async function runChatTurn(opts) {
     quiet: opts.quiet,
     additionalDirectories: [
       taskArtifactsPaths.absDir,
-      ...Array.from(new Set(imagePaths.map((p2) => path16.dirname(p2))))
+      ...Array.from(new Set(imagePaths.map((p2) => path15.dirname(p2))))
     ],
     systemPromptAppend: systemPrompt,
     ...opts.reasoningEffort ? { reasoningEffort: opts.reasoningEffort } : {},
@@ -22569,10 +22476,10 @@ async function emit(sink, type, sessionId, suffix, payload) {
 var MEMORY_INDEX_REL = ".kody-engine/runtime/memory/INDEX.md";
 var MAX_INDEX_BYTES = 8e3;
 function readMemoryIndexBlock(cwd) {
-  const indexPath = path16.join(cwd, MEMORY_INDEX_REL);
+  const indexPath = path15.join(cwd, MEMORY_INDEX_REL);
   let raw;
   try {
-    raw = fs15.readFileSync(indexPath, "utf-8");
+    raw = fs14.readFileSync(indexPath, "utf-8");
   } catch {
     return "";
   }
@@ -22592,17 +22499,17 @@ _\u2026 (memory index truncated; use recall_search to read more)_` : trimmed;
 var CONTEXT_DIR_REL = ".kody-engine/runtime/context";
 var MAX_CONTEXT_BYTES = 12e3;
 function readContextBlock(cwd) {
-  const dir = path16.join(cwd, CONTEXT_DIR_REL);
+  const dir = path15.join(cwd, CONTEXT_DIR_REL);
   let files;
   try {
-    files = fs15.readdirSync(dir).filter((f) => f.endsWith(".md")).sort();
+    files = fs14.readdirSync(dir).filter((f) => f.endsWith(".md")).sort();
   } catch {
     return "";
   }
   const sections = [];
   for (const file of files) {
     try {
-      const content = fs15.readFileSync(path16.join(dir, file), "utf-8").trim();
+      const content = fs14.readFileSync(path15.join(dir, file), "utf-8").trim();
       if (content) sections.push(`### ${file.replace(/\.md$/, "")}
 
 ${content}`);
@@ -22628,7 +22535,7 @@ var SYSTEM_PROMPT_OVERRIDE_REL = ".kody-engine/runtime/system-prompt.md";
 function readSystemPromptOverride(cwd) {
   let raw;
   try {
-    raw = fs15.readFileSync(path16.join(cwd, SYSTEM_PROMPT_OVERRIDE_REL), "utf-8");
+    raw = fs14.readFileSync(path15.join(cwd, SYSTEM_PROMPT_OVERRIDE_REL), "utf-8");
   } catch {
     return null;
   }
@@ -22636,10 +22543,10 @@ function readSystemPromptOverride(cwd) {
   return trimmed.length > 0 ? trimmed : null;
 }
 function readInstructionsBlock(cwd) {
-  const instructionsPath = path16.join(cwd, INSTRUCTIONS_REL);
+  const instructionsPath = path15.join(cwd, INSTRUCTIONS_REL);
   let raw;
   try {
-    raw = fs15.readFileSync(instructionsPath, "utf-8");
+    raw = fs14.readFileSync(instructionsPath, "utf-8");
   } catch {
     return "";
   }
@@ -22672,6 +22579,68 @@ function resolveBrainDriver(runtime) {
   return driver;
 }
 
+// src/chat/session.ts
+import * as fs15 from "fs";
+import * as path16 from "path";
+import posixPath3 from "path/posix";
+function sessionFilePath(cwd, sessionId) {
+  return path16.join(cwd, ".kody-engine", "runtime", "sessions", `${sessionId}.jsonl`);
+}
+function readMeta(file) {
+  if (!fs15.existsSync(file)) return null;
+  const raw = fs15.readFileSync(file, "utf-8");
+  const firstLine2 = raw.split("\n", 1)[0]?.trim();
+  if (!firstLine2) return null;
+  try {
+    const parsed = JSON.parse(firstLine2);
+    if (parsed.type !== "meta") return null;
+    if (parsed.mode !== "one-shot" && parsed.mode !== "interactive") return null;
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function readSession(file) {
+  if (!fs15.existsSync(file)) return [];
+  const raw = fs15.readFileSync(file, "utf-8").trim();
+  if (!raw) return [];
+  const turns = [];
+  for (const line of raw.split("\n")) {
+    if (!line.trim()) continue;
+    try {
+      const parsed = JSON.parse(line);
+      if (parsed.role !== "user" && parsed.role !== "assistant") continue;
+      if (typeof parsed.content !== "string") continue;
+      turns.push(parsed);
+    } catch {
+    }
+  }
+  return turns;
+}
+function appendTurn(file, turn) {
+  fs15.mkdirSync(path16.dirname(file), { recursive: true });
+  const line = JSON.stringify({
+    role: turn.role,
+    content: turn.content,
+    timestamp: turn.timestamp,
+    toolCalls: turn.toolCalls ?? []
+  });
+  fs15.appendFileSync(file, `${line}
+`);
+}
+function seedInitialMessage(file, message) {
+  if (!message.trim()) return false;
+  const turns = readSession(file);
+  const lastUser = [...turns].reverse().find((t) => t.role === "user");
+  if (lastUser && lastUser.content === message) return false;
+  appendTurn(file, {
+    role: "user",
+    content: message,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  return true;
+}
+
 // src/servers/brain-serve.ts
 init_config();
 
@@ -24436,7 +24405,7 @@ async function handleChatTurn(req, res, chatId, opts) {
   }
   const stateToken = repoToken || envGithubToken();
   const sessionFile = sessionFilePath(agentCwd, chatId);
-  const sessionStore = createSessionStore({
+  const sessionStore = opts.createStore({
     sessionId: chatId,
     sessionFile,
     ...repo ? { tenantId: repo } : {}
@@ -24491,6 +24460,7 @@ async function handleChatTurn(req, res, chatId, opts) {
 }
 function buildServer(opts) {
   const runTurn = opts.runTurn ?? runChatTurn;
+  const createStore = opts.createStore ?? createSessionStore;
   const cloneRepo = opts.cloneRepo ?? defaultCloneRepo;
   const reposRoot = opts.reposRoot ?? path48.join(path48.dirname(path48.resolve(opts.cwd)), "repos");
   return createServer2(async (req, res) => {
@@ -24521,6 +24491,7 @@ function buildServer(opts) {
         model: opts.model,
         litellmUrl: opts.litellmUrl,
         runTurn,
+        createStore,
         driver: opts.driver
       });
       return;

package/package.json

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