@kafca/agentdock 0.1.23 → 0.1.24

package/dist-electron/services/local-ai-core/src/channel/lark/local-core-lark-gateway.js

@@ -39,6 +39,7 @@ const node_crypto_1 = require("node:crypto");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const desktop_js_1 = require("../../../../../shared/desktop.js");
+const content_js_1 = require("../shared/content.js");
 const file_utils_js_1 = require("../shared/file-utils.js");
 const cards_js_1 = require("./cards.js");
 const config_js_1 = require("./config.js");
@@ -650,7 +651,7 @@ class LocalCoreLarkGateway extends node_events_1.EventEmitter {
         }
         this.options.store.clearPlatformThreadMessageId(input.workspaceId, input.chatId, input.platformUserId);
         const wrappedText = (0, desktop_js_1.wrapUserMessageWithSchedulerProtocol)(input.text);
-        await router.sendThreadMessage(threadId, this.createThreadMessageInput(wrappedText, input.contentParts));
+        await router.sendThreadMessage(threadId, (0, content_js_1.createChannelThreadMessageInput)(wrappedText, input.contentParts));
         return { paired: true, threadId };
     }
     close() {
@@ -857,15 +858,24 @@ class LocalCoreLarkGateway extends node_events_1.EventEmitter {
                 }
             }
         }
