@kody-ade/kody-engine 0.4.402 → 0.4.404

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.404",
       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,70 @@ 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;
-    },
+    readMode: async () => (await read()).conversation.runtime?.kind === "live" ? "interactive" : "one-shot",
+    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 +22186,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 +22227,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 +22294,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 +22477,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 +22500,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 +22536,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 +22544,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 +22580,31 @@ 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 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;
+}
+
 // src/servers/brain-serve.ts
 init_config();
 
@@ -24436,7 +24369,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 +24424,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 +24455,7 @@ function buildServer(opts) {
         model: opts.model,
         litellmUrl: opts.litellmUrl,
         runTurn,
+        createStore,
         driver: opts.driver
       });
       return;
@@ -25095,7 +25030,6 @@ async function loadConfigSafe() {
 }
 
 // src/chat-cli.ts
-import * as fs49 from "fs";
 import * as path49 from "path";
 
 // src/chat/inbox.ts
@@ -25425,15 +25359,27 @@ ${CHAT_HELP}`);
   process.stdout.write(`\u2192 kody:chat: litellm proxy ready (url=${litellm?.url ?? "skipped"})
 `);
   const sessionFile = sessionFilePath(cwd, sessionId);
-  if (args.initMessage) seedInitialMessage(sessionFile, args.initMessage);
+  const store = createSessionStore({ sessionId, sessionFile });
+  if (args.initMessage) {
+    await store.appendTurn({
+      role: "user",
+      content: args.initMessage,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  }
   const sink = buildSink(cwd, sessionId, args.dashboardUrl);
-  const meta = readMeta(sessionFile);
-  process.stdout.write(
-    `\u2192 kody:chat: session file=${sessionFile} exists=${fs49.existsSync(sessionFile)} meta=${meta ? meta.mode : "none"}
-`
-  );
+  const mode = await store.readMode();
+  const meta = {
+    type: "meta",
+    mode,
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    ...process.env.KODY_IDLE_EXIT_MS ? { idleExitMs: Number(process.env.KODY_IDLE_EXIT_MS) } : {},
+    ...process.env.KODY_HARD_CAP_MS ? { hardCapMs: Number(process.env.KODY_HARD_CAP_MS) } : {}
+  };
+  process.stdout.write(`\u2192 kody:chat: canonical conversation mode=${mode}
+`);
   try {
-    if (meta?.mode === "interactive") {
+    if (mode === "interactive") {
       const result2 = await runInteractiveMode({
         sessionId,
         cwd,
@@ -25444,6 +25390,7 @@ ${CHAT_HELP}`);
         verbose: args.verbose,
         quiet: args.quiet,
         config,
+        store,
         ...reasoningEffort ? { reasoningEffort } : {}
       });
       return result2.exitCode;
