npm - kanna-code - Versions diffs - 0.18.0 → 0.19.0 - Mend

kanna-code 0.18.0 → 0.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (30) hide show

package/dist/client/assets/index-C952_xJD.css +32 -0
package/dist/client/assets/index-lgfU0zw2.js +606 -0
package/dist/client/chat-sounds/Blow.mp3 +0 -0
package/dist/client/chat-sounds/Bottle.mp3 +0 -0
package/dist/client/chat-sounds/Frog.mp3 +0 -0
package/dist/client/chat-sounds/Funk.mp3 +0 -0
package/dist/client/chat-sounds/Glass.mp3 +0 -0
package/dist/client/chat-sounds/Ping.mp3 +0 -0
package/dist/client/chat-sounds/Pop.mp3 +0 -0
package/dist/client/chat-sounds/Purr.mp3 +0 -0
package/dist/client/chat-sounds/Tink.mp3 +0 -0
package/dist/client/index.html +2 -2
package/package.json +1 -1
package/src/server/agent.test.ts +89 -2
package/src/server/agent.ts +31 -12
package/src/server/event-store.test.ts +65 -0
package/src/server/event-store.ts +27 -1
package/src/server/events.ts +8 -0
package/src/server/generate-title.ts +42 -2
package/src/server/quick-response.test.ts +126 -3
package/src/server/quick-response.ts +107 -14
package/src/server/read-models.test.ts +4 -0
package/src/server/read-models.ts +1 -0
package/src/server/title-generation.live.test.ts +44 -0
package/src/server/ws-router.test.ts +181 -0
package/src/server/ws-router.ts +18 -0
package/src/shared/protocol.ts +1 -0
package/src/shared/types.ts +1 -0
package/dist/client/assets/index-BvhI1JYs.css +0 -32
package/dist/client/assets/index-CLqK0AWC.js +0 -606

package/dist/client/chat-sounds/Blow.mp3 ADDED Viewed

Binary file

package/dist/client/chat-sounds/Bottle.mp3 ADDED Viewed

Binary file

package/dist/client/chat-sounds/Frog.mp3 ADDED Viewed

Binary file

package/dist/client/chat-sounds/Funk.mp3 ADDED Viewed

Binary file

package/dist/client/chat-sounds/Glass.mp3 ADDED Viewed

Binary file

package/dist/client/chat-sounds/Ping.mp3 ADDED Viewed

Binary file

package/dist/client/chat-sounds/Pop.mp3 ADDED Viewed

Binary file

package/dist/client/chat-sounds/Purr.mp3 ADDED Viewed

Binary file

package/dist/client/chat-sounds/Tink.mp3 ADDED Viewed

Binary file

package/dist/client/index.html CHANGED Viewed

@@ -5,8 +5,8 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <link rel="icon" type="image/png" href="/favicon.png" />
     <title>Kanna</title>
