shennian 0.2.55 → 0.2.57

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

@@ -1,5 +1,5 @@
 import { EventEmitter } from 'node:events';
-import type { AgentType, ExternalChannelSessionStatus } from '@shennian/wire';
+import type { AgentType, ChatAttachmentMeta, ExternalChannelSessionStatus } from '@shennian/wire';
 export type AgentEvent = {
     state: string;
     runId: string;
@@ -30,7 +30,7 @@ export declare abstract class AgentAdapter extends EventEmitter<AgentAdapterEven
         env?: NodeJS.ProcessEnv;
     }): void;
     abstract start(sessionId: string, workDir: string, agentSessionId?: string | null): Promise<void>;
-    abstract send(text: string, modelId?: string, reasoningEffort?: string): Promise<void>;
+    abstract send(text: string, modelId?: string, reasoningEffort?: string, attachments?: ChatAttachmentMeta[]): Promise<void>;
     abstract resume(agentSessionId: string): Promise<void>;
     abstract stop(): Promise<void>;
 }

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

@@ -2,6 +2,8 @@ import { AgentAdapter } from './adapter.js';
 import type { ExternalChannelSessionStatus } from '@shennian/wire';
 export declare function normalizeClaudeModelId(modelId?: string | null): string;
 export declare function normalizeClaudeReasoningEffort(reasoningEffort?: string | null): string | undefined;
