shennian 0.2.89 → 0.2.90

package/dist/src/commands/external-attachments.js

@@ -1,51 +1 @@
-// @arch docs/features/wecom-managed-channel.md
-// @test src/__tests__/external-command.test.ts
-import fs from 'node:fs';
-import path from 'node:path';
-const MIME_BY_EXT = {
-    '.jpg': 'image/jpeg',
-    '.jpeg': 'image/jpeg',
-    '.png': 'image/png',
-    '.gif': 'image/gif',
-    '.webp': 'image/webp',
-    '.mp4': 'video/mp4',
-    '.mov': 'video/quicktime',
-    '.pdf': 'application/pdf',
-    '.txt': 'text/plain',
-    '.md': 'text/markdown',
-    '.csv': 'text/csv',
-    '.doc': 'application/msword',
-    '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
-    '.xls': 'application/vnd.ms-excel',
-    '.xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
-    '.ppt': 'application/vnd.ms-powerpoint',
-    '.pptx': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
-    '.zip': 'application/zip',
-};
-const MAX_EXTERNAL_ATTACHMENT_BYTES = Number(process.env.SHENNIAN_EXTERNAL_ATTACHMENT_MAX_BYTES || 20 * 1024 * 1024);
-function inferMimeType(filePath, kind) {
-    const ext = path.extname(filePath).toLowerCase();
-    if (MIME_BY_EXT[ext])
-        return MIME_BY_EXT[ext];
-    if (kind === 'image')
-        return 'image/jpeg';
-    if (kind === 'video')
-        return 'video/mp4';
-    return 'application/octet-stream';
-}
-export function readExternalAttachment(filePath, kind) {
-    const absolutePath = path.resolve(filePath);
-    const stat = fs.statSync(absolutePath);
-    if (!stat.isFile())
-        throw new Error(`Attachment is not a file: ${absolutePath}`);
-    if (stat.size > MAX_EXTERNAL_ATTACHMENT_BYTES) {
-        throw new Error(`Attachment is too large: ${stat.size} bytes. Max: ${MAX_EXTERNAL_ATTACHMENT_BYTES} bytes.`);
-    }
-    return {
-        kind,
-        name: path.basename(absolutePath),
-        mimeType: inferMimeType(absolutePath, kind),
-        size: stat.size,
-        localPath: absolutePath,
-    };
-}
+import m from"node:fs";import n from"node:path";const p={".jpg":"image/jpeg",".jpeg":"image/jpeg",".png":"image/png",".gif":"image/gif",".webp":"image/webp",".mp4":"video/mp4",".mov":"video/quicktime",".pdf":"application/pdf",".txt":"text/plain",".md":"text/markdown",".csv":"text/csv",".doc":"application/msword",".docx":"application/vnd.openxmlformats-officedocument.wordprocessingml.document",".xls":"application/vnd.ms-excel",".xlsx":"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",".ppt":"application/vnd.ms-powerpoint",".pptx":"application/vnd.openxmlformats-officedocument.presentationml.presentation",".zip":"application/zip"},a=Number(process.env.SHENNIAN_EXTERNAL_ATTACHMENT_MAX_BYTES||20*1024*1024);function r(i,t){const e=n.extname(i).toLowerCase();return p[e]?p[e]:t==="image"?"image/jpeg":t==="video"?"video/mp4":"application/octet-stream"}function l(i,t){const e=n.resolve(i),o=m.statSync(e);if(!o.isFile())throw new Error(`Attachment is not a file: ${e}`);if(o.size>a)throw new Error(`Attachment is too large: ${o.size} bytes. Max: ${a} bytes.`);return{kind:t,name:n.basename(e),mimeType:r(e,t),size:o.size,localPath:e}}export{l as readExternalAttachment};

package/dist/src/commands/external.js