-    <script type="module" crossorigin src="/assets/index-CLqK0AWC.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-BvhI1JYs.css">
+    <script type="module" crossorigin src="/assets/index-lgfU0zw2.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-C952_xJD.css">
   </head>
   <body>
     <div id="root"></div>

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "kanna-code",
   "type": "module",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "A beautiful web UI for Claude Code",
   "license": "MIT",
   "keywords": [

package/src/server/agent.test.ts CHANGED Viewed

@@ -127,6 +127,10 @@ describe("attachment prompt helpers", () => {
 describe("AgentCoordinator codex integration", () => {
   test("generates a chat title in the background on the first user message", async () => {
+    let releaseTitle!: () => void
+    const titleGate = new Promise<void>((resolve) => {
+      releaseTitle = resolve
+    })
     const fakeCodexManager = {
       async startSession() {},
       async startTurn(): Promise<HarnessTurn> {
@@ -169,7 +173,14 @@ describe("AgentCoordinator codex integration", () => {
       store: store as never,
       onStateChange: () => {},
       codexManager: fakeCodexManager as never,
-      generateTitle: async () => "Generated title",
+      generateTitle: async () => {
+        await titleGate
+        return {
+          title: "Generated title",
+          usedFallback: false,
+          failureMessage: null,
+        }
+      },
     })
     await coordinator.send({
@@ -180,6 +191,8 @@ describe("AgentCoordinator codex integration", () => {
       model: "gpt-5.4",
     })
+    expect(store.chat.title).toBe("first message")
+    releaseTitle()
     await waitFor(() => store.chat.title === "Generated title")
     expect(store.messages[0]?.kind).toBe("user_prompt")
   })
@@ -233,7 +246,11 @@ describe("AgentCoordinator codex integration", () => {
       codexManager: fakeCodexManager as never,
       generateTitle: async () => {
         await titleGate
-        return "Generated title"
+        return {
+          title: "Generated title",
+          usedFallback: false,
+          failureMessage: null,
+        }
       },
     })
@@ -252,6 +269,76 @@ describe("AgentCoordinator codex integration", () => {
     expect(store.chat.title).toBe("Manual title")
   })
+  test("reports provider failure without a second rename after the optimistic title", async () => {
+    const fakeCodexManager = {
+      async startSession() {},
+      async startTurn(): Promise<HarnessTurn> {
+        async function* stream() {
+          yield {
+            type: "transcript" as const,
+            entry: timestamped({
+              kind: "system_init",
+              provider: "codex",
+              model: "gpt-5.4",
+              tools: [],
+              agents: [],
+              slashCommands: [],
+              mcpServers: [],
+            }),
+          }
+          yield {
+            type: "transcript" as const,
+            entry: timestamped({
+              kind: "result",
+              subtype: "success",
+              isError: false,
+              durationMs: 0,
+              result: "",
+            }),
+          }
+        }
+        return {
+          provider: "codex",
+          stream: stream(),
+          interrupt: async () => {},
+          close: () => {},
+        }
+      },
+    }
+    const store = createFakeStore()
+    const backgroundErrors: string[] = []
+    const coordinator = new AgentCoordinator({
+      store: store as never,
+      onStateChange: () => {},
+      codexManager: fakeCodexManager as never,
+      generateTitle: async () => ({
+        title: "first message",
+        usedFallback: true,
+        failureMessage: "claude failed conversation title generation: Not authenticated",
+      }),
+    })
+    coordinator.setBackgroundErrorReporter((message) => {
+      backgroundErrors.push(message)
+    })
+    await coordinator.send({
+      type: "chat.send",
+      chatId: "chat-1",
+      provider: "codex",
+      content: "first message",
+      model: "gpt-5.4",
+    })
+    expect(store.chat.title).toBe("first message")
+    await waitFor(() => store.turnFinishedCount === 1)
+    expect(store.chat.title).toBe("first message")
+    expect(backgroundErrors).toEqual([
+      "[title-generation] chat chat-1 failed provider title generation: claude failed conversation title generation: Not authenticated",
+    ])
+  })
   test("binds codex provider and reuses the session token on later turns", async () => {
     const sessionCalls: Array<{ chatId: string; sessionToken: string | null }> = []
     const fakeCodexManager = {

package/src/server/agent.ts CHANGED Viewed

@@ -11,7 +11,7 @@ import { normalizeToolCall } from "../shared/tools"
 import type { ClientCommand } from "../shared/protocol"
 import { EventStore } from "./event-store"
 import { CodexAppServerManager } from "./codex-app-server"
-import { generateTitleForChat } from "./generate-title"
+import { type GenerateChatTitleResult, generateTitleForChatDetailed } from "./generate-title"
 import type { HarnessEvent, HarnessToolRequest, HarnessTurn } from "./harness-types"
 import {
   codexServiceTierFromModelOptions,
@@ -21,6 +21,7 @@ import {
   normalizeServerModel,
 } from "./provider-catalog"
 import { resolveClaudeApiModelId } from "../shared/types"
+import { fallbackTitleFromMessage } from "./generate-title"
 const CLAUDE_TOOLSET = [
   "Skill",
@@ -67,7 +68,7 @@ interface AgentCoordinatorArgs {
   store: EventStore
   onStateChange: () => void
   codexManager?: CodexAppServerManager
-  generateTitle?: (messageContent: string, cwd: string) => Promise<string | null>
+  generateTitle?: (messageContent: string, cwd: string) => Promise<GenerateChatTitleResult>
 }
 function timestamped<T extends Omit<TranscriptEntry, "_id" | "createdAt">>(
@@ -370,14 +371,19 @@ export class AgentCoordinator {
   private readonly store: EventStore
   private readonly onStateChange: () => void
   private readonly codexManager: CodexAppServerManager
-  private readonly generateTitle: (messageContent: string, cwd: string) => Promise<string | null>
+  private readonly generateTitle: (messageContent: string, cwd: string) => Promise<GenerateChatTitleResult>
+  private reportBackgroundError: ((message: string) => void) | null = null
   readonly activeTurns = new Map<string, ActiveTurn>()
   constructor(args: AgentCoordinatorArgs) {
     this.store = args.store
     this.onStateChange = args.onStateChange
     this.codexManager = args.codexManager ?? new CodexAppServerManager()
-    this.generateTitle = args.generateTitle ?? generateTitleForChat
+    this.generateTitle = args.generateTitle ?? generateTitleForChatDetailed
+  }
+  setBackgroundErrorReporter(report: ((message: string) => void) | null) {
+    this.reportBackgroundError = report
   }
   getActiveStatuses() {
@@ -444,6 +450,11 @@ export class AgentCoordinator {
     const existingMessages = this.store.getMessages(args.chatId)
     const shouldGenerateTitle = args.appendUserPrompt && chat.title === "New Chat" && existingMessages.length === 0
+    const optimisticTitle = shouldGenerateTitle ? fallbackTitleFromMessage(args.content) : null
+    if (optimisticTitle) {
+      await this.store.renameChat(args.chatId, optimisticTitle)
+    }
     if (args.appendUserPrompt) {
       await this.store.appendMessage(
@@ -459,7 +470,7 @@ export class AgentCoordinator {
     }
     if (shouldGenerateTitle) {
-      void this.generateTitleInBackground(args.chatId, args.content, project.localPath)
+      void this.generateTitleInBackground(args.chatId, args.content, project.localPath, optimisticTitle ?? "New Chat")
     }
     const onToolRequest = async (request: HarnessToolRequest): Promise<unknown> => {
@@ -570,18 +581,26 @@ export class AgentCoordinator {
     return { chatId }
   }
-  private async generateTitleInBackground(chatId: string, messageContent: string, cwd: string) {
+  private async generateTitleInBackground(chatId: string, messageContent: string, cwd: string, expectedCurrentTitle: string) {
     try {
-      const title = await this.generateTitle(messageContent, cwd)
-      if (!title) return
+      const result = await this.generateTitle(messageContent, cwd)
+      if (result.failureMessage) {
+        this.reportBackgroundError?.(
+          `[title-generation] chat ${chatId} failed provider title generation: ${result.failureMessage}`
+        )
+      }
+      if (!result.title || result.usedFallback) return
       const chat = this.store.requireChat(chatId)
-      if (chat.title !== "New Chat") return
+      if (chat.title !== expectedCurrentTitle) return
-      await this.store.renameChat(chatId, title)
+      await this.store.renameChat(chatId, result.title)
       this.onStateChange()
-    } catch {
-      // Ignore background title generation failures.
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error)
+      this.reportBackgroundError?.(
+        `[title-generation] chat ${chatId} failed background title generation: ${message}`
+      )
     }
   }

package/src/server/event-store.test.ts CHANGED Viewed

@@ -65,6 +65,7 @@ describe("EventStore", () => {
         title: "Chat",
         createdAt: 1,
         updatedAt: 5,
+        unread: false,
         provider: null,
         planMode: false,
         sessionToken: null,
@@ -130,4 +131,68 @@ describe("EventStore", () => {
     expect(snapshot.messages).toBeUndefined()
     expect(existsSync(join(dataDir, "transcripts", `${chat.id}.jsonl`))).toBe(true)
   })
+  test("marks chats unread on completed turns and clears unread when marked read", async () => {
+    const dataDir = await createTempDataDir()
+    const store = new EventStore(dataDir)
+    await store.initialize()
+    const project = await store.openProject("/tmp/project")
+    const chat = await store.createChat(project.id)
+    expect(store.getChat(chat.id)?.unread).toBe(false)
+    await store.recordTurnFinished(chat.id)
+    expect(store.getChat(chat.id)?.unread).toBe(true)
+    await store.setChatReadState(chat.id, false)
+    expect(store.getChat(chat.id)?.unread).toBe(false)
+    await store.recordTurnFailed(chat.id, "boom")
+    expect(store.getChat(chat.id)?.unread).toBe(true)
+    await store.recordTurnCancelled(chat.id)
+    expect(store.getChat(chat.id)?.unread).toBe(true)
+    await store.compact()
+    const reloaded = new EventStore(dataDir)
+    await reloaded.initialize()
+    expect(reloaded.getChat(chat.id)?.unread).toBe(true)
+  })
+  test("loads chats without unread from older snapshots as read", async () => {
+    const dataDir = await createTempDataDir()
+    const snapshotPath = join(dataDir, "snapshot.json")
+    const snapshot = {
+      v: 2,
+      generatedAt: 10,
+      projects: [{
+        id: "project-1",
+        localPath: "/tmp/project",
+        title: "Project",
+        createdAt: 1,
+        updatedAt: 5,
+      }],
+      chats: [{
+        id: "chat-1",
+        projectId: "project-1",
+        title: "Chat",
+        createdAt: 1,
+        updatedAt: 5,
+        provider: null,
+        planMode: false,
+        sessionToken: null,
+        lastTurnOutcome: null,
+      }],
+    }
+    await writeFile(snapshotPath, JSON.stringify(snapshot, null, 2), "utf8")
+    const store = new EventStore(dataDir)
+    await store.initialize()
+    expect(store.getChat("chat-1")?.unread).toBe(false)
+  })
 })

package/src/server/event-store.ts CHANGED Viewed

@@ -105,7 +105,10 @@ export class EventStore {
         this.state.projectIdsByPath.set(project.localPath, project.id)
       }
       for (const chat of parsed.chats) {
-        this.state.chatsById.set(chat.id, { ...chat })
+        this.state.chatsById.set(chat.id, {
+          ...chat,
+          unread: chat.unread ?? false,
+        })
       }
       if (parsed.messages?.length) {
         this.snapshotHasLegacyMessages = true
@@ -210,6 +213,7 @@ export class EventStore {
           title: event.title,
           createdAt: event.timestamp,
           updatedAt: event.timestamp,
+          unread: false,
           provider: null,
           planMode: false,
           sessionToken: null,
@@ -246,6 +250,13 @@ export class EventStore {
         chat.updatedAt = event.timestamp
         break
       }
+      case "chat_read_state_set": {
+        const chat = this.state.chatsById.get(event.chatId)
+        if (!chat) break
+        chat.unread = event.unread
+        chat.updatedAt = event.timestamp
+        break
+      }
       case "message_appended": {
         this.applyMessageMetadata(event.chatId, event.entry)
         const existing = this.legacyMessagesByChatId.get(event.chatId) ?? []
@@ -263,6 +274,7 @@ export class EventStore {
         const chat = this.state.chatsById.get(event.chatId)
         if (!chat) break
         chat.updatedAt = event.timestamp
+        chat.unread = true
         chat.lastTurnOutcome = "success"
         break
       }
@@ -270,6 +282,7 @@ export class EventStore {
         const chat = this.state.chatsById.get(event.chatId)
         if (!chat) break
         chat.updatedAt = event.timestamp
+        chat.unread = true
         chat.lastTurnOutcome = "failed"
         break
       }
@@ -438,6 +451,19 @@ export class EventStore {
     await this.append(this.chatsLogPath, event)
   }
+  async setChatReadState(chatId: string, unread: boolean) {
+    const chat = this.requireChat(chatId)
+    if (chat.unread === unread) return
+    const event: ChatEvent = {
+      v: STORE_VERSION,
+      type: "chat_read_state_set",
+      timestamp: Date.now(),
+      chatId,
+      unread,
+    }
+    await this.append(this.chatsLogPath, event)
+  }
   async appendMessage(chatId: string, entry: TranscriptEntry) {
     this.requireChat(chatId)
     const payload = `${JSON.stringify(entry)}\n`

package/src/server/events.ts CHANGED Viewed

@@ -11,6 +11,7 @@ export interface ChatRecord {
   createdAt: number
   updatedAt: number
   deletedAt?: number
+  unread: boolean
   provider: AgentProvider | null
   planMode: boolean
   sessionToken: string | null
@@ -82,6 +83,13 @@ export type ChatEvent =
       chatId: string
       planMode: boolean
     }
+  | {
+      v: 2
+      type: "chat_read_state_set"
+      timestamp: number
+      chatId: string
+      unread: boolean
+    }
 export type MessageEvent = {
   v: 2

package/src/server/generate-title.ts CHANGED Viewed

@@ -16,12 +16,39 @@ function normalizeGeneratedTitle(value: unknown): string | null {
   return normalized
 }
+export function fallbackTitleFromMessage(messageContent: string): string | null {
+  const normalized = messageContent.replace(/\s+/g, " ").trim()
+  if (!normalized) return null
+  if (normalized.length <= 35) return normalized
+  return `${normalized.slice(0, 35)}...`
+}
+export interface GenerateChatTitleResult {
+  title: string | null
+  usedFallback: boolean
+  failureMessage: string | null
+}
+function summarizeFailures(failures: Array<{ provider: "claude" | "codex"; reason: string }>) {
+  if (failures.length === 0) return null
+  return failures.map((failure) => failure.reason).join("; ")
+}
 export async function generateTitleForChat(
   messageContent: string,
   cwd: string,
   adapter = new QuickResponseAdapter()
 ): Promise<string | null> {
-  const result = await adapter.generateStructured<string>({
+  const result = await generateTitleForChatDetailed(messageContent, cwd, adapter)
+  return result.title
+}
+export async function generateTitleForChatDetailed(
+  messageContent: string,
+  cwd: string,
+  adapter = new QuickResponseAdapter()
+): Promise<GenerateChatTitleResult> {
+  const result = await adapter.generateStructuredWithDiagnostics<string>({
     cwd,
     task: "conversation title generation",
     prompt: `Generate a short, descriptive title (under 30 chars) for a conversation that starts with this message.\n\n${messageContent}`,
@@ -32,5 +59,18 @@ export async function generateTitleForChat(
     },
   })
-  return result
+  if (result.value) {
+    return {
+      title: result.value,
+      usedFallback: false,
+      failureMessage: null,
+    }
+  }
+  const fallbackTitle = fallbackTitleFromMessage(messageContent)
+  return {
+    title: fallbackTitle,
+    usedFallback: true,
+    failureMessage: summarizeFailures(result.failures),
+  }
 }

package/src/server/quick-response.test.ts CHANGED Viewed

@@ -1,6 +1,6 @@
 import { describe, expect, test } from "bun:test"
-import { generateTitleForChat } from "./generate-title"
-import { QuickResponseAdapter } from "./quick-response"
+import { fallbackTitleFromMessage, generateTitleForChat, generateTitleForChatDetailed } from "./generate-title"
+import { getQuickResponseWorkspace, QuickResponseAdapter } from "./quick-response"
 describe("QuickResponseAdapter", () => {
   test("returns the Claude structured result when it validates", async () => {
@@ -85,6 +85,83 @@ describe("QuickResponseAdapter", () => {
     expect(result).toBe("Codex title")
   })
+  test("uses the Kanna app data root as the quick-response workspace", async () => {
+    const previousProfile = process.env.KANNA_RUNTIME_PROFILE
+    process.env.KANNA_RUNTIME_PROFILE = "dev"
+    try {
+      let claudeCwd = ""
+      const adapter = new QuickResponseAdapter({
+        runClaudeStructured: async (args) => {
+          claudeCwd = args.cwd
+          return { title: "Claude title" }
+        },
+      })
+      await adapter.generateStructured({
+        cwd: "/tmp/project",
+        task: "title generation",
+        prompt: "Generate a title",
+        schema: {
+          type: "object",
+          properties: {
+            title: { type: "string" },
+          },
+          required: ["title"],
+          additionalProperties: false,
+        },
+        parse: (value) => {
+          const output = value && typeof value === "object" ? value as { title?: unknown } : {}
+          return typeof output.title === "string" ? output.title : null
+        },
+      })
+      expect(claudeCwd).toBe(getQuickResponseWorkspace(process.env))
+      expect(claudeCwd.endsWith("/.kanna-dev")).toBe(true)
+    } finally {
+      if (previousProfile === undefined) {
+        delete process.env.KANNA_RUNTIME_PROFILE
+      } else {
+        process.env.KANNA_RUNTIME_PROFILE = previousProfile
+      }
+    }
+  })
+  test("uses gpt-5.4-mini for Codex title generation fallback", async () => {
+    const requests: Array<{ cwd: string; prompt: string; model?: string }> = []
+    const adapter = new QuickResponseAdapter({
+      codexManager: {
+        async generateStructured(args: { cwd: string; prompt: string; model?: string }) {
+          requests.push(args)
+          return "{\"title\":\"Codex title\"}"
+        },
+      } as never,
+      runClaudeStructured: async () => null,
+    })
+    const result = await adapter.generateStructured({
+      cwd: "/tmp/project",
+      task: "title generation",
+      prompt: "Generate a title",
+      schema: {
+        type: "object",
+        properties: {
+          title: { type: "string" },
+        },
+        required: ["title"],
+        additionalProperties: false,
+      },
+      parse: (value) => {
+        const output = value && typeof value === "object" ? value as { title?: unknown } : {}
+        return typeof output.title === "string" ? output.title : null
+      },
+    })
+    expect(result).toBe("Codex title")
+    expect(requests).toHaveLength(1)
+    expect(requests[0]?.model).toBe("gpt-5.4-mini")
+  })
 })
 describe("generateTitleForChat", () => {
@@ -110,6 +187,52 @@ describe("generateTitleForChat", () => {
       })
     )
-    expect(title).toBeNull()
+    expect(title).toBe("hello")
+  })
+  test("falls back to the first 35 characters of the message with ellipsis", async () => {
+    const title = await generateTitleForChat(
+      "This message is definitely longer than thirty five characters",
+      "/tmp/project",
+      new QuickResponseAdapter({
+        runClaudeStructured: async () => {
+          throw new Error("Not authenticated")
+        },
+        runCodexStructured: async () => null,
+      })
+    )
+    expect(title).toBe("This message is definitely longer t...")
+  })
+  test("returns fallback metadata when providers fail", async () => {
+    const result = await generateTitleForChatDetailed(
+      "hello there",
+      "/tmp/project",
+      new QuickResponseAdapter({
+        runClaudeStructured: async () => {
+          throw new Error("Not authenticated")
+        },
+        runCodexStructured: async () => {
+          throw new Error("Codex unavailable")
+        },
+      })
+    )
+    expect(result).toEqual({
+      title: "hello there",
+      usedFallback: true,
+      failureMessage: "claude failed conversation title generation: Not authenticated; codex failed conversation title generation: Codex unavailable",
+    })
+  })
+})
+describe("fallbackTitleFromMessage", () => {
+  test("normalizes whitespace", () => {
+    expect(fallbackTitleFromMessage("  hello\n   world  ")).toBe("hello world")
+  })
+  test("returns null for blank input", () => {
+    expect(fallbackTitleFromMessage("   \n  ")).toBeNull()
   })
 })