shennian 0.2.48 → 0.2.50

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/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/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

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\\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 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\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

@@ -30,11 +30,17 @@ export const MANAGER_SYSTEM_PROMPT = `你是项目经理，是当前项目的管
 - 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 send --text <text>
 
+默认用 sessions send 排队发送 worker 消息：worker 正忙时消息会在本机 daemon 队列里等待，worker 空闲时自动执行。队列里的未执行消息可以 list/edit/delete；已经开始执行的消息不能编辑或删除，只能 stop 后重新发送。只有明确需要打断顺序时才使用 --direct。
+
 这些命令已经由神念注入当前 Manager 身份和同项目权限边界。不要尝试伪造 Manager session id。`;
 export function buildManagerPrompt(userText) {
     return 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);
@@ -442,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);
     });
@@ -282,7 +283,7 @@ export async function handleChatSend(runtime, req) {
         return;
     }
     rememberProcessedReqId(runtime, req.id);
-    const { sessionId, text, agentType, workDir, agentSessionId: incomingAgentSid, modelId, clientMessageId, sessionListProjection } = req.params;
+    const { sessionId, text, agentType, workDir, agentSessionId: incomingAgentSid, modelId, clientMessageId, sessionListProjection, waitForDispatch } = req.params;
     mergeProjectedSessions(sessionListProjection);
     if (!sessionId || !text) {
         runtime.processedReqIds.delete(req.id);
@@ -353,23 +354,6 @@ export async function handleChatSend(runtime, req) {
             return;
         }
     }
-    sendSessionUpdateEvent(runtime, {
-        sessionId,
-        agentType: requestedAgentType,
-        workDir: resolvedWorkDir,
-        agentSessionId: session.agentSessionId ?? incomingAgentSid ?? null,
-        modelId,
-    });
-    session.currentRunId = null;
-    session.nextEventSeq = 0;
-    runtime.nativeFusion?.registerManagedSend({
-        sessionId,
-        agentType: requestedAgentType,
-        sourceAgentType: getNativeSourceAgentType(requestedAgentType, modelId),
-        canonicalMessageId: clientMessageId ?? null,
-        sourceSessionKey: session.agentSessionId ?? incomingAgentSid ?? null,
-        text,
-    });
     const userEnvelope = {
         id: clientMessageId ?? `user-${req.id}`,
         sessionId,
@@ -377,36 +361,39 @@ export async function handleChatSend(runtime, req) {
         ts: Date.now(),
         payload: text,
     };
-    appendMessage(sessionId, userEnvelope);
-    sendSessionMessageEvent(runtime, userEnvelope, {
-        agentType: requestedAgentType,
-        workDir: resolvedWorkDir,
-        agentSessionId: session.agentSessionId ?? incomingAgentSid ?? null,
-        modelId,
-    });
     reportLog({
         level: 'info',
         sessionId,
         wsEvent: 'chat.send.start',
         metadata: { reqId: req.id, agentType: requestedAgentType, modelId },
     });
-    runtime.client.sendRes({ type: 'res', id: req.id, ok: true });
-    reportLog({
-        level: 'info',
-        sessionId,
-        wsEvent: 'chat.send.res',
-        metadata: { reqId: req.id, ok: true },
-    });
-    void session.adapter.send(text, modelId)
-        .then(() => {
-        reportLog({
-            level: 'info',
+    const markAccepted = () => {
+        sendSessionUpdateEvent(runtime, {
             sessionId,
-            wsEvent: 'chat.send.done',
-            metadata: { reqId: req.id },
+            agentType: requestedAgentType,
+            workDir: resolvedWorkDir,
+            agentSessionId: session.agentSessionId ?? incomingAgentSid ?? null,
+            modelId,
         });
-    })
-        .catch(async (err) => {
+        session.currentRunId = null;
+        session.nextEventSeq = 0;
+        runtime.nativeFusion?.registerManagedSend({
+            sessionId,
+            agentType: requestedAgentType,
+            sourceAgentType: getNativeSourceAgentType(requestedAgentType, modelId),
+            canonicalMessageId: clientMessageId ?? null,
+            sourceSessionKey: session.agentSessionId ?? incomingAgentSid ?? null,
+            text,
+        });
+        appendMessage(sessionId, userEnvelope);
+        sendSessionMessageEvent(runtime, userEnvelope, {
+            agentType: requestedAgentType,
+            workDir: resolvedWorkDir,
+            agentSessionId: session.agentSessionId ?? incomingAgentSid ?? null,
+            modelId,
+        });
+    };
+    const handleSendFailure = async (err, respondToReq) => {
         const message = `Agent send failed: ${err instanceof Error ? err.message : String(err)}`;
         console.error(`[chat.send] send failed reqId=${req.id} sessionId=${sessionId} agentType=${agentType} workDir=${resolvedWorkDir} agentSessionId=${session.agentSessionId ?? incomingAgentSid ?? ''}: ${message}`);
         runtime.sessions.delete(sessionId);
@@ -425,6 +412,59 @@ export async function handleChatSend(runtime, req) {
                 seq: 0,
             },
         });
+        if (respondToReq) {
+            runtime.processedReqIds.delete(req.id);
+            runtime.client.sendRes({
+                type: 'res',
+                id: req.id,
+                ok: false,
+                error: message,
+            });
+        }
+    };
+    if (waitForDispatch) {
+        try {
+            await session.adapter.send(text, modelId);
+            reportLog({
+                level: 'info',
+                sessionId,
+                wsEvent: 'chat.send.done',
+                metadata: { reqId: req.id },
+            });
+        }
+        catch (err) {
+            await handleSendFailure(err, true);
+            return;
+        }
+        markAccepted();
+        runtime.client.sendRes({ type: 'res', id: req.id, ok: true });
+        reportLog({
+            level: 'info',
+            sessionId,
+            wsEvent: 'chat.send.res',
+            metadata: { reqId: req.id, ok: true },
+        });
+        return;
+    }
+    markAccepted();
+    runtime.client.sendRes({ type: 'res', id: req.id, ok: true });
+    reportLog({
+        level: 'info',
+        sessionId,
+        wsEvent: 'chat.send.res',
+        metadata: { reqId: req.id, ok: true },
+    });
+    void session.adapter.send(text, modelId)
+        .then(() => {
+        reportLog({
+            level: 'info',
+            sessionId,
+            wsEvent: 'chat.send.done',
+            metadata: { reqId: req.id },
+        });
+    })
+        .catch((err) => {
+        void handleSendFailure(err, false);
     });
 }
 export async function handleChatAbort(runtime, req) {

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,248 @@
+// @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.opts.dispatchReq({
+                ...req,
+                method: 'chat.send',
+                params: {
+                    ...params,
+                    clientMessageId: params.clientMessageId ?? params.queueMessageId,
+                    waitForDispatch: true,
+                },
+            });
+            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.48",
+  "version": "0.2.50",
   "description": "Shennian — AI Agent Control Plane CLI",
   "type": "module",
   "bin": {