@foxden-app/foxclaw 0.5.8 → 0.5.10

package/dist/i18n.d.ts

@@ -103,6 +103,7 @@ declare const MESSAGES: {
         readonly status_sync_on_turn_complete: "Sync on turn complete: {value}";
         readonly status_pending_approvals: "Pending approvals: {value}";
         readonly status_pending_user_inputs: "Pending questions: {value}";
+        readonly status_queued_turns: "Queued turns: {value}";
         readonly status_active_turns: "Active turns: {value}";
         readonly status_codex_account: "Codex account: {value}";
         readonly status_codex_plan: "Codex plan: {value}";
@@ -133,6 +134,7 @@ declare const MESSAGES: {
         readonly status_last_codex_update: "Last Codex update: {value}";
         readonly update_started: "FoxClaw update started. I will report here after installation, checks, and service restart complete.";
         readonly update_succeeded: "FoxClaw updated and restarted: {from} -> {to}.";
+        readonly update_changes_title: "What changed:";
         readonly update_codex_result: "Codex CLI: {from} -> {to}.";
         readonly update_failed: "FoxClaw update failed: {error}\nRun foxclaw update in a terminal for details.";
         readonly update_unavailable: "Self-update is unavailable in this runtime. Run foxclaw update in a terminal.";
@@ -254,8 +256,18 @@ declare const MESSAGES: {
         readonly watch_read_only_active: "This chat is watching that turn read-only. Use approval commands if needed, or /unwatch before sending a new prompt.";
         readonly watch_not_enabled: "This chat is not watching any thread.";
         readonly watch_stopped: "Stopped watching thread {threadId}.";
-        readonly queued_prompt_set: "Queued. I will send it after the current turn finishes.";
+        readonly queued_prompt_set: "Queued #{position} ({id}). I will send it after the current turn finishes.";
         readonly queued_prompt_replaced: "Replaced the queued prompt. I will send the new one after the current turn finishes.";
+        readonly attachment_batch_staged: "Attachments staged: {count}. Send the prompt text to use them, or choose an action below.";
+        readonly attachment_batch_caption: "Caption: {value}";
+        readonly attachment_batch_consumed: "Attachments attached to the next Codex turn.";
+        readonly attachment_batch_queued: "Attachments queued as turn #{position} ({id}). I will send it after the current turn finishes.";
+        readonly attachment_batch_cleared: "Attachment batch cleared.";
+        readonly attachment_batch_missing: "This attachment batch is no longer active.";
+        readonly attachment_batch_mismatch: "This attachment batch does not match this message.";
+        readonly attachment_batch_default_prompt: "Analyze these attachments.";
+        readonly attachment_batch_button_analyze: "Analyze";
+        readonly attachment_batch_button_clear: "Clear";
         readonly bound_to_thread: "Bound to thread {threadId}";
         readonly line_title: "Title: {value}";
         readonly line_cwd: "CWD: {value}";
@@ -744,6 +756,7 @@ declare const MESSAGES: {
         readonly status_sync_on_turn_complete: "回复完成后同步：{value}";
         readonly status_pending_approvals: "待审批：{value}";
         readonly status_pending_user_inputs: "待确认问题：{value}";
+        readonly status_queued_turns: "排队中的回复：{value}";
         readonly status_active_turns: "进行中的回复：{value}";
         readonly status_codex_account: "Codex 账号：{value}";
         readonly status_codex_plan: "Codex 套餐：{value}";
@@ -774,6 +787,7 @@ declare const MESSAGES: {
         readonly status_last_codex_update: "最近 Codex 升级：{value}";
         readonly update_started: "已开始升级 FoxClaw。安装、自检和服务重启完成后，我会在这里回报结果。";
         readonly update_succeeded: "FoxClaw 已升级并重启：{from} -> {to}。";
+        readonly update_changes_title: "更新内容：";
         readonly update_codex_result: "Codex CLI：{from} -> {to}。";
         readonly update_failed: "FoxClaw 升级失败：{error}\n请在终端运行 foxclaw update 查看详情。";
         readonly update_unavailable: "当前运行方式不支持自升级，请在终端运行 foxclaw update。";
@@ -895,8 +909,18 @@ declare const MESSAGES: {
         readonly watch_read_only_active: "当前聊天正在只读观察这轮。需要审批时可用审批命令；要发送新 prompt 请先 /unwatch。";
         readonly watch_not_enabled: "当前没有正在观察的线程。";
         readonly watch_stopped: "已停止观察线程 {threadId}。";
-        readonly queued_prompt_set: "已排队。当前回复结束后我会自动发送。";
+        readonly queued_prompt_set: "已排队 #{position}（{id}）。当前回复结束后我会自动发送。";
         readonly queued_prompt_replaced: "已替换排队消息。当前回复结束后我会自动发送新的内容。";
+        readonly attachment_batch_staged: "附件已暂存：{count} 个。发送下一条文字即可带上这些附件，或使用下面的按钮。";
+        readonly attachment_batch_caption: "说明：{value}";
+        readonly attachment_batch_consumed: "附件已带入下一轮 Codex。";
+        readonly attachment_batch_queued: "附件已作为第 #{position} 个回复排队（{id}）。当前回复结束后我会自动发送。";
+        readonly attachment_batch_cleared: "已清除这组附件。";
+        readonly attachment_batch_missing: "这组附件已经不在待处理状态。";
+        readonly attachment_batch_mismatch: "这个附件按钮不属于当前消息。";
+        readonly attachment_batch_default_prompt: "分析这些附件。";
+        readonly attachment_batch_button_analyze: "分析";
+        readonly attachment_batch_button_clear: "清除";
         readonly bound_to_thread: "已绑定到线程 {threadId}";
         readonly line_title: "标题：{value}";
         readonly line_cwd: "工作目录：{value}";

package/dist/i18n.js

@@ -101,6 +101,7 @@ const MESSAGES = {
         status_sync_on_turn_complete: 'Sync on turn complete: {value}',
         status_pending_approvals: 'Pending approvals: {value}',
         status_pending_user_inputs: 'Pending questions: {value}',
+        status_queued_turns: 'Queued turns: {value}',
         status_active_turns: 'Active turns: {value}',
         status_codex_account: 'Codex account: {value}',
         status_codex_plan: 'Codex plan: {value}',
@@ -131,6 +132,7 @@ const MESSAGES = {
         status_last_codex_update: 'Last Codex update: {value}',
         update_started: 'FoxClaw update started. I will report here after installation, checks, and service restart complete.',
         update_succeeded: 'FoxClaw updated and restarted: {from} -> {to}.',
+        update_changes_title: 'What changed:',
         update_codex_result: 'Codex CLI: {from} -> {to}.',
         update_failed: 'FoxClaw update failed: {error}\nRun foxclaw update in a terminal for details.',
         update_unavailable: 'Self-update is unavailable in this runtime. Run foxclaw update in a terminal.',
@@ -252,8 +254,18 @@ const MESSAGES = {
         watch_read_only_active: 'This chat is watching that turn read-only. Use approval commands if needed, or /unwatch before sending a new prompt.',
         watch_not_enabled: 'This chat is not watching any thread.',
         watch_stopped: 'Stopped watching thread {threadId}.',
-        queued_prompt_set: 'Queued. I will send it after the current turn finishes.',
+        queued_prompt_set: 'Queued #{position} ({id}). I will send it after the current turn finishes.',
         queued_prompt_replaced: 'Replaced the queued prompt. I will send the new one after the current turn finishes.',
+        attachment_batch_staged: 'Attachments staged: {count}. Send the prompt text to use them, or choose an action below.',
+        attachment_batch_caption: 'Caption: {value}',
+        attachment_batch_consumed: 'Attachments attached to the next Codex turn.',
+        attachment_batch_queued: 'Attachments queued as turn #{position} ({id}). I will send it after the current turn finishes.',
+        attachment_batch_cleared: 'Attachment batch cleared.',
+        attachment_batch_missing: 'This attachment batch is no longer active.',
+        attachment_batch_mismatch: 'This attachment batch does not match this message.',
+        attachment_batch_default_prompt: 'Analyze these attachments.',
+        attachment_batch_button_analyze: 'Analyze',
+        attachment_batch_button_clear: 'Clear',
         bound_to_thread: 'Bound to thread {threadId}',
         line_title: 'Title: {value}',
         line_cwd: 'CWD: {value}',
@@ -742,6 +754,7 @@ const MESSAGES = {
         status_sync_on_turn_complete: '回复完成后同步：{value}',
         status_pending_approvals: '待审批：{value}',
         status_pending_user_inputs: '待确认问题：{value}',
+        status_queued_turns: '排队中的回复：{value}',
         status_active_turns: '进行中的回复：{value}',
         status_codex_account: 'Codex 账号：{value}',
         status_codex_plan: 'Codex 套餐：{value}',
@@ -772,6 +785,7 @@ const MESSAGES = {
         status_last_codex_update: '最近 Codex 升级：{value}',
         update_started: '已开始升级 FoxClaw。安装、自检和服务重启完成后，我会在这里回报结果。',
         update_succeeded: 'FoxClaw 已升级并重启：{from} -> {to}。',
+        update_changes_title: '更新内容：',
         update_codex_result: 'Codex CLI：{from} -> {to}。',
         update_failed: 'FoxClaw 升级失败：{error}\n请在终端运行 foxclaw update 查看详情。',
         update_unavailable: '当前运行方式不支持自升级，请在终端运行 foxclaw update。',
@@ -893,8 +907,18 @@ const MESSAGES = {
         watch_read_only_active: '当前聊天正在只读观察这轮。需要审批时可用审批命令；要发送新 prompt 请先 /unwatch。',
         watch_not_enabled: '当前没有正在观察的线程。',
         watch_stopped: '已停止观察线程 {threadId}。',
-        queued_prompt_set: '已排队。当前回复结束后我会自动发送。',
+        queued_prompt_set: '已排队 #{position}（{id}）。当前回复结束后我会自动发送。',
         queued_prompt_replaced: '已替换排队消息。当前回复结束后我会自动发送新的内容。',
+        attachment_batch_staged: '附件已暂存：{count} 个。发送下一条文字即可带上这些附件，或使用下面的按钮。',
+        attachment_batch_caption: '说明：{value}',
+        attachment_batch_consumed: '附件已带入下一轮 Codex。',
+        attachment_batch_queued: '附件已作为第 #{position} 个回复排队（{id}）。当前回复结束后我会自动发送。',
+        attachment_batch_cleared: '已清除这组附件。',
+        attachment_batch_missing: '这组附件已经不在待处理状态。',
+        attachment_batch_mismatch: '这个附件按钮不属于当前消息。',
+        attachment_batch_default_prompt: '分析这些附件。',
+        attachment_batch_button_analyze: '分析',
+        attachment_batch_button_clear: '清除',
         bound_to_thread: '已绑定到线程 {threadId}',
         line_title: '标题：{value}',
         line_cwd: '工作目录：{value}',

package/dist/main.js

@@ -289,6 +289,7 @@ async function runServeCli() {
                     currentBindings: store.countBindings(),
                     pendingApprovals: store.countPendingApprovals(),
                     pendingUserInputs: store.countPendingUserInputs(),
+                    queuedTurns: store.countQueuedTurnInputs(),
                     activeTurns: statuses.reduce((sum, status) => sum + status.activeTurns, 0)
                         + (weixinStatus?.activeTurns ?? 0),
                     lastError: statuses.find((status) => status.lastError)?.lastError
@@ -585,6 +586,7 @@ async function runServeCli() {
                 currentBindings: 0,
                 pendingApprovals: 0,
                 pendingUserInputs: 0,
+                queuedTurns: 0,
                 activeTurns: 0,
                 lastError: null,
                 updatedAt: new Date().toISOString(),
@@ -1132,6 +1134,7 @@ function runDoctorChecks() {
     warnIfProxyEnvMissingFromLoadedEnv();
     warnIfProxyConfigNeedsAttention();
     warnIfInstalledServiceNodeLooksWrong();
+    warnIfSystemdUserLingerDisabled();
     return passed;
 }
 function warnIfProxyConfigNeedsAttention() {
@@ -1204,6 +1207,21 @@ function warnIfInstalledServiceNodeLooksWrong() {
     console.log(`[WARN] installed service node is older than 24: ${nodePath}${version ? ` (${version})` : ''}`);
     console.log('[WARN] Run foxclaw start from a Node 24 shell to refresh the service unit.');
 }
+function warnIfSystemdUserLingerDisabled() {
+    if (process.platform !== 'linux' || !hasCommand('loginctl')) {
+        return;
+    }
+    const user = currentServiceUser();
+    const linger = readSystemdUserLinger(user);
+    if (linger === 'enabled') {
+        console.log(`[OK] systemd user linger enabled: ${user}`);
+        return;
+    }
+    if (linger === 'disabled') {
+        console.log(`[WARN] systemd user linger is disabled for ${user}; user services may stop after logout.`);
+        console.log('[WARN] Run foxclaw start to let FoxClaw enable it, or run: sudo loginctl enable-linger "$USER"');
+    }
+}
 function extractNodePathFromExecStart(execStart) {
     const tokens = execStart.split(/\s+/).map(systemdUnescape).filter(Boolean);
     const directNode = tokens[0] || '';
@@ -1262,6 +1280,7 @@ function installSystemd() {
             console.log(`[OK] updated FoxClaw ExecStart override: ${update.path}`);
         }
     }
+    ensureSystemdUserLingerEnabled();
     spawnChecked('systemctl', ['--user', 'daemon-reload']);
     spawnChecked('systemctl', ['--user', 'enable', unitName]);
     const restarted = spawnSync('systemctl', ['--user', 'restart', unitName], { stdio: 'inherit' });
@@ -1272,6 +1291,32 @@ function installSystemd() {
     console.log(`Status: systemctl --user status ${unitName}`);
     console.log(`Logs:   journalctl --user -u ${unitName} -f`);
 }
+function ensureSystemdUserLingerEnabled() {
+    if (process.platform !== 'linux') {
+        return;
+    }
+    if (!hasCommand('loginctl')) {
+        console.log('[WARN] loginctl not found; cannot enable systemd user linger automatically.');
+        return;
+    }
+    const user = currentServiceUser();
+    const before = readSystemdUserLinger(user);
+    if (before === 'enabled') {
+        console.log(`[OK] systemd user linger enabled: ${user}`);
+        return;
+    }
+    console.log(`[INFO] Enabling systemd user linger for ${user} so FoxClaw keeps running after logout.`);
+    let result = spawnSync('loginctl', ['enable-linger', user], { stdio: 'inherit' });
+    if (result.status !== 0 && hasCommand('sudo')) {
+        result = spawnSync('sudo', ['-n', 'loginctl', 'enable-linger', user], { stdio: 'inherit' });
+    }
+    if (result.status === 0 && readSystemdUserLinger(user) === 'enabled') {
+        console.log(`[OK] systemd user linger enabled: ${user}`);
+        return;
+    }
+    console.log(`[WARN] Could not enable systemd user linger automatically for ${user}.`);
+    console.log(`[WARN] FoxClaw is installed, but it may stop after logout until you run: sudo loginctl enable-linger ${shellQuote(user)}`);
+}
 function uninstallSystemd() {
     if (!hasCommand('systemctl')) {
         console.error('systemctl not found');
@@ -1392,6 +1437,36 @@ function buildServicePath(nodeDir) {
 function serviceEnvPath() {
     return path.resolve(process.env.FOXCLAW_ENV?.trim() || getLoadedEnvPath() || DEFAULT_ENV_PATH);
 }
+function currentServiceUser() {
+    return process.env.USER?.trim()
+        || process.env.LOGNAME?.trim()
+        || os.userInfo().username;
+}
+function readSystemdUserLinger(user) {
+    const valueResult = spawnSync('loginctl', ['show-user', user, '-p', 'Linger', '--value'], { encoding: 'utf8' });
+    if (valueResult.status === 0) {
+        return parseSystemdUserLinger(valueResult.stdout);
+    }
+    const propertyResult = spawnSync('loginctl', ['show-user', user, '-p', 'Linger'], { encoding: 'utf8' });
+    if (propertyResult.status === 0) {
+        return parseSystemdUserLinger(propertyResult.stdout);
+    }
+    return 'unknown';
+}
+function parseSystemdUserLinger(output) {
+    const value = output.trim().replace(/^Linger=/, '').toLowerCase();
+    if (value === 'yes')
+        return 'enabled';
+    if (value === 'no')
+        return 'disabled';
+    return 'unknown';
+}
+function shellQuote(value) {
+    if (/^[A-Za-z0-9_@%+=:,./-]+$/.test(value)) {
+        return value;
+    }
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
 function hasStandardNodeProxyEnv() {
     return STANDARD_NODE_PROXY_ENV_KEYS.some((key) => Boolean(proxyEnvValue(key)));
 }

package/dist/store/database.d.ts

@@ -1,4 +1,4 @@
-import type { AccessPresetValue, ActiveTurnMessageMode, AppLocale, CachedThread, ChatSessionSettings, CollaborationModeValue, PendingApprovalRecord, ReasoningEffortValue, ThreadBinding } from '../types.js';
+import type { AccessPresetValue, ActiveTurnMessageMode, AppLocale, CachedThread, ChatSessionSettings, CollaborationModeValue, GuidedPlanSessionRecord, GuidedPlanSessionState, PendingAttachmentBatchRecord, PendingAttachmentBatchStatus, PendingApprovalRecord, QueuedTurnInputRecord, QueuedTurnInputStatus, ReasoningEffortValue, ThreadBinding } from '../types.js';
 export interface ActiveTurnPreviewRecord {
     turnId: string;
     scopeId: string;
@@ -84,10 +84,34 @@ export declare class BridgeStore {
     markPendingUserInputInterrupted(localId: string): void;
     listPendingUserInputs(): PendingUserInputStoredRecord[];
     countPendingUserInputs(): number;
+    saveQueuedTurnInput(record: QueuedTurnInputRecord): void;
+    getQueuedTurnInput(queueId: string): QueuedTurnInputRecord | null;
+    peekQueuedTurnInput(scopeId: string): QueuedTurnInputRecord | null;
+    listQueuedTurnInputs(scopeId?: string): QueuedTurnInputRecord[];
+    countQueuedTurnInputs(scopeId?: string): number;
+    updateQueuedTurnInputStatus(queueId: string, status: QueuedTurnInputStatus, error?: string | null): void;
+    cancelQueuedTurnInputs(scopeId: string): number;
+    requeueInterruptedQueuedTurnInputs(): number;
+    savePendingAttachmentBatch(record: PendingAttachmentBatchRecord): void;
+    getPendingAttachmentBatch(batchId: string): PendingAttachmentBatchRecord | null;
+    findPendingAttachmentBatchByMediaGroup(scopeId: string, mediaGroupId: string): PendingAttachmentBatchRecord | null;
+    getLatestPendingAttachmentBatch(scopeId: string): PendingAttachmentBatchRecord | null;
+    updatePendingAttachmentBatchMessage(batchId: string, messageId: number): void;
+    resolvePendingAttachmentBatch(batchId: string, status: PendingAttachmentBatchStatus): void;
+    clearPendingAttachmentBatches(scopeId: string): number;
+    saveGuidedPlanSession(record: GuidedPlanSessionRecord): void;
+    getGuidedPlanSession(sessionId: string): GuidedPlanSessionRecord | null;
+    findOpenGuidedPlanSession(scopeId: string, turnId?: string): GuidedPlanSessionRecord | null;
+    listOpenGuidedPlanSessions(): GuidedPlanSessionRecord[];
+    updateGuidedPlanSessionMessage(sessionId: string, messageId: number): void;
+    updateGuidedPlanSessionState(sessionId: string, state: GuidedPlanSessionState): void;
     insertAudit(direction: 'inbound' | 'outbound', chatId: string, eventType: string, summary: string): void;
     close(): void;
     private mapApproval;
     private mapPendingUserInput;
+    private mapQueuedTurnInput;
+    private mapPendingAttachmentBatch;
+    private mapGuidedPlanSession;
     private writeChatSettings;
     getWeixinContextToken(scopeId: string): string | null;
     setWeixinContextToken(scopeId: string, contextToken: string): void;

package/dist/store/database.js

@@ -98,6 +98,61 @@ export class BridgeStore {
         created_at INTEGER NOT NULL,
         PRIMARY KEY (input_local_id, question_index, message_kind)
       );
+      CREATE TABLE IF NOT EXISTS queued_turn_inputs (
+        queue_id TEXT PRIMARY KEY,
+        scope_id TEXT NOT NULL,
+        chat_id TEXT NOT NULL,
+        chat_type TEXT NOT NULL,
+        topic_id INTEGER,
+        thread_id TEXT NOT NULL,
+        input_json TEXT NOT NULL,
+        source_summary TEXT NOT NULL,
+        message_id INTEGER,
+        status TEXT NOT NULL,
+        error TEXT,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL,
+        resolved_at INTEGER
+      );
+      CREATE INDEX IF NOT EXISTS queued_turn_inputs_scope_status_idx
+        ON queued_turn_inputs(scope_id, status, created_at);
+      CREATE TABLE IF NOT EXISTS pending_attachment_batches (
+        batch_id TEXT PRIMARY KEY,
+        scope_id TEXT NOT NULL,
+        chat_id TEXT NOT NULL,
+        chat_type TEXT NOT NULL,
+        topic_id INTEGER,
+        thread_id TEXT NOT NULL,
+        cwd TEXT,
+        media_group_id TEXT,
+        attachments_json TEXT NOT NULL,
+        caption TEXT NOT NULL,
+        message_id INTEGER,
+        status TEXT NOT NULL,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL,
+        resolved_at INTEGER
+      );
+      CREATE INDEX IF NOT EXISTS pending_attachment_batches_scope_status_idx
+        ON pending_attachment_batches(scope_id, status, updated_at);
+      CREATE TABLE IF NOT EXISTS guided_plan_sessions (
+        session_id TEXT PRIMARY KEY,
+        scope_id TEXT NOT NULL,
+        chat_id TEXT NOT NULL,
+        chat_type TEXT NOT NULL,
+        topic_id INTEGER,
+        thread_id TEXT NOT NULL,
+        turn_id TEXT NOT NULL,
+        cwd TEXT,
+        plan_markdown TEXT NOT NULL,
+        message_id INTEGER,
+        state TEXT NOT NULL,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL,
+        resolved_at INTEGER
+      );
+      CREATE INDEX IF NOT EXISTS guided_plan_sessions_scope_state_idx
+        ON guided_plan_sessions(scope_id, state, updated_at);
       CREATE TABLE IF NOT EXISTS audit_logs (
         id INTEGER PRIMARY KEY AUTOINCREMENT,
         direction TEXT NOT NULL,
@@ -438,6 +493,204 @@ export class BridgeStore {
         const row = this.db.prepare('SELECT COUNT(*) AS count FROM pending_user_inputs WHERE resolved_at IS NULL').get();
         return Number(row?.count ?? 0);
     }
+    saveQueuedTurnInput(record) {
+        this.db.prepare(`
+      INSERT INTO queued_turn_inputs (
+        queue_id, scope_id, chat_id, chat_type, topic_id, thread_id, input_json, source_summary,
+        message_id, status, error, created_at, updated_at, resolved_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(queue_id) DO UPDATE SET
+        scope_id = excluded.scope_id,
+        chat_id = excluded.chat_id,
+        chat_type = excluded.chat_type,
+        topic_id = excluded.topic_id,
+        thread_id = excluded.thread_id,
+        input_json = excluded.input_json,
+        source_summary = excluded.source_summary,
+        message_id = excluded.message_id,
+        status = excluded.status,
+        error = excluded.error,
+        created_at = excluded.created_at,
+        updated_at = excluded.updated_at,
+        resolved_at = excluded.resolved_at
+    `).run(record.queueId, record.scopeId, record.chatId, record.chatType, record.topicId, record.threadId, record.inputJson, record.sourceSummary, record.messageId, record.status, record.error, record.createdAt, record.updatedAt, record.resolvedAt);
+    }
+    getQueuedTurnInput(queueId) {
+        const row = this.db.prepare('SELECT * FROM queued_turn_inputs WHERE queue_id = ?').get(queueId);
+        return row ? this.mapQueuedTurnInput(row) : null;
+    }
+    peekQueuedTurnInput(scopeId) {
+        const row = this.db.prepare(`
+      SELECT * FROM queued_turn_inputs
+      WHERE scope_id = ? AND status = 'queued'
+      ORDER BY created_at ASC
+      LIMIT 1
+    `).get(scopeId);
+        return row ? this.mapQueuedTurnInput(row) : null;
+    }
+    listQueuedTurnInputs(scopeId) {
+        const sql = scopeId
+            ? `SELECT * FROM queued_turn_inputs WHERE scope_id = ? AND status IN ('queued', 'processing') ORDER BY created_at ASC`
+            : `SELECT * FROM queued_turn_inputs WHERE status IN ('queued', 'processing') ORDER BY created_at ASC`;
+        const rows = scopeId
+            ? this.db.prepare(sql).all(scopeId)
+            : this.db.prepare(sql).all();
+        return rows.map((row) => this.mapQueuedTurnInput(row));
+    }
+    countQueuedTurnInputs(scopeId) {
+        const row = scopeId
+            ? this.db.prepare(`SELECT COUNT(*) AS count FROM queued_turn_inputs WHERE scope_id = ? AND status IN ('queued', 'processing')`).get(scopeId)
+            : this.db.prepare(`SELECT COUNT(*) AS count FROM queued_turn_inputs WHERE status IN ('queued', 'processing')`).get();
+        return Number(row?.count ?? 0);
+    }
+    updateQueuedTurnInputStatus(queueId, status, error = null) {
+        const resolvedAt = status === 'queued' || status === 'processing' ? null : Date.now();
+        this.db.prepare(`
+      UPDATE queued_turn_inputs
+      SET status = ?, error = ?, updated_at = ?, resolved_at = ?
+      WHERE queue_id = ?
+    `).run(status, error, Date.now(), resolvedAt, queueId);
+    }
+    cancelQueuedTurnInputs(scopeId) {
+        const result = this.db.prepare(`
+      UPDATE queued_turn_inputs
+      SET status = 'cancelled', updated_at = ?, resolved_at = ?
+      WHERE scope_id = ? AND status = 'queued'
+    `).run(Date.now(), Date.now(), scopeId);
+        return Number(result.changes ?? 0);
+    }
+    requeueInterruptedQueuedTurnInputs() {
+        const result = this.db.prepare(`
+      UPDATE queued_turn_inputs
+      SET status = 'queued', error = NULL, updated_at = ?, resolved_at = NULL
+      WHERE status = 'processing'
+    `).run(Date.now());
+        return Number(result.changes ?? 0);
+    }
+    savePendingAttachmentBatch(record) {
+        this.db.prepare(`
+      INSERT INTO pending_attachment_batches (
+        batch_id, scope_id, chat_id, chat_type, topic_id, thread_id, cwd, media_group_id,
+        attachments_json, caption, message_id, status, created_at, updated_at, resolved_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(batch_id) DO UPDATE SET
+        scope_id = excluded.scope_id,
+        chat_id = excluded.chat_id,
+        chat_type = excluded.chat_type,
+        topic_id = excluded.topic_id,
+        thread_id = excluded.thread_id,
+        cwd = excluded.cwd,
+        media_group_id = excluded.media_group_id,
+        attachments_json = excluded.attachments_json,
+        caption = excluded.caption,
+        message_id = excluded.message_id,
+        status = excluded.status,
+        created_at = excluded.created_at,
+        updated_at = excluded.updated_at,
+        resolved_at = excluded.resolved_at
+    `).run(record.batchId, record.scopeId, record.chatId, record.chatType, record.topicId, record.threadId, record.cwd, record.mediaGroupId, record.attachmentsJson, record.caption, record.messageId, record.status, record.createdAt, record.updatedAt, record.resolvedAt);
+    }
+    getPendingAttachmentBatch(batchId) {
+        const row = this.db.prepare('SELECT * FROM pending_attachment_batches WHERE batch_id = ?').get(batchId);
+        return row ? this.mapPendingAttachmentBatch(row) : null;
+    }
+    findPendingAttachmentBatchByMediaGroup(scopeId, mediaGroupId) {
+        const row = this.db.prepare(`
+      SELECT * FROM pending_attachment_batches
+      WHERE scope_id = ? AND media_group_id = ? AND status = 'pending'
+      ORDER BY updated_at DESC
+      LIMIT 1
+    `).get(scopeId, mediaGroupId);
+        return row ? this.mapPendingAttachmentBatch(row) : null;
+    }
+    getLatestPendingAttachmentBatch(scopeId) {
+        const row = this.db.prepare(`
+      SELECT * FROM pending_attachment_batches
+      WHERE scope_id = ? AND status = 'pending'
+      ORDER BY updated_at DESC
+      LIMIT 1
+    `).get(scopeId);
+        return row ? this.mapPendingAttachmentBatch(row) : null;
+    }
+    updatePendingAttachmentBatchMessage(batchId, messageId) {
+        this.db.prepare('UPDATE pending_attachment_batches SET message_id = ?, updated_at = ? WHERE batch_id = ?').run(messageId, Date.now(), batchId);
+    }
+    resolvePendingAttachmentBatch(batchId, status) {
+        this.db.prepare(`
+      UPDATE pending_attachment_batches
+      SET status = ?, updated_at = ?, resolved_at = ?
+      WHERE batch_id = ?
+    `).run(status, Date.now(), Date.now(), batchId);
+    }
+    clearPendingAttachmentBatches(scopeId) {
+        const result = this.db.prepare(`
+      UPDATE pending_attachment_batches
+      SET status = 'cleared', updated_at = ?, resolved_at = ?
+      WHERE scope_id = ? AND status = 'pending'
+    `).run(Date.now(), Date.now(), scopeId);
+        return Number(result.changes ?? 0);
+    }
+    saveGuidedPlanSession(record) {
+        this.db.prepare(`
+      INSERT INTO guided_plan_sessions (
+        session_id, scope_id, chat_id, chat_type, topic_id, thread_id, turn_id, cwd,
+        plan_markdown, message_id, state, created_at, updated_at, resolved_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(session_id) DO UPDATE SET
+        scope_id = excluded.scope_id,
+        chat_id = excluded.chat_id,
+        chat_type = excluded.chat_type,
+        topic_id = excluded.topic_id,
+        thread_id = excluded.thread_id,
+        turn_id = excluded.turn_id,
+        cwd = excluded.cwd,
+        plan_markdown = excluded.plan_markdown,
+        message_id = excluded.message_id,
+        state = excluded.state,
+        created_at = excluded.created_at,
+        updated_at = excluded.updated_at,
+        resolved_at = excluded.resolved_at
+    `).run(record.sessionId, record.scopeId, record.chatId, record.chatType, record.topicId, record.threadId, record.turnId, record.cwd, record.planMarkdown, record.messageId, record.state, record.createdAt, record.updatedAt, record.resolvedAt);
+    }
+    getGuidedPlanSession(sessionId) {
+        const row = this.db.prepare('SELECT * FROM guided_plan_sessions WHERE session_id = ?').get(sessionId);
+        return row ? this.mapGuidedPlanSession(row) : null;
+    }
+    findOpenGuidedPlanSession(scopeId, turnId) {
+        const row = turnId
+            ? this.db.prepare(`
+          SELECT * FROM guided_plan_sessions
+          WHERE scope_id = ? AND turn_id = ? AND state = 'awaiting_confirmation'
+          ORDER BY updated_at DESC
+          LIMIT 1
+        `).get(scopeId, turnId)
+            : this.db.prepare(`
+          SELECT * FROM guided_plan_sessions
+          WHERE scope_id = ? AND state = 'awaiting_confirmation'
+          ORDER BY updated_at DESC
+          LIMIT 1
+        `).get(scopeId);
+        return row ? this.mapGuidedPlanSession(row) : null;
+    }
+    listOpenGuidedPlanSessions() {
+        const rows = this.db.prepare(`
+      SELECT * FROM guided_plan_sessions
+      WHERE state = 'awaiting_confirmation'
+      ORDER BY updated_at ASC
+    `).all();
+        return rows.map((row) => this.mapGuidedPlanSession(row));
+    }
+    updateGuidedPlanSessionMessage(sessionId, messageId) {
+        this.db.prepare('UPDATE guided_plan_sessions SET message_id = ?, updated_at = ? WHERE session_id = ?').run(messageId, Date.now(), sessionId);
+    }
+    updateGuidedPlanSessionState(sessionId, state) {
+        const resolvedAt = state === 'awaiting_confirmation' || state === 'executing' ? null : Date.now();
+        this.db.prepare(`
+      UPDATE guided_plan_sessions
+      SET state = ?, updated_at = ?, resolved_at = ?
+      WHERE session_id = ?
+    `).run(state, Date.now(), resolvedAt, sessionId);
+    }
     insertAudit(direction, chatId, eventType, summary) {
         this.db.prepare('INSERT INTO audit_logs (direction, chat_id, event_type, summary, created_at) VALUES (?, ?, ?, ?, ?)').run(direction, chatId, eventType, summary, Date.now());
     }
@@ -482,6 +735,61 @@ export class BridgeStore {
             resolvedAt: row.resolved_at === null ? null : Number(row.resolved_at),
         };
     }
+    mapQueuedTurnInput(row) {
+        return {
+            queueId: String(row.queue_id),
+            scopeId: String(row.scope_id),
+            chatId: String(row.chat_id),
+            chatType: String(row.chat_type),
+            topicId: row.topic_id === null ? null : Number(row.topic_id),
+            threadId: String(row.thread_id),
+            inputJson: String(row.input_json),
+            sourceSummary: String(row.source_summary),
+            messageId: row.message_id === null ? null : Number(row.message_id),
+            status: normalizeQueuedTurnInputStatus(row.status),
+            error: row.error === null ? null : String(row.error),
+            createdAt: Number(row.created_at),
+            updatedAt: Number(row.updated_at),
+            resolvedAt: row.resolved_at === null ? null : Number(row.resolved_at),
+        };
+    }
+    mapPendingAttachmentBatch(row) {
+        return {
+            batchId: String(row.batch_id),
+            scopeId: String(row.scope_id),
+            chatId: String(row.chat_id),
+            chatType: String(row.chat_type),
+            topicId: row.topic_id === null ? null : Number(row.topic_id),
+            threadId: String(row.thread_id),
+            cwd: row.cwd === null ? null : String(row.cwd),
+            mediaGroupId: row.media_group_id === null ? null : String(row.media_group_id),
+            attachmentsJson: String(row.attachments_json),
+            caption: String(row.caption ?? ''),
+            messageId: row.message_id === null ? null : Number(row.message_id),
+            status: normalizePendingAttachmentBatchStatus(row.status),
+            createdAt: Number(row.created_at),
+            updatedAt: Number(row.updated_at),
+            resolvedAt: row.resolved_at === null ? null : Number(row.resolved_at),
+        };
+    }
+    mapGuidedPlanSession(row) {
+        return {
+            sessionId: String(row.session_id),
+            scopeId: String(row.scope_id),
+            chatId: String(row.chat_id),
+            chatType: String(row.chat_type),
+            topicId: row.topic_id === null ? null : Number(row.topic_id),
+            threadId: String(row.thread_id),
+            turnId: String(row.turn_id),
+            cwd: row.cwd === null ? null : String(row.cwd),
+            planMarkdown: String(row.plan_markdown),
+            messageId: row.message_id === null ? null : Number(row.message_id),
+            state: normalizeGuidedPlanSessionState(row.state),
+            createdAt: Number(row.created_at),
+            updatedAt: Number(row.updated_at),
+            resolvedAt: row.resolved_at === null ? null : Number(row.resolved_at),
+        };
+    }
     writeChatSettings(chatId, model, reasoningEffort, locale, accessPreset, collaborationMode, serviceTier, activeTurnMessageMode) {
         this.db.prepare(`
       INSERT INTO chat_settings (chat_id, model, reasoning_effort, locale, access_preset, collaboration_mode, service_tier, active_turn_message_mode, updated_at)
@@ -615,3 +923,16 @@ function normalizeCollaborationMode(value) {
 function normalizeActiveTurnMessageMode(value) {
     return value === 'steer' || value === 'queue' ? value : null;
 }
+function normalizeQueuedTurnInputStatus(value) {
+    return value === 'processing' || value === 'completed' || value === 'cancelled' || value === 'failed'
+        ? value
+        : 'queued';
+}
+function normalizePendingAttachmentBatchStatus(value) {
+    return value === 'consumed' || value === 'cleared' ? value : 'pending';
+}
+function normalizeGuidedPlanSessionState(value) {
+    return value === 'executing' || value === 'cancelled' || value === 'completed'
+        ? value
+        : 'awaiting_confirmation';
+}

package/dist/telegram/gateway.d.ts

@@ -12,6 +12,7 @@ export interface TelegramTextEvent {
     userId: string;
     text: string;
     messageId: number;
+    mediaGroupId?: string | null;
     attachments: TelegramInboundAttachment[];
     entities: TelegramMessageEntity[];
     replyToBot: boolean;

package/dist/telegram/gateway.js

@@ -245,6 +245,7 @@ export class TelegramGateway extends EventEmitter {
                     userId: String(update.message.from.id),
                     text,
                     messageId: update.message.message_id,
+                    mediaGroupId: update.message.media_group_id ?? null,
                     attachments,
                     entities,
                     replyToBot,