+        if (messageType === 'file') {
+            const fileKey = String(parsedContent.file_key || '').trim();
+            if (fileKey) {
+                try {
+                    contentParts.push(await this.downloadMessageFile(workspaceId, String(message.message_id || ''), fileKey, String(parsedContent.file_name || parsedContent.name || '').trim(), instanceId));
+                }
+                catch (error) {
+                    const errorText = `[File download failed: ${error instanceof Error ? error.message : String(error)}]`;
+                    contentParts.push({ type: 'text', text: errorText });
+                    this.options.log?.(`localcore-lark file download failed for ${workspaceId}: message=${String(message.message_id || '')} fileKey=${fileKey} error=${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+        }
         if (contentParts.length === 0) {
             this.options.log?.(`localcore-lark ignored unsupported message for ${workspaceId}: type=${String(message.message_type || 'unknown')} contentKeys=${JSON.stringify(Object.keys(parsedContent))}`);
             return;
         }
-        const displayText = text || (contentParts.some((part) => part.type === 'image') ? '[Image]' : contentParts
-            .filter((part) => part.type === 'text')
-            .map((part) => part.text)
-            .join('\n\n')
-            .trim());
+        const displayText = text || this.summarizeInboundContentParts(contentParts);
         const platformUserId = String(sender.sender_id?.user_id || sender.sender_id?.open_id || '').trim();
         const chatId = String(message.chat_id || platformUserId).trim();
         if (!platformUserId || !chatId) {
@@ -887,25 +897,6 @@ class LocalCoreLarkGateway extends node_events_1.EventEmitter {
             contentParts,
         });
     }
-    createWrappedContentParts(wrappedText, parts) {
-        const nonTextParts = Array.isArray(parts)
-            ? parts.filter((part) => part.type !== 'text')
-            : [];
-        return [
-            { type: 'text', text: wrappedText },
-            ...nonTextParts,
-        ];
-    }
-    createThreadMessageInput(wrappedText, parts) {
-        const hasNonTextPart = Array.isArray(parts) && parts.some((part) => part.type !== 'text');
-        if (!hasNonTextPart) {
-            return wrappedText;
-        }
-        return {
-            displayText: wrappedText,
-            contentParts: this.createWrappedContentParts(wrappedText, parts),
-        };
-    }
     async downloadMessageImage(workspaceId, messageId, imageKey, instanceId) {
         const state = this.resolveRuntimeState(workspaceId, instanceId).state;
         if (!state?.client) {
@@ -935,6 +926,58 @@ class LocalCoreLarkGateway extends node_events_1.EventEmitter {
             fileName: `${imageKey}.${this.sniffImageExtension(buffer)}`,
         };
     }
+    async downloadMessageFile(workspaceId, messageId, fileKey, fileName, instanceId) {
+        const state = this.resolveRuntimeState(workspaceId, instanceId).state;
+        if (!state?.client) {
+            throw new Error('Lark client is not connected');
+        }
+        if (!messageId) {
+            throw new Error('Lark file message is missing message_id');
+        }
+        const resource = await state.client.im.messageResource.get({
+            path: {
+                message_id: messageId,
+                file_key: fileKey,
+            },
+            params: {
+                type: 'file',
+            },
+        });
+        const buffer = await this.readLarkResourceBuffer(resource);
+        if (buffer.length === 0) {
+            throw new Error('Lark file resource is empty');
+        }
+        return {
+            type: 'file',
+            data: buffer.toString('base64'),
+            mimeType: this.extractHeaderMimeType(resource?.headers) || 'application/octet-stream',
+            fileName: fileName || fileKey,
+            size: buffer.length,
+        };
+    }
+    summarizeInboundContentParts(parts) {
+        const text = parts
+            .filter((part) => part.type === 'text')
+            .map((part) => part.text)
+            .filter(Boolean)
+            .join('\n\n')
+            .trim();
+        if (text)
+            return text;
+        const attachmentSummary = parts
+            .map((part) => {
+            if (part.type === 'image') {
+                return '[Image]';
+            }
+            if (part.type === 'file') {
+                return part.fileName ? `[File: ${part.fileName}]` : '[File]';
+            }
+            return '';
+        })
+            .filter(Boolean)
+            .join('\n');
+        return attachmentSummary;
+    }
     async readLarkResourceBuffer(resource) {
         const readable = resource?.getReadableStream?.();
         if (!readable || typeof readable.on !== 'function') {

package/dist-electron/services/local-ai-core/src/channel/shared/content.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWrappedChannelContentParts = createWrappedChannelContentParts;
+exports.createChannelThreadMessageInput = createChannelThreadMessageInput;
+function createWrappedChannelContentParts(wrappedText, parts) {
+    const nonTextParts = Array.isArray(parts)
+        ? parts.filter((part) => part.type !== 'text')
+        : [];
+    return [
+        { type: 'text', text: wrappedText },
+        ...nonTextParts,
+    ];
+}
+function createChannelThreadMessageInput(wrappedText, parts) {
+    const hasNonTextPart = Array.isArray(parts) && parts.some((part) => part.type !== 'text');
+    if (!hasNonTextPart) {
+        return wrappedText;
+    }
+    return {
+        displayText: wrappedText,
+        contentParts: createWrappedChannelContentParts(wrappedText, parts),
+    };
+}

package/dist-electron/services/local-ai-core/src/channel/weixin/local-core-weixin-gateway.js

@@ -4,12 +4,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LocalCoreWeixinGateway = void 0;
+exports.createWeixinAttachmentContentPart = createWeixinAttachmentContentPart;
 const node_crypto_1 = __importDefault(require("node:crypto"));
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const node_events_1 = require("node:events");
 const node_crypto_2 = require("node:crypto");
 const desktop_js_1 = require("../../../../../shared/desktop.js");
+const content_js_1 = require("../shared/content.js");
 const file_utils_js_1 = require("../shared/file-utils.js");
 const config_js_1 = require("./config.js");
 const transport_js_1 = require("./transport.js");
@@ -97,6 +99,23 @@ function splitTextByUtf8Bytes(text, maxBytes) {
     pushCurrent();
     return chunks;
 }
+function createWeixinAttachmentContentPart(att) {
+    if (att.kind === 'image') {
+        if (!att.data)
+            return null;
+        return {
+            type: 'image',
+            data: att.data,
+            mimeType: att.mimeType,
+            fileName: att.name,
+        };
+    }
+    return {
+        type: 'file',
+        path: att.path,
+        fileName: att.name,
+    };
+}
 function truncateTextByUtf8Bytes(text, maxBytes) {
     const normalized = String(text || '').replace(/\r\n/g, '\n').trim();
     if (utf8ByteLength(normalized) <= maxBytes)
@@ -658,7 +677,7 @@ class LocalCoreWeixinGateway extends node_events_1.EventEmitter {
         }
         this.options.store.updatePlatformThreadMessageId(input.workspaceId, input.chatId, input.platformUserId, input.contextToken || input.messageId, platformKey);
         const wrappedText = (0, desktop_js_1.wrapUserMessageWithSchedulerProtocol)(input.text);
-        await router.sendThreadMessage(threadId, this.createThreadMessageInput(wrappedText, input.contentParts));
+        await router.sendThreadMessage(threadId, (0, content_js_1.createChannelThreadMessageInput)(wrappedText, input.contentParts));
         return { paired: true, threadId };
     }
     // ==================== Private: Bindings ====================
@@ -825,14 +844,9 @@ class LocalCoreWeixinGateway extends node_events_1.EventEmitter {
                                 if (att) {
                                     attachmentText += attachmentText ? '\n' : '';
                                     attachmentText += att.kind === 'image' ? `[Image: ${att.path}]` : `[File "${att.name}": ${att.path}]`;
-                                    if (att.kind === 'image' && att.data) {
-                                        attachmentParts.push({
-                                            type: 'image',
-                                            data: att.data,
-                                            mimeType: att.mimeType,
-                                            fileName: att.name,
-                                        });
-                                    }
+                                    const part = createWeixinAttachmentContentPart(att);
+                                    if (part)
+                                        attachmentParts.push(part);
                                 }
                             }
                             catch (dlErr) {
@@ -1017,25 +1031,6 @@ class LocalCoreWeixinGateway extends node_events_1.EventEmitter {
             mimeType: kind === 'image' ? this.mimeTypeForImageExt(ext) : undefined,
         };
     }
-    createWrappedContentParts(wrappedText, parts) {
-        const nonTextParts = Array.isArray(parts)
-            ? parts.filter((part) => part.type !== 'text')
-            : [];
-        return [
-            { type: 'text', text: wrappedText },
-            ...nonTextParts,
-        ];
-    }
-    createThreadMessageInput(wrappedText, parts) {
-        const hasNonTextPart = Array.isArray(parts) && parts.some((part) => part.type !== 'text');
-        if (!hasNonTextPart) {
-            return wrappedText;
-        }
-        return {
-            displayText: wrappedText,
-            contentParts: this.createWrappedContentParts(wrappedText, parts),
-        };
-    }
     mimeTypeForImageExt(ext) {
         if (ext === '.jpg')
             return 'image/jpeg';

package/dist-electron/services/local-ai-core/src/cli/lac.js

@@ -5,6 +5,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runCli = runCli;
 const node_process_1 = __importDefault(require("node:process"));
+const index_js_1 = require("../../../../packages/contracts/src/index.js");
+const job_id_js_1 = require("../scheduler/job-id.js");
 const DEFAULT_BASE_URL = 'http://127.0.0.1:9831/api/local/v1';
 async function runCli(argv, env = node_process_1.default.env, io = node_process_1.default) {
     try {
@@ -51,7 +53,8 @@ async function runCli(argv, env = node_process_1.default.env, io = node_process_
 async function handleChannelSendFile(flags, env, io, json) {
     const context = resolveContext(flags, env);
     const filePath = getRequiredFlag(flags, 'path');
-    const platform = getFlag(flags, 'platform') || context.platform;
+    const rawPlatform = getFlag(flags, 'platform') || context.platform;
+    const platform = rawPlatform ? (0, index_js_1.normalizeChannelPlatform)(rawPlatform) : '';
     if (!platform) {
         throw new Error('channel send-file requires a platform. Set LOCAL_AI_PLATFORM or pass --platform.');
     }
@@ -113,8 +116,8 @@ async function handleAdd(flags, env, io, json) {
         description,
         enabled: true,
     });
-    print(json, io.stdout, job, [
-        `Created scheduler job ${job.id}`,
+    print(json, io.stdout, presentJob(job), [
+        `Created scheduler job ${(0, job_id_js_1.toPublicScheduledJobId)(job.id)}`,
         `Schedule: ${job.cronExpr || ''}`,
         `Execution mode: ${job.executionMode}`,
         `Description: ${job.description}`,
@@ -132,7 +135,7 @@ async function handleList(flags, env, io, json) {
     const jobs = threadId
         ? response.jobs.filter((job) => job.route.threadId === threadId)
         : response.jobs;
-    print(json, io.stdout, { jobs }, jobs.length === 0 ? 'No scheduler jobs.' : jobs.map(formatJobLine).join('\n'));
+    print(json, io.stdout, { jobs: jobs.map(presentJob) }, jobs.length === 0 ? 'No scheduler jobs.' : jobs.map(formatJobLine).join('\n'));
     return 0;
 }
 async function handleInfo(jobId, flags, env, io, json) {
@@ -142,7 +145,7 @@ async function handleInfo(jobId, flags, env, io, json) {
     const context = resolveContext(flags, env);
     const job = await request(context.baseUrl, 'GET', `/scheduler/jobs/${encodeURIComponent(jobId)}`);
     const runs = await request(context.baseUrl, 'GET', `/scheduler/jobs/${encodeURIComponent(jobId)}/runs`);
-    print(json, io.stdout, { job, runs: runs.runs }, formatJobDetails(job, runs.runs[0]));
+    print(json, io.stdout, { job: presentJob(job), runs: runs.runs }, formatJobDetails(job, runs.runs[0]));
     return 0;
 }
 async function handleEdit(jobId, flags, env, io, json) {
@@ -168,14 +171,14 @@ async function handleEdit(jobId, flags, env, io, json) {
         input.enabled = enabled;
     }
     if (executionMode) {
-        input.executionMode = parseExecutionMode(executionMode);
+        input.executionMode = (0, index_js_1.normalizeScheduledJobExecutionMode)(executionMode);
     }
     if (Object.keys(input).length === 0) {
         throw new Error('scheduler edit requires at least one editable field.');
     }
     const context = resolveContext(flags, env);
     const job = await request(context.baseUrl, 'PATCH', `/scheduler/jobs/${encodeURIComponent(jobId)}`, input);
-    print(json, io.stdout, job, `Updated scheduler job ${job.id}`);
+    print(json, io.stdout, presentJob(job), `Updated scheduler job ${(0, job_id_js_1.toPublicScheduledJobId)(job.id)}`);
     return 0;
 }
 async function handleDelete(jobId, flags, env, io, json) {
@@ -284,13 +287,7 @@ function normalizeMaybeBooleanFlag(value) {
     return value === 'true' ? '' : value;
 }
 function getExecutionMode(flags) {
-    return parseExecutionMode(getFlag(flags, 'execution-mode') || 'same-thread');
-}
-function parseExecutionMode(value) {
-    if (value === 'same-thread' || value === 'side-thread') {
-        return value;
-    }
-    throw new Error('Flag --execution-mode must be same-thread or side-thread');
+    return (0, index_js_1.normalizeScheduledJobExecutionMode)(getFlag(flags, 'execution-mode'));
 }
 function print(asJson, output, payload, text) {
     output.write(asJson ? `${JSON.stringify(payload, null, 2)}\n` : `${text}\n`);
@@ -309,11 +306,11 @@ function printUsage(output) {
 }
 function formatJobLine(job) {
     const schedule = job.triggerType === 'cron' ? job.cronExpr || '' : job.runAt || '';
-    return `${job.id} | ${job.enabled ? 'enabled' : 'disabled'} | ${job.executionMode} | ${schedule} | ${job.description}`;
+    return `${(0, job_id_js_1.toPublicScheduledJobId)(job.id)} | ${job.enabled ? 'enabled' : 'disabled'} | ${job.executionMode} | ${schedule} | ${job.description}`;
 }
 function formatJobDetails(job, latestRun) {
     return [
-        `Job: ${job.id}`,
+        `Job: ${(0, job_id_js_1.toPublicScheduledJobId)(job.id)}`,
         `Workspace: ${job.workspaceId}`,
         `Platform: ${job.platform}`,
         `Thread: ${job.route.threadId || ''}`,
@@ -325,6 +322,12 @@ function formatJobDetails(job, latestRun) {
         latestRun ? `Latest run: ${latestRun.status} @ ${latestRun.triggeredAt}` : 'Latest run: none',
     ].join('\n');
 }
+function presentJob(job) {
+    return {
+        ...job,
+        id: (0, job_id_js_1.toPublicScheduledJobId)(job.id),
+    };
+}
 function formatError(error) {
     return error instanceof Error ? error.message : String(error);
 }

package/dist-electron/services/local-ai-core/src/scheduler/job-id.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createScheduledJobId = createScheduledJobId;
+exports.toPublicScheduledJobId = toPublicScheduledJobId;
+const node_crypto_1 = require("node:crypto");
+function createScheduledJobId() {
+    return (0, node_crypto_1.randomUUID)().split('-')[0] || (0, node_crypto_1.randomUUID)();
+}
+function toPublicScheduledJobId(jobId) {
+    const normalized = jobId.startsWith('job:') ? jobId.slice(4) : jobId;
+    if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(normalized)) {
+        return normalized.split('-')[0] || normalized;
+    }
+    return normalized;
+}

package/dist-electron/services/local-ai-core/src/scheduler/scheduler-service.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SchedulerService = void 0;
 const node_events_1 = require("node:events");
+const job_id_js_1 = require("./job-id.js");
 const scheduler_run_lifecycle_js_1 = require("./scheduler-run-lifecycle.js");
 class SchedulerService extends node_events_1.EventEmitter {
     options;
@@ -34,7 +35,8 @@ class SchedulerService extends node_events_1.EventEmitter {
         return this.options.store.listScheduledJobs(workspaceId);
     }
     getJob(jobId) {
-        return this.options.store.getScheduledJob(jobId);
+        const resolvedJobId = this.resolveJobId(jobId);
+        return resolvedJobId ? this.options.store.getScheduledJob(resolvedJobId) : undefined;
     }
     createJob(input) {
         const job = this.options.store.createScheduledJob(input);
@@ -43,24 +45,47 @@ class SchedulerService extends node_events_1.EventEmitter {
         return job;
     }
     updateJob(jobId, input) {
-        const job = this.options.store.updateScheduledJob(jobId, input);
+        const job = this.options.store.updateScheduledJob(this.resolveRequiredJobId(jobId), input);
         this.emit('job', job);
         this.options.eventBus.emit({ type: 'scheduler.job.updated', payload: job });
         return job;
     }
     deleteJob(jobId) {
-        return this.options.store.deleteScheduledJob(jobId);
+        return this.options.store.deleteScheduledJob(this.resolveRequiredJobId(jobId));
     }
     listJobRuns(jobId) {
-        return this.options.store.listScheduledJobRuns(jobId);
+        return this.options.store.listScheduledJobRuns(this.resolveRequiredJobId(jobId));
     }
     async runJobNow(jobId) {
-        const job = this.options.store.getScheduledJob(jobId);
+        const resolvedJobId = this.resolveRequiredJobId(jobId);
+        const job = this.options.store.getScheduledJob(resolvedJobId);
         if (!job) {
             throw new Error(`Scheduled job not found: ${jobId}`);
         }
         return this.executeJob(job, new Date().toISOString(), true);
     }
+    resolveJobId(jobId) {
+        if (this.options.store.getScheduledJob(jobId)) {
+            return jobId;
+        }
+        const matches = this.options.store
+            .listScheduledJobs()
+            .filter((job) => (0, job_id_js_1.toPublicScheduledJobId)(job.id) === jobId);
+        if (matches.length === 0) {
+            return '';
+        }
+        if (matches.length > 1) {
+            throw new Error(`Scheduled job id is ambiguous: ${jobId}`);
+        }
+        return matches[0].id;
+    }
+    resolveRequiredJobId(jobId) {
+        const resolvedJobId = this.resolveJobId(jobId);
+        if (!resolvedJobId) {
+            throw new Error(`Scheduled job not found: ${jobId}`);
+        }
+        return resolvedJobId;
+    }
     async tick() {
         if (this.pollInFlight) {
             return;

package/dist-electron/shared/desktop.js

@@ -62,13 +62,14 @@ exports.SCHEDULER_PROTOCOL_INSTRUCTION = [
     'lac scheduler add --cron "<5-field cron>" --message "<exact message to send>" --desc "<short label>" [--execution-mode same-thread|side-thread]',
     'lac scheduler list',
     'lac scheduler list --thread',
-    'lac scheduler info <job-id>',
-    'lac scheduler edit <job-id> [--cron "<5-field cron>"] [--message "<exact message>"] [--desc "<short label>"] [--enabled true|false] [--execution-mode same-thread|side-thread]',
-    'lac scheduler del <job-id>',
-    'lac scheduler run <job-id>',
+    'lac scheduler info <short-job-id>',
+    'lac scheduler edit <short-job-id> [--cron "<5-field cron>"] [--message "<exact message>"] [--desc "<short label>"] [--enabled true|false] [--execution-mode same-thread|side-thread]',
+    'lac scheduler del <short-job-id>',
+    'lac scheduler run <short-job-id>',
     'Environment variables LOCAL_AI_WORKSPACE_ID, LOCAL_AI_THREAD_ID, LOCAL_AI_PLATFORM, LOCAL_AI_CHAT_ID, and LOCAL_AI_PLATFORM_USER_ID are already set when available.',
     'Prefer relying on those variables instead of inventing your own route or creating session-only cron jobs.',
     'By default, `lac scheduler list` shows all scheduled tasks in the current workspace. Use `lac scheduler list --thread` to show only the current conversation thread.',
+    'Use the short job id shown by `lac scheduler list`; do not add a `job:` prefix or expand it to a full UUID.',
     'Use `--execution-mode same-thread` to reuse the current thread, or `--execution-mode side-thread` to run in a dedicated scheduled thread.',
     'Only use the scheduler CLI when the user explicitly asks for scheduled automation.',
     '[/Scheduler Tools]',
@@ -169,7 +170,28 @@ function normalizePermissionResponse(input) {
     if (!input) {
         return null;
     }
-    return PERMISSION_RESPONSE_MAP[String(input).trim().toLowerCase()] || null;
+    const normalized = String(input).trim().toLowerCase();
+    const mapped = PERMISSION_RESPONSE_MAP[normalized];
+    if (mapped) {
+        return mapped;
+    }
+    if (normalized.includes('allow_all') ||
+        normalized.includes('allow-always') ||
+        normalized.includes('allow_always') ||
+        normalized.includes('allow always') ||
+        normalized.includes('always allow') ||
+        normalized.includes('allow all') ||
+        normalized.includes('始终允许') ||
+        normalized.includes('永久允许')) {
+        return 'allow all';
+    }
+    if (normalized.startsWith('reject') || normalized.startsWith('deny')) {
+        return 'deny';
+    }
+    if (normalized.startsWith('allow')) {
+        return 'allow';
+    }
+    return null;
 }
 function isPermissionButtonOption(option) {
     return Boolean(normalizePermissionResponse(option?.data));

package/dist-electron/src/pages/Threads/thread-chat-model.js

@@ -5,6 +5,9 @@ exports.isInternalProgressMessage = isInternalProgressMessage;
 exports.isAwaitingInputMessage = isAwaitingInputMessage;
 exports.findStreamingPreviewMessage = findStreamingPreviewMessage;
 exports.shouldReplacePreviewWithReply = shouldReplacePreviewWithReply;
+exports.advancePreviewContent = advancePreviewContent;
+exports.settlePreviewMessages = settlePreviewMessages;
+exports.finalizeTurnMessageKinds = finalizeTurnMessageKinds;
 exports.extractVisibleMessageContent = extractVisibleMessageContent;
 exports.sessionMatchesDesktop = sessionMatchesDesktop;
 exports.toMessages = toMessages;
@@ -65,6 +68,60 @@ function shouldReplacePreviewWithReply(message, replyContent, replyCtx) {
     const content = message.streamTargetContent ?? message.content;
     return Boolean(replyContent && content === replyContent && !isInternalProgressMessage(content));
 }
+function advancePreviewContent(content, target) {
+    if (!target) {
+        return '';
+    }
+    if (!content || !target.startsWith(content)) {
+        return target.slice(0, Math.min(target.length, Math.max(1, Math.ceil(target.length / 24))));
+    }
+    if (content === target) {
+        return target;
+    }
+    const remaining = target.length - content.length;
+    const step = remaining > 160 ? 14 : remaining > 80 ? 8 : remaining > 24 ? 4 : 2;
+    return target.slice(0, Math.min(target.length, content.length + step));
+}
+function settlePreviewMessages(messages, turnKey) {
+    let changed = false;
+    const next = messages.map((message) => {
+        if (!message.preview) {
+            return message;
+        }
+        if (turnKey && message.turnKey !== turnKey) {
+            return message;
+        }
+        changed = true;
+        return {
+            ...message,
+            content: message.streamTargetContent ?? message.content,
+            streamTargetContent: undefined,
+            preview: false,
+            previewPlainText: false,
+        };
+    });
+    return changed ? next : messages;
+}
+function finalizeTurnMessageKinds(messages, turnKey) {
+    if (!turnKey) {
+        return messages;
+    }
+    const candidates = messages.filter((message) => message.turnKey === turnKey && !message.preview);
+    if (candidates.length === 0) {
+        return messages;
+    }
+    const finalMessage = [...candidates].reverse().find((message) => !isInternalProgressMessage(message.content));
+    const finalId = finalMessage?.id;
+    return messages.map((message) => {
+        if (message.turnKey !== turnKey || message.preview) {
+            return message;
+        }
+        return {
+            ...message,
+            kind: finalId && message.id === finalId ? 'final' : 'progress',
+        };
+    });
+}
 function extractVisibleMessageContent(content) {
     if (!content) {
         return '';

package/dist-electron/src/pages/Threads/thread-chat-permission.test.js

@@ -157,3 +157,73 @@ function createMessage(overrides) {
     strict_1.default.equal((0, thread_chat_model_1.shouldReplacePreviewWithReply)(thoughtPreview, 'Hi! How can I help you today?', 'run-1'), false);
     strict_1.default.equal((0, thread_chat_model_1.shouldReplacePreviewWithReply)(answerPreview, 'Hi! How can I help you today?', 'run-1'), true);
 });
+(0, node_test_1.default)('finalizeTurnMessageKinds marks only the last non-progress turn message as final', () => {
+    const messages = [
+        {
+            id: 'thought',
+            role: 'assistant',
+            content: '💭 checking',
+            kind: 'final',
+            order: 1,
+            turnKey: 'run-1',
+        },
+        {
+            id: 'tool',
+            role: 'assistant',
+            content: '🔧 Read file',
+            kind: 'final',
+            order: 2,
+            turnKey: 'run-1',
+        },
+        {
+            id: 'answer',
+            role: 'assistant',
+            content: 'Done',
+            kind: 'progress',
+            order: 3,
+            turnKey: 'run-1',
+        },
+    ];
+    const finalized = (0, thread_chat_model_1.finalizeTurnMessageKinds)(messages, 'run-1');
+    strict_1.default.deepEqual(finalized.map((message) => [message.id, message.kind]), [
+        ['thought', 'progress'],
+        ['tool', 'progress'],
+        ['answer', 'final'],
+    ]);
+});
+(0, node_test_1.default)('settlePreviewMessages settles only previews for the requested turn', () => {
+    const messages = [
+        {
+            id: 'preview-1',
+            role: 'assistant',
+            content: 'Hel',
+            streamTargetContent: 'Hello',
+            kind: 'progress',
+            order: 1,
+            turnKey: 'run-1',
+            preview: true,
+            previewPlainText: true,
+        },
+        {
+            id: 'preview-2',
+            role: 'assistant',
+            content: 'Wor',
+            streamTargetContent: 'World',
+            kind: 'progress',
+            order: 2,
+            turnKey: 'run-2',
+            preview: true,
+            previewPlainText: true,
+        },
+    ];
+    const settled = (0, thread_chat_model_1.settlePreviewMessages)(messages, 'run-1');
+    strict_1.default.equal(settled[0]?.content, 'Hello');
+    strict_1.default.equal(settled[0]?.preview, false);
+    strict_1.default.equal(settled[1]?.content, 'Wor');
+    strict_1.default.equal(settled[1]?.preview, true);
+});
+(0, node_test_1.default)('advancePreviewContent moves monotonically toward the target content', () => {
+    strict_1.default.equal((0, thread_chat_model_1.advancePreviewContent)('', 'Hello'), 'H');
+    strict_1.default.equal((0, thread_chat_model_1.advancePreviewContent)('Hel', 'Hello'), 'Hello');
+    strict_1.default.equal((0, thread_chat_model_1.advancePreviewContent)('Mismatch', 'Hello'), 'H');
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kafca/agentdock",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "type": "module",
   "main": "dist-electron/electron/main.js",
   "bin": {