@keyou007/agent-bot 0.1.15-alpha.1 → 0.1.15-alpha.3

package/src/proxy/ProxySessionController.ts

@@ -1,6 +1,7 @@
+import { createHash } from "node:crypto";
 import { promises as fs, type Dirent } from "node:fs";
-import path from "node:path";
 import os from "node:os";
+import path from "node:path";
 import type { Logger } from "pino";
 import { createProjectlessWorkspace, detectProjectlessWorkspace } from "../codex/ProjectlessWorkspace.js";
 import { resolveUserPath } from "../config/paths.js";
@@ -48,6 +49,7 @@ import type {
 } from "../runtime/types.js";
 import {
   StateStore,
+  type CardActionBinding,
   type MessageReactionRecord,
   type MessageReactionStatus,
   type QueuedPromptRecord,
@@ -96,7 +98,8 @@ const MESSAGE_RECEIVED_REACTION = "OnIt";
 const MESSAGE_COMPLETED_REACTION = "DONE";
 const MESSAGE_FAILED_REACTION = "ERROR";
 const MESSAGE_CANCELLED_REACTION = "CrossMark";
-const SESSION_PAGE_SIZE = 5;
+const SESSION_PAGE_SIZE = 10;
+const SESSION_PROMPT_PREVIEW_LENGTH = 50;
 const DIRECTORY_PAGE_SIZE = 15;
 const RESET_HISTORY_PAGE_SIZE = 10;
 const MAX_LLM_TURN_RETRIES = 3;
@@ -749,8 +752,17 @@ export class ProxySessionController {
       return;
     }
     if (!this.store.claimInboundEvent(action.actionId, "card_action")) return;
-    const contextKey = this.cardActionContextKey(action);
-    const scopedAction = contextKey === action.contextKey ? action : { ...action, contextKey };
+    let resolvedAction: CardAction;
+    try {
+      resolvedAction = this.resolveCardActionBinding(action);
+    } catch (error) {
+      await this.sendError(action.contextKey, error);
+      return;
+    }
+    const contextKey = this.cardActionContextKey(resolvedAction);
+    const scopedAction = contextKey === resolvedAction.contextKey
+      ? resolvedAction
+      : { ...resolvedAction, contextKey };
     const replyTarget = isThreadContextKey(contextKey) && action.messageId
       ? { messageId: action.messageId, replyInThread: true as const }
       : undefined;
@@ -821,6 +833,30 @@ export class ProxySessionController {
           const filePath = directoryFileActionPath(scopedAction.value.filePath);
           await this.assertSendableFile(filePath);
           await this.outbound.sendFile(contextKey, filePath);
+        } else if (kind === "directory_new_folder_prompt") {
+          const directory = directoryActionPath(scopedAction.value.directory);
+          await this.assertBrowsableDirectory(directory);
+          await this.outbound.updateInteractiveCard(
+            contextKey,
+            requiredCardMessageId(scopedAction.messageId),
+            this.cardRenderer.renderDirectoryNewFolderCard({
+              directory,
+              displayDirectory: abbreviateHomeDirectory(directory),
+              contextKey,
+              page: directoryPageValue(scopedAction.value.page),
+            }),
+          );
+        } else if (kind === "directory_new_folder_submit") {
+          await this.createDirectoryFromCard(contextKey, scopedAction);
+        } else if (kind === "directory_new_folder_cancel") {
+          await this.openDirectoryBrowser(
+            contextKey,
+            directoryActionPath(scopedAction.value.directory),
+            {
+              updateMessageId: requiredCardMessageId(scopedAction.messageId),
+              page: directoryPageValue(scopedAction.value.page),
+            },
+          );
         } else if (kind === "directory_new" || kind === "directory_new_group") {
           const directory = directoryActionPath(scopedAction.value.directory);
           await this.assertBrowsableDirectory(directory);
@@ -1639,6 +1675,16 @@ export class ProxySessionController {
       : action.contextKey;
   }
 
+  private resolveCardActionBinding(action: CardAction): CardAction {
+    if (typeof action.value.action === "string") return action;
+    const token = typeof action.value.t === "string" ? action.value.t : undefined;
+    if (!token) return action;
+    if (!action.messageId) throw new Error("任务列表卡片缺少消息 ID，请重新发送 /sessions。");
+    const value = this.store.getCardActionBinding(action.messageId, token);
+    if (!value) throw new Error("任务列表卡片已失效，请重新发送 /sessions。");
+    return { ...action, value };
+  }
+
   private async execute(
     contextKey: string,
     command: Command,
@@ -4842,12 +4888,12 @@ export class ProxySessionController {
     const card = this.cardRenderer.renderDirectoryBrowserCard({
       directory: abbreviateHomeDirectory(directory),
       entries: visibleEntries,
-      currentActions: directoryCreationActions(directory, contextKey),
+      currentActions: directoryCreationActions(directory, contextKey, page),
       navigationActions,
       footerLines: [
         `第 ${page + 1}/${totalPages} 页 · ${directoryCount} 个目录 · ${entries.length - directoryCount} 个文件`,
         "",
-        "> 点击目录名称进入，点击文件名称发送到当前会话；卡片顶部的 **New** 和 **NewGroup** 使用当前目录。",
+        "> 点击目录名称进入，点击文件名称发送到当前会话；卡片顶部可新建目录、任务或群聊。",
       ],
     });
     if (options.updateMessageId) {
@@ -4913,6 +4959,27 @@ export class ProxySessionController {
     if (!stats.isDirectory()) throw new Error(`这不是目录：${directory}`);
   }
 
+  private async createDirectoryFromCard(contextKey: string, action: CardAction): Promise<void> {
+    const directory = directoryActionPath(action.value.directory);
+    await this.assertBrowsableDirectory(directory);
+    const folderName = directoryFolderName(cardFormValue(action.value, "folderName"));
+    const newDirectory = path.join(directory, folderName);
+    try {
+      await fs.mkdir(newDirectory);
+    } catch (error) {
+      const code = typeof error === "object" && error !== null && "code" in error
+        ? String(error.code)
+        : undefined;
+      if (code === "EEXIST") throw new Error(`目录已存在：${newDirectory}`);
+      throw new Error(`无法创建目录 ${newDirectory}：${runtimeErrorMessage(error)}`);
+    }
+    await this.openDirectoryBrowser(contextKey, directory, {
+      updateMessageId: requiredCardMessageId(action.messageId),
+      page: directoryPageValue(action.value.page),
+    });
+    await this.outbound.sendText(contextKey, `已创建目录：${newDirectory}`);
+  }
+
   private async assertSendableFile(filePath: string): Promise<void> {
     let stats;
     try {
@@ -4952,13 +5019,34 @@ export class ProxySessionController {
     const remoteHint = remoteErrors.length > 0
       ? `部分 Agent 的任务读取失败：${remoteErrors.join("；")}`
       : undefined;
-
-    const entries = orderTaskListByProject(
-      mergeTaskList(localSessions, remoteSessions, context.currentSessionId)
+    const latestLocalUserPrompts = new Map<string, string>();
+    for (const session of localSessions) {
+      const persisted = this.store.findLatestTurnSnapshotForSession(session.localSessionId);
+      const prompt = latestUserPromptFromTurnView(turnViewSnapshot(persisted?.snapshot));
+      if (prompt) latestLocalUserPrompts.set(session.localSessionId, prompt);
+    }
+    const latestRemoteUserPrompts = new Map<string, string>();
+    for (const { agentName, session: remote } of remoteSessions) {
+      const local = this.store.findSessionByRemoteSessionId(remote.id, undefined, agentName);
+      if (!local) continue;
+      const persisted = this.store.findLatestTurnSnapshotForSession(local.localSessionId);
+      const prompt = latestUserPromptFromTurnView(turnViewSnapshot(persisted?.snapshot));
+      if (prompt) latestRemoteUserPrompts.set(agentRemoteKey(agentName, remote.id), prompt);
+    }
+
+    const globallyOrderedEntries = orderTaskListByRecency(
+      mergeTaskList(
+        localSessions,
+        remoteSessions,
+        context.currentSessionId,
+        latestLocalUserPrompts,
+        latestRemoteUserPrompts,
+      )
         .filter((entry) => !normalizedSearch
         || [entry.id, entry.title, entry.cwd, entry.agentName]
           .some((value) => value.toLowerCase().includes(normalizedSearch))),
     );
+    const entries = groupTaskListPagesByProject(globallyOrderedEntries, SESSION_PAGE_SIZE);
     const activeCount = entries.filter((entry) => entry.active).length;
     const lastKnownPage = Math.max(0, Math.ceil(entries.length / SESSION_PAGE_SIZE) - 1);
     const page = remoteHasMore ? requestedPage : Math.min(requestedPage, lastKnownPage);
@@ -4972,6 +5060,9 @@ export class ProxySessionController {
     const hasPrevious = page > 0;
     const hasNext = remoteHasMore || entries.length > offset + SESSION_PAGE_SIZE;
     this.lastSessionListings.set(contextKey, entries.map((entry) => entry.reference));
+    const cardActionBindings = new Map<string, CardActionBinding>();
+    const bindCardAction = (action: TaskListCardAction): TaskListCardAction =>
+      bindSessionCardAction(action, cardActionBindings);
     const cardEntries = visibleEntries.map((entry, index): {
       project: TaskProjectInfo;
       projectActions: TaskListCardAction[];
@@ -4979,11 +5070,11 @@ export class ProxySessionController {
     } => {
       const project = taskProjectInfo(entry);
       const projectActionSource = projectActionSources.get(project.key) ?? entry;
-      const marker = entry.current ? "✅" : entry.active ? "🟢" : "•";
+      const marker = entry.current ? "✅ " : entry.active ? "🟢 " : "";
       const showStop = entry.status === "外部执行中"
         && entry.reference !== options.forceSwitchTaskId
         && entry.id !== options.forceSwitchTaskId;
-      const actions: TaskListCardAction[] = entry.current ? [] : [{
+      const actions: TaskListCardAction[] = entry.current ? [] : [bindCardAction({
         text: showStop ? "Stop" : "Switch",
         type: showStop ? "danger" as const : "default" as const,
         value: {
@@ -4993,8 +5084,8 @@ export class ProxySessionController {
           page: String(page),
           contextKey,
         },
-      }];
-      const projectActions: TaskListCardAction[] = [{
+      })];
+      const projectActions: TaskListCardAction[] = [bindCardAction({
         text: "New",
         value: {
           action: "session_new",
@@ -5003,7 +5094,7 @@ export class ProxySessionController {
           page: String(page),
           contextKey,
         },
-      }, {
+      }), bindCardAction({
         text: "NewGroup",
         value: {
           action: "session_new_group",
@@ -5012,8 +5103,8 @@ export class ProxySessionController {
           page: String(page),
           contextKey,
         },
-      }];
-      actions.push({
+      })];
+      actions.push(bindCardAction({
         text: "Fork",
         value: {
           action: "session_fork",
@@ -5022,8 +5113,8 @@ export class ProxySessionController {
           page: String(page),
           contextKey,
         },
-      });
-      actions.push({
+      }));
+      actions.push(bindCardAction({
         text: "ForkGroup",
         value: {
           action: "session_fork_group",
@@ -5032,16 +5123,16 @@ export class ProxySessionController {
           page: String(page),
           contextKey,
         },
-      });
-      actions.push({
+      }));
+      actions.push(bindCardAction({
         text: "Status",
         value: {
           action: "session_status",
           sessionId: entry.reference,
           contextKey,
         },
-      });
-      actions.push({
+      }));
+      actions.push(bindCardAction({
         text: "Archive",
         value: {
           action: "session_archive",
@@ -5050,18 +5141,18 @@ export class ProxySessionController {
           page: String(page),
           contextKey,
         },
-      });
+      }));
       const title = truncateText(entry.title.replace(/\s+/gu, " ").trim() || "未命名任务", 56);
+      const lastUserPrompt = sessionPromptPreview(entry.lastUserPrompt);
       return {
         project,
         projectActions,
         cardEntry: {
           reference: entry.reference,
-          summary: `${offset + index + 1}. ${marker} ${title} · ${entry.agentName}`,
+          summary: `${offset + index + 1}. ${marker}${title} · ${entry.agentName}`,
           detailLines: [
-            `**状态 / 更新时间**：${cardText(entry.status)} / ${cardText(entry.updatedLabel)}`,
-            `**Agent / 任务 ID**：${cardCode(entry.agentName)} / ${cardCode(entry.id)}`,
-            `**目录**：${cardCode(entry.cwd || "目录未知")}`,
+            cardText(lastUserPrompt),
+            `**更新时间**：${cardText(entry.updatedLabel)}`,
           ],
           actions,
           current: entry.current,
@@ -5091,11 +5182,11 @@ export class ProxySessionController {
         ...(remoteHint ? [remoteHint] : []),
         `第 ${page + 1} 页 · 每页 ${SESSION_PAGE_SIZE} 个任务${hasNext ? "" : ` · 当前共 ${entries.length} 个任务`}`,
         "",
-        "> 项目行：**New** 新建任务，**NewGroup** 新建群。",
+        "> 项目菜单：**New** 新建任务，**NewGroup** 新建群。",
         "> 任务详情：**Switch** 切换，**Stop** 停止，**Fork** / **ForkGroup** 创建分支，**Status** 查看状态，**Archive** 归档。",
       ],
       [
-        ...(hasPrevious ? [{
+        ...(hasPrevious ? [bindCardAction({
           text: "Previous",
           value: {
             action: "session_page",
@@ -5103,8 +5194,8 @@ export class ProxySessionController {
             page: String(page - 1),
             contextKey,
           },
-        }] : []),
-        ...(hasNext ? [{
+        })] : []),
+        ...(hasNext ? [bindCardAction({
           text: "Next",
           value: {
             action: "session_page",
@@ -5112,13 +5203,20 @@ export class ProxySessionController {
             page: String(page + 1),
             contextKey,
           },
-        }] : []),
+        })] : []),
       ],
     );
+    const bindings = [...cardActionBindings.values()];
     if (options.updateMessageId) {
+      this.store.upsertCardActionBindings(options.updateMessageId, bindings);
       await this.outbound.updateInteractiveCard(contextKey, options.updateMessageId, card);
+      this.store.retainCardActionBindings(options.updateMessageId, bindings.map((binding) => binding.token));
     } else {
-      await this.outbound.sendInteractiveCard(contextKey, card);
+      const messageId = await this.outbound.sendInteractiveCard(contextKey, card);
+      if (messageId) {
+        this.store.upsertCardActionBindings(messageId, bindings);
+        this.store.retainCardActionBindings(messageId, bindings.map((binding) => binding.token));
+      }
     }
   }
 
@@ -5928,6 +6026,7 @@ interface UnifiedTaskListEntry {
   status: string;
   active: boolean;
   current: boolean;
+  lastUserPrompt?: string;
   updatedAt: number;
   updatedLabel: string;
 }
@@ -5937,26 +6036,28 @@ interface TaskProjectInfo {
   title: string;
 }
 
-function orderTaskListByProject(entries: UnifiedTaskListEntry[]): UnifiedTaskListEntry[] {
-  const groups = new Map<string, { project: TaskProjectInfo; entries: UnifiedTaskListEntry[] }>();
-  for (const entry of entries) {
-    const project = taskProjectInfo(entry);
-    const group = groups.get(project.key);
-    if (group) group.entries.push(entry);
-    else groups.set(project.key, { project, entries: [entry] });
-  }
-  const orderedGroups = [...groups.values()]
-    .map((group) => ({
-      ...group,
-      current: group.entries.some((entry) => entry.current),
-      active: group.entries.some((entry) => entry.active),
-      updatedAt: Math.max(...group.entries.map((entry) => entry.updatedAt)),
-    }))
-    .sort((left, right) => Number(right.current) - Number(left.current)
-      || Number(right.active) - Number(left.active)
-      || right.updatedAt - left.updatedAt
-      || left.project.title.localeCompare(right.project.title, undefined, { sensitivity: "base" }));
-  return orderedGroups.flatMap((group) => group.entries.sort(compareTaskListEntries));
+function orderTaskListByRecency(entries: UnifiedTaskListEntry[]): UnifiedTaskListEntry[] {
+  return [...entries].sort(compareTaskListEntries);
+}
+
+function groupTaskListPagesByProject(
+  entries: UnifiedTaskListEntry[],
+  pageSize: number,
+): UnifiedTaskListEntry[] {
+  const result: UnifiedTaskListEntry[] = [];
+  for (let offset = 0; offset < entries.length; offset += pageSize) {
+    const groups = new Map<string, UnifiedTaskListEntry[]>();
+    for (const entry of entries.slice(offset, offset + pageSize)) {
+      const key = taskProjectInfo(entry).key;
+      const group = groups.get(key);
+      if (group) group.push(entry);
+      else groups.set(key, [entry]);
+    }
+    for (const group of groups.values()) {
+      result.push(...group.sort(compareTaskListEntries));
+    }
+  }
+  return result;
 }
 
 function compareTaskListEntries(left: UnifiedTaskListEntry, right: UnifiedTaskListEntry): number {
@@ -5985,6 +6086,8 @@ function mergeTaskList(
   localSessions: SessionRecord[],
   remoteSessions: AgentRemoteSessionSummary[],
   currentLocalSessionId?: string,
+  latestLocalUserPrompts: ReadonlyMap<string, string> = new Map(),
+  latestRemoteUserPrompts: ReadonlyMap<string, string> = new Map(),
 ): UnifiedTaskListEntry[] {
   const localByRemoteId = new Map(
     localSessions
@@ -6009,6 +6112,9 @@ function mergeTaskList(
       status,
       active,
       current: Boolean(local && local.localSessionId === currentLocalSessionId),
+      lastUserPrompt: remote.lastUserPrompt
+        ?? (local ? latestLocalUserPrompts.get(local.localSessionId) : undefined)
+        ?? latestRemoteUserPrompts.get(agentRemoteKey(agentName, remote.id)),
       updatedAt: (recencyAt ?? 0) * 1_000,
       updatedLabel: formatRemoteTime(recencyAt),
     };
@@ -6028,6 +6134,7 @@ function mergeTaskList(
       status: sessionStatusLabel(local.status),
       active: local.status === "running",
       current: local.localSessionId === currentLocalSessionId,
+      lastUserPrompt: latestLocalUserPrompts.get(local.localSessionId),
       updatedAt: Number.isNaN(updatedAt) ? 0 : updatedAt,
       updatedLabel: formatStatusTime(local.updatedAt),
     });
@@ -6057,6 +6164,20 @@ function parseRemoteSessionReference(reference: string): { agentName: string; re
   }
 }
 
+function bindSessionCardAction(
+  action: TaskListCardAction,
+  bindings: Map<string, CardActionBinding>,
+): TaskListCardAction {
+  const serialized = JSON.stringify(action.value);
+  const token = createHash("sha256").update(serialized).digest("hex").slice(0, 16);
+  const existing = bindings.get(token);
+  if (existing && JSON.stringify(existing.value) !== serialized) {
+    throw new Error("任务列表卡片操作令牌发生冲突，请重试。");
+  }
+  bindings.set(token, { token, value: action.value });
+  return { ...action, value: { t: token } };
+}
+
 function runtimeErrorMessage(error: unknown): string {
   return error instanceof Error ? error.message : String(error);
 }
@@ -6079,6 +6200,22 @@ function turnViewSnapshot(value: unknown): TurnViewState | undefined {
     : undefined;
 }
 
+function latestUserPromptFromTurnView(snapshot: TurnViewState | undefined): string | undefined {
+  const latestUserActivity = [...(snapshot?.activities ?? [])]
+    .reverse()
+    .find((activity): activity is Extract<TurnActivity, { kind: "user" }> =>
+      activity.kind === "user" && Boolean(activity.text.trim()));
+  return latestUserActivity?.text.trim() || snapshot?.prompt?.trim() || undefined;
+}
+
+function sessionPromptPreview(prompt: string | undefined): string {
+  const normalized = prompt?.replace(/\s+/gu, " ").trim() || "暂无用户 Prompt";
+  const characters = Array.from(normalized);
+  return characters.length > SESSION_PROMPT_PREVIEW_LENGTH
+    ? `${characters.slice(0, SESSION_PROMPT_PREVIEW_LENGTH).join("")}...`
+    : normalized;
+}
+
 function isTerminalTurnViewStatus(status: TurnViewState["status"]): boolean {
   return status === "completed" || status === "cancelled" || status === "failed";
 }
@@ -6424,10 +6561,45 @@ function directoryFileActionPath(value: unknown): string {
   return path.resolve(value);
 }
 
-function directoryCreationActions(directory: string, contextKey: string): TaskListCardAction[] {
+function cardFormValue(value: Record<string, unknown>, name: string): unknown {
+  const formValue = value.formValue;
+  return typeof formValue === "object" && formValue !== null
+    ? (formValue as Record<string, unknown>)[name]
+    : undefined;
+}
+
+function directoryFolderName(value: unknown): string {
+  if (typeof value !== "string" || !value.trim()) throw new Error("请输入目录名。");
+  const name = value.trim();
+  if (name === "." || name === "..") throw new Error("目录名不能是 . 或 ..。");
+  if (name.length > 255) throw new Error("目录名不能超过 255 个字符。");
+  if (/[<>:"/\\|?*\u0000-\u001F]/u.test(name)) {
+    throw new Error("目录名不能包含路径分隔符或以下字符：< > : \" / \\ | ? *");
+  }
+  if (/[. ]$/u.test(name)) throw new Error("目录名不能以空格或句点结尾。");
+  if (/^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\..*)?$/iu.test(name)) {
+    throw new Error("该名称是系统保留名称，请使用其他目录名。");
+  }
+  return name;
+}
+
+function directoryCreationActions(
+  directory: string,
+  contextKey: string,
+  page: number,
+): TaskListCardAction[] {
   return [
     {
-      text: "New",
+      text: "NewFolder",
+      value: {
+        action: "directory_new_folder_prompt",
+        directory,
+        contextKey,
+        page: String(page),
+      },
+    },
+    {
+      text: "NewTask",
       value: {
         action: "directory_new",
         directory,
@@ -6435,7 +6607,7 @@ function directoryCreationActions(directory: string, contextKey: string): TaskLi
       },
     },
     {
-      text: "NewGroup",
+      text: "NewGroupTask",
       value: {
         action: "directory_new_group",
         directory,

package/src/runtime/types.ts

@@ -123,6 +123,7 @@ export interface RemoteSessionSummary {
   lastTurnId?: string;
   lastCompletedTurnId?: string;
   lastTurnStatus?: "completed" | "interrupted" | "failed" | "inProgress";
+  lastUserPrompt?: string;
   lastActivity?: string;
   finalResponse?: string;
   lastError?: string;

package/src/state/StateStore.ts

@@ -75,6 +75,11 @@ export interface GoalCardDeliveryRecord {
   updatedAt: string;
 }
 
+export interface CardActionBinding {
+  token: string;
+  value: Record<string, string>;
+}
+
 export interface TurnRuntimeOriginRecord {
   turnId: string;
   localSessionId: string;
@@ -289,6 +294,52 @@ export class StateStore {
     return rows.map(goalCardDeliveryFromRow);
   }
 
+  upsertCardActionBindings(messageId: string, bindings: CardActionBinding[]): void {
+    if (bindings.length === 0) return;
+    const createdAt = new Date().toISOString();
+    const upsert = this.db.prepare(`
+      INSERT INTO card_action_bindings (message_id, token, value_json, created_at)
+      VALUES (?, ?, ?, ?)
+      ON CONFLICT(message_id, token) DO UPDATE SET
+        value_json = excluded.value_json,
+        created_at = excluded.created_at
+    `);
+    this.db.transaction(() => {
+      for (const binding of bindings) {
+        upsert.run(messageId, binding.token, JSON.stringify(binding.value), createdAt);
+      }
+    })();
+  }
+
+  retainCardActionBindings(messageId: string, tokens: string[]): void {
+    if (tokens.length === 0) {
+      this.db.prepare("DELETE FROM card_action_bindings WHERE message_id = ?").run(messageId);
+      return;
+    }
+    const placeholders = tokens.map(() => "?").join(", ");
+    this.db.prepare(`
+      DELETE FROM card_action_bindings
+      WHERE message_id = ? AND token NOT IN (${placeholders})
+    `).run(messageId, ...tokens);
+  }
+
+  getCardActionBinding(messageId: string, token: string): Record<string, unknown> | undefined {
+    const row = this.db.prepare(`
+      SELECT value_json
+      FROM card_action_bindings
+      WHERE message_id = ? AND token = ?
+    `).get(messageId, token) as { value_json: string } | undefined;
+    if (!row) return undefined;
+    try {
+      const value = JSON.parse(row.value_json) as unknown;
+      return value && typeof value === "object" && !Array.isArray(value)
+        ? value as Record<string, unknown>
+        : undefined;
+    } catch {
+      return undefined;
+    }
+  }
+
   close(): void {
     this.db.close();
   }

package/src/state/migrations.ts

@@ -184,4 +184,15 @@ export const migrations = [
   CREATE INDEX IF NOT EXISTS idx_goal_card_deliveries_session
     ON goal_card_deliveries(local_session_id);
   `,
+  `
+  CREATE TABLE IF NOT EXISTS card_action_bindings (
+    message_id TEXT NOT NULL,
+    token TEXT NOT NULL,
+    value_json TEXT NOT NULL,
+    created_at TEXT NOT NULL,
+    PRIMARY KEY (message_id, token)
+  );
+  CREATE INDEX IF NOT EXISTS idx_card_action_bindings_created
+    ON card_action_bindings(created_at);
+  `,
 ] as const;