@@ -1,137 +1 @@
-// @arch docs/features/wecom-managed-channel.md
-// @test src/__tests__/external-command.test.ts
-import fs from 'node:fs';
-import chalk from 'chalk';
-import { resolveShennianPath } from '../config/index.js';
-import { readExternalAttachment } from './external-attachments.js';
-function loadManagerIpcFromRuntimeFile() {
-    const filePath = resolveShennianPath('runtime', 'manager-ipc.json');
-    try {
-        const parsed = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
-        const pid = Number(parsed.pid);
-        if (Number.isInteger(pid) && pid > 0 && !processExists(pid)) {
-            return { error: `Manager IPC runtime file is stale for PID ${pid}. Restart the desktop daemon and retry.` };
-        }
-        return {
-            url: typeof parsed.url === 'string' ? parsed.url : undefined,
-            token: typeof parsed.token === 'string' ? parsed.token : undefined,
-        };
-    }
-    catch {
-        return {};
-    }
-}
-function requireExternalContext(explicitSessionId) {
-    const runtimeIpc = !process.env.SHENNIAN_MANAGER_IPC_URL || !process.env.SHENNIAN_MANAGER_IPC_TOKEN
-        ? loadManagerIpcFromRuntimeFile()
-        : {};
-    if (runtimeIpc.error) {
-        console.error(chalk.red(`✗ ${runtimeIpc.error}`));
-        process.exit(1);
-    }
-    const url = process.env.SHENNIAN_MANAGER_IPC_URL || runtimeIpc.url;
-    const token = process.env.SHENNIAN_MANAGER_IPC_TOKEN || runtimeIpc.token;
-    const sessionId = explicitSessionId?.trim() || process.env.SHENNIAN_EXTERNAL_SESSION_ID || process.env.SHENNIAN_MANAGER_SESSION_ID;
-    if (!url || !token || !sessionId) {
-        console.error(chalk.red('✗ This command must run inside a Shennian conversation with an external channel, or pass --session-id <id>.'));
-        process.exit(1);
-    }
-    return { url, token, sessionId };
-}
-function processExists(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-async function sendExternal(input) {
-    const ctx = requireExternalContext(input.sessionId);
-    const replyTarget = input.replyTarget?.trim() || process.env.SHENNIAN_EXTERNAL_REPLY_TARGET || undefined;
-    const response = await fetch(`${ctx.url}/external/reply`, {
-        method: 'POST',
-        headers: {
-            authorization: `Bearer ${ctx.token}`,
-            'content-type': 'application/json',
-            'x-shennian-manager-session-id': ctx.sessionId,
-        },
-        body: JSON.stringify({
-            managerSessionId: ctx.sessionId,
-            text: input.text,
-            attachment: input.attachment,
-            idempotencyKey: input.idempotencyKey,
-            replyTarget,
-        }),
-    });
-    const data = await response.json().catch(() => ({ ok: false, error: response.statusText }));
-    if (!response.ok || !data.ok) {
-        throw new Error(data.error || `External send failed: ${response.status}`);
-    }
-    console.log('ok');
-}
-export function registerExternalCommand(program) {
-    const external = program.command('external').description('External channel tools for this Shennian conversation');
-    external
-        .command('send')
-        .description('Send a message to the external channel bound to this conversation')
-        .requiredOption('--text <text>', 'Message text')
-        .option('--session-id <id>', 'Shennian conversation/session id; defaults to injected current-session env')
-        .option('--reply-target <id>', 'Daemon-generated reply target; defaults to SHENNIAN_EXTERNAL_REPLY_TARGET or latest external message')
-        .option('--idempotency-key <key>', 'Idempotency key')
-        .action(async (opts) => {
-        await sendExternal({ text: opts.text, replyTarget: opts.replyTarget, idempotencyKey: opts.idempotencyKey, sessionId: opts.sessionId });
-    });
-    external
-        .command('send-image')
-        .description('Send an image file to the external channel bound to this conversation')
-        .requiredOption('--path <path>', 'Image file path')
-        .option('--caption <text>', 'Optional text to send before the image')
-        .option('--session-id <id>', 'Shennian conversation/session id; defaults to injected current-session env')
-        .option('--reply-target <id>', 'Daemon-generated reply target; defaults to SHENNIAN_EXTERNAL_REPLY_TARGET or latest external message')
-        .option('--idempotency-key <key>', 'Idempotency key')
-        .action(async (opts) => {
-        await sendExternal({
-            text: opts.caption,
-            attachment: readExternalAttachment(opts.path, 'image'),
-            replyTarget: opts.replyTarget,
-            idempotencyKey: opts.idempotencyKey,
-            sessionId: opts.sessionId,
-        });
-    });
-    external
-        .command('send-video')
-        .description('Send a video file to the external channel bound to this conversation')
-        .requiredOption('--path <path>', 'Video file path')
-        .option('--caption <text>', 'Optional text to send before the video')
-        .option('--session-id <id>', 'Shennian conversation/session id; defaults to injected current-session env')
-        .option('--reply-target <id>', 'Daemon-generated reply target; defaults to SHENNIAN_EXTERNAL_REPLY_TARGET or latest external message')
-        .option('--idempotency-key <key>', 'Idempotency key')
-        .action(async (opts) => {
-        await sendExternal({
-            text: opts.caption,
-            attachment: readExternalAttachment(opts.path, 'video'),
-            replyTarget: opts.replyTarget,
-            idempotencyKey: opts.idempotencyKey,
-            sessionId: opts.sessionId,
-        });
-    });
-    external
-        .command('send-file')
-        .description('Send a file to the external channel bound to this conversation')
-        .requiredOption('--path <path>', 'File path')
-        .option('--caption <text>', 'Optional text to send before the file')
-        .option('--session-id <id>', 'Shennian conversation/session id; defaults to injected current-session env')
-        .option('--reply-target <id>', 'Daemon-generated reply target; defaults to SHENNIAN_EXTERNAL_REPLY_TARGET or latest external message')
-        .option('--idempotency-key <key>', 'Idempotency key')
-        .action(async (opts) => {
-        await sendExternal({
-            text: opts.caption,
-            attachment: readExternalAttachment(opts.path, 'file'),
-            replyTarget: opts.replyTarget,
-            idempotencyKey: opts.idempotencyKey,
-            sessionId: opts.sessionId,
-        });
-    });
-}
+import d from"node:fs";import s from"chalk";import{resolveShennianPath as c}from"../config/index.js";import{readExternalAttachment as a}from"./external-attachments.js";function p(){const n=c("runtime","manager-ipc.json");try{const t=JSON.parse(d.readFileSync(n,"utf-8")),e=Number(t.pid);return Number.isInteger(e)&&e>0&&!m(e)?{error:`Manager IPC runtime file is stale for PID ${e}. Restart the desktop daemon and retry.`}:{url:typeof t.url=="string"?t.url:void 0,token:typeof t.token=="string"?t.token:void 0}}catch{return{}}}function l(n){const t=!process.env.SHENNIAN_MANAGER_IPC_URL||!process.env.SHENNIAN_MANAGER_IPC_TOKEN?p():{};t.error&&(console.error(s.red(`\u2717 ${t.error}`)),process.exit(1));const e=process.env.SHENNIAN_MANAGER_IPC_URL||t.url,o=process.env.SHENNIAN_MANAGER_IPC_TOKEN||t.token,i=n?.trim()||process.env.SHENNIAN_EXTERNAL_SESSION_ID||process.env.SHENNIAN_MANAGER_SESSION_ID;return(!e||!o||!i)&&(console.error(s.red("\u2717 This command must run inside a Shennian conversation with an external channel, or pass --session-id <id>.")),process.exit(1)),{url:e,token:o,sessionId:i}}function m(n){try{return process.kill(n,0),!0}catch{return!1}}async function r(n){const t=l(n.sessionId),e=n.replyTarget?.trim()||process.env.SHENNIAN_EXTERNAL_REPLY_TARGET||void 0,o=await fetch(`${t.url}/external/reply`,{method:"POST",headers:{authorization:`Bearer ${t.token}`,"content-type":"application/json","x-shennian-manager-session-id":t.sessionId},body:JSON.stringify({managerSessionId:t.sessionId,text:n.text,attachment:n.attachment,idempotencyKey:n.idempotencyKey,replyTarget:e})}),i=await o.json().catch(()=>({ok:!1,error:o.statusText}));if(!o.ok||!i.ok)throw new Error(i.error||`External send failed: ${o.status}`);console.log("ok")}function E(n){const t=n.command("external").description("External channel tools for this Shennian conversation");t.command("send").description("Send a message to the external channel bound to this conversation").requiredOption("--text <text>","Message text").option("--session-id <id>","Shennian conversation/session id; defaults to injected current-session env").option("--reply-target <id>","Daemon-generated reply target; defaults to SHENNIAN_EXTERNAL_REPLY_TARGET or latest external message").option("--idempotency-key <key>","Idempotency key").action(async e=>{await r({text:e.text,replyTarget:e.replyTarget,idempotencyKey:e.idempotencyKey,sessionId:e.sessionId})}),t.command("send-image").description("Send an image file to the external channel bound to this conversation").requiredOption("--path <path>","Image file path").option("--caption <text>","Optional text to send before the image").option("--session-id <id>","Shennian conversation/session id; defaults to injected current-session env").option("--reply-target <id>","Daemon-generated reply target; defaults to SHENNIAN_EXTERNAL_REPLY_TARGET or latest external message").option("--idempotency-key <key>","Idempotency key").action(async e=>{await r({text:e.caption,attachment:a(e.path,"image"),replyTarget:e.replyTarget,idempotencyKey:e.idempotencyKey,sessionId:e.sessionId})}),t.command("send-video").description("Send a video file to the external channel bound to this conversation").requiredOption("--path <path>","Video file path").option("--caption <text>","Optional text to send before the video").option("--session-id <id>","Shennian conversation/session id; defaults to injected current-session env").option("--reply-target <id>","Daemon-generated reply target; defaults to SHENNIAN_EXTERNAL_REPLY_TARGET or latest external message").option("--idempotency-key <key>","Idempotency key").action(async e=>{await r({text:e.caption,attachment:a(e.path,"video"),replyTarget:e.replyTarget,idempotencyKey:e.idempotencyKey,sessionId:e.sessionId})}),t.command("send-file").description("Send a file to the external channel bound to this conversation").requiredOption("--path <path>","File path").option("--caption <text>","Optional text to send before the file").option("--session-id <id>","Shennian conversation/session id; defaults to injected current-session env").option("--reply-target <id>","Daemon-generated reply target; defaults to SHENNIAN_EXTERNAL_REPLY_TARGET or latest external message").option("--idempotency-key <key>","Idempotency key").action(async e=>{await r({text:e.caption,attachment:a(e.path,"file"),replyTarget:e.replyTarget,idempotencyKey:e.idempotencyKey,sessionId:e.sessionId})})}export{E as registerExternalCommand};

package/dist/src/commands/manager.js

@@ -1,391 +1,2 @@
-// @arch docs/features/manager-agent.md
-// @test src/__tests__/manager-runtime.test.ts
-// @test src/__tests__/manager-command.test.ts
-import fs from 'node:fs';
-import chalk from 'chalk';
-import { readExternalAttachment } from './external-attachments.js';
-function requireManagerContext() {
-    const url = process.env.SHENNIAN_MANAGER_IPC_URL;
-    const token = process.env.SHENNIAN_MANAGER_IPC_TOKEN;
-    const managerSessionId = process.env.SHENNIAN_MANAGER_SESSION_ID;
-    if (!url || !token || !managerSessionId) {
-        console.error(chalk.red('✗ This command must run inside a Shennian Manager Agent session.'));
-        process.exit(1);
-    }
-    return { url, token, managerSessionId };
-}
-async function ipc(path, body) {
-    const ctx = requireManagerContext();
-    const response = await fetch(`${ctx.url}${path}`, {
-        method: 'POST',
-        headers: {
-            authorization: `Bearer ${ctx.token}`,
-            'content-type': 'application/json',
-            'x-shennian-manager-session-id': ctx.managerSessionId,
-        },
-        body: JSON.stringify({ ...body, managerSessionId: ctx.managerSessionId }),
-    });
-    const data = await response.json().catch(() => ({ ok: false, error: response.statusText }));
-    if (!response.ok || !data.ok) {
-        throw new Error(data.error || `Manager IPC failed: ${response.status}`);
-    }
-    return data;
-}
-function printJson(data) {
-    console.log(JSON.stringify(data, null, 2));
-}
-function readMessage(opts) {
-    if (opts.messageFile)
-        return fs.readFileSync(opts.messageFile, 'utf-8');
-    return opts.message ?? '';
-}
-function collect(value, previous = []) {
-    previous.push(value);
-    return previous;
-}
-function parseBool(value) {
-    if (value === undefined)
-        return undefined;
-    return value === 'true';
-}
-function parseNumber(value) {
-    const number = Number(value);
-    return Number.isFinite(number) ? number : undefined;
-}
-function printWeChatRpaStatus(channel) {
-    if (!channel) {
-        console.log('not configured');
-        return;
-    }
-    const groups = Array.isArray(channel.wechatRpaGroups)
-        ? channel.wechatRpaGroups
-            .map((group) => typeof group === 'object' && group ? String(group.name || '').trim() : '')
-            .filter(Boolean)
-            .join(', ')
-        : '';
-    const fields = [
-        `enabled=${Boolean(channel.enabled)}`,
-        `connected=${Boolean(channel.tokenConfigured ?? channel.enabled)}`,
-        channel.wechatRpaSource ? `source=${String(channel.wechatRpaSource)}` : '',
-        groups ? `groups=${groups}` : 'groups=',
-        channel.pollIntervalMs ? `poll=${String(channel.pollIntervalMs)}ms` : '',
-        channel.wechatRpaRuntimeState ? `state=${String(channel.wechatRpaRuntimeState)}` : '',
-        Number.isFinite(channel.wechatRpaPendingReplyCount) ? `pendingReplies=${String(channel.wechatRpaPendingReplyCount)}` : '',
-        channel.wechatRpaLastRunAt ? `lastRun=${String(channel.wechatRpaLastRunAt)}` : '',
-        channel.wechatRpaLastMessageAt ? `lastMessage=${String(channel.wechatRpaLastMessageAt)}` : '',
-        channel.wechatRpaLastInterruptedAt ? `lastInterrupted=${String(channel.wechatRpaLastInterruptedAt)}` : '',
-        channel.wechatRpaLastError ? `lastError=${String(channel.wechatRpaLastError)}` : 'lastError=none',
-    ].filter(Boolean);
-    console.log(fields.join('\n'));
-}
-export function registerManagerCommand(program) {
-    const manager = program.command('manager').description('Manager Agent local tools');
-    const sessions = manager.command('sessions').description('Manage same-project worker sessions');
-    sessions
-        .command('list')
-        .description('List same-project sessions visible to this Manager')
-        .option('--json', 'Print JSON')
-        .action(async (opts) => {
-        const result = await ipc('/sessions/list', {});
-        if (opts.json)
-            printJson(result);
-        else {
-            const sessions = result.sessions ?? [];
-            for (const session of sessions) {
-                console.log(`${session.sessionId}\t${session.agentType}\t${session.role ?? ''}\t${session.status}\t${session.title ?? session.summary ?? ''}`);
-            }
-        }
-    });
-    sessions
-        .command('start')
-        .description('Start a worker session in the same project')
-        .requiredOption('--agent <agent>', 'Worker agent type, e.g. codex, claude, gemini, cursor, opencode, pi, or custom:<name>')
-        .requiredOption('--workdir <path>', 'Worker workdir; must match Manager workdir')
-        .option('--model <model>', 'Worker model id')
-        .option('--message <text>', 'Worker prompt')
-        .option('--message-file <path>', 'Read worker prompt from file')
-        .option('--json', 'Print JSON')
-        .action(async (opts) => {
-        const result = await ipc('/sessions/start', {
-            agentType: opts.agent,
-            workDir: opts.workdir,
-            modelId: opts.model,
-            message: readMessage(opts),
-        });
-        if (opts.json)
-            printJson(result);
-        else
-            console.log(result.session?.sessionId ?? 'ok');
-    });
-    sessions
-        .command('send')
-        .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),
-            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');
-    });
-    const stopWorker = async (opts) => {
-        await ipc('/sessions/stop', { sessionId: opts.sessionId });
-        console.log('ok');
-    };
-    sessions
-        .command('stop')
-        .aliases(['terminate', 'kill'])
-        .description('Stop or terminate a running managed worker')
-        .requiredOption('--session-id <id>', 'Worker session id')
-        .action(stopWorker);
-    sessions
-        .command('read')
-        .description('Read a managed worker transcript')
-        .requiredOption('--session-id <id>', 'Worker session id')
-        .option('--limit <n>', 'Message limit', '200')
-        .option('--json', 'Print JSON')
-        .action(async (opts) => {
-        const result = await ipc('/sessions/read', { sessionId: opts.sessionId, limit: Number(opts.limit) });
-        if (opts.json)
-            printJson(result);
-        else
-            printJson(result.messages ?? []);
-    });
-    manager
-        .command('memory')
-        .description('Manager project memory helpers')
-        .command('path')
-        .description('Print project memory directory path')
-        .action(async () => {
-        const result = await ipc('/memory/path', {});
-        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('--reply-target <id>', 'Daemon-generated reply target; omitted means latest external message for this Manager')
-        .option('--idempotency-key <key>', 'Idempotency key')
-        .action(sendExternal);
-    external
-        .command('send-image')
-        .description('Send an image file to the Manager-bound external channel')
-        .requiredOption('--path <path>', 'Image file path')
-        .option('--caption <text>', 'Optional text to send before the image')
-        .option('--reply-target <id>', 'Daemon-generated reply target; omitted means latest external message for this Manager')
-        .option('--idempotency-key <key>', 'Idempotency key')
-        .action(async (opts) => {
-        await sendExternal({
-            text: opts.caption,
-            attachment: readExternalAttachment(opts.path, 'image'),
-            replyTarget: opts.replyTarget,
-            idempotencyKey: opts.idempotencyKey,
-        });
-    });
-    external
-        .command('send-video')
-        .description('Send a video file to the Manager-bound external channel')
-        .requiredOption('--path <path>', 'Video file path')
-        .option('--caption <text>', 'Optional text to send before the video')
-        .option('--reply-target <id>', 'Daemon-generated reply target; omitted means latest external message for this Manager')
-        .option('--idempotency-key <key>', 'Idempotency key')
-        .action(async (opts) => {
-        await sendExternal({
-            text: opts.caption,
-            attachment: readExternalAttachment(opts.path, 'video'),
-            replyTarget: opts.replyTarget,
-            idempotencyKey: opts.idempotencyKey,
-        });
-    });
-    external
-        .command('send-file')
-        .description('Send a file to the Manager-bound external channel')
-        .requiredOption('--path <path>', 'File path')
-        .option('--caption <text>', 'Optional text to send before the file')
-        .option('--reply-target <id>', 'Daemon-generated reply target; omitted means latest external message for this Manager')
-        .option('--idempotency-key <key>', 'Idempotency key')
-        .action(async (opts) => {
-        await sendExternal({
-            text: opts.caption,
-            attachment: readExternalAttachment(opts.path, 'file'),
-            replyTarget: opts.replyTarget,
-            idempotencyKey: opts.idempotencyKey,
-        });
-    });
-    external
-        .command('reply')
-        .description('Send an explicit reply to an external channel')
-        .option('--reply-target <id>', 'Daemon-generated reply target; omitted means latest external message for this Manager')
-        .option('--channel-id <id>', 'Channel id')
-        .option('--conversation-id <id>', 'Conversation id')
-        .requiredOption('--text <text>', 'Reply text')
-        .option('--idempotency-key <key>', 'Idempotency key')
-        .action(sendExternal);
-    const channel = manager.command('channel').description('Manager external channel config');
-    channel
-        .command('get')
-        .description('Get bound external channel config')
-        .option('--json', 'Print JSON')
-        .action(async (opts) => {
-        const result = await ipc('/channel/get', {});
-        if (opts.json)
-            printJson(result);
-        else
-            printJson(result.channel ?? null);
-    });
-    channel
-        .command('upsert')
-        .description('Create or update an external channel binding')
-        .option('--id <id>', 'Channel id')
-        .option('--name <name>', 'Channel display name')
-        .requiredOption('--enabled <true|false>', 'Whether the channel should be enabled')
-        .option('--ws-url <url>', 'External websocket URL')
-        .option('--token <token>', 'Bearer token')
-        .option('--can-reply <true|false>', 'Whether reply should be allowed')
-        .option('--json', 'Print JSON')
-        .action(async (opts) => {
-        const result = await ipc('/channel/upsert', {
-            id: opts.id,
-            name: opts.name,
-            enabled: opts.enabled === 'true',
-            wsUrl: opts.wsUrl,
-            token: opts.token,
-            canReply: opts.canReply === undefined ? undefined : opts.canReply === 'true',
-        });
-        if (opts.json)
-            printJson(result);
-        else
-            printJson(result.channel ?? null);
-    });
-    const wechatRpa = manager.command('wechat-rpa').description('Local WeChat RPA channel config');
-    wechatRpa
-        .command('get')
-        .description('Get local WeChat RPA channel config')
-        .option('--json', 'Print JSON')
-        .action(async (opts) => {
-        const result = await ipc('/wechat-rpa/channel/get', {});
-        if (opts.json)
-            printJson(result);
-        else
-            printJson(result.channel ?? null);
-    });
-    wechatRpa
-        .command('status')
-        .description('Print local WeChat RPA channel runtime status')
-        .option('--json', 'Print JSON')
-        .action(async (opts) => {
-        const result = await ipc('/wechat-rpa/channel/get', {});
-        if (opts.json)
-            printJson(result);
-        else
-            printWeChatRpaStatus((result.channel ?? null));
-    });
-    wechatRpa
-        .command('sync')
-        .description('Run one immediate WeChat RPA sync and print the updated runtime status')
-        .option('--json', 'Print JSON')
-        .action(async (opts) => {
-        const result = await ipc('/wechat-rpa/channel/sync', {});
-        if (opts.json)
-            printJson(result);
-        else
-            printWeChatRpaStatus((result.channel ?? null));
-    });
-    wechatRpa
-        .command('upsert')
-        .description('Create or update a local WeChat RPA channel binding')
-        .option('--id <id>', 'Channel id')
-        .option('--name <name>', 'Channel display name')
-        .requiredOption('--enabled <true|false>', 'Whether the channel should be enabled')
-        .option('--group <name>', 'Bound WeChat conversation name; pass once per Shennian conversation', collect, [])
-        .option('--can-reply <true|false>', 'Whether reply should be allowed')
-        .option('--source <macos-flow|wechat-rpa-lab|macos-probe|fixture-jsonl>', 'WeChat RPA implementation source')
-        .option('--poll-interval-ms <n>', 'Polling interval in milliseconds')
-        .option('--recent-limit <n>', 'Recent message limit')
-        .option('--idle-seconds <n>', 'Minimum user idle seconds before foreground automation')
-        .option('--force-foreground <true|false>', 'Force WeChat foreground while syncing')
-        .option('--restore-previous <true|false>', 'Restore previous foreground app after syncing')
-        .option('--download-attachments <true|false>', 'Click and localize inbound attachment candidates')
-        .option('--download-attachments-dir <path>', 'Directory for localized inbound WeChat attachments')
-        .option('--privacy-consent <true|false>', 'Confirm WeChat channel data and privacy consent')
-        .option('--flow-script-path <path>', 'Override macOS flow script path')
-        .option('--json', 'Print JSON')
-        .action(async (opts) => {
-        if (opts.enabled === 'true' && opts.group.length > 1) {
-            throw new Error('WeChat RPA 每个对话只能绑定一个群');
-        }
-        const result = await ipc('/wechat-rpa/channel/upsert', {
-            id: opts.id,
-            name: opts.name,
-            enabled: opts.enabled === 'true',
-            groups: opts.group.map((name) => ({ name })),
-            canReply: parseBool(opts.canReply),
-            source: opts.source,
-            pollIntervalMs: parseNumber(opts.pollIntervalMs),
-            recentLimit: parseNumber(opts.recentLimit),
-            idleSeconds: parseNumber(opts.idleSeconds),
-            forceForeground: parseBool(opts.forceForeground),
-            noRestore: opts.restorePrevious === undefined ? undefined : opts.restorePrevious !== 'true',
-            downloadAttachments: parseBool(opts.downloadAttachments),
-            downloadAttachmentsDir: opts.downloadAttachmentsDir,
-            privacyConsentAccepted: parseBool(opts.privacyConsent),
-            flowScriptPath: opts.flowScriptPath,
-        });
-        if (opts.json)
-            printJson(result);
-        else
-            printJson(result.channel ?? null);
-    });
-}
+import R from"node:fs";import S from"chalk";import{readExternalAttachment as h}from"./external-attachments.js";function x(){const n=process.env.SHENNIAN_MANAGER_IPC_URL,o=process.env.SHENNIAN_MANAGER_IPC_TOKEN,a=process.env.SHENNIAN_MANAGER_SESSION_ID;return(!n||!o||!a)&&(console.error(S.red("\u2717 This command must run inside a Shennian Manager Agent session.")),process.exit(1)),{url:n,token:o,managerSessionId:a}}async function i(n,o){const a=x(),r=await fetch(`${a.url}${n}`,{method:"POST",headers:{authorization:`Bearer ${a.token}`,"content-type":"application/json","x-shennian-manager-session-id":a.managerSessionId},body:JSON.stringify({...o,managerSessionId:a.managerSessionId})}),c=await r.json().catch(()=>({ok:!1,error:r.statusText}));if(!r.ok||!c.ok)throw new Error(c.error||`Manager IPC failed: ${r.status}`);return c}function s(n){console.log(JSON.stringify(n,null,2))}function y(n){return n.messageFile?R.readFileSync(n.messageFile,"utf-8"):n.message??""}function I(n,o=[]){return o.push(n),o}function g(n){if(n!==void 0)return n==="true"}function f(n){const o=Number(n);return Number.isFinite(o)?o:void 0}function k(n){if(!n){console.log("not configured");return}const o=Array.isArray(n.wechatRpaGroups)?n.wechatRpaGroups.map(r=>typeof r=="object"&&r?String(r.name||"").trim():"").filter(Boolean).join(", "):"",a=[`enabled=${!!n.enabled}`,`connected=${!!(n.tokenConfigured??n.enabled)}`,n.wechatRpaSource?`source=${String(n.wechatRpaSource)}`:"",o?`groups=${o}`:"groups=",n.pollIntervalMs?`poll=${String(n.pollIntervalMs)}ms`:"",n.wechatRpaRuntimeState?`state=${String(n.wechatRpaRuntimeState)}`:"",Number.isFinite(n.wechatRpaPendingReplyCount)?`pendingReplies=${String(n.wechatRpaPendingReplyCount)}`:"",n.wechatRpaLastRunAt?`lastRun=${String(n.wechatRpaLastRunAt)}`:"",n.wechatRpaLastMessageAt?`lastMessage=${String(n.wechatRpaLastMessageAt)}`:"",n.wechatRpaLastInterruptedAt?`lastInterrupted=${String(n.wechatRpaLastInterruptedAt)}`:"",n.wechatRpaLastError?`lastError=${String(n.wechatRpaLastError)}`:"lastError=none"].filter(Boolean);console.log(a.join(`
+`))}function A(n){const o=n.command("manager").description("Manager Agent local tools"),a=o.command("sessions").description("Manage same-project worker sessions");a.command("list").description("List same-project sessions visible to this Manager").option("--json","Print JSON").action(async e=>{const t=await i("/sessions/list",{});if(e.json)s(t);else{const m=t.sessions??[];for(const d of m)console.log(`${d.sessionId}	${d.agentType}	${d.role??""}	${d.status}	${d.title??d.summary??""}`)}}),a.command("start").description("Start a worker session in the same project").requiredOption("--agent <agent>","Worker agent type, e.g. codex, claude, gemini, cursor, opencode, pi, or custom:<name>").requiredOption("--workdir <path>","Worker workdir; must match Manager workdir").option("--model <model>","Worker model id").option("--message <text>","Worker prompt").option("--message-file <path>","Read worker prompt from file").option("--json","Print JSON").action(async e=>{const t=await i("/sessions/start",{agentType:e.agent,workDir:e.workdir,modelId:e.model,message:y(e)});e.json?s(t):console.log(t.session?.sessionId??"ok")}),a.command("send").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 e=>{await i("/sessions/send",{sessionId:e.sessionId,message:y(e),enqueue:!e.direct}),console.log("ok")});const r=a.command("queue").description("Inspect and edit pending worker messages");r.command("list").description("List pending messages for a managed worker").requiredOption("--session-id <id>","Worker session id").option("--json","Print JSON").action(async e=>{const t=await i("/sessions/queue",{sessionId:e.sessionId});if(e.json)s(t);else{const m=t.queue?.pending??[];for(const d of m)console.log(`${d.id}	${d.text.replace(/\s+/g," ").slice(0,120)}`)}}),r.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 e=>{await i("/sessions/queue/edit",{sessionId:e.sessionId,queueMessageId:e.messageId,message:y(e)}),console.log("ok")}),r.command("delete").description("Delete a pending worker message").requiredOption("--session-id <id>","Worker session id").requiredOption("--message-id <id>","Queued message id").action(async e=>{await i("/sessions/queue/delete",{sessionId:e.sessionId,queueMessageId:e.messageId}),console.log("ok")});const c=async e=>{await i("/sessions/stop",{sessionId:e.sessionId}),console.log("ok")};a.command("stop").aliases(["terminate","kill"]).description("Stop or terminate a running managed worker").requiredOption("--session-id <id>","Worker session id").action(c),a.command("read").description("Read a managed worker transcript").requiredOption("--session-id <id>","Worker session id").option("--limit <n>","Message limit","200").option("--json","Print JSON").action(async e=>{const t=await i("/sessions/read",{sessionId:e.sessionId,limit:Number(e.limit)});e.json?s(t):s(t.messages??[])}),o.command("memory").description("Manager project memory helpers").command("path").description("Print project memory directory path").action(async()=>{const e=await i("/memory/path",{});console.log(e.path)});const l=o.command("external").description("External channel tools"),p=async e=>{await i("/external/reply",e),console.log("ok")};l.command("send").description("Send a message to the Manager-bound external channel").requiredOption("--text <text>","Message text").option("--reply-target <id>","Daemon-generated reply target; omitted means latest external message for this Manager").option("--idempotency-key <key>","Idempotency key").action(p),l.command("send-image").description("Send an image file to the Manager-bound external channel").requiredOption("--path <path>","Image file path").option("--caption <text>","Optional text to send before the image").option("--reply-target <id>","Daemon-generated reply target; omitted means latest external message for this Manager").option("--idempotency-key <key>","Idempotency key").action(async e=>{await p({text:e.caption,attachment:h(e.path,"image"),replyTarget:e.replyTarget,idempotencyKey:e.idempotencyKey})}),l.command("send-video").description("Send a video file to the Manager-bound external channel").requiredOption("--path <path>","Video file path").option("--caption <text>","Optional text to send before the video").option("--reply-target <id>","Daemon-generated reply target; omitted means latest external message for this Manager").option("--idempotency-key <key>","Idempotency key").action(async e=>{await p({text:e.caption,attachment:h(e.path,"video"),replyTarget:e.replyTarget,idempotencyKey:e.idempotencyKey})}),l.command("send-file").description("Send a file to the Manager-bound external channel").requiredOption("--path <path>","File path").option("--caption <text>","Optional text to send before the file").option("--reply-target <id>","Daemon-generated reply target; omitted means latest external message for this Manager").option("--idempotency-key <key>","Idempotency key").action(async e=>{await p({text:e.caption,attachment:h(e.path,"file"),replyTarget:e.replyTarget,idempotencyKey:e.idempotencyKey})}),l.command("reply").description("Send an explicit reply to an external channel").option("--reply-target <id>","Daemon-generated reply target; omitted means latest external message for this Manager").option("--channel-id <id>","Channel id").option("--conversation-id <id>","Conversation id").requiredOption("--text <text>","Reply text").option("--idempotency-key <key>","Idempotency key").action(p);const w=o.command("channel").description("Manager external channel config");w.command("get").description("Get bound external channel config").option("--json","Print JSON").action(async e=>{const t=await i("/channel/get",{});e.json?s(t):s(t.channel??null)}),w.command("upsert").description("Create or update an external channel binding").option("--id <id>","Channel id").option("--name <name>","Channel display name").requiredOption("--enabled <true|false>","Whether the channel should be enabled").option("--ws-url <url>","External websocket URL").option("--token <token>","Bearer token").option("--can-reply <true|false>","Whether reply should be allowed").option("--json","Print JSON").action(async e=>{const t=await i("/channel/upsert",{id:e.id,name:e.name,enabled:e.enabled==="true",wsUrl:e.wsUrl,token:e.token,canReply:e.canReply===void 0?void 0:e.canReply==="true"});e.json?s(t):s(t.channel??null)});const u=o.command("wechat-rpa").description("Local WeChat RPA channel config");u.command("get").description("Get local WeChat RPA channel config").option("--json","Print JSON").action(async e=>{const t=await i("/wechat-rpa/channel/get",{});e.json?s(t):s(t.channel??null)}),u.command("status").description("Print local WeChat RPA channel runtime status").option("--json","Print JSON").action(async e=>{const t=await i("/wechat-rpa/channel/get",{});e.json?s(t):k(t.channel??null)}),u.command("sync").description("Run one immediate WeChat RPA sync and print the updated runtime status").option("--json","Print JSON").action(async e=>{const t=await i("/wechat-rpa/channel/sync",{});e.json?s(t):k(t.channel??null)}),u.command("upsert").description("Create or update a local WeChat RPA channel binding").option("--id <id>","Channel id").option("--name <name>","Channel display name").requiredOption("--enabled <true|false>","Whether the channel should be enabled").option("--group <name>","Bound WeChat conversation name; pass once per Shennian conversation",I,[]).option("--can-reply <true|false>","Whether reply should be allowed").option("--source <macos-flow|wechat-rpa-lab|macos-probe|fixture-jsonl>","WeChat RPA implementation source").option("--poll-interval-ms <n>","Polling interval in milliseconds").option("--recent-limit <n>","Recent message limit").option("--idle-seconds <n>","Minimum user idle seconds before foreground automation").option("--force-foreground <true|false>","Force WeChat foreground while syncing").option("--restore-previous <true|false>","Restore previous foreground app after syncing").option("--download-attachments <true|false>","Click and localize inbound attachment candidates").option("--download-attachments-dir <path>","Directory for localized inbound WeChat attachments").option("--privacy-consent <true|false>","Confirm WeChat channel data and privacy consent").option("--flow-script-path <path>","Override macOS flow script path").option("--json","Print JSON").action(async e=>{if(e.enabled==="true"&&e.group.length>1)throw new Error("WeChat RPA \u6BCF\u4E2A\u5BF9\u8BDD\u53EA\u80FD\u7ED1\u5B9A\u4E00\u4E2A\u7FA4");const t=await i("/wechat-rpa/channel/upsert",{id:e.id,name:e.name,enabled:e.enabled==="true",groups:e.group.map(m=>({name:m})),canReply:g(e.canReply),source:e.source,pollIntervalMs:f(e.pollIntervalMs),recentLimit:f(e.recentLimit),idleSeconds:f(e.idleSeconds),forceForeground:g(e.forceForeground),noRestore:e.restorePrevious===void 0?void 0:e.restorePrevious!=="true",downloadAttachments:g(e.downloadAttachments),downloadAttachmentsDir:e.downloadAttachmentsDir,privacyConsentAccepted:g(e.privacyConsent),flowScriptPath:e.flowScriptPath});e.json?s(t):s(t.channel??null)})}export{A as registerManagerCommand};

package/dist/src/commands/pair-qr.js

@@ -1,6 +1 @@
-// @arch docs/product/PRD.md#手机扫码配对
-// @test src/__tests__/pair-qr.test.ts
-export const PAIR_QR_RENDER_OPTIONS = { small: false };
-export function buildPairQrPayload(pairToken) {
-    return `pair:${pairToken}`;
-}
+const a={small:!1};function l(r){return`pair:${r}`}export{a as PAIR_QR_RENDER_OPTIONS,l as buildPairQrPayload};