shennian 0.2.86 → 0.2.88

package/dist/src/agents/adapter.d.ts

@@ -1,11 +1,12 @@
 import { EventEmitter } from 'node:events';
-import type { AgentType, ChatAttachmentMeta, ExternalChannelSessionStatus } from '@shennian/wire';
+import type { AgentType, ChatAttachmentMeta, ExternalChannelSessionStatus, SessionRunPhase } from '@shennian/wire';
 export type AgentEvent = {
     state: string;
     runId: string;
     seq: number;
     text?: string;
     thinking?: boolean;
+    runPhase?: SessionRunPhase;
     name?: string;
     args?: Record<string, unknown>;
     result?: string;

package/dist/src/agents/codex-utils.d.ts

@@ -1,4 +1,9 @@
 export declare function makeThreadTitle(text: string): string;
+export declare const CODEX_APP_SERVER_CLIENT_INFO: {
+    readonly name: "codex-tui";
+    readonly title: "Codex TUI";
+    readonly version: "0.0.0";
+};
 export declare function isCodexCollabAgentToolName(name: string): boolean;
 export declare function isCodexCollabAgentItem(item: Record<string, unknown>): boolean;
 export declare function isCodexLegacyCollabAgentItem(item: {

package/dist/src/agents/codex-utils.js

@@ -5,6 +5,11 @@ export function makeThreadTitle(text) {
     const title = firstLine.trim().slice(0, 80);
     return title || 'Shennian';
 }
+export const CODEX_APP_SERVER_CLIENT_INFO = {
+    name: 'codex-tui',
+    title: 'Codex TUI',
+    version: '0.0.0',
+};
 const CODEX_COLLAB_AGENT_TOOL_NAMES = new Set([
     'spawnAgent',
     'sendInput',

package/dist/src/agents/codex.js

@@ -6,7 +6,7 @@ import { AgentAdapter, registerAgent } from './adapter.js';
 import { resolveBuiltinCommand, spawnAgentCommand } from './command-spec.js';
 import { buildAgentProcessEnv } from '../agent-env.js';
 import { ensurePlatformInstructionsFile } from './platform-instructions.js';
-import { extractAppServerErrorMessage, formatCodexErrorMessage, formatTransientCodexStatus, isCodexCollabAgentItem, isCodexCollabAgentToolName, isCodexLegacyCollabAgentItem, isCodexUnsupportedEffortError, isMissingCodexRolloutError, isTransientCodexErrorMessage, looksLikeCodexInteractiveAuthPrompt, looksLikeFatalCodexStderr, makeThreadTitle, normalizeCodexModelId, normalizeCodexReasoningEffort, normalizeCodexStderr, normalizeTerminalText, safeStringify, stripGitDirectiveArtifacts, } from './codex-utils.js';
+import { CODEX_APP_SERVER_CLIENT_INFO, extractAppServerErrorMessage, formatCodexErrorMessage, formatTransientCodexStatus, isCodexCollabAgentItem, isCodexCollabAgentToolName, isCodexLegacyCollabAgentItem, isCodexUnsupportedEffortError, isMissingCodexRolloutError, isTransientCodexErrorMessage, looksLikeCodexInteractiveAuthPrompt, looksLikeFatalCodexStderr, makeThreadTitle, normalizeCodexModelId, normalizeCodexReasoningEffort, normalizeCodexStderr, normalizeTerminalText, safeStringify, stripGitDirectiveArtifacts, } from './codex-utils.js';
 export { isCodexUnsupportedEffortError, isMissingCodexRolloutError, normalizeCodexModelId, normalizeCodexReasoningEffort, } from './codex-utils.js';
 function buildCodexTextInput(text, attachments) {
     const images = attachments
@@ -239,7 +239,7 @@ export class CodexAdapter extends AgentAdapter {
     async initializeAppServer(modelId) {
         const codexModelId = normalizeCodexModelId(modelId);
         await this.sendRpc('initialize', {
-            clientInfo: { name: 'shennian', title: 'Shennian', version: '0.0.0' },
+            clientInfo: CODEX_APP_SERVER_CLIENT_INFO,
             capabilities: { experimentalApi: true },
         });
         if (this.agentSessionId) {

package/dist/src/agents/model-registry/discovery.js

@@ -6,6 +6,7 @@ import { fallbackClaudeAliasModels, discoverClaudeAliasModelsFromEnv, fallbackGe
 import { runResolvedCommand } from './runner.js';
 import { DISCOVERY_WORKDIR } from './types.js';
 import { buildAgentProcessEnv, readLatestUserEnv } from '../../agent-env.js';
+import { CODEX_APP_SERVER_CLIENT_INFO } from '../codex-utils.js';
 function sendAppServerRpc(proc, pending, id, method, params, timeoutMs) {
     if (!proc.stdin)
         return Promise.reject(new Error('codex app-server stdin unavailable'));
@@ -59,7 +60,7 @@ async function discoverCodexModelsViaAppServer(spec) {
     });
     try {
         await sendAppServerRpc(proc, pending, seq++, 'initialize', {
-            clientInfo: { name: 'shennian', title: 'Shennian', version: '0.0.0' },
+            clientInfo: CODEX_APP_SERVER_CLIENT_INFO,
             capabilities: { experimentalApi: true },
         }, 10_000);
         const [modelList, configRead] = await Promise.all([

package/dist/src/channels/base.d.ts

@@ -1,5 +1,5 @@
 import type { ExternalChannelSessionStatus } from '@shennian/wire';
-export type ExternalChannelRuntimeStatus = Pick<ExternalChannelSessionStatus, 'wechatRpaRuntimeState' | 'wechatRpaLastRunAt' | 'wechatRpaLastMessageAt' | 'wechatRpaLastInterruptedAt' | 'wechatRpaPendingReplyCount' | 'wechatRpaLastError' | 'wechatRpaLastRunId' | 'wechatRpaLastTracePath' | 'wechatRpaLastTraceSummary' | 'wechatRpaRecentTaskSummaries' | 'wechatRpaLastCloudOcrAt' | 'wechatRpaLastCloudOcrPurpose' | 'wechatRpaLastCloudOcrRequestId' | 'wechatRpaLastCloudOcrImageHash' | 'wechatRpaLastCloudOcrUsage'>;
+export type ExternalChannelRuntimeStatus = Pick<ExternalChannelSessionStatus, 'wechatRpaRuntimeState' | 'wechatRpaLastRunAt' | 'wechatRpaLastMessageAt' | 'wechatRpaLastInterruptedAt' | 'wechatRpaPendingReplyCount' | 'wechatRpaLastError' | 'wechatRpaLastRunId' | 'wechatRpaLastTracePath' | 'wechatRpaLastTraceSummary' | 'wechatRpaRecentTaskSummaries'>;
 export type ExternalChannelType = 'wecom' | 'websocket' | 'wechat-rpa';
 export type ExternalChannelConfig = {
     id: string;
@@ -42,9 +42,6 @@ export type ExternalChannelView = {
     downloadAttachments?: boolean;
     downloadAttachmentsDir?: string;
     selfNickname?: string | null;
-    cloudOcrUrl?: string;
-    cloudOcrToken?: string;
-    cloudOcrMode?: string;
     wechatRpaRuntimeState?: ExternalChannelSessionStatus['wechatRpaRuntimeState'];
     wechatRpaLastRunAt?: string | null;
     wechatRpaLastMessageAt?: string | null;
@@ -54,15 +51,6 @@ export type ExternalChannelView = {
     wechatRpaLastTracePath?: string | null;
     wechatRpaLastTraceSummary?: string | null;
     wechatRpaRecentTaskSummaries?: ExternalChannelSessionStatus['wechatRpaRecentTaskSummaries'];
-    wechatRpaLastCloudOcrAt?: string | null;
-    wechatRpaLastCloudOcrPurpose?: string | null;
-    wechatRpaLastCloudOcrRequestId?: string | null;
-    wechatRpaLastCloudOcrImageHash?: string | null;
-    wechatRpaLastCloudOcrUsage?: {
-        inputTokens?: number;
-        outputTokens?: number;
-        totalTokens?: number;
-    } | null;
 };
 export type ExternalMessageEvent = {
     type: 'external.message';

package/dist/src/channels/runtime.d.ts

@@ -101,9 +101,6 @@ export declare class ChannelRuntime {
         downloadAttachmentsDir?: string;
         selfNickname?: string;
         flowScriptPath?: string;
-        cloudOcrUrl?: string;
-        cloudOcrToken?: string;
-        cloudOcrMode?: 'off' | 'fallback' | 'always';
     }): Promise<ExternalChannelView>;
 }
 export type ExternalReplySendPlanItem = {

package/dist/src/channels/runtime.js

@@ -357,7 +357,6 @@ export class ChannelRuntime {
             : channel);
         configs.push(nextConfig);
         this.configs.replaceAll(configs);
-        const cloudOcrMode = 'off';
         this.secrets.upsert(nextConfig.secretRef, {
             type: 'wechat-rpa',
             source,
@@ -371,9 +370,6 @@ export class ChannelRuntime {
             downloadAttachmentsDir: input.downloadAttachmentsDir?.trim() || stringOrUndefined(priorSecret?.downloadAttachmentsDir),
             selfNickname: input.selfNickname?.trim() || stringOrUndefined(priorSecret?.selfNickname),
             flowScriptPath: input.flowScriptPath?.trim() || stringOrUndefined(priorSecret?.flowScriptPath),
-            cloudOcrUrl: '',
-            cloudOcrToken: '',
-            cloudOcrMode,
             canReply: input.canReply ?? priorSecret?.canReply ?? false,
             systemPrompt: input.systemPrompt ?? (typeof priorSecret?.systemPrompt === 'string' ? priorSecret.systemPrompt : ''),
         });
@@ -445,7 +441,7 @@ function normalizeWeChatRpaGroups(groups) {
     return result;
 }
 function defaultWeChatRpaSource() {
-    return process.platform === 'win32' ? 'windows-visual-flow' : 'wechat-rpa-lab';
+    return 'wechat-rpa-lab';
 }
 export function planExternalReplySends(channelType, input) {
     const parts = splitExternalReplyText(input.text);

package/dist/src/channels/secret-registry.d.ts

@@ -19,11 +19,7 @@ type ChannelSecretRecord = {
     selfNickname?: string;
     idleSeconds?: number;
     recentLimit?: number;
-    readMode?: 'local-ocr' | 'hybrid-vlm';
     flowScriptPath?: string;
-    cloudOcrUrl?: string;
-    cloudOcrToken?: string;
-    cloudOcrMode?: 'off' | 'fallback' | 'always';
     updatedAt: string;
 };
 export declare class ChannelSecretRegistry {

package/dist/src/channels/wechat-rpa/macos-flow.d.ts

@@ -10,10 +10,6 @@ export type MacWeChatRpaFlowOptions = {
     recentLimit?: number;
     downloadAttachmentsDir?: string;
     timeoutMs?: number;
-    cloudOcrUrl?: string;
-    cloudOcrToken?: string;
-    cloudOcrMode?: 'off' | 'fallback' | 'always';
-    cloudOcrChannelId?: string;
 };
 export type MacWeChatRpaFlowResult = {
     ok: boolean;
@@ -30,14 +26,8 @@ export type MacWeChatRpaFlowResult = {
     sentAttachment?: boolean;
     sentAttachmentObserved?: boolean;
     postSendScreenshotPath?: string;
-    cloudOcrPurpose?: MacWeChatRpaCloudOcrPurpose;
-    cloudOcrObservations?: MacWeChatRpaCloudOcrObservation[];
-    cloudOcrRequestId?: string;
-    cloudOcrImageHash?: string;
-    cloudOcrUsage?: MacWeChatRpaCloudOcrUsage;
     error?: string;
 };
-export type MacWeChatRpaCloudOcrPurpose = 'message-read' | 'attachment-localization' | 'send-confirmation';
 export type MacWeChatRpaFlowMessage = {
     id?: string;
     text?: string;
@@ -62,22 +52,4 @@ export type MacWeChatRpaAttachment = {
     expiresAt?: string;
     providerError?: string;
 };
-export type MacWeChatRpaCloudOcrObservation = {
-    text: string;
-    confidence?: number;
-    role?: string;
-    attachment?: MacWeChatRpaAttachment;
-};
-export type MacWeChatRpaCloudOcrUsage = {
-    inputTokens?: number;
-    outputTokens?: number;
-    totalTokens?: number;
-};
 export declare function runMacWeChatRpaFlow(options: MacWeChatRpaFlowOptions): Promise<MacWeChatRpaFlowResult>;
-export declare function selectCloudOcrRequest(result: Pick<MacWeChatRpaFlowResult, 'newMessages' | 'recentMessages' | 'screenshotPath' | 'postSendScreenshotPath' | 'sentReply' | 'sentAttachment'>, mode: 'off' | 'fallback' | 'always'): {
-    screenshotPath: string;
-    purpose: MacWeChatRpaCloudOcrPurpose;
-} | null;
-export declare function shouldUseCloudOcr(result: Pick<MacWeChatRpaFlowResult, 'newMessages' | 'recentMessages'>, mode: 'off' | 'fallback' | 'always'): boolean;
-export declare function mergeCloudMessages(localMessages: MacWeChatRpaFlowMessage[], cloudMessages: MacWeChatRpaFlowMessage[]): MacWeChatRpaFlowMessage[];
-export declare function messagesFromCloudOcrObservations(groupName: string, observations: MacWeChatRpaCloudOcrObservation[]): MacWeChatRpaFlowMessage[];

package/dist/src/channels/wechat-rpa/macos-flow.js

@@ -2,7 +2,6 @@
 // @test src/__tests__/wechat-rpa-normalizer.test.ts
 import fs from 'node:fs';
 import path from 'node:path';
-import crypto from 'node:crypto';
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
 const execFileAsync = promisify(execFile);
@@ -61,7 +60,7 @@ export async function runMacWeChatRpaFlow(options) {
             return parsed;
         if (!parsed.ok)
             throw new Error(parsed.error || 'WeChat RPA flow failed');
-        return await maybeEnrichWithCloudOcr(parsed, options);
+        return parsed;
     }
     catch (error) {
         const detail = stderr.trim() || stdout.slice(0, 1_000);
@@ -82,138 +81,6 @@ function hasPartialSendProgress(result) {
 function hasSendAttempt(result) {
     return Boolean(result.sentReply || result.sentAttachment || result.sentReplyObserved || result.sentAttachmentObserved);
 }
-async function maybeEnrichWithCloudOcr(result, options) {
-    void options;
-    return result;
-}
-export function selectCloudOcrRequest(result, mode) {
-    if (!shouldUseCloudOcr(result, mode))
-        return null;
-    if ((result.sentReply || result.sentAttachment) && result.postSendScreenshotPath) {
-        return { screenshotPath: result.postSendScreenshotPath, purpose: 'send-confirmation' };
-    }
-    if (!result.screenshotPath)
-        return null;
-    const messages = [...(result.newMessages ?? []), ...(result.recentMessages ?? [])];
-    const hasUnresolvedAttachment = messages.some((message) => (message.attachments ?? []).some((attachment) => attachment.availability === 'metadata-only'
-        || attachment.availability === 'pending-download'
-        || Boolean(attachment.providerError)));
-    return {
-        screenshotPath: result.screenshotPath,
-        purpose: hasUnresolvedAttachment ? 'attachment-localization' : 'message-read',
-    };
-}
-export function shouldUseCloudOcr(result, mode) {
-    if (mode === 'off')
-        return false;
-    if (mode === 'always')
-        return true;
-    const messages = [...(result.newMessages ?? []), ...(result.recentMessages ?? [])];
-    if (!(result.newMessages?.length))
-        return true;
-    if (messages.some((message) => Number.isFinite(message.confidence) && Number(message.confidence) < 0.65))
-        return true;
-    return messages.some((message) => (message.attachments ?? []).some((attachment) => attachment.availability === 'metadata-only'
-        || attachment.availability === 'pending-download'
-        || Boolean(attachment.providerError)));
-}
-export function mergeCloudMessages(localMessages, cloudMessages) {
-    const merged = [...localMessages];
-    for (const cloud of cloudMessages) {
-        const signature = messageSignature(cloud);
-        const index = merged.findIndex((message) => messageSignature(message) === signature);
-        if (index < 0) {
-            merged.push(cloud);
-            continue;
-        }
-        const existingAttachments = merged[index]?.attachments ?? [];
-        const cloudAttachments = cloud.attachments ?? [];
-        if (!existingAttachments.length && cloudAttachments.length) {
-            const existing = merged[index] ?? {};
-            merged[index] = { ...existing, attachments: cloudAttachments };
-        }
-    }
-    return merged;
-}
-export function messagesFromCloudOcrObservations(groupName, observations) {
-    const messages = [];
-    for (const item of observations) {
-        const text = String(item.text || '').trim();
-        if (!text)
-            continue;
-        const role = String(item.role || 'unknown');
-        if (!['message', 'attachment', 'unknown'].includes(role))
-            continue;
-        const attachment = normalizeCloudAttachment(item.attachment) ?? (role === 'attachment' ? attachmentFromText(text) : null);
-        messages.push({
-            id: `cloud:${stableId(`${groupName}\n${role}\n${text}`)}`,
-            text,
-            confidence: item.confidence,
-            attachments: attachment ? [attachment] : [],
-        });
-    }
-    return messages;
-}
-function messageSignature(message) {
-    const text = String(message.text || '').replace(/\s+/g, ' ').trim().toLowerCase();
-    const attachments = (message.attachments ?? [])
-        .map((attachment) => `${attachment.type}:${attachment.name || ''}:${attachment.mimeType || ''}`)
-        .sort()
-        .join('|');
-    return text || attachments || String(message.id || '');
-}
-function normalizeCloudAttachment(value) {
-    if (!value || typeof value !== 'object')
-        return null;
-    const record = value;
-    const type = String(record.type || 'file').trim() || 'file';
-    const name = String(record.name || '').replace(/\s+/g, ' ').trim();
-    const mimeType = String(record.mimeType || '').replace(/\s+/g, ' ').trim();
-    const size = Number(record.size);
-    return {
-        type: ['image', 'video', 'audio', 'file'].includes(type) ? type : 'file',
-        ...(name ? { name } : {}),
-        ...(mimeType ? { mimeType } : {}),
-        ...(Number.isFinite(size) && size > 0 ? { size } : {}),
-        availability: 'metadata-only',
-    };
-}
-function attachmentFromText(text) {
-    const matches = Array.from(text.matchAll(/[\p{L}\p{N}_().[\]-]+\.(png|jpe?g|gif|webp|heic|mp4|mov|avi|mkv|pdf|docx?|xlsx?|pptx?|txt|md|csv|zip|rar)/giu));
-    const filename = matches.at(-1)?.[0]?.trim();
-    if (!filename)
-        return null;
-    const ext = path.extname(filename).toLowerCase();
-    return { type: attachmentTypeFromExt(ext), name: filename, mimeType: mimeTypeFromExt(ext), availability: 'metadata-only' };
-}
-function attachmentTypeFromExt(ext) {
-    if (['.png', '.jpg', '.jpeg', '.gif', '.webp', '.heic'].includes(ext))
-        return 'image';
-    if (['.mp4', '.mov', '.avi', '.mkv'].includes(ext))
-        return 'video';
-    return 'file';
-}
-function mimeTypeFromExt(ext) {
-    const map = {
-        '.png': 'image/png',
-        '.jpg': 'image/jpeg',
-        '.jpeg': 'image/jpeg',
-        '.gif': 'image/gif',
-        '.webp': 'image/webp',
-        '.heic': 'image/heic',
-        '.mp4': 'video/mp4',
-        '.mov': 'video/quicktime',
-        '.pdf': 'application/pdf',
-        '.txt': 'text/plain',
-        '.md': 'text/markdown',
-        '.csv': 'text/csv',
-        '.zip': 'application/zip',
-    };
-    return map[ext] || 'application/octet-stream';
-}
-function stableId(value) {
-    return crypto.createHash('sha256').update(value).digest('hex').slice(0, 24);
-}
 function resolveFlowScriptPath(scriptPath, workDir) {
     const candidates = [
         scriptPath,

package/dist/src/channels/wechat-rpa.js

@@ -8,7 +8,6 @@ import { fileURLToPath, pathToFileURL } from 'node:url';
 import { ChannelSecretRegistry } from './secret-registry.js';
 import { probeMacWeChat, observedMessageFromProbe } from './wechat-rpa/macos.js';
 import { runMacWeChatRpaFlow } from './wechat-rpa/macos-flow.js';
-import { runWindowsWeChatRpaVisualFlow } from './wechat-rpa/windows-visual-flow.js';
 import { normalizeWeChatRpaMessage, WeChatRpaDeduper, weChatRpaConversationId, } from './wechat-rpa/normalizer.js';
 const DEFAULT_POLL_INTERVAL_MS = 5_000;
 const DEFAULT_RECENT_LIMIT = 5;
@@ -159,7 +158,6 @@ export class WeChatRpaChannelAdapter {
             noteManualReview(conn, pendingKey, reason);
             return { status: 'manual-review', reason };
         }
-        recordCloudOcrRuntime(conn, flow);
         addTaskSummary(conn, {
             status: 'sent',
             runId: conn.lastRunId ?? null,
@@ -225,11 +223,6 @@ export class WeChatRpaChannelAdapter {
             wechatRpaLastTracePath: conn.lastTracePath ?? null,
             wechatRpaLastTraceSummary: conn.lastTraceSummary ?? null,
             wechatRpaRecentTaskSummaries: conn.recentTaskSummaries,
-            wechatRpaLastCloudOcrAt: conn.lastCloudOcrAt ?? null,
-            wechatRpaLastCloudOcrPurpose: conn.lastCloudOcrPurpose ?? null,
-            wechatRpaLastCloudOcrRequestId: conn.lastCloudOcrRequestId ?? null,
-            wechatRpaLastCloudOcrImageHash: conn.lastCloudOcrImageHash ?? null,
-            wechatRpaLastCloudOcrUsage: conn.lastCloudOcrUsage ?? null,
         };
     }
     ensureConnection(config) {
@@ -284,7 +277,6 @@ export class WeChatRpaChannelAdapter {
             conn.runtimeState = 'syncing';
             const observed = await this.readObservedMessages(conn.config, secret, (flow) => {
                 recordTraceRuntime(conn, flow);
-                recordCloudOcrRuntime(conn, flow);
                 if (!flow.interrupted)
                     return;
                 interrupted = true;
@@ -345,7 +337,6 @@ export class WeChatRpaChannelAdapter {
             persistPendingReplyState(conn);
             const flow = await runSendFlow(conn.config, secret, pending.conversationName, pending.skipText ? '' : pending.text, pending.attachmentPath, pending.key);
             recordTraceRuntime(conn, flow);
-            recordCloudOcrRuntime(conn, flow);
             const partial = applyPartialSendProgress(flow, {
                 text: pending.skipText ? '' : pending.text,
                 attachmentPath: pending.attachmentPath,
@@ -446,10 +437,8 @@ function isWeChatRpaTextMentioned(text, aliases) {
 export function windowsVisualFlowHealth(secret, platform = process.platform) {
     if (platform !== 'win32')
         return { ok: false, message: 'WeChat RPA Windows visual flow requires Windows' };
-    if (!configuredGroups({ type: 'wechat-rpa', groups: secret.groups, updatedAt: '' }).length) {
-        return { ok: false, message: 'WeChat RPA Windows visual flow requires at least one group' };
-    }
-    return { ok: true, message: 'WeChat RPA Windows visual flow configured' };
+    void secret;
+    return { ok: false, message: 'WeChat RPA Windows visual flow is archived; redesign Windows support before enabling it' };
 }
 async function readLabMessages(config, secret, onFlow) {
     const api = await importWeChatRpaLabApi(config.workDir);
@@ -475,7 +464,6 @@ async function runLabReadFlow(api, secret, groupName) {
         targetGroup: groupName,
         policy: secret.forceForeground ? 'work' : 'polite',
         limit: clampNumber(secret.recentLimit, DEFAULT_RECENT_LIMIT, 1, 50),
-        readMode: secret.readMode === 'hybrid-vlm' ? 'hybrid-vlm' : 'local-ocr',
     };
     const result = await api.runWechatRpaReadLatest(task);
     const structuredMessages = Array.isArray(result.data?.structuredMessages) ? result.data.structuredMessages : [];
@@ -497,7 +485,6 @@ async function runLabReadFlow(api, secret, groupName) {
         recentMessages: flowMessages,
         newMessages: flowMessages,
         screenshotPath: result.tracePath,
-        cloudOcrUsage: result.data?.hybrid?.usage,
         error: labResultError(result),
     };
 }
@@ -630,7 +617,6 @@ async function readMacFlowMessages(config, secret, onFlow) {
             idleSeconds: clampNumber(secret.idleSeconds, 15, 0, 3600),
             recentLimit: clampNumber(secret.recentLimit, DEFAULT_RECENT_LIMIT, 0, 50),
             downloadAttachmentsDir: resolveInboundAttachmentDir(config.workDir, secret),
-            cloudOcrMode: 'off',
         });
         onFlow?.(flow);
         if (flow.interrupted)
@@ -644,26 +630,18 @@ async function readMacFlowMessages(config, secret, onFlow) {
     return result;
 }
 async function readWindowsVisualFlowMessages(config, secret, onFlow) {
-    const result = [];
-    for (const name of configuredGroups(secret)) {
-        const flow = await runWindowsWeChatRpaVisualFlow({
-            groupName: name,
-            scriptPath: secret.flowScriptPath,
-            workDir: config.workDir,
-            recentLimit: clampNumber(secret.recentLimit, DEFAULT_RECENT_LIMIT, 0, 50),
-            downloadAttachmentsDir: resolveInboundAttachmentDir(config.workDir, secret),
-            cloudOcrMode: 'off',
-        });
-        onFlow?.(flow);
-        if (flow.interrupted)
-            continue;
-        for (const message of flow.newMessages ?? []) {
-            const observed = flowMessageToObservedMessage(name, message, secret);
-            if (observed)
-                result.push(observed);
-        }
-    }
-    return result;
+    void config;
+    const groupName = configuredGroups(secret)[0] || '<unbound>';
+    onFlow?.({
+        ok: false,
+        groupName,
+        interrupted: true,
+        reason: 'windows-visual-flow-archived',
+        newMessages: [],
+        recentMessages: [],
+        error: 'WeChat RPA Windows visual flow is archived; redesign Windows support before enabling it',
+    });
+    return [];
 }
 function flowMessageToObservedMessage(conversationName, message, secret) {
     const text = String(message.text || '').trim();
@@ -684,16 +662,19 @@ function flowMessageToObservedMessage(conversationName, message, secret) {
 }
 async function runSendFlow(config, secret, conversationName, text, attachmentPath, dedupeKey) {
     if (secret.source === 'windows-visual-flow') {
-        return runWindowsWeChatRpaVisualFlow({
+        void config;
+        void text;
+        void attachmentPath;
+        void dedupeKey;
+        return {
+            ok: false,
             groupName: conversationName,
-            replyText: text || undefined,
-            attachmentPath,
-            scriptPath: secret.flowScriptPath,
-            workDir: config.workDir,
-            recentLimit: clampNumber(secret.recentLimit, DEFAULT_RECENT_LIMIT, 0, 50),
-            downloadAttachmentsDir: resolveInboundAttachmentDir(config.workDir, secret),
-            cloudOcrMode: 'off',
-        });
+            interrupted: true,
+            reason: 'windows-visual-flow-archived',
+            newMessages: [],
+            recentMessages: [],
+            error: 'WeChat RPA Windows visual flow is archived; redesign Windows support before enabling it',
+        };
     }
     if (secret.source === 'wechat-rpa-lab') {
         return runLabSendFlow(config, secret, conversationName, text, attachmentPath, dedupeKey);
@@ -709,11 +690,10 @@ async function runSendFlow(config, secret, conversationName, text, attachmentPat
         idleSeconds: clampNumber(secret.idleSeconds, 15, 0, 3600),
         recentLimit: clampNumber(secret.recentLimit, DEFAULT_RECENT_LIMIT, 0, 50),
         downloadAttachmentsDir: resolveInboundAttachmentDir(config.workDir, secret),
-        cloudOcrMode: 'off',
     });
 }
 function isFlowSource(source) {
-    return source === 'macos-flow' || source === 'windows-visual-flow' || source === 'wechat-rpa-lab';
+    return source === 'macos-flow' || source === 'wechat-rpa-lab';
 }
 function applyPartialSendProgress(flow, input) {
     if (input.text && input.attachmentPath && flow.sentReplyObserved && !flow.sentAttachmentObserved) {
@@ -883,7 +863,6 @@ function noteInterruption(conn, flow, reason) {
         conn.interruptionCooldownUntil = Date.now() + INTERRUPTION_COOLDOWN_MS;
         conn.runtimeState = 'cooldown';
     }
-    recordCloudOcrRuntime(conn, flow);
     addTaskSummary(conn, {
         status: 'interrupted',
         runId: flow.rpaRunId || conn.lastRunId || null,
@@ -1041,10 +1020,3 @@ function clampNumber(value, fallback, min, max) {
         return fallback;
     return Math.min(max, Math.max(min, number));
 }
-function recordCloudOcrRuntime(conn, flow) {
-    void conn;
-    void flow;
-    // WeChat RPA production routing is local OCR only. Legacy cloud OCR payload
-    // fields may still appear in old fixtures, but the channel must not publish
-    // them as runtime status or invite a server OCR dependency back in.
-}

package/dist/src/commands/daemon.js

@@ -38,6 +38,7 @@ const SAFE_SNAPSHOT_ENV_KEYS = new Set([
     'LOCALAPPDATA',
     'SHENNIAN_DESKTOP_SERVER_URL',
     'SHENNIAN_HOME',
+    'SHENNIAN_NATIVE_FUSION_DISABLED',
 ]);
 export function isSafeSnapshotEnvKey(key) {
     return SAFE_SNAPSHOT_ENV_KEYS.has(key);

package/dist/src/commands/manager.d.ts

@@ -1,2 +1,2 @@
-import { type Command } from 'commander';
+import type { Command } from 'commander';
 export declare function registerManagerCommand(program: Command): void;

package/dist/src/commands/manager.js

@@ -2,7 +2,6 @@
 // @test src/__tests__/manager-runtime.test.ts
 // @test src/__tests__/manager-command.test.ts
 import fs from 'node:fs';
-import { Option } from 'commander';
 import chalk from 'chalk';
 import { readExternalAttachment } from './external-attachments.js';
 function requireManagerContext() {
@@ -75,9 +74,6 @@ function printWeChatRpaStatus(channel) {
         channel.wechatRpaLastRunAt ? `lastRun=${String(channel.wechatRpaLastRunAt)}` : '',
         channel.wechatRpaLastMessageAt ? `lastMessage=${String(channel.wechatRpaLastMessageAt)}` : '',
         channel.wechatRpaLastInterruptedAt ? `lastInterrupted=${String(channel.wechatRpaLastInterruptedAt)}` : '',
-        channel.wechatRpaLastCloudOcrAt ? `lastLocalOcr=${String(channel.wechatRpaLastCloudOcrAt)}` : '',
-        channel.wechatRpaLastCloudOcrPurpose ? `lastLocalOcrPurpose=${String(channel.wechatRpaLastCloudOcrPurpose)}` : '',
-        channel.wechatRpaLastCloudOcrRequestId ? `lastLocalOcrRequestId=${String(channel.wechatRpaLastCloudOcrRequestId)}` : '',
         channel.wechatRpaLastError ? `lastError=${String(channel.wechatRpaLastError)}` : 'lastError=none',
     ].filter(Boolean);
     console.log(fields.join('\n'));
@@ -353,20 +349,17 @@ export function registerManagerCommand(program) {
         .option('--id <id>', 'Channel id')
         .option('--name <name>', 'Channel display name')
         .requiredOption('--enabled <true|false>', 'Whether the channel should be enabled')
-        .option('--group <name>', 'Bound WeChat group name; pass once per conversation', collect, [])
+        .option('--group <name>', 'Bound WeChat conversation name; pass once per Shennian conversation', collect, [])
         .option('--can-reply <true|false>', 'Whether reply should be allowed')
-        .option('--source <macos-flow|windows-visual-flow|wechat-rpa-lab|macos-probe|fixture-jsonl>', 'WeChat RPA implementation source')
+        .option('--source <macos-flow|wechat-rpa-lab|macos-probe|fixture-jsonl>', 'WeChat RPA implementation source')
         .option('--poll-interval-ms <n>', 'Polling interval in milliseconds')
-        .option('--recent-limit <n>', 'Recent message OCR debug limit')
+        .option('--recent-limit <n>', 'Recent message limit')
         .option('--idle-seconds <n>', 'Minimum user idle seconds before foreground automation')
         .option('--force-foreground <true|false>', 'Force WeChat foreground while syncing')
         .option('--restore-previous <true|false>', 'Restore previous foreground app after syncing')
         .option('--download-attachments <true|false>', 'Click and localize inbound attachment candidates')
         .option('--download-attachments-dir <path>', 'Directory for localized inbound WeChat attachments')
         .option('--flow-script-path <path>', 'Override macOS flow script path')
-        .addOption(new Option('--cloud-ocr-url <url>', 'Deprecated; ignored because WeChat RPA uses local-only OCR').hideHelp())
-        .addOption(new Option('--cloud-ocr-token <token>', 'Deprecated; ignored because WeChat RPA uses local-only OCR').hideHelp())
-        .addOption(new Option('--cloud-ocr-mode <off|fallback|always>', 'Deprecated; ignored because WeChat RPA uses local-only OCR').hideHelp())
         .option('--json', 'Print JSON')
         .action(async (opts) => {
         if (opts.enabled === 'true' && opts.group.length > 1) {

package/dist/src/index.js

@@ -25,6 +25,7 @@ const AUTO_UPGRADE_INITIAL_DELAY_MS = 30_000;
 const AUTO_UPGRADE_POLL_INTERVAL_MS = 5 * 60_000;
 import { getCachedAgentInfos, resolveAgentInfos } from './agents/model-registry.js';
 import { initCliLogReporter, reportLog } from './log-reporter.js';
+import { isNativeFusionEnabled } from './native-fusion/config.js';
 import { NativeSessionFusionService } from './native-fusion/service.js';
 import { startDaemonLogRetention } from './daemon-log.js';
 const SHENNIAN_DIR = getShennianDir();
@@ -285,7 +286,7 @@ program
         },
     });
     nativeFusion =
-        process.env.SHENNIAN_NATIVE_FUSION_ENABLED === '1'
+        isNativeFusionEnabled()
             ? new NativeSessionFusionService(client)
             : null;
     const sessionManager = new SessionManager(client, nativeFusion, currentCliVersion);

package/dist/src/manager/runtime.js

@@ -665,9 +665,6 @@ export class ManagerRuntimeService {
                     downloadAttachments: body.downloadAttachments === undefined ? undefined : Boolean(body.downloadAttachments),
                     downloadAttachmentsDir: typeof body.downloadAttachmentsDir === 'string' ? body.downloadAttachmentsDir : undefined,
                     flowScriptPath: typeof body.flowScriptPath === 'string' ? body.flowScriptPath : undefined,
-                    cloudOcrUrl: typeof body.cloudOcrUrl === 'string' ? body.cloudOcrUrl : undefined,
-                    cloudOcrToken: typeof body.cloudOcrToken === 'string' ? body.cloudOcrToken : undefined,
-                    cloudOcrMode: parseCloudOcrMode(body.cloudOcrMode),
                 });
                 this.registry.upsertManager({
                     ...manager,
@@ -1004,9 +1001,6 @@ function mimeTypeFromExternalAttachment(attachment) {
         return 'audio/*';
     return 'application/octet-stream';
 }
-function parseCloudOcrMode(value) {
-    return value === 'off' || value === 'fallback' || value === 'always' ? value : undefined;
-}
 function optionalNumber(value) {
     const number = Number(value);
     return Number.isFinite(number) ? number : undefined;

package/dist/src/native-fusion/config.d.ts

@@ -0,0 +1 @@
+export declare function isNativeFusionEnabled(env?: NodeJS.ProcessEnv): boolean;

package/dist/src/native-fusion/config.js

@@ -0,0 +1,5 @@
+// @arch docs/architecture/cli/native-session-fusion.md
+// @test src/__tests__/native-fusion-config.test.ts
+export function isNativeFusionEnabled(env = process.env) {
+    return env.SHENNIAN_NATIVE_FUSION_DISABLED !== '1';
+}