shennian 0.2.47 → 0.2.49

package/dist/src/agents/claude.js

@@ -3,6 +3,7 @@ import { randomUUID } from 'node:crypto';
 import { AgentAdapter, registerAgent } from './adapter.js';
 import { resolveBuiltinCommand, spawnResolvedCommand } from './command-spec.js';
 import { buildAgentProcessEnv } from '../agent-env.js';
+import { buildPlatformInstructions } from './platform-instructions.js';
 export function normalizeClaudeModelId(modelId) {
     const trimmed = modelId?.trim();
     return trimmed || 'default';
@@ -34,8 +35,9 @@ export class ClaudeAdapter extends AgentAdapter {
         this.runId = randomUUID();
         this.resetRunState();
         const args = ['-p', text, '--output-format', 'stream-json', '--verbose'];
-        if (this.options.systemPrompt) {
-            args.push('--append-system-prompt', this.options.systemPrompt);
+        const systemPrompt = this.options.systemPrompt ?? buildPlatformInstructions(this.workDir ?? process.cwd());
+        if (systemPrompt) {
+            args.push('--append-system-prompt', systemPrompt);
         }
         if (this.options.hidden) {
             args.push('--name', 'Shennian Manager Substrate');
@@ -55,8 +57,9 @@ export class ClaudeAdapter extends AgentAdapter {
         this.runId = randomUUID();
         this.resetRunState();
         const resumeArgs = ['--resume', agentSessionId, '--output-format', 'stream-json', '--verbose'];
-        if (this.options.systemPrompt) {
-            resumeArgs.push('--append-system-prompt', this.options.systemPrompt);
+        const systemPrompt = this.options.systemPrompt ?? buildPlatformInstructions(this.workDir ?? process.cwd());
+        if (systemPrompt) {
+            resumeArgs.push('--append-system-prompt', systemPrompt);
         }
         if (this.options.hidden) {
             resumeArgs.push('--name', 'Shennian Manager Substrate');

package/dist/src/agents/codex.js

@@ -5,6 +5,7 @@ import { randomUUID } from 'node:crypto';
 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';
 export class CodexAdapter extends AgentAdapter {
     options;
     type = 'codex';
@@ -125,8 +126,9 @@ export class CodexAdapter extends AgentAdapter {
             return;
         }
         const args = ['app-server', '--listen', 'stdio://'];
-        if (this.options.modelInstructionsFile) {
-            args.push('-c', `model_instructions_file=${JSON.stringify(this.options.modelInstructionsFile)}`);
+        const modelInstructionsFile = this.options.modelInstructionsFile ?? ensurePlatformInstructionsFile(this.workDir ?? process.cwd());
+        if (modelInstructionsFile) {
+            args.push('-c', `model_instructions_file=${JSON.stringify(modelInstructionsFile)}`);
         }
         const proc = spawnResolvedCommand(spec, args, {
             cwd: this.workDir ?? undefined,

package/dist/src/agents/platform-instructions.d.ts

@@ -0,0 +1,3 @@
+export declare const PLATFORM_OUTPUT_INSTRUCTIONS = "## Shennian Output Instructions\n\nWhen you mention a local file that the user may want to open in Shennian, format it as a Markdown link using the exact local path:\n\n- Use [filename.ext](</absolute/path/to/filename.ext>) for absolute Unix, macOS, or Windows paths.\n- Use [filename.ext](<relative/path/to/filename.ext>) for paths relative to the current working directory.\n- Do not use file:// URLs for local files.\n- Do not put user-openable file paths only inside code blocks.\n- Keep normal http:// and https:// links unchanged.";
+export declare function buildPlatformInstructions(workDir: string): string;
+export declare function ensurePlatformInstructionsFile(workDir: string): string;

package/dist/src/agents/platform-instructions.js

@@ -0,0 +1,50 @@
+// @arch docs/architecture/cli/agent-adapters.md#平台输出规范
+// @test src/__tests__/platform-instructions.test.ts
+import fs from 'node:fs';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { resolveShennianPath } from '../config/index.js';
+export const PLATFORM_OUTPUT_INSTRUCTIONS = `## Shennian Output Instructions
+
+When you mention a local file that the user may want to open in Shennian, format it as a Markdown link using the exact local path:
+
+- Use [filename.ext](</absolute/path/to/filename.ext>) for absolute Unix, macOS, or Windows paths.
+- Use [filename.ext](<relative/path/to/filename.ext>) for paths relative to the current working directory.
+- Do not use file:// URLs for local files.
+- Do not put user-openable file paths only inside code blocks.
+- Keep normal http:// and https:// links unchanged.`;
+function readProjectAgentsMd(workDir) {
+    const agentsPath = path.join(workDir, 'AGENTS.md');
+    try {
+        return fs.readFileSync(agentsPath, 'utf8').trim();
+    }
+    catch {
+        return '';
+    }
+}
+export function buildPlatformInstructions(workDir) {
+    const projectInstructions = readProjectAgentsMd(workDir);
+    const sections = [
+        '# Shennian Agent Instructions',
+        projectInstructions
+            ? `## Project Instructions\n\n${projectInstructions}`
+            : '',
+        PLATFORM_OUTPUT_INSTRUCTIONS,
+    ].filter(Boolean);
+    return `${sections.join('\n\n')}\n`;
+}
+export function ensurePlatformInstructionsFile(workDir) {
+    const key = createHash('sha256').update(path.resolve(workDir)).digest('hex').slice(0, 16);
+    const filePath = resolveShennianPath('runtime', 'agent-instructions', `${key}.md`);
+    const content = buildPlatformInstructions(workDir);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    try {
+        if (fs.readFileSync(filePath, 'utf8') === content)
+            return filePath;
+    }
+    catch {
+        // Write the generated instruction file below.
+    }
+    fs.writeFileSync(filePath, content);
+    return filePath;
+}

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

@@ -59,4 +59,8 @@ export interface ExternalChannelAdapter {
         ok: boolean;
         message?: string;
     }>;
+    defaultConversation?(config: ExternalChannelConfig): Promise<{
+        conversationId: string;
+        conversationName?: string;
+    }>;
 }

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

@@ -24,6 +24,10 @@ export declare class ChannelRuntime {
         ok: false;
         error: string;
     }>;
+    getDefaultReplyTarget(managerSessionId: string): Promise<{
+        channelId: string;
+        conversationId: string;
+    }>;
     getManagerChannel(managerSessionId: string, type: ExternalChannelConfig['type'], opts?: {
         includeSecret?: boolean;
     }): ExternalChannelView | null;

package/dist/src/channels/runtime.js

@@ -59,6 +59,19 @@ export class ChannelRuntime {
             return { ok: false, error: err instanceof Error ? err.message : String(err) };
         }
     }
+    async getDefaultReplyTarget(managerSessionId) {
+        const config = this.configs.list().find((channel) => channel.managerSessionId === managerSessionId && channel.enabled);
+        if (!config)
+            throw new Error('No enabled external channel is bound to this manager');
+        const adapter = this.adapters.get(config.type);
+        if (!adapter?.defaultConversation)
+            throw new Error(`External channel ${config.type} has no default conversation`);
+        const conversation = await adapter.defaultConversation(config);
+        return {
+            channelId: config.id,
+            conversationId: conversation.conversationId,
+        };
+    }
     getManagerChannel(managerSessionId, type, opts = {}) {
         const configs = this.configs.list()
             .filter((channel) => channel.managerSessionId === managerSessionId && channel.type === type);

package/dist/src/channels/secret-registry.js

@@ -26,7 +26,9 @@ export class ChannelSecretRegistry {
         try {
             fs.chmodSync(SECRETS_PATH, 0o600);
         }
-        catch { }
+        catch {
+            // Best effort on filesystems that do not support POSIX modes.
+        }
     }
     get(secretRef) {
         return this.load().secrets[secretRef];

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

@@ -32,6 +32,10 @@ export declare class ExternalWebSocketChannelAdapter implements ExternalChannelA
         ok: boolean;
         message?: string;
     }>;
+    defaultConversation(config: ExternalChannelConfig): Promise<{
+        conversationId: string;
+        conversationName?: string;
+    }>;
     private ensureConnection;
     private readSecret;
     private openConnection;

package/dist/src/channels/websocket.js

@@ -80,6 +80,33 @@ export class ExternalWebSocketChannelAdapter {
             ? { ok: true }
             : { ok: false, message: 'External websocket disconnected' };
     }
+    async defaultConversation(config) {
+        const secret = this.readSecret(config);
+        const url = new URL(secret.wsUrl);
+        url.protocol = url.protocol === 'wss:' ? 'https:' : 'http:';
+        url.pathname = url.pathname.replace(/\/ws\/?$/, '/subscription/self');
+        url.search = '';
+        const response = await fetch(url, {
+            headers: {
+                Authorization: `Bearer ${secret.token}`,
+            },
+        });
+        const data = await response.json().catch(() => null);
+        if (!response.ok || !data?.ok) {
+            throw new Error(data?.error || `External websocket metadata failed: ${response.status}`);
+        }
+        if (data.subscription?.allowSend === false) {
+            throw new Error('External websocket subscription does not allow send');
+        }
+        const conversationId = String(data.subscription?.defaultConversationId || '').trim();
+        if (!conversationId) {
+            throw new Error('External websocket subscription has no single default conversation');
+        }
+        return {
+            conversationId,
+            conversationName: String(data.subscription?.defaultConversationName || '').trim() || undefined,
+        };
+    }
     ensureConnection(config) {
         let conn = this.connections.get(config.id);
         if (!conn) {

package/dist/src/commands/daemon.js

@@ -550,7 +550,7 @@ export function installService() {
     const spec = resolveCurrentServiceLaunchSpec();
     if (spec.mode === 'direct' && isEphemeralCliPath(SHENNIAN_SCRIPT)) {
         console.warn(chalk.yellow('⚠ Warning: Current CLI path is temporary (npx). Auto-start may not work after reboot.\n' +
-            '  Run `npm install -g shennian` for reliable auto-start.'));
+            '  Run `npm install -g shennian@latest` for reliable auto-start.'));
     }
     switch (platform) {
         case 'darwin': {

package/dist/src/commands/manager.js

@@ -78,12 +78,60 @@ export function registerManagerCommand(program) {
     });
     sessions
         .command('send')
-        .description('Send a message to a managed worker')
+        .description('Queue a message for a managed worker; runs immediately if idle')
         .requiredOption('--session-id <id>', 'Worker session id')
         .option('--message <text>', 'Message text')
         .option('--message-file <path>', 'Read message from file')
+        .option('--direct', 'Bypass queue and send immediately')
         .action(async (opts) => {
-        await ipc('/sessions/send', { sessionId: opts.sessionId, message: readMessage(opts) });
+        await ipc('/sessions/send', {
+            sessionId: opts.sessionId,
+            message: readMessage(opts),
+            enqueue: !opts.direct,
+        });
+        console.log('ok');
+    });
+    const queue = sessions.command('queue').description('Inspect and edit pending worker messages');
+    queue
+        .command('list')
+        .description('List pending messages for a managed worker')
+        .requiredOption('--session-id <id>', 'Worker session id')
+        .option('--json', 'Print JSON')
+        .action(async (opts) => {
+        const result = await ipc('/sessions/queue', { sessionId: opts.sessionId });
+        if (opts.json)
+            printJson(result);
+        else {
+            const pending = result.queue?.pending ?? [];
+            for (const message of pending)
+                console.log(`${message.id}\t${message.text.replace(/\s+/g, ' ').slice(0, 120)}`);
+        }
+    });
+    queue
+        .command('edit')
+        .description('Edit a pending worker message')
+        .requiredOption('--session-id <id>', 'Worker session id')
+        .requiredOption('--message-id <id>', 'Queued message id')
+        .option('--message <text>', 'Replacement message text')
+        .option('--message-file <path>', 'Read replacement message from file')
+        .action(async (opts) => {
+        await ipc('/sessions/queue/edit', {
+            sessionId: opts.sessionId,
+            queueMessageId: opts.messageId,
+            message: readMessage(opts),
+        });
+        console.log('ok');
+    });
+    queue
+        .command('delete')
+        .description('Delete a pending worker message')
+        .requiredOption('--session-id <id>', 'Worker session id')
+        .requiredOption('--message-id <id>', 'Queued message id')
+        .action(async (opts) => {
+        await ipc('/sessions/queue/delete', {
+            sessionId: opts.sessionId,
+            queueMessageId: opts.messageId,
+        });
         console.log('ok');
     });
     sessions
@@ -117,6 +165,16 @@ export function registerManagerCommand(program) {
         console.log(result.path);
     });
     const external = manager.command('external').description('External channel tools');
+    const sendExternal = async (opts) => {
+        await ipc('/external/reply', opts);
+        console.log('ok');
+    };
+    external
+        .command('send')
+        .description('Send a message to the Manager-bound external channel')
+        .requiredOption('--text <text>', 'Message text')
+        .option('--idempotency-key <key>', 'Idempotency key')
+        .action(sendExternal);
     external
         .command('reply')
         .description('Send an explicit reply to an external channel')
@@ -125,10 +183,7 @@ export function registerManagerCommand(program) {
         .option('--conversation-id <id>', 'Conversation id')
         .requiredOption('--text <text>', 'Reply text')
         .option('--idempotency-key <key>', 'Idempotency key')
-        .action(async (opts) => {
-        await ipc('/external/reply', opts);
-        console.log('ok');
-    });
+        .action(sendExternal);
     const channel = manager.command('channel').description('Manager external channel config');
     channel
         .command('get')

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

@@ -1,2 +1,2 @@
-export declare const MANAGER_SYSTEM_PROMPT = "\u4F60\u662F\u795E\u5FF5\u91CC\u7684 Manager Agent\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\u672A\u7ECF\u7528\u6237\u5141\u8BB8 commit\u3001push\u3001deploy\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: \u5185\u5BB9\u201D\uFF1B\u5185\u5BB9\u53EF\u80FD\u662F\u5916\u90E8\u7FA4\u5185\u4E00\u6BB5\u65F6\u95F4\u7684\u5408\u5E76\u6D88\u606F\uFF0C\u6BCF\u6761\u4F1A\u5305\u542B\u5916\u90E8\u5E73\u53F0\u7528\u6237 ID \u548C\u65F6\u95F4\u6233\u3002\u8FD9\u91CC\u7684\u7528\u6237 ID \u662F\u4F01\u4E1A\u5FAE\u4FE1/\u5916\u90E8\u5E73\u53F0 ID\uFF0C\u4E0D\u662F\u795E\u5FF5\u7528\u6237 ID\u3002\n- \u5916\u90E8\u6D88\u606F\u53EF\u80FD\u5305\u542B\u56FE\u7247\u3001\u89C6\u9891\u6216\u6587\u4EF6 URL\u3002\u9700\u8981\u7406\u89E3\u5A92\u4F53\u5185\u5BB9\u65F6\uFF0C\u5148\u57FA\u4E8E URL/\u9644\u4EF6\u4FE1\u606F\u5224\u65AD\u662F\u5426\u80FD\u76F4\u63A5\u5904\u7406\uFF1B\u4E0D\u80FD\u5904\u7406\u65F6\uFF0C\u7B80\u6D01\u8BF4\u660E\u9700\u8981\u7528\u6237\u8865\u5145\u6216\u5B89\u6392 worker \u67E5\u770B\u3002\n- \u4F60\u5FC5\u987B\u663E\u5F0F\u51B3\u5B9A\u662F\u5426\u4EE5\u53CA\u5982\u4F55\u56DE\u590D\u5916\u90E8\u7528\u6237\u3002\u4E0E\u5F53\u524D\u9879\u76EE\u6216\u7528\u6237\u76EE\u6807\u65E0\u5173\u7684\u5916\u90E8\u6D88\u606F\u53EF\u4EE5\u5FFD\u7565\uFF0C\u4E0D\u8981\u4E3A\u4E86\u793C\u8C8C\u5F3A\u884C\u56DE\u590D\u3002\n- \u5982\u679C\u5916\u90E8\u8BF7\u6C42\u9700\u8981\u8F83\u957F\u65F6\u95F4\u5904\u7406\uFF0C\u5148\u7528\u5916\u90E8\u56DE\u590D\u7B80\u77ED\u786E\u8BA4\u201C\u6536\u5230\uFF0C\u6211\u5148\u5904\u7406/\u5B89\u6392\u4E00\u4E0B\u201D\uFF0C\u518D\u521B\u5EFA\u6216\u6307\u6D3E worker\u3002\n- \u5982\u679C\u5F53\u524D Manager \u914D\u7F6E\u4E86\u5916\u90E8\u6D88\u606F\u901A\u9053\uFF0C\u4F60\u53EF\u4EE5\u628A\u5B83\u5F53\u6210\u4E00\u4E2A\u53EF\u7528\u7684\u6536\u53D1\u6E20\u9053\u3002\u56DE\u590D\u6536\u5230\u7684\u5916\u90E8\u6D88\u606F\u65F6\uFF0C\u59CB\u7EC8\u76F4\u63A5\u8C03\u7528 shennian manager external reply --text \"<\u56DE\u590D\u5185\u5BB9>\"\uFF1B\u4E0D\u8981\u4E3A\u4E86\u56DE\u590D\u5916\u90E8\u6D88\u606F\u5148\u67E5\u8BE2 channel\uFF0C\u4E5F\u4E0D\u8981\u624B\u5DE5\u62FC channelId \u6216 conversationId\u3002\n- \u53EA\u6709\u5728\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u4E3B\u52A8\u53D1\u5230\u67D0\u4E2A\u975E\u6700\u8FD1\u5916\u90E8\u6D88\u606F\u7684\u6307\u5B9A\u5916\u90E8\u4F1A\u8BDD\u65F6\uFF0C\u624D\u7528 shennian manager channel get --json \u67E5\u770B channelId\u3001enabled\u3001canReply\uFF0C\u518D\u7528 channelId + conversationId \u8C03\u7528 external reply\u3002\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 stop --session-id <id>\n- shennian manager sessions read --session-id <id> --limit 200 --json\n- shennian manager memory path\n- shennian manager external reply --text <text>\n- shennian manager external reply --reply-target <id> --text <text>\n- shennian manager external reply --channel-id <id> --conversation-id <id> --text <text>\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\\n\u5185\u5BB9\u201D\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- \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

@@ -1,6 +1,6 @@
 // @arch docs/features/manager-agent.md
 // @test src/__tests__/manager-runtime.test.ts
-export const MANAGER_SYSTEM_PROMPT = `你是神念里的 Manager Agent，是当前项目的管理者。
+export const MANAGER_SYSTEM_PROMPT = `你是项目经理，是当前项目的管理者。
 
 你的职责：
 - 理解用户目标。
@@ -18,27 +18,28 @@ export const MANAGER_SYSTEM_PROMPT = `你是神念里的 Manager Agent，是当
 - 创建 worker 后，除非用户明确要求你当场继续调度，否则回复用户已安排并结束当前 turn；不要主动轮询 worker 状态，神念会在 worker 终态或健康摘要到来时重新唤醒你。
 - sessions read 返回的是给管理者看的简洁进展、工具摘要和最终结果，不是原始流式 token；不要要求读取或转述完整流式日志。
 - 只能管理与你处于同一台机器、同一项目目录的会话；不要跨机器或跨项目调度。
-- 不要未经用户允许 commit、push、deploy。
 - 不要无限循环；没有明确下一步时询问用户或结束当前 turn 等待系统事件。
 - 不要自己设置定时唤醒；神念会在用户消息、worker 终态或 worker 长运行健康摘要到来时唤醒你。
-- 外部消息通道事件会像普通用户消息一样送达，格式类似“外部消息 / 发送人: 内容”；内容可能是外部群内一段时间的合并消息，每条会包含外部平台用户 ID 和时间戳。这里的用户 ID 是企业微信/外部平台 ID，不是神念用户 ID。
-- 外部消息可能包含图片、视频或文件 URL。需要理解媒体内容时，先基于 URL/附件信息判断是否能直接处理；不能处理时，简洁说明需要用户补充或安排 worker 查看。
-- 你必须显式决定是否以及如何回复外部用户。与当前项目或用户目标无关的外部消息可以忽略，不要为了礼貌强行回复。
-- 如果外部请求需要较长时间处理，先用外部回复简短确认“收到，我先处理/安排一下”，再创建或指派 worker。
-- 如果当前 Manager 配置了外部消息通道，你可以把它当成一个可用的收发渠道。回复收到的外部消息时，始终直接调用 shennian manager external reply --text "<回复内容>"；不要为了回复外部消息先查询 channel，也不要手工拼 channelId 或 conversationId。
-- 只有在用户明确要求你主动发到某个非最近外部消息的指定外部会话时，才用 shennian manager channel get --json 查看 channelId、enabled、canReply，再用 channelId + conversationId 调用 external reply。
+- 外部消息通道事件会像普通用户消息一样送达，格式类似“外部消息 / 发送人\\n内容”，可能是合并消息，也可能包含图片、视频或文件 URL。
+- 对外你是当前项目的项目经理，不要自称神念、Manager Agent 或 worker，也不要解释内部调度机制；只在需要时用“我这边/我们这边”沟通。
+- 外部消息与当前项目无关时可以忽略；需要较长处理时，先简短回复“收到，我先处理/安排一下”，再创建或指派 worker。
+- 向外部群发消息一律调用 shennian manager external send --text "<消息内容>"
 - 不要把所有细节塞进对话上下文；需要长期保存的信息写到项目 .shennian/ 下。
 
 需要管理 worker 或外部通道时，使用本地命令：
 - shennian manager sessions list --json
 - shennian manager sessions start --agent codex --workdir <path> --message <text>
 - shennian manager sessions send --session-id <id> --message <text>
+- shennian manager sessions send --session-id <id> --message <text> --direct
+- shennian manager sessions queue list --session-id <id> --json
+- shennian manager sessions queue edit --session-id <id> --message-id <queueMessageId> --message <text>
+- shennian manager sessions queue delete --session-id <id> --message-id <queueMessageId>
 - shennian manager sessions stop --session-id <id>
 - shennian manager sessions read --session-id <id> --limit 200 --json
 - shennian manager memory path
-- shennian manager external reply --text <text>
-- shennian manager external reply --reply-target <id> --text <text>
-- shennian manager external reply --channel-id <id> --conversation-id <id> --text <text>
+- shennian manager external send --text <text>
+
+默认用 sessions send 排队发送 worker 消息：worker 正忙时消息会在本机 daemon 队列里等待，worker 空闲时自动执行。队列里的未执行消息可以 list/edit/delete；已经开始执行的消息不能编辑或删除，只能 stop 后重新发送。只有明确需要打断顺序时才使用 --direct。
 
 这些命令已经由神念注入当前 Manager 身份和同项目权限边界。不要尝试伪造 Manager session id。`;
 export function buildManagerPrompt(userText) {

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

@@ -41,6 +41,7 @@ export declare class ManagerRuntimeService {
     private broadcastManagerChannelStatus;
     private handleIpc;
     private dispatchChatSend;
+    private dispatchChatEnqueue;
     private wakeManagerForWorker;
     private handleExternalMessage;
     private scanWorkerHealth;

package/dist/src/manager/runtime.js

@@ -341,13 +341,63 @@ export class ManagerRuntimeService {
             if (url.pathname === '/sessions/send') {
                 const sessionId = String(body.sessionId || '');
                 const message = String(body.message || '');
+                const enqueue = body.enqueue === undefined ? true : Boolean(body.enqueue);
                 const worker = this.registry.getWorkerForManager(managerSessionId, sessionId);
                 if (!worker)
                     throw new Error('Worker not found in this manager scope');
-                await this.dispatchChatSend(worker.sessionId, worker.agentType, worker.workDir, message, worker.agentSessionId ?? null, String(body.modelId || ''));
+                if (enqueue) {
+                    await this.dispatchChatEnqueue(worker.sessionId, worker.agentType, worker.workDir, message, worker.agentSessionId ?? null, String(body.modelId || ''));
+                }
+                else {
+                    await this.dispatchChatSend(worker.sessionId, worker.agentType, worker.workDir, message, worker.agentSessionId ?? null, String(body.modelId || ''));
+                }
                 json(res, 200, { ok: true });
                 return;
             }
+            if (url.pathname === '/sessions/queue') {
+                const sessionId = String(body.sessionId || '');
+                const worker = this.registry.getWorkerForManager(managerSessionId, sessionId);
+                if (!worker)
+                    throw new Error('Worker not found in this manager scope');
+                const queue = this.opts.getRuntime().chatQueue?.getSnapshot(sessionId);
+                json(res, 200, { ok: true, queue });
+                return;
+            }
+            if (url.pathname === '/sessions/queue/edit') {
+                const sessionId = String(body.sessionId || '');
+                const worker = this.registry.getWorkerForManager(managerSessionId, sessionId);
+                if (!worker)
+                    throw new Error('Worker not found in this manager scope');
+                await this.opts.dispatchReq({
+                    type: 'req',
+                    id: `manager-queue-edit-${randomUUID()}`,
+                    method: 'chat.queue.edit',
+                    params: {
+                        sessionId,
+                        queueMessageId: String(body.queueMessageId || body.messageId || ''),
+                        text: String(body.message || body.text || ''),
+                    },
+                });
+                json(res, 200, { ok: true, queue: this.opts.getRuntime().chatQueue?.getSnapshot(sessionId) });
+                return;
+            }
+            if (url.pathname === '/sessions/queue/delete') {
+                const sessionId = String(body.sessionId || '');
+                const worker = this.registry.getWorkerForManager(managerSessionId, sessionId);
+                if (!worker)
+                    throw new Error('Worker not found in this manager scope');
+                await this.opts.dispatchReq({
+                    type: 'req',
+                    id: `manager-queue-delete-${randomUUID()}`,
+                    method: 'chat.queue.delete',
+                    params: {
+                        sessionId,
+                        queueMessageId: String(body.queueMessageId || body.messageId || ''),
+                    },
+                });
+                json(res, 200, { ok: true, queue: this.opts.getRuntime().chatQueue?.getSnapshot(sessionId) });
+                return;
+            }
             if (url.pathname === '/sessions/stop') {
                 const sessionId = String(body.sessionId || '');
                 const worker = this.registry.getWorkerForManager(managerSessionId, sessionId);
@@ -380,11 +430,15 @@ export class ManagerRuntimeService {
                 const replyTarget = typeof body.replyTarget === 'string'
                     ? this.registry.getReplyTarget(body.replyTarget)
                     : this.registry.getLatestReplyTargetForManager(managerSessionId);
-                const channelId = replyTarget?.channelId ?? String(body.channelId || '');
-                const conversationId = replyTarget?.conversationId ?? String(body.conversationId || '');
-                if (!channelId || !conversationId) {
-                    throw new Error('No external reply target is available; pass --channel-id and --conversation-id explicitly');
-                }
+                const explicitChannelId = String(body.channelId || '');
+                const explicitConversationId = String(body.conversationId || '');
+                const defaultTarget = !replyTarget && (!explicitChannelId || !explicitConversationId)
+                    ? await this.channelRuntime.getDefaultReplyTarget(managerSessionId)
+                    : null;
+                const channelId = replyTarget?.channelId || explicitChannelId || defaultTarget?.channelId || '';
+                const conversationId = replyTarget?.conversationId || explicitConversationId || defaultTarget?.conversationId || '';
+                if (!channelId || !conversationId)
+                    throw new Error('No external channel target is available for this Manager');
                 const result = await this.channelRuntime.reply({
                     managerSessionId,
                     channelId,
@@ -438,6 +492,14 @@ export class ManagerRuntimeService {
             params: { sessionId, text, agentType, workDir, agentSessionId, modelId },
         });
     }
+    async dispatchChatEnqueue(sessionId, agentType, workDir, text, agentSessionId, modelId) {
+        await this.opts.dispatchReq({
+            type: 'req',
+            id: `manager-enqueue-${randomUUID()}`,
+            method: 'chat.enqueue',
+            params: { sessionId, text, agentType, workDir, agentSessionId, modelId },
+        });
+    }
     wakeManagerForWorker(managerSessionId, worker, state, message) {
         const manager = this.registry.getManager(managerSessionId);
         if (!manager)

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

@@ -214,6 +214,7 @@ function bindAdapterEvents(runtime, sessionId, agentType, adapter) {
             activeSession?.currentRunId === event.runId) {
             activeSession.currentRunId = null;
             activeSession.nextEventSeq = 0;
+            runtime.chatQueue?.noteTerminal(sessionId);
         }
         sendAgentEvent(event, extra);
     });

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

@@ -21,6 +21,7 @@ export declare class SessionManager {
     /** In-flight chunked uploads: transferId → metadata */
     private pendingTransfers;
     private managerRuntime;
+    private chatQueue;
     constructor(client: CliRelayClient, nativeFusion?: NativeSessionFusionService | null, cliVersion?: string | undefined);
     private getRuntime;
     private reloadCustomAgents;

package/dist/src/session/manager.js

@@ -11,6 +11,7 @@ import { handleChatAbort, handleChatSend } from './handlers/chat.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';
+import { ChatQueueManager } from './queue.js';
 // Side-effect imports to register built-in agent adapters.
 import '../agents/claude.js';
 import '../agents/codex.js';
@@ -61,6 +62,7 @@ export class SessionManager {
     /** In-flight chunked uploads: transferId → metadata */
     pendingTransfers = new Map();
     managerRuntime;
+    chatQueue;
     constructor(client, nativeFusion = null, cliVersion) {
         this.client = client;
         this.nativeFusion = nativeFusion;
@@ -69,6 +71,10 @@ export class SessionManager {
             getRuntime: () => this.getRuntime(),
             dispatchReq: (req) => this.handleReq(req),
         });
+        this.chatQueue = new ChatQueueManager({
+            getRuntime: () => this.getRuntime(),
+            dispatchReq: (req) => this.handleReq(req),
+        });
         setManagerRuntimeService(this.managerRuntime);
         void this.managerRuntime.start();
         this.reloadCustomAgents();
@@ -85,6 +91,7 @@ export class SessionManager {
             evictIdleSessions: () => this.evictIdleSessions(),
             nativeFusion: this.nativeFusion,
             managerRuntime: this.managerRuntime,
+            chatQueue: this.chatQueue,
         };
     }
     reloadCustomAgents() {
@@ -105,6 +112,18 @@ export class SessionManager {
                 case 'chat.send':
                     await handleChatSend(runtime, req);
                     break;
+                case 'chat.enqueue':
+                    await this.chatQueue.handleEnqueue(req);
+                    break;
+                case 'chat.queue.get':
+                    await this.chatQueue.handleGet(req);
+                    break;
+                case 'chat.queue.edit':
+                    await this.chatQueue.handleEdit(req);
+                    break;
+                case 'chat.queue.delete':
+                    await this.chatQueue.handleDelete(req);
+                    break;
                 case 'chat.abort':
                     await handleChatAbort(runtime, req);
                     break;

package/dist/src/session/queue.d.ts

@@ -0,0 +1,20 @@
+import type { ChatQueueSnapshot, ReqFrame } from '@shennian/wire';
+import type { LocalReqDispatcher } from '../manager/runtime.js';
+import type { SessionManagerRuntime } from './types.js';
+export declare class ChatQueueManager {
+    private opts;
+    private draining;
+    constructor(opts: {
+        getRuntime: () => SessionManagerRuntime;
+        dispatchReq: LocalReqDispatcher;
+    });
+    getSnapshot(sessionId: string): ChatQueueSnapshot;
+    handleEnqueue(req: ReqFrame): Promise<void>;
+    handleGet(req: ReqFrame): Promise<void>;
+    handleEdit(req: ReqFrame): Promise<void>;
+    handleDelete(req: ReqFrame): Promise<void>;
+    noteTerminal(sessionId: string): void;
+    private drainNext;
+    private dispatchQueuedMessage;
+    private broadcast;
+}

package/dist/src/session/queue.js

@@ -0,0 +1,246 @@
+// @arch docs/features/session-message-queue.md
+// @test src/__tests__/session-manager.test.ts
+import fs from 'node:fs';
+import { randomUUID } from 'node:crypto';
+import { resolveShennianPath } from '../config/index.js';
+const QUEUE_FILE = resolveShennianPath('chat-queue.json');
+function emptyQueue() {
+    return { sessions: {} };
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+function readQueue() {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(QUEUE_FILE, 'utf-8'));
+        return {
+            sessions: parsed.sessions && typeof parsed.sessions === 'object' ? parsed.sessions : {},
+        };
+    }
+    catch {
+        return emptyQueue();
+    }
+}
+function writeQueue(queue) {
+    fs.mkdirSync(resolveShennianPath(''), { recursive: true });
+    fs.writeFileSync(QUEUE_FILE, JSON.stringify(queue, null, 2));
+}
+function normalizeAttachments(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const attachments = value
+        .map((item) => {
+        if (!item || typeof item !== 'object')
+            return null;
+        const entry = item;
+        const attachment = {
+            path: typeof entry.path === 'string' ? entry.path : '',
+            name: typeof entry.name === 'string' ? entry.name : '',
+            mimeType: typeof entry.mimeType === 'string' ? entry.mimeType : '',
+        };
+        return attachment.path && attachment.name && attachment.mimeType ? attachment : null;
+    })
+        .filter((item) => item != null);
+    return attachments.length ? attachments : undefined;
+}
+function queueMessageFromParams(params) {
+    const timestamp = nowIso();
+    return {
+        id: params.queueMessageId || params.clientMessageId || `queue-${randomUUID()}`,
+        sessionId: params.sessionId,
+        text: params.text,
+        agentType: params.agentType,
+        workDir: params.workDir,
+        agentSessionId: params.agentSessionId ?? null,
+        modelId: params.modelId ?? null,
+        clientMessageId: params.clientMessageId ?? null,
+        attachments: normalizeAttachments(params.attachments),
+        createdAt: timestamp,
+        updatedAt: timestamp,
+    };
+}
+export class ChatQueueManager {
+    opts;
+    draining = new Set();
+    constructor(opts) {
+        this.opts = opts;
+    }
+    getSnapshot(sessionId) {
+        return {
+            sessionId,
+            busy: Boolean(this.opts.getRuntime().sessions.get(sessionId)?.currentRunId),
+            pending: readQueue().sessions[sessionId] ?? [],
+        };
+    }
+    async handleEnqueue(req) {
+        const runtime = this.opts.getRuntime();
+        const params = req.params;
+        if (!params.sessionId || !params.text || !params.agentType || !params.workDir) {
+            runtime.client.sendRes({
+                type: 'res',
+                id: req.id,
+                ok: false,
+                error: 'sessionId, text, agentType and workDir are required',
+            });
+            return;
+        }
+        const active = runtime.sessions.get(params.sessionId);
+        const isBusy = Boolean(active?.currentRunId);
+        if (!isBusy && !(readQueue().sessions[params.sessionId]?.length)) {
+            await this.dispatchQueuedMessage(queueMessageFromParams(params));
+            runtime.client.sendRes({
+                type: 'res',
+                id: req.id,
+                ok: true,
+                payload: { queued: false, queue: this.getSnapshot(params.sessionId) },
+            });
+            return;
+        }
+        const queue = readQueue();
+        const message = queueMessageFromParams(params);
+        queue.sessions[params.sessionId] = [...(queue.sessions[params.sessionId] ?? []), message];
+        writeQueue(queue);
+        this.broadcast(params.sessionId);
+        runtime.client.sendRes({
+            type: 'res',
+            id: req.id,
+            ok: true,
+            payload: { queued: true, queueMessageId: message.id, queue: this.getSnapshot(params.sessionId) },
+        });
+    }
+    async handleGet(req) {
+        const runtime = this.opts.getRuntime();
+        const params = req.params;
+        if (!params.sessionId) {
+            runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: 'sessionId is required' });
+            return;
+        }
+        runtime.client.sendRes({
+            type: 'res',
+            id: req.id,
+            ok: true,
+            payload: { queue: this.getSnapshot(params.sessionId) },
+        });
+    }
+    async handleEdit(req) {
+        const runtime = this.opts.getRuntime();
+        const params = req.params;
+        if (!params.sessionId || !params.queueMessageId || !params.text) {
+            runtime.client.sendRes({
+                type: 'res',
+                id: req.id,
+                ok: false,
+                error: 'sessionId, queueMessageId and text are required',
+            });
+            return;
+        }
+        const queue = readQueue();
+        const pending = queue.sessions[params.sessionId] ?? [];
+        const index = pending.findIndex((message) => message.id === params.queueMessageId);
+        if (index < 0) {
+            runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: 'Queued message not found' });
+            return;
+        }
+        pending[index] = {
+            ...pending[index],
+            text: params.text,
+            attachments: normalizeAttachments(params.attachments),
+            updatedAt: nowIso(),
+        };
+        queue.sessions[params.sessionId] = pending;
+        writeQueue(queue);
+        this.broadcast(params.sessionId);
+        runtime.client.sendRes({
+            type: 'res',
+            id: req.id,
+            ok: true,
+            payload: { queue: this.getSnapshot(params.sessionId) },
+        });
+    }
+    async handleDelete(req) {
+        const runtime = this.opts.getRuntime();
+        const params = req.params;
+        if (!params.sessionId || !params.queueMessageId) {
+            runtime.client.sendRes({
+                type: 'res',
+                id: req.id,
+                ok: false,
+                error: 'sessionId and queueMessageId are required',
+            });
+            return;
+        }
+        const queue = readQueue();
+        const pending = queue.sessions[params.sessionId] ?? [];
+        const next = pending.filter((message) => message.id !== params.queueMessageId);
+        if (next.length === pending.length) {
+            runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: 'Queued message not found' });
+            return;
+        }
+        if (next.length)
+            queue.sessions[params.sessionId] = next;
+        else
+            delete queue.sessions[params.sessionId];
+        writeQueue(queue);
+        this.broadcast(params.sessionId);
+        runtime.client.sendRes({
+            type: 'res',
+            id: req.id,
+            ok: true,
+            payload: { queue: this.getSnapshot(params.sessionId) },
+        });
+    }
+    noteTerminal(sessionId) {
+        void this.drainNext(sessionId);
+    }
+    async drainNext(sessionId) {
+        if (this.draining.has(sessionId))
+            return;
+        const runtime = this.opts.getRuntime();
+        if (runtime.sessions.get(sessionId)?.currentRunId)
+            return;
+        const queue = readQueue();
+        const pending = queue.sessions[sessionId] ?? [];
+        const next = pending.shift();
+        if (!next) {
+            this.broadcast(sessionId);
+            return;
+        }
+        if (pending.length)
+            queue.sessions[sessionId] = pending;
+        else
+            delete queue.sessions[sessionId];
+        writeQueue(queue);
+        this.broadcast(sessionId);
+        this.draining.add(sessionId);
+        try {
+            await this.dispatchQueuedMessage(next);
+        }
+        finally {
+            this.draining.delete(sessionId);
+        }
+    }
+    async dispatchQueuedMessage(message) {
+        await this.opts.dispatchReq({
+            type: 'req',
+            id: `queue-send-${message.id}-${Date.now()}`,
+            method: 'chat.send',
+            params: {
+                sessionId: message.sessionId,
+                text: message.text,
+                agentType: message.agentType,
+                workDir: message.workDir,
+                agentSessionId: message.agentSessionId ?? null,
+                modelId: message.modelId ?? undefined,
+                clientMessageId: message.clientMessageId ?? message.id,
+                attachments: message.attachments,
+            },
+        });
+    }
+    broadcast(sessionId) {
+        this.opts.getRuntime().client.sendEvent({
+            type: 'event',
+            event: 'session.queue.update',
+            payload: { queue: this.getSnapshot(sessionId) },
+        });
+    }
+}

package/dist/src/session/types.d.ts

@@ -23,6 +23,14 @@ export type PendingTransfer = {
     targetPath: string;
     totalSize: number;
 };
+export type ChatQueueService = {
+    handleEnqueue(req: import('@shennian/wire').ReqFrame): Promise<void>;
+    handleGet(req: import('@shennian/wire').ReqFrame): Promise<void>;
+    handleEdit(req: import('@shennian/wire').ReqFrame): Promise<void>;
+    handleDelete(req: import('@shennian/wire').ReqFrame): Promise<void>;
+    noteTerminal(sessionId: string): void;
+    getSnapshot(sessionId: string): import('@shennian/wire').ChatQueueSnapshot;
+};
 export type SessionManagerRuntime = {
     client: CliRelayClient;
     pendingTransfers: Map<string, PendingTransfer>;
@@ -34,4 +42,5 @@ export type SessionManagerRuntime = {
     evictIdleSessions: () => void;
     nativeFusion: NativeSessionFusionService | null;
     managerRuntime: ManagerRuntimeService | null;
+    chatQueue: ChatQueueService | null;
 };

package/package.json

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