@@ -25458,6 +25405,7 @@ ${CHAT_HELP}`);
       verbose: args.verbose,
       quiet: args.quiet,
       config,
+      store,
       ...reasoningEffort ? { reasoningEffort } : {}
     });
     return result.exitCode;
@@ -25475,7 +25423,7 @@ init_config();
 // src/definition-hydration.ts
 init_state_backend();
 import { createHash as createHash5 } from "crypto";
-import * as fs50 from "fs";
+import * as fs49 from "fs";
 import * as path50 from "path";
 var SLUG_RE2 = /^[a-z0-9][a-z0-9_-]{0,63}$/;
 function assertSafeDefinitionPath(filePath) {
@@ -25510,32 +25458,32 @@ function writeDefinition(root, kind, definition) {
   if (kind === "agent") {
     const raw = bundle.files["agent.md"];
     if (typeof raw !== "string") throw new Error(`agent definition ${definition.slug} is missing agent.md`);
-    fs50.writeFileSync(path50.join(root, "agents", `${definition.slug}.md`), raw, "utf8");
+    fs49.writeFileSync(path50.join(root, "agents", `${definition.slug}.md`), raw, "utf8");
     return;
   }
   if (kind === "goal") {
     const goalRoot = path50.join(root, "goals", definition.slug);
     for (const [filePath, contents] of Object.entries(bundle.files)) {
       const target = path50.join(goalRoot, filePath);
-      fs50.mkdirSync(path50.dirname(target), { recursive: true });
-      fs50.writeFileSync(target, contents, "utf8");
+      fs49.mkdirSync(path50.dirname(target), { recursive: true });
+      fs49.writeFileSync(target, contents, "utf8");
     }
     return;
   }
   const capabilityRoot = path50.join(root, "capabilities", definition.slug);
   for (const [filePath, contents] of Object.entries(bundle.files)) {
     const target = path50.join(capabilityRoot, filePath);
-    fs50.mkdirSync(path50.dirname(target), { recursive: true });
-    fs50.writeFileSync(target, contents, "utf8");
+    fs49.mkdirSync(path50.dirname(target), { recursive: true });
+    fs49.writeFileSync(target, contents, "utf8");
   }
 }
 async function hydrateDefinitions(options) {
   const root = path50.join(options.cwd, ".kody-engine", "definitions");
   const staging = `${root}.tmp-${process.pid}-${Date.now()}`;
-  fs50.rmSync(staging, { recursive: true, force: true });
-  fs50.mkdirSync(path50.join(staging, "agents"), { recursive: true });
-  fs50.mkdirSync(path50.join(staging, "capabilities"), { recursive: true });
-  fs50.mkdirSync(path50.join(staging, "goals"), { recursive: true });
+  fs49.rmSync(staging, { recursive: true, force: true });
+  fs49.mkdirSync(path50.join(staging, "agents"), { recursive: true });
+  fs49.mkdirSync(path50.join(staging, "capabilities"), { recursive: true });
+  fs49.mkdirSync(path50.join(staging, "goals"), { recursive: true });
   try {
     const [capabilities, agents, goals] = await Promise.all([
       options.backend.listDefinitions(options.tenantId, "capability"),
@@ -25561,13 +25509,13 @@ async function hydrateDefinitions(options) {
       hydratedAt: (/* @__PURE__ */ new Date()).toISOString(),
       versions: Object.fromEntries(Object.entries(versions).sort(([left], [right]) => left.localeCompare(right)))
     };
-    fs50.writeFileSync(path50.join(staging, "manifest.json"), `${JSON.stringify(manifest, null, 2)}
+    fs49.writeFileSync(path50.join(staging, "manifest.json"), `${JSON.stringify(manifest, null, 2)}
 `, "utf8");
-    fs50.rmSync(root, { recursive: true, force: true });
-    fs50.renameSync(staging, root);
+    fs49.rmSync(root, { recursive: true, force: true });
+    fs49.renameSync(staging, root);
     return { root, tenantId: options.tenantId, versions: manifest.versions };
   } catch (error) {
-    fs50.rmSync(staging, { recursive: true, force: true });
+    fs49.rmSync(staging, { recursive: true, force: true });
     throw error;
   }
 }
@@ -26426,7 +26374,7 @@ async function poolServe() {
 
 // src/servers/runner-serve.ts
 import { spawn as spawn9 } from "child_process";
-import * as fs51 from "fs";
+import * as fs50 from "fs";
 import { createServer as createServer6 } from "http";
 var DEFAULT_PORT2 = 8080;
 var DEFAULT_WORKDIR = "/workspace/repo";
@@ -26561,8 +26509,8 @@ async function defaultRunJob(job) {
   const workdir = process.env.RUNNER_WORKDIR ?? DEFAULT_WORKDIR;
   const branch = job.ref ?? "main";
   const authUrl = `https://x-access-token:${job.githubToken}@github.com/${job.repo}.git`;
-  fs51.rmSync(workdir, { recursive: true, force: true });
-  fs51.mkdirSync(workdir, { recursive: true });
+  fs50.rmSync(workdir, { recursive: true, force: true });
+  fs50.mkdirSync(workdir, { recursive: true });
   const allSecrets = typeof job.allSecrets === "string" ? job.allSecrets : JSON.stringify(job.allSecrets ?? {});
   const target = job.runRequest.target;
   const interactive = target.type === "chat";

package/package.json

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