twinny 0.0.0-dev.260525150705

package/dist/types.d.ts

@@ -0,0 +1,330 @@
+export type ProfileName = string;
+export type UserIdentity = "owner" | "guest";
+export declare const HOST_PROFILE_NAME = "host";
+export declare const GUEST_PROFILE_NAME = "guest";
+export declare const NONE_PROFILE_NAME = "none";
+export type ConversationType = "p2p" | "group" | "topic_group";
+export type LarkChatMode = "group" | "topic";
+export type LarkGroupMessageType = "chat" | "thread";
+export type LarkBrand = "feishu" | "lark";
+export type ConversationResponseMode = "all" | "all_at" | "owner" | "owner_at" | "none";
+export type AgentMessagePhase = "commentary" | "final_answer";
+export type LarkMessageRedactionStrategy = "mask" | "whitespace" | "none";
+export type CodexThreadMode = "default" | "plan";
+export type CodexThreadStatus = "idle" | "working" | "waiting";
+export type CodexThreadGoalStatus = "none" | "active" | "paused" | "blocked" | "usageLimited" | "budgetLimited" | "complete";
+export interface CodexAgentMessage {
+    id: string;
+    text: string;
+    phase?: AgentMessagePhase | null;
+}
+export interface CodexImageGeneration {
+    id: string;
+    status?: string;
+    savedPath?: string;
+    revisedPrompt?: string;
+    result?: string;
+}
+export interface CodexThreadNameUpdate {
+    threadId: string;
+    name: string;
+}
+export type LarkMessageRouteKind = "message" | "side_message" | "goal_message" | "steered_message" | "queued_message" | "control_message" | "card_action" | "menu_action";
+export type LarkMessageStatus = "queued" | "recalled" | "processing" | "steered" | "completed" | "failed" | "interrupted" | "cleared";
+export declare const DEFAULT_LARK_WORKING_REACTION = "Typing";
+export declare const DEFAULT_LARK_COMPLETED_REACTION = "DONE";
+export declare const DEFAULT_LARK_QUEUED_REACTION = "OneSecond";
+export declare const DEFAULT_LARK_MAX_MESSAGE_AGE_SECONDS = 60;
+export declare const DEFAULT_LARK_MESSAGE_REDACTION_STRATEGY: LarkMessageRedactionStrategy;
+export interface LarkMessageRedactionConfig {
+    email: LarkMessageRedactionStrategy;
+    chinesePhoneNumber: LarkMessageRedactionStrategy;
+}
+export interface OwnerConfig {
+    openId: string;
+    userId?: string;
+    displayName: string;
+}
+export interface TwinnyAuthFile {
+    larkAppId: string;
+    larkBrand: LarkBrand;
+    ownerOpenId: string;
+    displayName: string;
+}
+export interface TwinnyHomeIdentity {
+    random: string;
+    telemetryHashSalt: string;
+    keychainAccounts: {
+        larkAppSecret: string;
+    };
+}
+export interface LarkConfig {
+    workingReaction: string;
+    completedReaction: string;
+    queuedReaction: string;
+    maxMessageAgeSeconds: number;
+    messageRedaction: LarkMessageRedactionConfig;
+}
+export interface CodexConfig {
+    binary: string;
+}
+export interface ProfileConfig {
+    codexHome: string;
+    defaultModel?: string;
+    defaultEffort?: string;
+}
+export interface PermissionsConfig {
+    p2pDefaultProfile: ProfileName;
+}
+export interface TelemetryConfig {
+    enabled: boolean;
+    posthogProjectToken: string;
+    posthogHost: string;
+}
+export interface TwinnyConfig {
+    home: string;
+    codex: CodexConfig;
+    lark: LarkConfig;
+    auth: TwinnyAuthFile;
+    homeIdentity: TwinnyHomeIdentity;
+    permissions: PermissionsConfig;
+    telemetry?: TelemetryConfig;
+    owner: OwnerConfig;
+    profiles: Record<ProfileName, ProfileConfig>;
+}
+export interface RuntimePaths {
+    home: string;
+    configFile: string;
+    authFile: string;
+    homeRandomFile: string;
+    sqliteDir: string;
+    sqliteFile: string;
+    workspacesDir: string;
+    runtimeDir: string;
+    larkAssetsFile: string;
+    lockFile: string;
+    logsDir: string;
+}
+export interface ConversationRecord {
+    id: number;
+    conversationKey: string;
+    type: ConversationType;
+    chatId: string;
+    name: string;
+    responseMode: ConversationResponseMode;
+    profile: ProfileName;
+    codexThreadId: string;
+    workspace: string;
+    profileCodexHome: string;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface NewConversationRecord {
+    conversationKey: string;
+    type: ConversationType;
+    chatId: string;
+    name: string;
+    responseMode?: ConversationResponseMode;
+    profile: ProfileName;
+    codexThreadId: string;
+    workspace: string;
+    profileCodexHome: string;
+}
+export interface CodexThreadRecord {
+    id: number;
+    codexThreadId: string;
+    conversationKey: string;
+    name: string;
+    larkThreadId?: string;
+    profile: ProfileName;
+    model?: string;
+    effort?: string;
+    mode: CodexThreadMode;
+    status: CodexThreadStatus;
+    goalStatus: CodexThreadGoalStatus;
+    goalUpdatedAt?: number;
+    forkedFromCodexThreadId?: string;
+    forkedAt?: number;
+    creatorOpenId?: string;
+    cardMessageId?: string;
+    codexThreadHasRollout: boolean;
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens: number;
+    reasoningOutputTokens: number;
+    totalTokens: number;
+    contextTokens: number;
+    contextWindow: number;
+    tokenUsageJson: string;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface LarkMessageRecord {
+    id: number;
+    larkMessageId?: string;
+    eventId: string;
+    larkUserId: string;
+    larkGroupId?: string;
+    larkThreadId?: string;
+    conversationKey?: string;
+    codexThreadId?: string;
+    codexTurnId?: string;
+    routeKind: LarkMessageRouteKind;
+    status: LarkMessageStatus;
+    text: string;
+    larkCreateTime?: number;
+    receivedAt: number;
+    updatedAt: number;
+    processingStartedAt?: number;
+    completedAt?: number;
+    failedAt?: number;
+    clearedAt?: number;
+    sideId?: number;
+    agentCardMessageId?: string;
+    rawEventJson?: string;
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens: number;
+    reasoningOutputTokens: number;
+    tokenUsageJson: string;
+}
+export interface IncomingLarkMessage {
+    eventId: string;
+    messageId: string;
+    chatId: string;
+    chatType: "p2p" | "group" | "topic_group" | string;
+    messageType: string;
+    senderOpenId: string;
+    senderName?: string;
+    chatName?: string;
+    larkGroupId?: string;
+    larkThreadId?: string;
+    larkRootMessageId?: string;
+    larkParentMessageId?: string;
+    mentions?: IncomingLarkMention[];
+    resources?: IncomingLarkMessageResource[];
+    downloadedFiles?: DownloadedLarkFile[];
+    rawForCodex?: boolean;
+    text: string;
+    createTime?: number;
+    raw: unknown;
+}
+export interface IncomingLarkMention {
+    key: string;
+    openId?: string;
+    userId?: string;
+    unionId?: string;
+    name?: string;
+}
+export interface IncomingLarkMessageRecall {
+    eventId: string;
+    messageId: string;
+    chatId?: string;
+    recallTime?: number;
+    raw: unknown;
+}
+export type LarkBotMenuActionKey = "stop" | "new" | "queue" | "status" | "help" | "new_session";
+export interface IncomingLarkBotMenuAction {
+    eventId: string;
+    eventKey: string;
+    action: LarkBotMenuActionKey;
+    operatorOpenId: string;
+    operatorName?: string;
+    chatId?: string;
+    timestamp?: number;
+    raw: unknown;
+}
+export interface IncomingLarkCardAction {
+    eventId: string;
+    operatorOpenId: string;
+    openMessageId?: string;
+    openChatId?: string;
+    actionTag?: string;
+    actionValue: Record<string, unknown>;
+    formValue?: Record<string, unknown>;
+    raw: unknown;
+}
+export interface IncomingLarkMessageResource {
+    resourceType: "image" | "file";
+    fileKey: string;
+    fileName?: string;
+    codexTag?: "img" | "video" | "file";
+    textPlaceholder?: string;
+}
+export interface DownloadedLarkFile extends IncomingLarkMessageResource {
+    path: string;
+    size: number;
+    contentType?: string;
+}
+export interface LarkReactionHandle {
+    messageId: string;
+    reactionId: string;
+}
+export interface CodexTurnRequest {
+    threadId: string;
+    input: string;
+    cwd: string;
+    profile: ProfileName;
+}
+export interface CodexTurnResult {
+    threadId: string;
+    turnId?: string;
+    text: string;
+    status: "completed" | "failed" | "interrupted";
+    error?: string;
+    durationMs?: number;
+    generatedImages?: CodexImageGeneration[];
+}
+export interface CodexRequestUserInputOption {
+    label: string;
+    description: string;
+}
+export interface CodexRequestUserInputQuestion {
+    id: string;
+    header: string;
+    question: string;
+    isOther: boolean;
+    isSecret: boolean;
+    options: CodexRequestUserInputOption[] | null;
+}
+export interface CodexRequestUserInputParams {
+    threadId: string;
+    turnId: string;
+    itemId: string;
+    questions: CodexRequestUserInputQuestion[];
+}
+export interface CodexRequestUserInputAnswer {
+    answers: string[];
+}
+export interface CodexRequestUserInputResponse {
+    answers: Record<string, CodexRequestUserInputAnswer | undefined>;
+}
+export interface CodexRequestUserInputRequest {
+    requestId: string | number;
+    params: CodexRequestUserInputParams;
+}
+export interface CodexPlanStep {
+    step: string;
+    status: "pending" | "inProgress" | "completed";
+}
+export interface CodexPlanUpdate {
+    threadId: string;
+    turnId: string;
+    explanation: string | null;
+    plan: CodexPlanStep[];
+}
+export interface CodexThreadTokenUsageUpdate {
+    threadId: string;
+    turnId?: string;
+    totalTokens: number;
+    raw: unknown;
+}
+export interface HealthCheck {
+    name: string;
+    ok: boolean;
+    detail?: string;
+}
+export interface HealthSnapshot {
+    ok: boolean;
+    checks: HealthCheck[];
+}

package/dist/types.js

@@ -0,0 +1,9 @@
+export const HOST_PROFILE_NAME = "host";
+export const GUEST_PROFILE_NAME = "guest";
+export const NONE_PROFILE_NAME = "none";
+export const DEFAULT_LARK_WORKING_REACTION = "Typing";
+export const DEFAULT_LARK_COMPLETED_REACTION = "DONE";
+export const DEFAULT_LARK_QUEUED_REACTION = "OneSecond";
+export const DEFAULT_LARK_MAX_MESSAGE_AGE_SECONDS = 60;
+export const DEFAULT_LARK_MESSAGE_REDACTION_STRATEGY = "mask";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACxC,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAoExC,MAAM,CAAC,MAAM,6BAA6B,GAAG,QAAQ,CAAC;AACtD,MAAM,CAAC,MAAM,+BAA+B,GAAG,MAAM,CAAC;AACtD,MAAM,CAAC,MAAM,4BAA4B,GAAG,WAAW,CAAC;AACxD,MAAM,CAAC,MAAM,oCAAoC,GAAG,EAAE,CAAC;AACvD,MAAM,CAAC,MAAM,uCAAuC,GAAiC,MAAM,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const TWINNY_VERSION: string;

package/dist/version.js

@@ -0,0 +1 @@
+export const TWINNY_VERSION = "0.0.0-dev.260525150705";

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC"}

package/dist/version.json

@@ -0,0 +1,3 @@
+{
+  "version": "0.0.0-dev.260525150705"
+}

package/dist/workspace/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./manager.js";
+export * from "./slug.js";

package/dist/workspace/index.js

@@ -0,0 +1,3 @@
+export * from "./manager.js";
+export * from "./slug.js";
+//# sourceMappingURL=index.js.map

package/dist/workspace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/workspace/manager.d.ts

@@ -0,0 +1,14 @@
+import type { RuntimePaths } from "../types.js";
+export interface WorkspaceManagerOptions {
+    workspacesDir: string;
+}
+export declare class WorkspaceManager {
+    readonly workspacesDir: string;
+    constructor(options: WorkspaceManagerOptions);
+    static fromTwinnyHome(twinnyHome: string): WorkspaceManager;
+    static fromRuntimePaths(paths: Pick<RuntimePaths, "workspacesDir">): WorkspaceManager;
+    getWorkspacePath(conversationKey: string): string;
+    ensureWorkspace(conversationKey: string): string;
+}
+export declare function getWorkspacePath(twinnyHome: string, conversationKey: string): string;
+export declare function ensureWorkspace(twinnyHome: string, conversationKey: string): string;

package/dist/workspace/manager.js

@@ -0,0 +1,69 @@
+import fs from "node:fs";
+import path from "node:path";
+import { TwinnyError } from "../errors.js";
+import { assertValidConversationKey } from "./slug.js";
+export class WorkspaceManager {
+    workspacesDir;
+    constructor(options) {
+        this.workspacesDir = path.resolve(options.workspacesDir);
+    }
+    static fromTwinnyHome(twinnyHome) {
+        return new WorkspaceManager({ workspacesDir: path.join(twinnyHome, "workspaces") });
+    }
+    static fromRuntimePaths(paths) {
+        return new WorkspaceManager({ workspacesDir: paths.workspacesDir });
+    }
+    getWorkspacePath(conversationKey) {
+        assertValidConversationKey(conversationKey);
+        const workspace = path.resolve(this.workspacesDir, conversationKey);
+        assertPathInside(this.workspacesDir, workspace);
+        return workspace;
+    }
+    ensureWorkspace(conversationKey) {
+        const workspace = this.getWorkspacePath(conversationKey);
+        ensureDirectory(this.workspacesDir, "workspacesDir");
+        ensureDirectory(workspace, "workspace");
+        return workspace;
+    }
+}
+export function getWorkspacePath(twinnyHome, conversationKey) {
+    return WorkspaceManager.fromTwinnyHome(twinnyHome).getWorkspacePath(conversationKey);
+}
+export function ensureWorkspace(twinnyHome, conversationKey) {
+    return WorkspaceManager.fromTwinnyHome(twinnyHome).ensureWorkspace(conversationKey);
+}
+function ensureDirectory(directory, field) {
+    const existing = safeLstat(directory);
+    if (existing) {
+        if (existing.isSymbolicLink()) {
+            throw new TwinnyError(`${field} must not be a symbolic link`, "WORKSPACE_SYMLINK");
+        }
+        if (!existing.isDirectory()) {
+            throw new TwinnyError(`${field} must be a directory`, "WORKSPACE_PATH_NOT_DIRECTORY");
+        }
+        return;
+    }
+    fs.mkdirSync(directory, { recursive: true });
+    const created = fs.lstatSync(directory);
+    if (created.isSymbolicLink() || !created.isDirectory()) {
+        throw new TwinnyError(`${field} must be a real directory`, "WORKSPACE_PATH_INVALID");
+    }
+}
+function safeLstat(target) {
+    try {
+        return fs.lstatSync(target);
+    }
+    catch (error) {
+        if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
+            return undefined;
+        }
+        throw error;
+    }
+}
+function assertPathInside(root, child) {
+    const relative = path.relative(root, child);
+    if (relative === "" || relative.startsWith("..") || path.isAbsolute(relative)) {
+        throw new TwinnyError("Workspace path escaped the workspaces directory", "WORKSPACE_PATH_ESCAPE");
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/workspace/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/workspace/manager.ts"],"names":[],"mappings":"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"}

package/dist/workspace/slug.d.ts

@@ -0,0 +1,8 @@
+export declare const p2pConversationKeyPrefix = "p2p_";
+export declare const groupConversationKeyPrefix = "group_";
+export declare function createP2PConversationKey(chatId: string): string;
+export declare function createGroupConversationKey(chatId: string): string;
+export declare function getP2PChatIdFromConversationKey(conversationKey: string): string;
+export declare function getGroupChatIdFromConversationKey(conversationKey: string): string;
+export declare function assertValidConversationKey(conversationKey: string): void;
+export declare function isValidConversationKey(conversationKey: string): boolean;

package/dist/workspace/slug.js

@@ -0,0 +1,59 @@
+import { TwinnyError } from "../errors.js";
+export const p2pConversationKeyPrefix = "p2p_";
+export const groupConversationKeyPrefix = "group_";
+export function createP2PConversationKey(chatId) {
+    assertSafePathSegment(chatId, "chatId");
+    return `${p2pConversationKeyPrefix}${chatId}`;
+}
+export function createGroupConversationKey(chatId) {
+    assertSafePathSegment(chatId, "chatId");
+    return `${groupConversationKeyPrefix}${chatId}`;
+}
+export function getP2PChatIdFromConversationKey(conversationKey) {
+    assertValidConversationKey(conversationKey);
+    if (!conversationKey.startsWith(p2pConversationKeyPrefix)) {
+        throw new TwinnyError(`conversationKey must start with ${p2pConversationKeyPrefix}`, "CONVERSATION_KEY_INVALID");
+    }
+    return conversationKey.slice(p2pConversationKeyPrefix.length);
+}
+export function getGroupChatIdFromConversationKey(conversationKey) {
+    assertValidConversationKey(conversationKey);
+    if (!conversationKey.startsWith(groupConversationKeyPrefix)) {
+        throw new TwinnyError(`conversationKey must start with ${groupConversationKeyPrefix}`, "CONVERSATION_KEY_INVALID");
+    }
+    return conversationKey.slice(groupConversationKeyPrefix.length);
+}
+export function assertValidConversationKey(conversationKey) {
+    assertSafePathSegment(conversationKey, "conversationKey");
+    const prefix = conversationKey.startsWith(p2pConversationKeyPrefix)
+        ? p2pConversationKeyPrefix
+        : conversationKey.startsWith(groupConversationKeyPrefix)
+            ? groupConversationKeyPrefix
+            : undefined;
+    if (!prefix) {
+        throw new TwinnyError(`conversationKey must start with ${p2pConversationKeyPrefix} or ${groupConversationKeyPrefix}`, "CONVERSATION_KEY_INVALID");
+    }
+    const chatId = conversationKey.slice(prefix.length);
+    assertSafePathSegment(chatId, "chatId");
+}
+export function isValidConversationKey(conversationKey) {
+    try {
+        assertValidConversationKey(conversationKey);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function assertSafePathSegment(value, field) {
+    if (value.length === 0) {
+        throw new TwinnyError(`${field} must not be empty`, "WORKSPACE_KEY_EMPTY");
+    }
+    if (value.includes("/") || value.includes("\\")) {
+        throw new TwinnyError(`${field} must not contain slashes`, "WORKSPACE_KEY_SLASH");
+    }
+    if (value === "." || value.includes("..")) {
+        throw new TwinnyError(`${field} must not contain dot traversal`, "WORKSPACE_KEY_DOT_SEGMENT");
+    }
+}
+//# sourceMappingURL=slug.js.map

package/dist/workspace/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../src/workspace/slug.ts"],"names":[],"mappings":"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"}

package/migrations/0001_initial.sql

@@ -0,0 +1,102 @@
+CREATE TABLE conversations (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  conversation_key TEXT NOT NULL UNIQUE,
+  type TEXT NOT NULL,
+  chat_id TEXT NOT NULL,
+  name TEXT NOT NULL,
+  profile TEXT NOT NULL,
+  thread_id TEXT NOT NULL,
+  workspace TEXT NOT NULL,
+  profile_codex_home TEXT NOT NULL,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  response_mode TEXT NOT NULL DEFAULT 'all'
+);
+
+CREATE INDEX idx_conversations_type_chat_id ON conversations(type, chat_id);
+CREATE INDEX idx_conversations_thread_id ON conversations(thread_id);
+CREATE INDEX idx_conversations_profile ON conversations(profile);
+
+CREATE TABLE threads (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  thread_id TEXT NOT NULL UNIQUE,
+  conversation_key TEXT NOT NULL,
+  lark_thread_id TEXT,
+  profile TEXT NOT NULL,
+  forked_from_thread_id TEXT,
+  forked_at INTEGER,
+  total_tokens INTEGER NOT NULL DEFAULT 0,
+  token_usage_json TEXT NOT NULL DEFAULT '{}',
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  creator_open_id TEXT,
+  card_message_id TEXT,
+  input_tokens INTEGER NOT NULL DEFAULT 0,
+  output_tokens INTEGER NOT NULL DEFAULT 0,
+  cached_input_tokens INTEGER NOT NULL DEFAULT 0,
+  reasoning_output_tokens INTEGER NOT NULL DEFAULT 0,
+  context_tokens INTEGER NOT NULL DEFAULT 0,
+  context_window INTEGER NOT NULL DEFAULT 0,
+  thread_has_rollout INTEGER NOT NULL DEFAULT 1,
+  mode TEXT NOT NULL DEFAULT 'default' CHECK(mode IN ('default', 'plan')),
+  status TEXT NOT NULL DEFAULT 'idle' CHECK(status IN ('idle', 'working', 'waiting')),
+  name TEXT NOT NULL DEFAULT '新会话',
+  goal_status TEXT NOT NULL DEFAULT 'none' CHECK(goal_status IN ('none', 'active', 'paused', 'blocked', 'usageLimited', 'budgetLimited', 'complete')),
+  goal_updated_at INTEGER,
+  model TEXT,
+  effort TEXT
+);
+
+CREATE INDEX idx_threads_conversation_key ON threads(conversation_key);
+CREATE UNIQUE INDEX idx_threads_conversation_lark_thread
+  ON threads(conversation_key, lark_thread_id)
+  WHERE lark_thread_id IS NOT NULL;
+
+CREATE TABLE lark_messages (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  lark_message_id TEXT,
+  event_id TEXT NOT NULL,
+  lark_user_id TEXT NOT NULL,
+  lark_group_id TEXT,
+  lark_thread_id TEXT,
+  conversation_key TEXT,
+  thread_id TEXT,
+  codex_turn_id TEXT,
+  route_kind TEXT NOT NULL,
+  status TEXT NOT NULL,
+  text TEXT NOT NULL,
+  lark_create_time INTEGER,
+  received_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  processing_started_at INTEGER,
+  completed_at INTEGER,
+  failed_at INTEGER,
+  cleared_at INTEGER,
+  raw_event_json TEXT,
+  side_id INTEGER,
+  agent_card_message_id TEXT,
+  input_tokens INTEGER NOT NULL DEFAULT 0,
+  output_tokens INTEGER NOT NULL DEFAULT 0,
+  cached_input_tokens INTEGER NOT NULL DEFAULT 0,
+  reasoning_output_tokens INTEGER NOT NULL DEFAULT 0,
+  token_usage_json TEXT NOT NULL DEFAULT '{}'
+);
+
+CREATE UNIQUE INDEX idx_lark_messages_event_id
+  ON lark_messages(event_id);
+CREATE UNIQUE INDEX idx_lark_messages_lark_message_id
+  ON lark_messages(lark_message_id)
+  WHERE lark_message_id IS NOT NULL;
+CREATE INDEX idx_lark_messages_conversation_route
+  ON lark_messages(conversation_key, route_kind);
+CREATE INDEX idx_lark_messages_conversation_turn
+  ON lark_messages(conversation_key, thread_id, codex_turn_id, processing_started_at)
+  WHERE thread_id IS NOT NULL
+    AND codex_turn_id IS NOT NULL
+    AND processing_started_at IS NOT NULL
+    AND route_kind <> 'side_message';
+CREATE UNIQUE INDEX idx_lark_messages_card_action_event_id
+  ON lark_messages(event_id)
+  WHERE route_kind = 'card_action';
+CREATE INDEX idx_lark_messages_thread_turn
+  ON lark_messages(thread_id, codex_turn_id);