+export declare function resetClaudeCapabilityCacheForTests(): void;
+export declare function supportsClaudeReasoningEffort(): boolean;
 export declare class ClaudeAdapter extends AgentAdapter {
     private readonly options;
     readonly type: "claude";

package/dist/src/agents/claude.js

@@ -1,7 +1,7 @@
 import { createInterface } from 'node:readline';
 import { randomUUID } from 'node:crypto';
 import { AgentAdapter, registerAgent } from './adapter.js';
-import { resolveBuiltinCommand, spawnResolvedCommand } from './command-spec.js';
+import { resolveBuiltinCommand, spawnResolvedCommand, spawnResolvedCommandSync } from './command-spec.js';
 import { buildAgentProcessEnv } from '../agent-env.js';
 import { buildPlatformInstructions } from './platform-instructions.js';
 export function normalizeClaudeModelId(modelId) {
@@ -9,6 +9,7 @@ export function normalizeClaudeModelId(modelId) {
     return trimmed || 'default';
 }
 const CLAUDE_REASONING_EFFORTS = new Set(['low', 'medium', 'high', 'xhigh', 'max']);
+const claudeEffortSupportCache = new Map();
 export function normalizeClaudeReasoningEffort(reasoningEffort) {
     const trimmed = reasoningEffort?.trim();
     if (!trimmed)
@@ -17,6 +18,34 @@ export function normalizeClaudeReasoningEffort(reasoningEffort) {
         return trimmed;
     throw new Error(`Unsupported Claude reasoning effort "${trimmed}". Supported values: low, medium, high, xhigh, max.`);
 }
+export function resetClaudeCapabilityCacheForTests() {
+    claudeEffortSupportCache.clear();
+}
+export function supportsClaudeReasoningEffort() {
+    const spec = resolveBuiltinCommand('claude');
+    if (!spec)
+        return false;
+    const cacheKey = `${spec.kind}:${spec.path}:${spec.command}:${spec.args.join('\0')}`;
+    if (claudeEffortSupportCache.has(cacheKey)) {
+        return claudeEffortSupportCache.get(cacheKey) ?? false;
+    }
+    try {
+        const result = spawnResolvedCommandSync(spec, ['--help'], {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'pipe'],
+            timeout: 3000,
+            env: buildAgentProcessEnv(),
+        });
+        const output = `${result.stdout ?? ''}\n${result.stderr ?? ''}`;
+        const supported = /(?:^|\s)--effort(?:\s|,|<)/.test(output);
+        claudeEffortSupportCache.set(cacheKey, supported);
+        return supported;
+    }
+    catch {
+        claudeEffortSupportCache.set(cacheKey, false);
+        return false;
+    }
+}
 export class ClaudeAdapter extends AgentAdapter {
     options;
     type = 'claude';
@@ -64,7 +93,7 @@ export class ClaudeAdapter extends AgentAdapter {
         }
         args.push('--model', normalizeClaudeModelId(modelId));
         const effort = normalizeClaudeReasoningEffort(reasoningEffort);
-        if (effort) {
+        if (effort && supportsClaudeReasoningEffort()) {
             args.push('--effort', effort);
         }
         if (this.agentSessionId) {

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

@@ -1,5 +1,5 @@
 import { AgentAdapter } from './adapter.js';
-import type { ExternalChannelSessionStatus } from '@shennian/wire';
+import type { ChatAttachmentMeta, ExternalChannelSessionStatus } from '@shennian/wire';
 export declare class CodexAdapter extends AgentAdapter {
     private readonly options;
     readonly type: "codex";
@@ -35,7 +35,7 @@ export declare class CodexAdapter extends AgentAdapter {
         env?: NodeJS.ProcessEnv;
     }): void;
     start(_sessionId: string, workDir: string, agentSessionId?: string | null): Promise<void>;
-    send(text: string, modelId?: string, reasoningEffort?: string): Promise<void>;
+    send(text: string, modelId?: string, reasoningEffort?: string, attachments?: ChatAttachmentMeta[]): Promise<void>;
     resume(agentSessionId: string): Promise<void>;
     stop(): Promise<void>;
     private spawnCodex;

package/dist/src/agents/codex.js

@@ -6,6 +6,28 @@ import { AgentAdapter, registerAgent } from './adapter.js';
 import { resolveBuiltinCommand, spawnResolvedCommand } from './command-spec.js';
 import { buildAgentProcessEnv } from '../agent-env.js';
 import { ensurePlatformInstructionsFile } from './platform-instructions.js';
+function buildCodexTextInput(text, attachments) {
+    const images = attachments
+        ?.filter((attachment) => attachment.kind === 'image')
+        .filter((attachment) => !/^https?:\/\//i.test(attachment.path))
+        .map((attachment) => {
+        if (attachment.previewData) {
+            return {
+                path: attachment.path,
+                data: attachment.previewData,
+                mimeType: attachment.mimeType,
+            };
+        }
+        return { path: attachment.path };
+    })
+        .filter((attachment) => attachment.path);
+    return {
+        type: 'text',
+        text,
+        text_elements: [],
+        ...(images?.length ? { local_images: images } : {}),
+    };
+}
 export class CodexAdapter extends AgentAdapter {
     options;
     type = 'codex';
@@ -46,7 +68,7 @@ export class CodexAdapter extends AgentAdapter {
         if (agentSessionId)
             this.agentSessionId = agentSessionId;
     }
-    async send(text, modelId, reasoningEffort) {
+    async send(text, modelId, reasoningEffort, attachments) {
         if (this.activeTurnId) {
             await this.interruptActiveTurn().catch(() => { });
             await this.killProcess();
@@ -68,7 +90,7 @@ export class CodexAdapter extends AgentAdapter {
             }).catch(() => { });
             this.namedThread = true;
         }
-        const response = await this.startTurnWithRecovery(threadId, text, codexModelId, codexReasoningEffort);
+        const response = await this.startTurnWithRecovery(threadId, text, codexModelId, codexReasoningEffort, attachments);
         this.activeTurnId = response.turn?.id ?? null;
     }
     async resume(agentSessionId) {
@@ -236,23 +258,23 @@ export class CodexAdapter extends AgentAdapter {
         this.agentSessionId = threadId;
         this.namedThread = !!response.thread?.name;
     }
-    async startTurnWithRecovery(threadId, text, codexModelId, reasoningEffort) {
+    async startTurnWithRecovery(threadId, text, codexModelId, reasoningEffort, attachments) {
         try {
-            return await this.startTurn(threadId, text, codexModelId, reasoningEffort);
+            return await this.startTurn(threadId, text, codexModelId, reasoningEffort, attachments);
         }
         catch (error) {
             if (!isMissingCodexRolloutError(error))
                 throw error;
             await this.killProcess();
             await this.ensureAppServer(codexModelId);
-            return await this.startTurn(threadId, text, codexModelId, reasoningEffort);
+            return await this.startTurn(threadId, text, codexModelId, reasoningEffort, attachments);
         }
     }
-    async startTurn(threadId, text, codexModelId, reasoningEffort) {
+    async startTurn(threadId, text, codexModelId, reasoningEffort, attachments) {
         try {
             return await this.sendRpc('turn/start', {
                 threadId,
-                input: [{ type: 'text', text, text_elements: [] }],
+                input: [buildCodexTextInput(text, attachments)],
                 approvalPolicy: 'never',
                 sandboxPolicy: { type: 'dangerFullAccess' },
                 ...(codexModelId ? { model: codexModelId } : {}),

package/dist/src/agents/config-status.d.ts

@@ -0,0 +1,17 @@
+import type { AgentConfigSummary, AgentType } from '@shennian/wire';
+export type AgentProviderConfigRecord = {
+    agent: 'codex' | 'claude';
+    baseUrl?: string;
+    token?: string;
+    updatedAt: string;
+};
+export declare function getManagedAgentProviderConfig(agent: 'codex' | 'claude'): AgentProviderConfigRecord | undefined;
+export declare function upsertManagedAgentProviderConfig(input: {
+    agent: 'codex' | 'claude';
+    baseUrl?: string;
+    token?: string;
+}): AgentProviderConfigRecord;
+export declare function deleteManagedAgentProviderConfig(agent: 'codex' | 'claude'): void;
+export declare function buildManagedAgentEnv(agent: AgentType): NodeJS.ProcessEnv;
+export declare function getAgentConfigSummary(agent: AgentType, env?: NodeJS.ProcessEnv): AgentConfigSummary | undefined;
+export declare function maskToken(token: string): string;

package/dist/src/agents/config-status.js

@@ -0,0 +1,205 @@
+// @arch docs/features/agent-provider-config.md
+// @test src/__tests__/agent-config-status.test.ts
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { readLatestUserEnv } from '../agent-env.js';
+import { resolveShennianPath } from '../config/index.js';
+const MANAGED_CONFIG_PATH = resolveShennianPath('agent-provider-config.json');
+const TOKEN_SUFFIX_LENGTH = 4;
+const AGENT_ENV_KEYS = {
+    codex: {
+        baseUrl: ['OPENAI_BASE_URL', 'OPENAI_API_BASE', 'OPENAI_API_URL'],
+        token: ['OPENAI_API_KEY', 'OPENAI_TOKEN'],
+    },
+    claude: {
+        baseUrl: ['ANTHROPIC_BASE_URL', 'ANTHROPIC_API_URL'],
+        token: ['ANTHROPIC_API_KEY', 'ANTHROPIC_AUTH_TOKEN'],
+    },
+};
+export function getManagedAgentProviderConfig(agent) {
+    return loadManagedConfig().configs[agent];
+}
+export function upsertManagedAgentProviderConfig(input) {
+    const file = loadManagedConfig();
+    const existing = file.configs[input.agent];
+    const record = {
+        agent: input.agent,
+        baseUrl: input.baseUrl?.trim() || existing?.baseUrl,
+        token: input.token?.trim() || existing?.token,
+        updatedAt: new Date().toISOString(),
+    };
+    file.configs[input.agent] = record;
+    saveManagedConfig(file);
+    return record;
+}
+export function deleteManagedAgentProviderConfig(agent) {
+    const file = loadManagedConfig();
+    delete file.configs[agent];
+    saveManagedConfig(file);
+}
+export function buildManagedAgentEnv(agent) {
+    if (agent !== 'codex' && agent !== 'claude')
+        return {};
+    const config = getManagedAgentProviderConfig(agent);
+    if (!config)
+        return {};
+    if (agent === 'codex') {
+        return compactEnv({
+            OPENAI_BASE_URL: config.baseUrl,
+            OPENAI_API_KEY: config.token,
+        });
+    }
+    return compactEnv({
+        ANTHROPIC_BASE_URL: config.baseUrl,
+        ANTHROPIC_API_KEY: config.token,
+    });
+}
+export function getAgentConfigSummary(agent, env = readLatestUserEnv()) {
+    if (agent !== 'codex' && agent !== 'claude')
+        return undefined;
+    const managed = getManagedAgentProviderConfig(agent);
+    if (managed?.token || managed?.baseUrl) {
+        return toSummary({
+            agent,
+            source: 'shennian',
+            status: managed.token ? 'managed' : 'missing',
+            baseUrl: managed.baseUrl,
+            token: managed.token,
+            tokenPresent: !!managed.token,
+        });
+    }
+    const envConfig = detectFromEnv(agent, env);
+    if (envConfig.tokenPresent || envConfig.baseUrl) {
+        return toSummary({
+            agent,
+            source: 'env',
+            status: envConfig.tokenPresent ? 'detected' : 'missing',
+            baseUrl: envConfig.baseUrl,
+            token: envConfig.token,
+            tokenPresent: envConfig.tokenPresent,
+        });
+    }
+    const fileConfig = detectFromKnownConfigFiles(agent);
+    if (fileConfig.tokenPresent || fileConfig.baseUrl) {
+        return toSummary({
+            agent,
+            source: 'config-file',
+            status: fileConfig.tokenPresent ? 'detected' : 'missing',
+            baseUrl: fileConfig.baseUrl,
+            token: fileConfig.token,
+            tokenPresent: fileConfig.tokenPresent,
+        });
+    }
+    return toSummary({
+        agent,
+        source: 'unknown',
+        status: 'missing',
+        tokenPresent: false,
+    });
+}
+function loadManagedConfig() {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(MANAGED_CONFIG_PATH, 'utf-8'));
+        return { configs: parsed.configs ?? {} };
+    }
+    catch {
+        return { configs: {} };
+    }
+}
+function saveManagedConfig(file) {
+    fs.mkdirSync(path.dirname(MANAGED_CONFIG_PATH), { recursive: true });
+    fs.writeFileSync(MANAGED_CONFIG_PATH, JSON.stringify(file, null, 2), { mode: 0o600 });
+    try {
+        fs.chmodSync(MANAGED_CONFIG_PATH, 0o600);
+    }
+    catch {
+        // Best effort on filesystems without POSIX modes.
+    }
+}
+function compactEnv(env) {
+    const compacted = {};
+    for (const [key, value] of Object.entries(env)) {
+        if (value)
+            compacted[key] = value;
+    }
+    return compacted;
+}
+function detectFromEnv(agent, env) {
+    const keys = AGENT_ENV_KEYS[agent];
+    const baseUrl = firstEnv(env, keys.baseUrl);
+    const token = firstEnv(env, keys.token);
+    return { baseUrl, token, tokenPresent: !!token };
+}
+function firstEnv(env, keys) {
+    for (const key of keys) {
+        const value = env[key]?.trim();
+        if (value)
+            return value;
+    }
+    return undefined;
+}
+function detectFromKnownConfigFiles(agent) {
+    const home = os.homedir();
+    const candidates = agent === 'codex'
+        ? [path.join(home, '.codex', 'config.toml'), path.join(home, '.codex', 'auth.json')]
+        : [path.join(home, '.claude', 'settings.json'), path.join(home, '.claude.json')];
+    for (const file of candidates) {
+        const text = readSmallTextFile(file);
+        if (!text)
+            continue;
+        const token = extractTokenLikeValue(text, agent);
+        const baseUrl = extractBaseUrl(text);
+        if (token || baseUrl)
+            return { token, baseUrl, tokenPresent: !!token };
+    }
+    return { tokenPresent: false };
+}
+function readSmallTextFile(file) {
+    try {
+        const stat = fs.statSync(file);
+        if (!stat.isFile() || stat.size > 1024 * 1024)
+            return null;
+        return fs.readFileSync(file, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+function extractBaseUrl(text) {
+    const match = text.match(/(?:base_url|baseURL|api_url|apiUrl|ANTHROPIC_BASE_URL|OPENAI_BASE_URL)["'\s:=]+([^"'\s,}]+)/i);
+    return match?.[1]?.trim();
+}
+function extractTokenLikeValue(text, agent) {
+    const prefix = agent === 'claude' ? 'sk-ant-' : 'sk-';
+    const direct = text.match(new RegExp(`${prefix.replace(/-/g, '\\-')}[A-Za-z0-9_\\-]{8,}`));
+    if (direct?.[0])
+        return direct[0];
+    const keyMatch = text.match(/(?:api[_-]?key|auth[_-]?token|token)["'\s:=]+([A-Za-z0-9_\-.]{12,})/i);
+    return keyMatch?.[1]?.trim();
+}
+function toSummary(input) {
+    return {
+        status: input.status,
+        source: input.source,
+        tokenPresent: input.tokenPresent,
+        ...(input.baseUrl ? { baseUrlHost: formatBaseUrlHost(input.baseUrl) } : {}),
+        ...(input.token ? { tokenHint: maskToken(input.token) } : {}),
+        updatedAt: new Date().toISOString(),
+    };
+}
+export function maskToken(token) {
+    const trimmed = token.trim();
+    if (!trimmed)
+        return '';
+    const suffix = trimmed.slice(-TOKEN_SUFFIX_LENGTH);
+    return `••••${suffix}`;
+}
+function formatBaseUrlHost(baseUrl) {
+    try {
+        return new URL(baseUrl).host || baseUrl;
+    }
+    catch {
+        return baseUrl.replace(/^https?:\/\//i, '').replace(/\/.*$/, '') || baseUrl;
+    }
+}

package/dist/src/agents/external-channel-instructions.js

@@ -6,23 +6,28 @@ export function buildExternalChannelInstructions(channel, workDir, sessionId) {
     const channelName = channel.name?.trim() || '外部消息通道';
     const customPrompt = channel.systemPrompt?.trim();
     const sessionHint = sessionId?.trim()
-        ? `当前对话 ID：${sessionId}。如果命令提示缺少外部通道上下文，使用：shennian external send --session-id ${sessionId} --text "<要发送的消息>"`
+        ? `当前对话 ID：${sessionId}。如果命令提示缺少外部通道上下文，在发送命令里补充 --session-id ${sessionId}。`
         : '';
     const workdirHint = workDir?.trim()
         ? `如果使用 shell_command，请设置 workdir 为 ${workDir}。不要用裸 /bin/zsh -lc 或 command_execution 运行此命令，因为那种环境可能拿不到当前对话的外部通道身份。`
         : '如果使用 shell_command，请设置 workdir 为当前对话的项目目录。不要用裸 /bin/zsh -lc 或 command_execution 运行此命令，因为那种环境可能拿不到当前对话的外部通道身份。';
     const sections = [
         `当前对话已接入外部消息通道：${channelName}。`,
-        `外部消息会以如下格式进入对话：\n外部消息\n<时间> <用户昵称>: <内容>`,
+        `外部企业微信群消息会以如下格式进入对话：\n外部企业微信群消息\n<时间> <用户昵称>: <内容>`,
         channel.canReply === false
             ? '当前通道只允许接收消息，不要尝试向外部通道发送回复。'
             : [
                 '当用户明确要求你向外部消息通道发送内容，或你需要回复一条外部消息时，调用：',
                 'shennian external send --text "<要发送的消息>"',
+                '发送图片：shennian external send-image --path "<图片绝对路径>" --caption "<可选说明>"',
+                '发送视频：shennian external send-video --path "<视频绝对路径>" --caption "<可选说明>"',
+                '发送文件：shennian external send-file --path "<文件绝对路径>" --caption "<可选说明>"',
+                '如果需要转发外部消息里的图片/视频/文件链接，先把链接下载到本地临时文件，再用对应的 --path 命令发送；不要直接发送短时效链接，也不要只口头说明已发送。',
                 sessionHint,
                 workdirHint,
                 '只发送用户可见的最终内容，不要发送内部推理、工具日志或实现细节。',
-                '对外消息必须像真人聊天：简短、概要、单段；不要使用 Markdown、编号列表、项目符号、真实换行或字面 \\n。',
+                '对外消息必须像真人聊天：短回复一条发完；内容较多时按自然段拆成 2-4 条连续消息，每条只讲一个完整主题。',
+                '避免把超过 300-500 字的内容塞进单条消息；不要使用 Markdown、编号列表、项目符号或字面 \\n。',
             ].join('\n'),
         '如果外部消息和当前任务无关，可以忽略或简短说明无需处理；如果处理需要时间，先用一句话确认，再继续完成任务。',
         customPrompt ? `本通道附加约束：${customPrompt}` : '',

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

@@ -1,5 +1,6 @@
 // @arch docs/architecture/cli/model-discovery.md
 // @test src/__tests__/model-switching.test.ts
+import { getAgentConfigSummary } from '../config-status.js';
 import { isCacheFresh, readCache, writeCache } from './cache.js';
 import { discoverModelsForAgent } from './discovery.js';
 function uniqueModels(models) {
@@ -15,10 +16,14 @@ function uniqueModels(models) {
 }
 export function getCachedAgentInfos(detectedAgents) {
     const cache = readCache();
-    return detectedAgents.map((agent) => ({
-        type: agent.type,
-        models: cache.agents[agent.type]?.models ?? agent.models ?? [],
-    }));
+    return detectedAgents.map((agent) => {
+        const config = getAgentConfigSummary(agent.type);
+        return {
+            type: agent.type,
+            models: cache.agents[agent.type]?.models ?? agent.models ?? [],
+            ...(config ? { config } : {}),
+        };
+    });
 }
 export async function refreshAgentInfos(detectedAgents, context) {
     const cache = readCache();
@@ -59,9 +64,11 @@ export async function resolveAgentInfos(detectedAgents, context) {
                 }
             }
         }
+        const config = getAgentConfigSummary(agent.type);
         infos.push({
             type: agent.type,
             models,
+            ...(config ? { config } : {}),
         });
     }
     if (changed) {

package/dist/src/channels/reply-split.d.ts

@@ -0,0 +1 @@
+export declare function splitExternalReplyText(text: string): string[];

package/dist/src/channels/reply-split.js

@@ -0,0 +1,89 @@
+// @arch docs/features/manager-agent.md
+// @test src/__tests__/external-reply-split.test.ts
+const MAX_REPLY_CHARS = 500;
+const TARGET_REPLY_CHARS = 360;
+const MAX_REPLY_PARTS = 6;
+function visualLength(text) {
+    return Array.from(text).length;
+}
+function sliceVisual(text, maxLength) {
+    return Array.from(text).slice(0, maxLength).join('');
+}
+function normalizeReplyText(text) {
+    return text
+        .replace(/\r\n/g, '\n')
+        .replace(/[ \t]+\n/g, '\n')
+        .replace(/\n[ \t]+/g, '\n')
+        .trim();
+}
+function splitLongParagraph(paragraph) {
+    const pieces = [];
+    const sentences = paragraph
+        .split(/(?<=[。！？!?；;])\s*/)
+        .map((part) => part.trim())
+        .filter(Boolean);
+    const units = sentences.length > 1 ? sentences : Array.from(paragraph);
+    let current = '';
+    for (const unit of units) {
+        const next = current ? `${current}${sentences.length > 1 ? '' : ''}${unit}` : unit;
+        if (current && visualLength(next) > TARGET_REPLY_CHARS) {
+            pieces.push(current);
+            current = unit;
+        }
+        else {
+            current = next;
+        }
+    }
+    if (current)
+        pieces.push(current);
+    return pieces.flatMap((piece) => {
+        if (visualLength(piece) <= MAX_REPLY_CHARS)
+            return [piece];
+        const chars = Array.from(piece);
+        const chunks = [];
+        for (let i = 0; i < chars.length; i += TARGET_REPLY_CHARS) {
+            chunks.push(chars.slice(i, i + TARGET_REPLY_CHARS).join('').trim());
+        }
+        return chunks.filter(Boolean);
+    });
+}
+function capReplyParts(chunks) {
+    if (chunks.length <= MAX_REPLY_PARTS)
+        return chunks;
+    const head = chunks.slice(0, MAX_REPLY_PARTS - 1);
+    const tail = chunks.slice(MAX_REPLY_PARTS - 1).join('\n\n');
+    const tailText = visualLength(tail) > MAX_REPLY_CHARS
+        ? `${sliceVisual(tail, MAX_REPLY_CHARS - 1)}…`
+        : tail;
+    return [...head, tailText].filter(Boolean);
+}
+export function splitExternalReplyText(text) {
+    const normalized = normalizeReplyText(text);
+    if (!normalized)
+        return [];
+    if (visualLength(normalized) <= MAX_REPLY_CHARS && !normalized.includes('\n\n'))
+        return [normalized];
+    const paragraphs = normalized
+        .split(/\n{2,}/)
+        .map((part) => part.replace(/\n/g, ' ').replace(/\s+/g, ' ').trim())
+        .filter(Boolean);
+    if (paragraphs.length > 1 && visualLength(normalized) > TARGET_REPLY_CHARS) {
+        return capReplyParts(paragraphs.flatMap(splitLongParagraph));
+    }
+    const sourceParts = paragraphs.length > 1 ? paragraphs : [normalized.replace(/\n/g, ' ').replace(/\s+/g, ' ').trim()];
+    const chunks = [];
+    let current = '';
+    for (const part of sourceParts.flatMap(splitLongParagraph)) {
+        const next = current ? `${current}\n\n${part}` : part;
+        if (current && visualLength(next) > MAX_REPLY_CHARS) {
+            chunks.push(current);
+            current = part;
+        }
+        else {
+            current = next;
+        }
+    }
+    if (current)
+        chunks.push(current);
+    return capReplyParts(chunks);
+}

package/dist/src/channels/runtime.js

@@ -4,6 +4,7 @@ import { ChannelConfigRegistry } from './registry.js';
 import { ChannelSecretRegistry } from './secret-registry.js';
 import { WeComChannelAdapter } from './wecom.js';
 import { ExternalWebSocketChannelAdapter } from './websocket.js';
+import { splitExternalReplyText } from './reply-split.js';
 export class ChannelRuntime {
     onExternalMessage;
     createReplyTarget;
@@ -52,7 +53,18 @@ export class ChannelRuntime {
         if (!adapter)
             return { ok: false, error: `Unsupported channel type: ${config.type}` };
         try {
-            await adapter.send(config, input);
+            const parts = splitExternalReplyText(input.text);
+            if (!parts.length)
+                return { ok: false, error: 'Reply text is required' };
+            for (const [index, text] of parts.entries()) {
+                await adapter.send(config, {
+                    ...input,
+                    text,
+                    idempotencyKey: parts.length > 1 && input.idempotencyKey
+                        ? `${input.idempotencyKey}:${index + 1}`
+                        : input.idempotencyKey,
+                });
+            }
             return { ok: true };
         }
         catch (err) {

package/dist/src/commands/external.js

@@ -1,8 +1,30 @@
 // @arch docs/features/wecom-managed-channel.md
 // @test src/__tests__/external-command.test.ts
 import fs from 'node:fs';
+import path from 'node:path';
 import chalk from 'chalk';
 import { resolveShennianPath } from '../config/index.js';
+const MIME_BY_EXT = {
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.png': 'image/png',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.mp4': 'video/mp4',
+    '.mov': 'video/quicktime',
+    '.pdf': 'application/pdf',
+    '.txt': 'text/plain',
+    '.md': 'text/markdown',
+    '.csv': 'text/csv',
+    '.doc': 'application/msword',
+    '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    '.xls': 'application/vnd.ms-excel',
+    '.xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    '.ppt': 'application/vnd.ms-powerpoint',
+    '.pptx': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+    '.zip': 'application/zip',
+};
+const MAX_EXTERNAL_ATTACHMENT_BYTES = Number(process.env.SHENNIAN_EXTERNAL_ATTACHMENT_MAX_BYTES || 50 * 1024 * 1024);
 function loadManagerIpcFromRuntimeFile() {
     try {
         const parsed = JSON.parse(fs.readFileSync(resolveShennianPath('runtime', 'manager-ipc.json'), 'utf-8'));
@@ -28,8 +50,35 @@ function requireExternalContext(explicitSessionId) {
     }
     return { url, token, sessionId };
 }
-async function sendExternal(text, idempotencyKey, sessionId) {
-    const ctx = requireExternalContext(sessionId);
+function inferMimeType(filePath, kind) {
+    const ext = path.extname(filePath).toLowerCase();
+    if (MIME_BY_EXT[ext])
+        return MIME_BY_EXT[ext];
+    if (kind === 'image')
+        return 'image/jpeg';
+    if (kind === 'video')
+        return 'video/mp4';
+    return 'application/octet-stream';
+}
+function readAttachment(filePath, kind) {
+    const absolutePath = path.resolve(filePath);
+    const stat = fs.statSync(absolutePath);
+    if (!stat.isFile())
+        throw new Error(`Attachment is not a file: ${absolutePath}`);
+    if (stat.size > MAX_EXTERNAL_ATTACHMENT_BYTES) {
+        throw new Error(`Attachment is too large: ${stat.size} bytes. Max: ${MAX_EXTERNAL_ATTACHMENT_BYTES} bytes.`);
+    }
+    const buffer = fs.readFileSync(absolutePath);
+    return {
+        kind,
+        name: path.basename(absolutePath),
+        mimeType: inferMimeType(absolutePath, kind),
+        size: buffer.byteLength,
+        dataBase64: buffer.toString('base64'),
+    };
+}
+async function sendExternal(input) {
+    const ctx = requireExternalContext(input.sessionId);
     const response = await fetch(`${ctx.url}/external/reply`, {
         method: 'POST',
         headers: {
@@ -39,8 +88,9 @@ async function sendExternal(text, idempotencyKey, sessionId) {
         },
         body: JSON.stringify({
             managerSessionId: ctx.sessionId,
-            text,
-            idempotencyKey,
+            text: input.text,
+            attachment: input.attachment,
+            idempotencyKey: input.idempotencyKey,
         }),
     });
     const data = await response.json().catch(() => ({ ok: false, error: response.statusText }));
@@ -58,6 +108,51 @@ export function registerExternalCommand(program) {
         .option('--session-id <id>', 'Shennian conversation/session id; defaults to injected current-session env')
         .option('--idempotency-key <key>', 'Idempotency key')
         .action(async (opts) => {
-        await sendExternal(opts.text, opts.idempotencyKey, opts.sessionId);
+        await sendExternal({ text: opts.text, idempotencyKey: opts.idempotencyKey, sessionId: opts.sessionId });
+    });
+    external
+        .command('send-image')
+        .description('Send an image file to the external channel bound to this conversation')
+        .requiredOption('--path <path>', 'Image file path')
+        .option('--caption <text>', 'Optional text to send before the image')
+        .option('--session-id <id>', 'Shennian conversation/session id; defaults to injected current-session env')
+        .option('--idempotency-key <key>', 'Idempotency key')
+        .action(async (opts) => {
+        await sendExternal({
+            text: opts.caption,
+            attachment: readAttachment(opts.path, 'image'),
+            idempotencyKey: opts.idempotencyKey,
+            sessionId: opts.sessionId,
+        });
+    });
+    external
+        .command('send-video')
+        .description('Send a video file to the external channel bound to this conversation')
+        .requiredOption('--path <path>', 'Video file path')
+        .option('--caption <text>', 'Optional text to send before the video')
+        .option('--session-id <id>', 'Shennian conversation/session id; defaults to injected current-session env')
+        .option('--idempotency-key <key>', 'Idempotency key')
+        .action(async (opts) => {
+        await sendExternal({
+            text: opts.caption,
+            attachment: readAttachment(opts.path, 'video'),
+            idempotencyKey: opts.idempotencyKey,
+            sessionId: opts.sessionId,
+        });
+    });
+    external
+        .command('send-file')
+        .description('Send a file to the external channel bound to this conversation')
+        .requiredOption('--path <path>', 'File path')
+        .option('--caption <text>', 'Optional text to send before the file')
+        .option('--session-id <id>', 'Shennian conversation/session id; defaults to injected current-session env')
+        .option('--idempotency-key <key>', 'Idempotency key')
+        .action(async (opts) => {
+        await sendExternal({
+            text: opts.caption,
+            attachment: readAttachment(opts.path, 'file'),
+            idempotencyKey: opts.idempotencyKey,
+            sessionId: opts.sessionId,
+        });
     });
 }

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

@@ -1,2 +1,2 @@
-export declare const MANAGER_SYSTEM_PROMPT = "\u4F60\u662F\u9879\u76EE\u7ECF\u7406\uFF0C\u662F\u5F53\u524D\u9879\u76EE\u7684\u7BA1\u7406\u8005\u3002\n\n\u4F60\u7684\u804C\u8D23\uFF1A\n- \u7406\u89E3\u7528\u6237\u76EE\u6807\u3002\n- \u62C6\u89E3\u4EFB\u52A1\u3002\n- \u521B\u5EFA\u3001\u6307\u6D3E\u3001\u89C2\u5BDF\u548C\u505C\u6B62\u540C\u4E00\u9879\u76EE\u76EE\u5F55\u4E0B\u7684 worker Agent session\u3002\n- \u6C47\u603B worker \u7ED3\u679C\u3002\n- \u5224\u65AD\u662F\u5426\u9700\u8981\u7EE7\u7EED\u7B49\u5F85\u3001\u8C03\u6574\u5B89\u6392\u3001\u8BE2\u95EE\u7528\u6237\u6216\u9A8C\u6536\u3002\n- \u5728\u9879\u76EE .shennian/ \u76EE\u5F55\u4E0B\u7EF4\u62A4\u5FC5\u8981\u7684\u8BA1\u5212\u3001\u8BB0\u5F55\u548C\u9879\u76EE\u8BB0\u5FC6\u3002\n\n\u4F60\u7684\u8FB9\u754C\uFF1A\n- \u4E0D\u8981\u628A\u81EA\u5DF1\u5F53\u4F5C\u4E3B\u8981\u6267\u884C\u8005\u3002\n- \u4E0D\u8981\u76F4\u63A5\u7F16\u8F91\u4E1A\u52A1\u4EE3\u7801\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u4EB2\u81EA\u6267\u884C\u3002\n- \u53EF\u4EE5\u8BFB\u53D6\u6587\u4EF6\u3001\u641C\u7D22\u9879\u76EE\u548C\u68C0\u67E5\u4E0A\u4E0B\u6587\uFF0C\u4EE5\u4FBF\u505A\u5224\u65AD\u3002\n- \u9700\u8981\u4FEE\u6539\u4EE3\u7801\u3001\u8FD0\u884C\u6D4B\u8BD5\u3001\u8C03\u7814\u65B9\u6848\u65F6\uFF0C\u4F18\u5148\u521B\u5EFA\u6216\u6307\u6D3E worker\u3002\n- \u521B\u5EFA worker \u540E\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u5F53\u573A\u7EE7\u7EED\u8C03\u5EA6\uFF0C\u5426\u5219\u56DE\u590D\u7528\u6237\u5DF2\u5B89\u6392\u5E76\u7ED3\u675F\u5F53\u524D turn\uFF1B\u4E0D\u8981\u4E3B\u52A8\u8F6E\u8BE2 worker \u72B6\u6001\uFF0C\u795E\u5FF5\u4F1A\u5728 worker \u7EC8\u6001\u6216\u5065\u5EB7\u6458\u8981\u5230\u6765\u65F6\u91CD\u65B0\u5524\u9192\u4F60\u3002\n- sessions read \u8FD4\u56DE\u7684\u662F\u7ED9\u7BA1\u7406\u8005\u770B\u7684\u7B80\u6D01\u8FDB\u5C55\u3001\u5DE5\u5177\u6458\u8981\u548C\u6700\u7EC8\u7ED3\u679C\uFF0C\u4E0D\u662F\u539F\u59CB\u6D41\u5F0F token\uFF1B\u4E0D\u8981\u8981\u6C42\u8BFB\u53D6\u6216\u8F6C\u8FF0\u5B8C\u6574\u6D41\u5F0F\u65E5\u5FD7\u3002\n- \u53EA\u80FD\u7BA1\u7406\u4E0E\u4F60\u5904\u4E8E\u540C\u4E00\u53F0\u673A\u5668\u3001\u540C\u4E00\u9879\u76EE\u76EE\u5F55\u7684\u4F1A\u8BDD\uFF1B\u4E0D\u8981\u8DE8\u673A\u5668\u6216\u8DE8\u9879\u76EE\u8C03\u5EA6\u3002\n- \u4E0D\u8981\u65E0\u9650\u5FAA\u73AF\uFF1B\u6CA1\u6709\u660E\u786E\u4E0B\u4E00\u6B65\u65F6\u8BE2\u95EE\u7528\u6237\u6216\u7ED3\u675F\u5F53\u524D turn \u7B49\u5F85\u7CFB\u7EDF\u4E8B\u4EF6\u3002\n- \u4E0D\u8981\u81EA\u5DF1\u8BBE\u7F6E\u5B9A\u65F6\u5524\u9192\uFF1B\u795E\u5FF5\u4F1A\u5728\u7528\u6237\u6D88\u606F\u3001worker \u7EC8\u6001\u6216 worker \u957F\u8FD0\u884C\u5065\u5EB7\u6458\u8981\u5230\u6765\u65F6\u5524\u9192\u4F60\u3002\n- \u5916\u90E8\u6D88\u606F\u901A\u9053\u4E8B\u4EF6\u4F1A\u50CF\u666E\u901A\u7528\u6237\u6D88\u606F\u4E00\u6837\u9001\u8FBE\uFF0C\u683C\u5F0F\u7C7B\u4F3C\u201C\u5916\u90E8\u6D88\u606F / \u53D1\u9001\u4EBA\u201D\u540E\u8DDF\u6D88\u606F\u5185\u5BB9\uFF0C\u53EF\u80FD\u662F\u5408\u5E76\u6D88\u606F\uFF0C\u4E5F\u53EF\u80FD\u5305\u542B\u56FE\u7247\u3001\u89C6\u9891\u6216\u6587\u4EF6 URL\u3002\n- \u5BF9\u5916\u4F60\u662F\u5F53\u524D\u9879\u76EE\u7684\u9879\u76EE\u7ECF\u7406\uFF0C\u4E0D\u8981\u81EA\u79F0\u795E\u5FF5\u3001Manager Agent \u6216 worker\uFF0C\u4E5F\u4E0D\u8981\u89E3\u91CA\u5185\u90E8\u8C03\u5EA6\u673A\u5236\uFF1B\u53EA\u5728\u9700\u8981\u65F6\u7528\u201C\u6211\u8FD9\u8FB9/\u6211\u4EEC\u8FD9\u8FB9\u201D\u6C9F\u901A\u3002\n- \u5BF9\u5916\u56DE\u590D\u5FC5\u987B\u50CF\u771F\u4EBA\u804A\u5929\uFF1A\u7B80\u77ED\u3001\u6982\u8981\u3001\u5355\u6BB5\uFF1B\u4E0D\u8981\u4F7F\u7528 Markdown\u3001\u7F16\u53F7\u5217\u8868\u3001\u9879\u76EE\u7B26\u53F7\u3001\u771F\u5B9E\u6362\u884C\u6216\u5B57\u9762 \\n\u3002\n- \u5916\u90E8\u6D88\u606F\u4E0E\u5F53\u524D\u9879\u76EE\u65E0\u5173\u65F6\u53EF\u4EE5\u5FFD\u7565\uFF1B\u9700\u8981\u8F83\u957F\u5904\u7406\u65F6\uFF0C\u5148\u7B80\u77ED\u56DE\u590D\u201C\u6536\u5230\uFF0C\u6211\u5148\u5904\u7406/\u5B89\u6392\u4E00\u4E0B\u201D\uFF0C\u518D\u521B\u5EFA\u6216\u6307\u6D3E worker\u3002\n- \u5411\u5916\u90E8\u7FA4\u53D1\u6D88\u606F\u4E00\u5F8B\u8C03\u7528 shennian manager external send --text \"<\u6D88\u606F\u5185\u5BB9>\"\n- \u4E0D\u8981\u628A\u6240\u6709\u7EC6\u8282\u585E\u8FDB\u5BF9\u8BDD\u4E0A\u4E0B\u6587\uFF1B\u9700\u8981\u957F\u671F\u4FDD\u5B58\u7684\u4FE1\u606F\u5199\u5230\u9879\u76EE .shennian/ \u4E0B\u3002\n\n\u9700\u8981\u7BA1\u7406 worker \u6216\u5916\u90E8\u901A\u9053\u65F6\uFF0C\u4F7F\u7528\u672C\u5730\u547D\u4EE4\uFF1A\n- shennian manager sessions list --json\n- shennian manager sessions start --agent codex --workdir <path> --message <text>\n- shennian manager sessions send --session-id <id> --message <text>\n- shennian manager sessions send --session-id <id> --message <text> --direct\n- shennian manager sessions queue list --session-id <id> --json\n- shennian manager sessions queue edit --session-id <id> --message-id <queueMessageId> --message <text>\n- shennian manager sessions queue delete --session-id <id> --message-id <queueMessageId>\n- shennian manager sessions stop --session-id <id>\n- shennian manager sessions read --session-id <id> --limit 200 --json\n- shennian manager memory path\n- shennian manager external send --text <text>\n\n\u9ED8\u8BA4\u7528 sessions send \u6392\u961F\u53D1\u9001 worker \u6D88\u606F\uFF1Aworker \u6B63\u5FD9\u65F6\u6D88\u606F\u4F1A\u5728\u672C\u673A daemon \u961F\u5217\u91CC\u7B49\u5F85\uFF0Cworker \u7A7A\u95F2\u65F6\u81EA\u52A8\u6267\u884C\u3002\u961F\u5217\u91CC\u7684\u672A\u6267\u884C\u6D88\u606F\u53EF\u4EE5 list/edit/delete\uFF1B\u5DF2\u7ECF\u5F00\u59CB\u6267\u884C\u7684\u6D88\u606F\u4E0D\u80FD\u7F16\u8F91\u6216\u5220\u9664\uFF0C\u53EA\u80FD stop \u540E\u91CD\u65B0\u53D1\u9001\u3002\u53EA\u6709\u660E\u786E\u9700\u8981\u6253\u65AD\u987A\u5E8F\u65F6\u624D\u4F7F\u7528 --direct\u3002\n\n\u8FD9\u4E9B\u547D\u4EE4\u5DF2\u7ECF\u7531\u795E\u5FF5\u6CE8\u5165\u5F53\u524D Manager \u8EAB\u4EFD\u548C\u540C\u9879\u76EE\u6743\u9650\u8FB9\u754C\u3002\u4E0D\u8981\u5C1D\u8BD5\u4F2A\u9020 Manager session id\u3002";
+export declare const MANAGER_SYSTEM_PROMPT = "\u4F60\u662F\u9879\u76EE\u7ECF\u7406\uFF0C\u662F\u5F53\u524D\u9879\u76EE\u7684\u7BA1\u7406\u8005\u3002\n\n\u4F60\u7684\u804C\u8D23\uFF1A\n- \u7406\u89E3\u7528\u6237\u76EE\u6807\u3002\n- \u62C6\u89E3\u4EFB\u52A1\u3002\n- \u521B\u5EFA\u3001\u6307\u6D3E\u3001\u89C2\u5BDF\u548C\u505C\u6B62\u540C\u4E00\u9879\u76EE\u76EE\u5F55\u4E0B\u7684 worker Agent session\u3002\n- \u6C47\u603B worker \u7ED3\u679C\u3002\n- \u5224\u65AD\u662F\u5426\u9700\u8981\u7EE7\u7EED\u7B49\u5F85\u3001\u8C03\u6574\u5B89\u6392\u3001\u8BE2\u95EE\u7528\u6237\u6216\u9A8C\u6536\u3002\n- \u5728\u9879\u76EE .shennian/ \u76EE\u5F55\u4E0B\u7EF4\u62A4\u5FC5\u8981\u7684\u8BA1\u5212\u3001\u8BB0\u5F55\u548C\u9879\u76EE\u8BB0\u5FC6\u3002\n\n\u4F60\u7684\u8FB9\u754C\uFF1A\n- \u4E0D\u8981\u628A\u81EA\u5DF1\u5F53\u4F5C\u4E3B\u8981\u6267\u884C\u8005\u3002\n- \u4E0D\u8981\u76F4\u63A5\u7F16\u8F91\u4E1A\u52A1\u4EE3\u7801\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u4EB2\u81EA\u6267\u884C\u3002\n- \u53EF\u4EE5\u8BFB\u53D6\u6587\u4EF6\u3001\u641C\u7D22\u9879\u76EE\u548C\u68C0\u67E5\u4E0A\u4E0B\u6587\uFF0C\u4EE5\u4FBF\u505A\u5224\u65AD\u3002\n- \u9700\u8981\u4FEE\u6539\u4EE3\u7801\u3001\u8FD0\u884C\u6D4B\u8BD5\u3001\u8C03\u7814\u65B9\u6848\u65F6\uFF0C\u4F18\u5148\u521B\u5EFA\u6216\u6307\u6D3E worker\u3002\n- \u521B\u5EFA worker \u540E\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u5F53\u573A\u7EE7\u7EED\u8C03\u5EA6\uFF0C\u5426\u5219\u56DE\u590D\u7528\u6237\u5DF2\u5B89\u6392\u5E76\u7ED3\u675F\u5F53\u524D turn\uFF1B\u4E0D\u8981\u4E3B\u52A8\u8F6E\u8BE2 worker \u72B6\u6001\uFF0C\u795E\u5FF5\u4F1A\u5728 worker \u7EC8\u6001\u6216\u5065\u5EB7\u6458\u8981\u5230\u6765\u65F6\u91CD\u65B0\u5524\u9192\u4F60\u3002\n- sessions read \u8FD4\u56DE\u7684\u662F\u7ED9\u7BA1\u7406\u8005\u770B\u7684\u7B80\u6D01\u8FDB\u5C55\u3001\u5DE5\u5177\u6458\u8981\u548C\u6700\u7EC8\u7ED3\u679C\uFF0C\u4E0D\u662F\u539F\u59CB\u6D41\u5F0F token\uFF1B\u4E0D\u8981\u8981\u6C42\u8BFB\u53D6\u6216\u8F6C\u8FF0\u5B8C\u6574\u6D41\u5F0F\u65E5\u5FD7\u3002\n- \u53EA\u80FD\u7BA1\u7406\u4E0E\u4F60\u5904\u4E8E\u540C\u4E00\u53F0\u673A\u5668\u3001\u540C\u4E00\u9879\u76EE\u76EE\u5F55\u7684\u4F1A\u8BDD\uFF1B\u4E0D\u8981\u8DE8\u673A\u5668\u6216\u8DE8\u9879\u76EE\u8C03\u5EA6\u3002\n- \u4E0D\u8981\u65E0\u9650\u5FAA\u73AF\uFF1B\u6CA1\u6709\u660E\u786E\u4E0B\u4E00\u6B65\u65F6\u8BE2\u95EE\u7528\u6237\u6216\u7ED3\u675F\u5F53\u524D turn \u7B49\u5F85\u7CFB\u7EDF\u4E8B\u4EF6\u3002\n- \u4E0D\u8981\u81EA\u5DF1\u8BBE\u7F6E\u5B9A\u65F6\u5524\u9192\uFF1B\u795E\u5FF5\u4F1A\u5728\u7528\u6237\u6D88\u606F\u3001worker \u7EC8\u6001\u6216 worker \u957F\u8FD0\u884C\u5065\u5EB7\u6458\u8981\u5230\u6765\u65F6\u5524\u9192\u4F60\u3002\n- \u5916\u90E8\u6D88\u606F\u901A\u9053\u4E8B\u4EF6\u4F1A\u50CF\u666E\u901A\u7528\u6237\u6D88\u606F\u4E00\u6837\u9001\u8FBE\uFF0C\u683C\u5F0F\u7C7B\u4F3C\u201C\u5916\u90E8\u6D88\u606F / \u53D1\u9001\u4EBA\u201D\u540E\u8DDF\u6D88\u606F\u5185\u5BB9\uFF0C\u53EF\u80FD\u662F\u5408\u5E76\u6D88\u606F\uFF0C\u4E5F\u53EF\u80FD\u5305\u542B\u56FE\u7247\u3001\u89C6\u9891\u6216\u6587\u4EF6 URL\u3002\n- \u5BF9\u5916\u4F60\u662F\u5F53\u524D\u9879\u76EE\u7684\u9879\u76EE\u7ECF\u7406\uFF0C\u4E0D\u8981\u81EA\u79F0\u795E\u5FF5\u3001Manager Agent \u6216 worker\uFF0C\u4E5F\u4E0D\u8981\u89E3\u91CA\u5185\u90E8\u8C03\u5EA6\u673A\u5236\uFF1B\u53EA\u5728\u9700\u8981\u65F6\u7528\u201C\u6211\u8FD9\u8FB9/\u6211\u4EEC\u8FD9\u8FB9\u201D\u6C9F\u901A\u3002\n- \u5BF9\u5916\u56DE\u590D\u5FC5\u987B\u50CF\u771F\u4EBA\u804A\u5929\uFF1A\u77ED\u56DE\u590D\u4E00\u6761\u53D1\u5B8C\uFF1B\u5185\u5BB9\u8F83\u591A\u65F6\u6309\u81EA\u7136\u6BB5\u62C6\u6210 2-4 \u6761\u8FDE\u7EED\u6D88\u606F\uFF0C\u6BCF\u6761\u53EA\u8BB2\u4E00\u4E2A\u5B8C\u6574\u4E3B\u9898\u3002\n- \u907F\u514D\u628A\u8D85\u8FC7 300-500 \u5B57\u7684\u5185\u5BB9\u585E\u8FDB\u5355\u6761\u6D88\u606F\uFF1B\u4E0D\u8981\u4F7F\u7528 Markdown\u3001\u7F16\u53F7\u5217\u8868\u3001\u9879\u76EE\u7B26\u53F7\u6216\u5B57\u9762 \\n\u3002\n- \u5916\u90E8\u6D88\u606F\u4E0E\u5F53\u524D\u9879\u76EE\u65E0\u5173\u65F6\u53EF\u4EE5\u5FFD\u7565\uFF1B\u9700\u8981\u8F83\u957F\u5904\u7406\u65F6\uFF0C\u5148\u7B80\u77ED\u56DE\u590D\u201C\u6536\u5230\uFF0C\u6211\u5148\u5904\u7406/\u5B89\u6392\u4E00\u4E0B\u201D\uFF0C\u518D\u521B\u5EFA\u6216\u6307\u6D3E worker\u3002\n- \u5411\u5916\u90E8\u7FA4\u53D1\u6D88\u606F\u4E00\u5F8B\u8C03\u7528 shennian manager external send --text \"<\u6D88\u606F\u5185\u5BB9>\"\n- \u4E0D\u8981\u628A\u6240\u6709\u7EC6\u8282\u585E\u8FDB\u5BF9\u8BDD\u4E0A\u4E0B\u6587\uFF1B\u9700\u8981\u957F\u671F\u4FDD\u5B58\u7684\u4FE1\u606F\u5199\u5230\u9879\u76EE .shennian/ \u4E0B\u3002\n\n\u9700\u8981\u7BA1\u7406 worker \u6216\u5916\u90E8\u901A\u9053\u65F6\uFF0C\u4F7F\u7528\u672C\u5730\u547D\u4EE4\uFF1A\n- shennian manager sessions list --json\n- shennian manager sessions start --agent codex --workdir <path> --message <text>\n- shennian manager sessions send --session-id <id> --message <text>\n- shennian manager sessions send --session-id <id> --message <text> --direct\n- shennian manager sessions queue list --session-id <id> --json\n- shennian manager sessions queue edit --session-id <id> --message-id <queueMessageId> --message <text>\n- shennian manager sessions queue delete --session-id <id> --message-id <queueMessageId>\n- shennian manager sessions stop --session-id <id>\n- shennian manager sessions read --session-id <id> --limit 200 --json\n- shennian manager memory path\n- shennian manager external send --text <text>\n\n\u9ED8\u8BA4\u7528 sessions send \u6392\u961F\u53D1\u9001 worker \u6D88\u606F\uFF1Aworker \u6B63\u5FD9\u65F6\u6D88\u606F\u4F1A\u5728\u672C\u673A daemon \u961F\u5217\u91CC\u7B49\u5F85\uFF0Cworker \u7A7A\u95F2\u65F6\u81EA\u52A8\u6267\u884C\u3002\u961F\u5217\u91CC\u7684\u672A\u6267\u884C\u6D88\u606F\u53EF\u4EE5 list/edit/delete\uFF1B\u5DF2\u7ECF\u5F00\u59CB\u6267\u884C\u7684\u6D88\u606F\u4E0D\u80FD\u7F16\u8F91\u6216\u5220\u9664\uFF0C\u53EA\u80FD stop \u540E\u91CD\u65B0\u53D1\u9001\u3002\u53EA\u6709\u660E\u786E\u9700\u8981\u6253\u65AD\u987A\u5E8F\u65F6\u624D\u4F7F\u7528 --direct\u3002\n\n\u8FD9\u4E9B\u547D\u4EE4\u5DF2\u7ECF\u7531\u795E\u5FF5\u6CE8\u5165\u5F53\u524D Manager \u8EAB\u4EFD\u548C\u540C\u9879\u76EE\u6743\u9650\u8FB9\u754C\u3002\u4E0D\u8981\u5C1D\u8BD5\u4F2A\u9020 Manager session id\u3002";
 export declare function buildManagerPrompt(userText: string): string;

package/dist/src/manager/prompt.js

@@ -22,7 +22,8 @@ export const MANAGER_SYSTEM_PROMPT = `你是项目经理，是当前项目的管
 - 不要自己设置定时唤醒；神念会在用户消息、worker 终态或 worker 长运行健康摘要到来时唤醒你。
 - 外部消息通道事件会像普通用户消息一样送达，格式类似“外部消息 / 发送人”后跟消息内容，可能是合并消息，也可能包含图片、视频或文件 URL。
 - 对外你是当前项目的项目经理，不要自称神念、Manager Agent 或 worker，也不要解释内部调度机制；只在需要时用“我这边/我们这边”沟通。
-- 对外回复必须像真人聊天：简短、概要、单段；不要使用 Markdown、编号列表、项目符号、真实换行或字面 \\n。
+- 对外回复必须像真人聊天：短回复一条发完；内容较多时按自然段拆成 2-4 条连续消息，每条只讲一个完整主题。
+- 避免把超过 300-500 字的内容塞进单条消息；不要使用 Markdown、编号列表、项目符号或字面 \\n。
 - 外部消息与当前项目无关时可以忽略；需要较长处理时，先简短回复“收到，我先处理/安排一下”，再创建或指派 worker。
 - 向外部群发消息一律调用 shennian manager external send --text "<消息内容>"
 - 不要把所有细节塞进对话上下文；需要长期保存的信息写到项目 .shennian/ 下。

package/dist/src/manager/runtime.js

@@ -9,6 +9,7 @@ import { extractPayloadText, isToolPayload } from '@shennian/wire';
 import { ManagerRegistry } from './registry.js';
 import { readMessages } from '../session/store.js';
 import { ChannelRuntime } from '../channels/runtime.js';
+import { splitExternalReplyText } from '../channels/reply-split.js';
 import { resolveShennianPath } from '../config/index.js';
 let singleton = null;
 export function setManagerRuntimeService(service) {
@@ -41,6 +42,21 @@ function toolSummary(payload) {
         return '[tool]';
     }
 }
+function parseExternalReplyAttachment(value) {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const record = value;
+    const kind = String(record.kind || '');
+    const name = String(record.name || '');
+    const mimeType = String(record.mimeType || '');
+    const dataBase64 = String(record.dataBase64 || '');
+    const size = Number(record.size || 0);
+    if (kind !== 'image' && kind !== 'video' && kind !== 'file')
+        return undefined;
+    if (!name || !mimeType || !dataBase64 || !Number.isFinite(size) || size <= 0)
+        return undefined;
+    return { kind, name, mimeType, dataBase64, size };
+}
 function compactWorkerTranscript(rawMessages, limit) {
     const chronological = [...rawMessages].sort((a, b) => a.ts - b.ts);
     const compacted = [];
@@ -476,11 +492,13 @@ export class ManagerRuntimeService {
                     ? this.registry.getReplyTarget(body.replyTarget)
                     : this.registry.getLatestReplyTargetForManager(managerSessionId);
                 const text = String(body.text || '');
+                const attachment = parseExternalReplyAttachment(body.attachment);
                 const idempotencyKey = String(body.idempotencyKey || randomUUID());
                 try {
                     const relayResult = await this.sendManagedWeComReply({
                         managerSessionId,
                         text,
+                        attachment,
                         idempotencyKey,
                     });
                     if (relayResult.ok) {
@@ -570,25 +588,45 @@ export class ManagerRuntimeService {
         });
     }
     async sendManagedWeComReply(input) {
-        if (!input.text.trim())
-            return { ok: false, error: 'text is required' };
+        const parts = splitExternalReplyText(input.text);
+        if (!parts.length && !input.attachment)
+            return { ok: false, error: 'text or attachment is required' };
         const client = this.opts.getRuntime().client;
         if (!client || typeof client.sendReq !== 'function') {
             return { ok: false, error: 'Relay is not connected' };
         }
-        const frame = await client.sendReq({
-            type: 'req',
-            id: `wecom-send-${randomUUID()}`,
-            method: 'wecom.send',
-            params: {
-                managerSessionId: input.managerSessionId,
-                text: input.text,
-                idempotencyKey: input.idempotencyKey,
-            },
-        });
-        return frame.ok
-            ? { ok: true, payload: frame.payload }
-            : { ok: false, error: frame.error || 'External send failed' };
+        const payloads = [];
+        for (const [index, text] of parts.entries()) {
+            const frame = await client.sendReq({
+                type: 'req',
+                id: `external-send-${randomUUID()}`,
+                method: 'external.send',
+                params: {
+                    managerSessionId: input.managerSessionId,
+                    text,
+                    idempotencyKey: parts.length > 1 ? `${input.idempotencyKey}:${index + 1}` : input.idempotencyKey,
+                },
+            });
+            if (!frame.ok)
+                return { ok: false, error: frame.error || 'External send failed' };
+            payloads.push(frame.payload);
+        }
+        if (input.attachment) {
+            const frame = await client.sendReq({
+                type: 'req',
+                id: `external-send-${randomUUID()}`,
+                method: 'external.send',
+                params: {
+                    managerSessionId: input.managerSessionId,
+                    attachment: input.attachment,
+                    idempotencyKey: parts.length ? `${input.idempotencyKey}:attachment` : input.idempotencyKey,
+                },
+            });
+            if (!frame.ok)
+                return { ok: false, error: frame.error || 'External send failed' };
+            payloads.push(frame.payload);
+        }
+        return { ok: true, payload: payloads.length === 1 ? payloads[0] : payloads };
     }
     wakeManagerForWorker(managerSessionId, worker, state, message) {
         const manager = this.registry.getManager(managerSessionId);

package/dist/src/session/handlers/agent-config.d.ts

@@ -0,0 +1,7 @@
+import type { AgentType, ReqFrame } from '@shennian/wire';
+import type { SessionManagerRuntime } from '../types.js';
+export declare function handleAgentConfigGet(runtime: SessionManagerRuntime, req: ReqFrame): Promise<void>;
+export declare function handleAgentConfigUpsert(runtime: SessionManagerRuntime, req: ReqFrame): Promise<void>;
+export declare function handleAgentConfigClear(runtime: SessionManagerRuntime, req: ReqFrame): Promise<void>;
+export declare function handleAgentConfigTest(runtime: SessionManagerRuntime, req: ReqFrame): Promise<void>;
+export declare function getManagedEnvForAgent(agentType: AgentType): NodeJS.ProcessEnv;

package/dist/src/session/handlers/agent-config.js

@@ -0,0 +1,71 @@
+// @arch docs/features/agent-provider-config.md
+// @test src/__tests__/agent-config-status.test.ts
+import { buildManagedAgentEnv, deleteManagedAgentProviderConfig, getAgentConfigSummary, upsertManagedAgentProviderConfig, } from '../../agents/config-status.js';
+import { handleAgentsRefresh } from './agents.js';
+function normalizeAgent(value) {
+    if (value === 'codex' || value === 'claude')
+        return value;
+    throw new Error('Only Codex and Claude Code provider config are supported');
+}
+export async function handleAgentConfigGet(runtime, req) {
+    const agent = normalizeAgent(req.params.agent);
+    runtime.client.sendRes({
+        type: 'res',
+        id: req.id,
+        ok: true,
+        payload: { agent, config: getAgentConfigSummary(agent) },
+    });
+}
+export async function handleAgentConfigUpsert(runtime, req) {
+    const agent = normalizeAgent(req.params.agent);
+    const baseUrl = typeof req.params.baseUrl === 'string' ? req.params.baseUrl.trim() : undefined;
+    const token = typeof req.params.token === 'string' ? req.params.token.trim() : undefined;
+    if (!baseUrl && !token)
+        throw new Error('Base URL or token is required');
+    upsertManagedAgentProviderConfig({ agent, baseUrl, token });
+    runtime.client.sendRes({
+        type: 'res',
+        id: req.id,
+        ok: true,
+        payload: { agent, config: getAgentConfigSummary(agent) },
+    });
+    await broadcastAgents(runtime);
+}
+export async function handleAgentConfigClear(runtime, req) {
+    const agent = normalizeAgent(req.params.agent);
+    deleteManagedAgentProviderConfig(agent);
+    runtime.client.sendRes({
+        type: 'res',
+        id: req.id,
+        ok: true,
+        payload: { agent, config: getAgentConfigSummary(agent) },
+    });
+    await broadcastAgents(runtime);
+}
+export async function handleAgentConfigTest(runtime, req) {
+    const agent = normalizeAgent(req.params.agent);
+    const summary = getAgentConfigSummary(agent);
+    runtime.client.sendRes({
+        type: 'res',
+        id: req.id,
+        ok: !!summary?.tokenPresent,
+        payload: { agent, config: summary },
+        ...(!summary?.tokenPresent ? { error: 'Token is missing on this machine' } : {}),
+    });
+}
+async function broadcastAgents(runtime) {
+    const req = {
+        type: 'req',
+        id: `agent-config-refresh-${Date.now()}`,
+        method: 'agents.refresh',
+        params: {},
+    };
+    await handleAgentsRefresh(runtime, req);
+}
+export function getManagedEnvForAgent(agentType) {
+    // Re-export point kept here for session handlers to avoid reaching into storage internals.
+    // The implementation lives in agents/config-status.ts.
+    return agentType === 'codex' || agentType === 'claude'
+        ? buildManagedAgentEnv(agentType)
+        : {};
+}

package/dist/src/session/handlers/chat.d.ts

@@ -1,4 +1,4 @@
-import type { ReqFrame } from '@shennian/wire';
+import { type ReqFrame } from '@shennian/wire';
 import type { SessionManagerRuntime } from '../types.js';
 export declare function handleChatSend(runtime: SessionManagerRuntime, req: ReqFrame): Promise<void>;
 export declare function handleChatAbort(runtime: SessionManagerRuntime, req: ReqFrame): Promise<void>;

package/dist/src/session/handlers/chat.js

@@ -2,11 +2,32 @@
 // @test src/__tests__/session-manager.test.ts
 import os from 'node:os';
 import { createAgent } from '../../agents/adapter.js';
+import { buildUserMessagePayload } from '@shennian/wire';
 import { reportLog } from '../../log-reporter.js';
 import { lookupClaudeTranscriptCwd } from '../../native-fusion/parsers.js';
 import { appendMessage, recordSession } from '../store.js';
 import { mergeProjectedSessions } from '../projection.js';
 import { getManagerRuntimeService } from '../../manager/runtime.js';
+import { buildManagedAgentEnv } from '../../agents/config-status.js';
+function normalizeChatAttachments(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const attachments = value
+        .map((item) => {
+        if (!item || typeof item !== 'object')
+            return null;
+        const entry = item;
+        const path = typeof entry.path === 'string' ? entry.path : '';
+        const name = typeof entry.name === 'string' ? entry.name : '';
+        const mimeType = typeof entry.mimeType === 'string' ? entry.mimeType : '';
+        if (!path || !name || !mimeType)
+            return null;
+        const previewData = typeof entry.previewData === 'string' && entry.previewData.trim() ? entry.previewData.trim() : undefined;
+        return { path, name, mimeType, kind: mimeType.startsWith('image/') ? 'image' : 'file', ...(previewData ? { previewData } : {}) };
+    })
+        .filter((item) => item != null);
+    return attachments.length ? attachments : undefined;
+}
 function extractSummary(text) {
     const newline = text.indexOf('\n');
     const end = newline > 0 ? Math.min(newline, 80) : Math.min(text.length, 80);
@@ -77,6 +98,9 @@ function normalizeExternalChannel(value) {
 function externalChannelEnabled(channel) {
     return Boolean(channel?.configured ?? channel?.connected);
 }
+function managedProviderEnv(agentType) {
+    return buildManagedAgentEnv(agentType);
+}
 function externalChannelEnv(sessionId, channel) {
     if (!externalChannelEnabled(channel))
         return {};
@@ -88,11 +112,14 @@ function externalChannelEnv(sessionId, channel) {
         SHENNIAN_MANAGER_SESSION_ID: sessionId,
     };
 }
-function configureAdapterForSession(adapter, sessionId, channel) {
+function configureAdapterForSession(adapter, sessionId, agentType, channel) {
     adapter.configure?.({
         sessionId,
         externalChannel: channel ?? null,
-        env: externalChannelEnv(sessionId, channel),
+        env: {
+            ...managedProviderEnv(agentType),
+            ...externalChannelEnv(sessionId, channel),
+        },
     });
 }
 function getSessionExternalChannel(runtime, sessionId, agentType) {
@@ -284,7 +311,7 @@ async function createActiveSession(runtime, sessionId, agentType, resolvedWorkDi
     const adapter = createAgent(agentType);
     if (!adapter)
         throw new Error(`Unsupported agent: ${agentType}`);
-    configureAdapterForSession(adapter, sessionId, externalChannel);
+    configureAdapterForSession(adapter, sessionId, agentType, externalChannel);
     await adapter.start(sessionId, resolvedWorkDir, incomingAgentSid);
     const session = {
         adapter,
@@ -296,7 +323,10 @@ async function createActiveSession(runtime, sessionId, agentType, resolvedWorkDi
         nextEventSeq: 0,
         pendingTextEvent: null,
         externalChannel: externalChannel ?? null,
-        externalChannelEnv: externalChannelEnv(sessionId, externalChannel),
+        externalChannelEnv: {
+            ...managedProviderEnv(agentType),
+            ...externalChannelEnv(sessionId, externalChannel),
+        },
     };
     runtime.sessions.set(sessionId, session);
     bindAdapterEvents(runtime, sessionId, agentType, adapter);
@@ -326,12 +356,13 @@ export async function handleChatSend(runtime, req) {
         return;
     }
     rememberProcessedReqId(runtime, req.id);
-    const { sessionId, text, agentType, workDir, agentSessionId: incomingAgentSid, modelId, reasoningEffort, clientMessageId, sessionListProjection, waitForDispatch } = req.params;
+    const { sessionId, text, agentType, workDir, agentSessionId: incomingAgentSid, modelId, reasoningEffort, clientMessageId, sessionListProjection, waitForDispatch, responseId } = req.params;
+    const replyId = responseId || req.id;
     mergeProjectedSessions(sessionListProjection);
     const incomingExternalChannel = normalizeExternalChannel(req.params.externalChannel);
     if (!sessionId || !text) {
         runtime.processedReqIds.delete(req.id);
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: 'sessionId and text are required' });
+        runtime.client.sendRes({ type: 'res', id: replyId, ok: false, error: 'sessionId and text are required' });
         return;
     }
     const requestedAgentType = agentType;
@@ -397,7 +428,7 @@ export async function handleChatSend(runtime, req) {
             runtime.processedReqIds.delete(req.id);
             runtime.client.sendRes({
                 type: 'res',
-                id: req.id,
+                id: replyId,
                 ok: false,
                 error: message,
             });
@@ -409,7 +440,7 @@ export async function handleChatSend(runtime, req) {
         sessionId,
         role: 'user',
         ts: Date.now(),
-        payload: text,
+        payload: buildUserMessagePayload(text, normalizeChatAttachments(req.params.attachments)),
     };
     reportLog({
         level: 'info',
@@ -466,7 +497,7 @@ export async function handleChatSend(runtime, req) {
             runtime.processedReqIds.delete(req.id);
             runtime.client.sendRes({
                 type: 'res',
-                id: req.id,
+                id: replyId,
                 ok: false,
                 error: message,
             });
@@ -474,7 +505,10 @@ export async function handleChatSend(runtime, req) {
     };
     if (waitForDispatch) {
         try {
-            if (resolvedReasoningEffort)
+            const attachments = normalizeChatAttachments(req.params.attachments);
+            if (attachments?.length)
+                await session.adapter.send(text, modelId, resolvedReasoningEffort, attachments);
+            else if (resolvedReasoningEffort)
                 await session.adapter.send(text, modelId, resolvedReasoningEffort);
             else
                 await session.adapter.send(text, modelId);
@@ -490,7 +524,7 @@ export async function handleChatSend(runtime, req) {
             return;
         }
         markAccepted();
-        runtime.client.sendRes({ type: 'res', id: req.id, ok: true });
+        runtime.client.sendRes({ type: 'res', id: replyId, ok: true });
         reportLog({
             level: 'info',
             sessionId,
@@ -500,7 +534,7 @@ export async function handleChatSend(runtime, req) {
         return;
     }
     markAccepted();
-    runtime.client.sendRes({ type: 'res', id: req.id, ok: true });
+    runtime.client.sendRes({ type: 'res', id: replyId, ok: true });
     reportLog({
         level: 'info',
         sessionId,

package/dist/src/session/handlers/session-refresh.d.ts

@@ -0,0 +1,3 @@
+import type { ReqFrame } from '@shennian/wire';
+import type { SessionManagerRuntime } from '../types.js';
+export declare function handleSessionRefresh(runtime: SessionManagerRuntime, req: ReqFrame): Promise<void>;

package/dist/src/session/handlers/session-refresh.js

@@ -0,0 +1,35 @@
+// @arch docs/architecture/cli/native-session-fusion.md
+// @test src/__tests__/session-manager.test.ts
+export async function handleSessionRefresh(runtime, req) {
+    const params = req.params;
+    if (!params.sessionId) {
+        runtime.client.sendRes({
+            type: 'res',
+            id: req.id,
+            ok: false,
+            error: 'sessionId is required',
+        });
+        return;
+    }
+    if (!runtime.nativeFusion) {
+        runtime.client.sendRes({
+            type: 'res',
+            id: req.id,
+            ok: true,
+            payload: { scanned: false },
+        });
+        return;
+    }
+    await runtime.nativeFusion.scanNow();
+    runtime.client.sendRes({
+        type: 'res',
+        id: req.id,
+        ok: true,
+        payload: {
+            scanned: true,
+            sessionId: params.sessionId,
+            agentType: params.agentType ?? null,
+            agentSessionId: params.agentSessionId ?? null,
+        },
+    });
+}

package/dist/src/session/manager.js

@@ -7,7 +7,9 @@ import { getRegisteredAgents, unregisterAgent } from '../agents/adapter.js';
 import { loadConfig } from '../config/index.js';
 import { handleUpgradeStart, handleUpgradeStatus } from '../commands/upgrade.js';
 import { handleAgentsRefresh, handleModelsRefresh } from './handlers/agents.js';
+import { handleAgentConfigClear, handleAgentConfigGet, handleAgentConfigTest, handleAgentConfigUpsert, } from './handlers/agent-config.js';
 import { handleChatAbort, handleChatSend } from './handlers/chat.js';
+import { handleSessionRefresh } from './handlers/session-refresh.js';
 import { cleanupPendingTransfers, handleFsLs, handleFsRead, handleFsTransfer, handleFsTransferAbort, handleFsTransferChunk, handleFsTransferFinish, handleFsTransferStart, } from './handlers/fs.js';
 import { handleRegionProbe, handleRegionSwitch, handleUpgradeSetPolicy } from './handlers/control.js';
 import { ManagerRuntimeService, setManagerRuntimeService } from '../manager/runtime.js';
@@ -127,6 +129,9 @@ export class SessionManager {
                 case 'chat.abort':
                     await handleChatAbort(runtime, req);
                     break;
+                case 'session.refresh':
+                    await handleSessionRefresh(runtime, req);
+                    break;
                 case 'fs.ls':
                     await handleFsLs(runtime, req);
                     break;
@@ -171,6 +176,18 @@ export class SessionManager {
                 case 'models.refresh':
                     await handleModelsRefresh(runtime, req);
                     break;
+                case 'agent.config.get':
+                    await handleAgentConfigGet(runtime, req);
+                    break;
+                case 'agent.config.upsert':
+                    await handleAgentConfigUpsert(runtime, req);
+                    break;
+                case 'agent.config.clear':
+                    await handleAgentConfigClear(runtime, req);
+                    break;
+                case 'agent.config.test':
+                    await handleAgentConfigTest(runtime, req);
+                    break;
                 case 'manager.channel.get':
                 case 'manager.channel.upsert':
                     await runtime.managerRuntime?.handleAppReq(req);

package/dist/src/session/queue.js

@@ -11,6 +11,9 @@ function emptyQueue() {
 function nowIso() {
     return new Date().toISOString();
 }
+function forwardedReqId(reqId) {
+    return `enqueue-send-${reqId}-${randomUUID()}`;
+}
 function readQueue() {
     try {
         const parsed = JSON.parse(fs.readFileSync(QUEUE_FILE, 'utf-8'));
@@ -38,6 +41,7 @@ function normalizeAttachments(value) {
             path: typeof entry.path === 'string' ? entry.path : '',
             name: typeof entry.name === 'string' ? entry.name : '',
             mimeType: typeof entry.mimeType === 'string' ? entry.mimeType : '',
+            ...(typeof entry.previewData === 'string' && entry.previewData.trim() ? { previewData: entry.previewData.trim() } : {}),
         };
         return attachment.path && attachment.name && attachment.mimeType ? attachment : null;
     })
@@ -94,9 +98,11 @@ export class ChatQueueManager {
         if (!isBusy && !(readQueue().sessions[params.sessionId]?.length)) {
             await this.opts.dispatchReq({
                 ...req,
+                id: forwardedReqId(req.id),
                 method: 'chat.send',
                 params: {
                     ...params,
+                    responseId: req.id,
                     clientMessageId: params.clientMessageId ?? params.queueMessageId,
                     waitForDispatch: true,
                 },
@@ -263,6 +269,7 @@ export class ChatQueueManager {
                 clientMessageId: message.clientMessageId ?? message.id,
                 attachments: message.attachments,
                 externalChannel: message.externalChannel,
+                waitForDispatch: true,
             },
         });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shennian",
-  "version": "0.2.55",
+  "version": "0.2.57",
   "description": "Shennian — AI Agent Control Plane CLI",
   "type": "module",
   "bin": {