shennian 0.2.54 → 0.2.56

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,