@hunterzhu/pulse-cli 0.1.3 → 0.1.5

package/dist/bin.d.ts

@@ -1,2 +1,11 @@
 #!/usr/bin/env node
-export {};
+import type { LocalHostOptions } from '@hunterzhu/pulse-server';
+export declare const version: string;
+export interface Parsed {
+    command: string;
+    positionals: string[];
+    options: Record<string, string | boolean>;
+}
+export declare function parse(argv: string[]): Parsed;
+export declare function option(options: Parsed['options'], key: string): string | undefined;
+export declare function hostOptions(parsed: Parsed): Promise<LocalHostOptions>;

package/dist/bin.js

@@ -1,12 +1,18 @@
 #!/usr/bin/env node
-import { createInterface } from 'node:readline';
-import { access, chmod, mkdir, writeFile } from 'node:fs/promises';
 import { createRequire } from 'node:module';
-import { dirname } from 'node:path';
-import { createLocalHost } from '@hunterzhu/pulse-server';
-import { defaultPulseConfig, defaultPulseConfigPath, ensurePulseUserConfig, expandHome, loadPulseConfig } from './config.js';
+import { ensurePulseUserConfig, expandHome, loadPulseConfig } from './config.js';
+import { runInteractive } from './commands/interactive.js';
+import { runOneShot } from './commands/run.js';
+import { runDoctor } from './commands/doctor.js';
+import { runSessions } from './commands/sessions.js';
+import { runResume } from './commands/resume.js';
+import { runSetup } from './commands/setup.js';
 const packageManifest = createRequire(import.meta.url)('../package.json');
-const version = packageManifest.version;
+export const version = packageManifest.version;
+process.stdout.on('error', (error) => {
+    if (error.code !== 'EPIPE')
+        process.exitCode = 1;
+});
 const help = `Pulse ${version}
 
 Usage:
@@ -35,7 +41,7 @@ Options:
   --version, -v             show the version
   setup --force              write a user config template (also created on first run)
 `;
-function parse(argv) {
+export function parse(argv) {
     const options = {};
     const positionals = [];
     let command = '';
@@ -63,8 +69,9 @@ function parse(argv) {
                 options[key] = next;
                 index++;
             }
-            else
+            else {
                 options[key] = true;
+            }
             continue;
         }
         if (arg.startsWith('-') && arg.length === 2) {
@@ -72,134 +79,56 @@ function parse(argv) {
             options[key] = true;
             continue;
         }
-        if (!command && ['run', 'sessions', 'resume', 'doctor', 'setup'].includes(arg))
+        if (!command && ['run', 'sessions', 'resume', 'doctor', 'setup'].includes(arg)) {
             command = arg;
-        else
+        }
+        else {
             positionals.push(arg);
+        }
     }
     return { command, positionals, options };
 }
-function option(options, key) { const value = options[key]; return typeof value === 'string' ? value : undefined; }
-async function hostOptions(parsed) { const requestedCwd = expandHome(option(parsed.options, 'cwd')); const explicitConfig = expandHome(option(parsed.options, 'config')); if (explicitConfig === undefined && process.env.PULSE_CONFIG === undefined)
-    await ensurePulseUserConfig(); const config = (await loadPulseConfig(requestedCwd ?? process.cwd(), explicitConfig, parsed.options['trust-workspace'] === true)).value; const providerName = option(parsed.options, 'provider') ?? process.env.PULSE_PROVIDER ?? config.provider?.provider; const model = option(parsed.options, 'model') ?? process.env.PULSE_MODEL ?? config.provider?.model; const baseURL = option(parsed.options, 'base-url') ?? process.env.PULSE_BASE_URL ?? config.provider?.baseURL; const apiKeyEnv = config.provider?.apiKeyEnv ?? (providerName === 'anthropic' ? 'ANTHROPIC_API_KEY' : 'OPENAI_API_KEY'); const apiKey = process.env[apiKeyEnv]; const provider = providerName ? { provider: providerName, ...(model === undefined ? {} : { defaultModel: model }), ...(baseURL === undefined ? {} : { baseURL }), ...(apiKey === undefined ? {} : { apiKey }) } : undefined; const cwd = requestedCwd ?? expandHome(config.cwd); const dataDir = expandHome(option(parsed.options, 'data-dir') ?? process.env.PULSE_DATA_DIR ?? config.dataDir); const mockResponse = option(parsed.options, 'mock-response'); const approvalMode = parsed.options['read-only'] === true ? 'read-only' : parsed.options['auto-approve'] === true || process.env.PULSE_AUTO_APPROVE === '1' ? 'auto' : config.approvalMode; const allowNetwork = parsed.options['allow-network'] === true || process.env.PULSE_ALLOW_NETWORK === '1' ? true : config.allowNetwork; return { ...(cwd === undefined ? {} : { cwd }), ...(dataDir === undefined ? {} : { dataDir }), ...(provider === undefined ? {} : { provider }), ...(mockResponse === undefined ? {} : { mockResponse }), ...(approvalMode === undefined ? {} : { approvalMode }), ...(allowNetwork === undefined ? {} : { allowNetwork }) }; }
-async function setupConfig(force, explicitPath) { const path = explicitPath ?? process.env.PULSE_CONFIG ?? defaultPulseConfigPath(); try {
-    await access(path);
-    if (!force)
-        throw new Error(`CONFIG_EXISTS:${path}`);
+export function option(options, key) {
+    const value = options[key];
+    return typeof value === 'string' ? value : undefined;
 }
-catch (error) {
-    if (error.code !== 'ENOENT' && error instanceof Error && error.message.startsWith('CONFIG_EXISTS:'))
-        throw error;
-} await mkdir(dirname(path), { recursive: true }); await writeFile(path, `${JSON.stringify(defaultPulseConfig, null, 2)}\n`, { mode: 0o600 }); await chmod(path, 0o600); process.stdout.write(`Wrote ${path}\n`); }
-function writeEvent(event, format) { if (format === 'jsonl') {
-    process.stdout.write(`${JSON.stringify(event)}\n`);
-    return;
-} if (event.type === 'text')
-    process.stdout.write(String(event.data ?? ''));
-else if (event.type === 'waiting')
-    process.stdout.write(`\n[需要输入] ${JSON.stringify(event.data ?? '')}\n`);
-else if (event.type === 'error')
-    process.stderr.write(`\n[错误] ${String(event.data ?? '')}\n`); }
-async function consume(run, format, approvalInput) { let streamedText = false; let ownedApprovalInput = false; let input = approvalInput; try {
-    for await (const event of run.events) {
-        if (event.type === 'text')
-            streamedText = true;
-        writeEvent(event, format);
-        if (event.type === 'waiting') {
-            const payload = event.data && typeof event.data === 'object' && !Array.isArray(event.data) ? event.data : {};
-            const effectId = typeof payload.effectId === 'string' ? payload.effectId : undefined;
-            const request = payload.input && typeof payload.input === 'object' && !Array.isArray(payload.input) ? payload.input : {};
-            if (!effectId) {
-                await run.cancel('INVALID_APPROVAL_REQUEST');
-                continue;
-            }
-            if (!process.stdin.isTTY) {
-                await run.cancel('INTERACTION_REQUIRED');
-                continue;
-            }
-            if (!input) {
-                input = createInterface({ input: process.stdin, output: process.stderr, terminal: true });
-                ownedApprovalInput = true;
-            }
-            const prompt = typeof request.prompt === 'string' ? request.prompt : 'Approve this operation?';
-            const answer = await new Promise((resolve) => input.question(`${prompt}\nApprove? [y/N] `, resolve));
-            const approved = ['y', 'yes', '是', '确认'].includes(answer.trim().toLocaleLowerCase());
-            await run.reply(effectId, { approved, ...(approved ? {} : { reason: answer.trim() || 'User denied the operation.' }) });
-        }
+export async function hostOptions(parsed) {
+    const requestedCwd = expandHome(option(parsed.options, 'cwd'));
+    const explicitConfig = expandHome(option(parsed.options, 'config'));
+    if (explicitConfig === undefined && process.env.PULSE_CONFIG === undefined) {
+        await ensurePulseUserConfig();
     }
-    const outcome = await run.outcome();
-    if (format === 'jsonl') {
-        process.stdout.write(`${JSON.stringify({ schemaVersion: 1, type: 'result', runId: run.id, status: outcome.status, text: outcome.text ?? null, error: outcome.error ?? null })}\n`);
-    }
-    else if (outcome.status === 'failed' && outcome.error)
-        process.stderr.write(`\n[错误] ${outcome.error.code}: ${outcome.error.message}\n`);
-    else if (!streamedText && outcome.text)
-        process.stdout.write(`${outcome.text}\n`);
-    else
-        process.stdout.write(`\n[${outcome.status}]\n`);
-    return outcome;
-}
-finally {
-    if (ownedApprovalInput)
-        input?.close();
-} }
-async function consumeManaged(run, format, approvalInput, setActive) { setActive(run); try {
-    return await consume(run, format, approvalInput);
-}
-finally {
-    setActive(undefined);
-} }
-async function interactive(host, conversationId, setActive) {
-    const conversation = conversationId ? await host.getConversation(conversationId) : await host.createConversation();
-    process.stderr.write(`Pulse · ${conversation.summary.cwd}\nType /help for commands.\n`);
-    const input = createInterface({ input: process.stdin, output: process.stderr, terminal: process.stdin.isTTY });
-    input.setPrompt('› ');
-    const prompt = () => { if (input.terminal)
-        input.prompt(); };
-    prompt();
-    for await (const line of input) {
-        const text = line.trim();
-        if (!text) {
-            prompt();
-            continue;
-        }
-        if (text === '/exit' || text === '/quit')
-            break;
-        if (text === '/help') {
-            process.stderr.write('Commands: /help /status /tools /artifacts /exit\n');
-            prompt();
-            continue;
-        }
-        if (text === '/status') {
-            process.stderr.write(`${JSON.stringify(conversation.summary)}\n`);
-            prompt();
-            continue;
-        }
-        if (text === '/tools') {
-            process.stderr.write(`${(await host.doctor()).tools.join(', ')}\n`);
-            prompt();
-            continue;
-        }
-        if (text === '/artifacts') {
-            process.stderr.write(`${JSON.stringify(await host.listArtifacts(conversation.id), null, 2)}\n`);
-            prompt();
-            continue;
-        }
-        if (text === '/new') {
-            process.stderr.write('Start another `npx @hunterzhu/pulse-cli` process for a new conversation.\n');
-            prompt();
-            continue;
-        }
-        try {
-            const run = await host.sendMessage(conversation.id, { text });
-            await consumeManaged(run, 'text', input, setActive);
-        }
-        catch (error) {
-            process.stderr.write(`[错误] ${error instanceof Error ? error.message : String(error)}\n`);
-        }
-        prompt();
-    }
-    input.close();
+    const config = (await loadPulseConfig(requestedCwd ?? process.cwd(), explicitConfig, parsed.options['trust-workspace'] === true)).value;
+    const providerName = option(parsed.options, 'provider') ?? process.env.PULSE_PROVIDER ?? config.provider?.provider;
+    const model = option(parsed.options, 'model') ?? process.env.PULSE_MODEL ?? config.provider?.model;
+    const baseURL = option(parsed.options, 'base-url') ?? process.env.PULSE_BASE_URL ?? config.provider?.baseURL;
+    const apiKeyEnv = config.provider?.apiKeyEnv ?? (providerName === 'anthropic' ? 'ANTHROPIC_API_KEY' : 'OPENAI_API_KEY');
+    const apiKey = process.env[apiKeyEnv];
+    const provider = providerName
+        ? {
+            provider: providerName,
+            ...(model === undefined ? {} : { defaultModel: model }),
+            ...(baseURL === undefined ? {} : { baseURL }),
+            ...(apiKey === undefined ? {} : { apiKey }),
+        }
+        : undefined;
+    const cwd = requestedCwd ?? expandHome(config.cwd);
+    const dataDir = expandHome(option(parsed.options, 'data-dir') ?? process.env.PULSE_DATA_DIR ?? config.dataDir);
+    const mockResponse = option(parsed.options, 'mock-response');
+    const approvalMode = parsed.options['read-only'] === true
+        ? 'read-only'
+        : parsed.options['auto-approve'] === true || process.env.PULSE_AUTO_APPROVE === '1'
+            ? 'auto'
+            : config.approvalMode;
+    const allowNetwork = parsed.options['allow-network'] === true || process.env.PULSE_ALLOW_NETWORK === '1' ? true : config.allowNetwork;
+    return {
+        ...(cwd === undefined ? {} : { cwd }),
+        ...(dataDir === undefined ? {} : { dataDir }),
+        ...(provider === undefined ? {} : { provider }),
+        ...(mockResponse === undefined ? {} : { mockResponse }),
+        ...(approvalMode === undefined ? {} : { approvalMode }),
+        ...(allowNetwork === undefined ? {} : { allowNetwork }),
+    };
 }
 async function main() {
     const parsed = parse(process.argv.slice(2));
@@ -212,56 +141,36 @@ async function main() {
         return 0;
     }
     if (parsed.command === 'setup') {
-        await setupConfig(parsed.options.force === true, expandHome(option(parsed.options, 'config')));
-        process.stdout.write('Configure the provider in that file, then run `pulse doctor`.\n');
-        return 0;
+        return runSetup(parsed.options.force === true, expandHome(option(parsed.options, 'config')));
     }
-    const host = createLocalHost(await hostOptions(parsed));
-    await host.init();
-    let activeRun;
-    const onInterrupt = () => { if (activeRun) {
-        void activeRun.cancel('USER_INTERRUPT');
+    const options = await hostOptions(parsed);
+    if (parsed.command === 'doctor') {
+        return runDoctor(options, parsed.options.live === true, option(parsed.options, 'format') ?? 'text');
     }
-    else
-        process.exitCode = 130; };
-    process.once('SIGINT', onInterrupt);
-    process.once('SIGTERM', onInterrupt);
-    try {
-        if (parsed.command === 'doctor') {
-            const result = await host.doctor({ live: parsed.options.live === true });
-            process.stdout.write(parsed.options.format === 'jsonl' ? `${JSON.stringify(result)}\n` : `${result.ok ? 'ok' : 'error'}\nworkspace: ${result.cwd}\ndata: ${result.dataDir}\nnode: ${result.node}\nprovider: ${result.provider}\ntools: ${result.tools.join(', ')}\n${result.live ? `live: ${result.live.ok ? 'ok' : 'error'} (${result.live.message})\n` : ''}${result.errors.map((item) => `error: ${item}`).join('\n')}`.trim() + '\n');
-            return result.ok ? 0 : 1;
-        }
-        if (parsed.command === 'sessions') {
-            const sessions = await host.listConversations();
-            process.stdout.write(parsed.options.format === 'jsonl' ? sessions.map((item) => `${JSON.stringify(item)}\n`).join('') : (sessions.length ? sessions.map((item) => `${item.id}\t${item.updatedAt}\t${item.title}\t${item.cwd}`).join('\n') + '\n' : 'No conversations.\n'));
-            return 0;
-        }
-        if (parsed.command === 'run') {
-            const task = parsed.positionals.join(' ').trim();
-            if (!task)
-                throw new Error('TASK_REQUIRED');
-            const cwd = option(parsed.options, 'cwd');
-            const conversation = await host.createConversation(cwd === undefined ? {} : { cwd });
-            const outcome = await consumeManaged(await host.sendMessage(conversation.id, { text: task, format: option(parsed.options, 'format') === 'jsonl' ? 'jsonl' : 'text' }), option(parsed.options, 'format') ?? 'text', undefined, (run) => { activeRun = run; });
-            return outcome.status === 'succeeded' ? 0 : outcome.status === 'cancelled' ? 3 : 1;
-        }
-        if (parsed.command === 'resume') {
-            const id = parsed.positionals.shift();
-            const task = parsed.positionals.join(' ').trim();
-            if (!id)
-                throw new Error('RESUME_REQUIRES_ID');
-            const run = task ? await host.sendMessage(id, { text: task }) : await host.resumeRun(id);
-            const outcome = await consumeManaged(run, option(parsed.options, 'format') ?? 'text', undefined, (current) => { activeRun = current; });
-            return outcome.status === 'succeeded' ? 0 : outcome.status === 'cancelled' ? 3 : 1;
-        }
-        await interactive(host, undefined, (run) => { activeRun = run; });
-        return 0;
+    if (parsed.command === 'sessions') {
+        return runSessions(options, option(parsed.options, 'format') ?? 'text', version);
+    }
+    if (parsed.command === 'run') {
+        const task = parsed.positionals.join(' ').trim();
+        if (!task)
+            throw new Error('TASK_REQUIRED');
+        return runOneShot(options, task, option(parsed.options, 'format') ?? 'text', version);
     }
-    finally {
-        process.removeListener('SIGINT', onInterrupt);
-        process.removeListener('SIGTERM', onInterrupt);
-        await host.close();
+    if (parsed.command === 'resume') {
+        const id = parsed.positionals.shift();
+        const task = parsed.positionals.join(' ').trim();
+        if (!id)
+            throw new Error('RESUME_REQUIRES_ID');
+        return runResume(options, id, task || undefined, option(parsed.options, 'format') ?? 'text', version);
     }
+    // 默认启动交互式 Ink 界面
+    return runInteractive(options, undefined, undefined, version);
 }
-main().then((code) => { process.exitCode = code; }).catch((error) => { process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`); process.exitCode = 1; });
+main()
+    .then((code) => {
+    process.exitCode = code;
+})
+    .catch((error) => {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+});

package/dist/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+import { type LocalHostOptions } from '@hunterzhu/pulse-server';
+export declare function runDoctor(options: LocalHostOptions, live?: boolean, format?: string): Promise<number>;

package/dist/commands/doctor.js

@@ -0,0 +1,36 @@
+import { createLocalHost } from '@hunterzhu/pulse-server';
+import chalk from 'chalk';
+import { theme } from '../theme.js';
+export async function runDoctor(options, live = false, format = 'text') {
+    const host = createLocalHost(options);
+    try {
+        const result = await host.doctor({ live });
+        if (format === 'json' || format === 'jsonl') {
+            process.stdout.write(`${JSON.stringify(result)}\n`);
+            return result.ok ? 0 : 1;
+        }
+        process.stdout.write(`${result.ok ? chalk.hex(theme.success)('● 诊断通过') : chalk.hex(theme.error)('● 发现问题')}\n`);
+        process.stdout.write(`工作区:     ${chalk.hex(theme.accent)(result.cwd)}\n`);
+        process.stdout.write(`数据目录:   ${chalk.hex(theme.dim)(result.dataDir)}\n`);
+        process.stdout.write(`Node 版本:  ${result.node}\n`);
+        process.stdout.write(`Provider:   ${chalk.hex(theme.primary)(result.provider)}\n`);
+        process.stdout.write(`可用工具:   ${result.tools.map((t) => chalk.hex(theme.tool)(t)).join(', ')}\n`);
+        if (result.live) {
+            process.stdout.write(`实时连接:   ${result.live.ok ? chalk.hex(theme.success)('✓ 成功') : chalk.hex(theme.error)(`✗ 失败 (${result.live.message})`)}\n`);
+        }
+        if (result.errors.length > 0) {
+            process.stdout.write(`\n${chalk.hex(theme.error)('错误详情:')}\n`);
+            for (const err of result.errors) {
+                process.stdout.write(`  ✗ ${err}\n`);
+            }
+        }
+        return result.ok ? 0 : 1;
+    }
+    catch (error) {
+        process.stderr.write(`${chalk.hex(theme.error)('诊断执行失败:')} ${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+    finally {
+        await host.close();
+    }
+}

package/dist/commands/interactive.d.ts

@@ -0,0 +1,2 @@
+import type { LocalHostOptions } from '@hunterzhu/pulse-server';
+export declare function runInteractive(options: LocalHostOptions, conversationId?: string | undefined, initialTask?: string | undefined, version?: string): Promise<number>;

package/dist/commands/interactive.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render } from 'ink';
+import { App } from '../components/App.js';
+import { closePendingHosts } from '../hooks/useHost.js';
+export async function runInteractive(options, conversationId, initialTask, version = '0.1.4') {
+    const { waitUntilExit, unmount } = render(_jsx(App, { hostOptions: options, conversationId: conversationId, initialTask: initialTask, version: version }));
+    let interrupted = false;
+    const onSignal = () => {
+        interrupted = true;
+        unmount();
+    };
+    process.on('SIGINT', onSignal);
+    process.on('SIGTERM', onSignal);
+    try {
+        await waitUntilExit();
+        return interrupted ? 130 : 0;
+    }
+    catch (error) {
+        console.error(error);
+        return 1;
+    }
+    finally {
+        process.off('SIGINT', onSignal);
+        process.off('SIGTERM', onSignal);
+        await closePendingHosts();
+    }
+}

package/dist/commands/resume.d.ts

@@ -0,0 +1,2 @@
+import { type LocalHostOptions } from '@hunterzhu/pulse-server';
+export declare function runResume(options: LocalHostOptions, conversationId: string, task?: string | undefined, format?: string, version?: string): Promise<number>;

package/dist/commands/resume.js

@@ -0,0 +1,75 @@
+import { createLocalHost } from '@hunterzhu/pulse-server';
+import { runInteractive } from './interactive.js';
+import { bindRunSignals } from './signals.js';
+function writeEvent(event, format) {
+    if (format === 'jsonl') {
+        process.stdout.write(`${JSON.stringify(event)}\n`);
+        return;
+    }
+    if (event.type === 'text') {
+        process.stdout.write(String(event.data ?? ''));
+    }
+    else if (event.type === 'waiting') {
+        process.stdout.write(`\n[需要输入] ${JSON.stringify(event.data ?? '')}\n`);
+    }
+    else if (event.type === 'error') {
+        process.stderr.write(`\n[错误] ${String(event.data ?? '')}\n`);
+    }
+}
+export async function runResume(options, conversationId, task, format = 'text', version = '0.1.4') {
+    // 如果在交互式终端且没有指定 jsonl，启动交互式 Ink 界面直接继续会话
+    if (process.stdout.isTTY && format !== 'jsonl') {
+        return runInteractive(options, conversationId, task, version);
+    }
+    const host = createLocalHost(options);
+    let activeRun;
+    const unbindSignals = bindRunSignals(host, () => activeRun);
+    try {
+        await host.init();
+        const run = task
+            ? await host.sendMessage(conversationId, { text: task, format: format === 'jsonl' ? 'jsonl' : 'text' })
+            : await host.resumeRun(conversationId);
+        activeRun = run;
+        let streamedText = false;
+        let approvalCancelled = false;
+        for await (const event of run.events) {
+            if (event.type === 'text')
+                streamedText = true;
+            writeEvent(event, format);
+            if (event.type === 'waiting' && !approvalCancelled) {
+                approvalCancelled = true;
+                process.stderr.write('\n[错误] 此运行处于非交互模式，无法请求工具审批；运行已取消。\n');
+                await run.cancel('INTERACTION_REQUIRED');
+            }
+        }
+        const outcome = await run.outcome();
+        if (format === 'jsonl') {
+            process.stdout.write(`${JSON.stringify({
+                schemaVersion: 1,
+                type: 'result',
+                runId: run.id,
+                status: outcome.status,
+                text: outcome.text ?? null,
+                error: outcome.error ?? null,
+            })}\n`);
+        }
+        else if (outcome.status === 'failed' && outcome.error) {
+            process.stderr.write(`\n[错误] ${outcome.error.code}: ${outcome.error.message}\n`);
+        }
+        else if (!streamedText && outcome.text) {
+            process.stdout.write(`${outcome.text}\n`);
+        }
+        else {
+            process.stdout.write(`\n[${outcome.status}]\n`);
+        }
+        return outcome.status === 'succeeded' ? 0 : outcome.status === 'cancelled' ? 3 : 1;
+    }
+    catch (error) {
+        process.stderr.write(`[错误] ${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+    finally {
+        unbindSignals();
+        await host.close();
+    }
+}

package/dist/commands/run.d.ts

@@ -0,0 +1,2 @@
+import { type LocalHostOptions } from '@hunterzhu/pulse-server';
+export declare function runOneShot(options: LocalHostOptions, task: string, format?: string, version?: string): Promise<number>;

package/dist/commands/run.js

@@ -0,0 +1,73 @@
+import { createLocalHost } from '@hunterzhu/pulse-server';
+import { runInteractive } from './interactive.js';
+import { bindRunSignals } from './signals.js';
+function writeEvent(event, format) {
+    if (format === 'jsonl') {
+        process.stdout.write(`${JSON.stringify(event)}\n`);
+        return;
+    }
+    if (event.type === 'text') {
+        process.stdout.write(String(event.data ?? ''));
+    }
+    else if (event.type === 'waiting') {
+        process.stdout.write(`\n[需要输入] ${JSON.stringify(event.data ?? '')}\n`);
+    }
+    else if (event.type === 'error') {
+        process.stderr.write(`\n[错误] ${String(event.data ?? '')}\n`);
+    }
+}
+export async function runOneShot(options, task, format = 'text', version = '0.1.4') {
+    // 如果在交互式终端且没有指定 jsonl，启动交互式 Ink 界面直接执行任务
+    if (process.stdout.isTTY && format !== 'jsonl') {
+        return runInteractive(options, undefined, task, version);
+    }
+    const host = createLocalHost(options);
+    let activeRun;
+    const unbindSignals = bindRunSignals(host, () => activeRun);
+    try {
+        await host.init();
+        const conversation = await host.createConversation(options.cwd ? { cwd: options.cwd } : {});
+        const run = await host.sendMessage(conversation.id, {
+            text: task,
+            format: format === 'jsonl' ? 'jsonl' : 'text',
+        });
+        activeRun = run;
+        let streamedText = false;
+        let approvalCancelled = false;
+        for await (const event of run.events) {
+            if (event.type === 'text')
+                streamedText = true;
+            writeEvent(event, format);
+            if (event.type === 'waiting' && !approvalCancelled) {
+                approvalCancelled = true;
+                process.stderr.write('\n[错误] 此运行处于非交互模式，无法请求工具审批；运行已取消。\n');
+                await run.cancel('INTERACTION_REQUIRED');
+            }
+        }
+        const outcome = await run.outcome();
+        if (format === 'jsonl') {
+            process.stdout.write(`${JSON.stringify({
+                schemaVersion: 1,
+                type: 'result',
+                runId: run.id,
+                status: outcome.status,
+                text: outcome.text ?? null,
+                error: outcome.error ?? null,
+            })}\n`);
+        }
+        else if (outcome.status === 'failed' && outcome.error) {
+            process.stderr.write(`\n[错误] ${outcome.error.code}: ${outcome.error.message}\n`);
+        }
+        else if (!streamedText && outcome.text) {
+            process.stdout.write(`${outcome.text}\n`);
+        }
+        else {
+            process.stdout.write(`\n[${outcome.status}]\n`);
+        }
+        return outcome.status === 'succeeded' ? 0 : outcome.status === 'cancelled' ? 3 : 1;
+    }
+    finally {
+        unbindSignals();
+        await host.close();
+    }
+}

package/dist/commands/sessions.d.ts

@@ -0,0 +1,2 @@
+import { type LocalHostOptions } from '@hunterzhu/pulse-server';
+export declare function runSessions(options: LocalHostOptions, format?: string, version?: string): Promise<number>;

package/dist/commands/sessions.js

@@ -0,0 +1,66 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render } from 'ink';
+import { useState } from 'react';
+import { createLocalHost } from '@hunterzhu/pulse-server';
+import { SessionList } from '../components/SessionList.js';
+import { runInteractive } from './interactive.js';
+export async function runSessions(options, format = 'text', version = '0.1.4') {
+    const host = createLocalHost(options);
+    try {
+        await host.init();
+        const sessions = await host.listConversations();
+        if (format === 'jsonl') {
+            for (const s of sessions) {
+                process.stdout.write(`${JSON.stringify(s)}\n`);
+            }
+            return 0;
+        }
+        if (!process.stdout.isTTY) {
+            if (sessions.length === 0) {
+                process.stdout.write('暂无历史会话。\n');
+                return 0;
+            }
+            for (const s of sessions) {
+                process.stdout.write(`${s.id}\t${s.updatedAt}\t${s.title}\t${s.cwd}\n`);
+            }
+            return 0;
+        }
+        // 交互式终端：使用 SessionList
+        let selectedId;
+        let closeMenu = () => undefined;
+        const AppContainer = () => {
+            const [items, setItems] = useState(sessions);
+            const [notice, setNotice] = useState(null);
+            return (_jsx(SessionList, { sessions: items, notice: notice, onSelect: (id) => {
+                    selectedId = id;
+                    closeMenu();
+                }, onDelete: async (id) => {
+                    try {
+                        await host.deleteConversation(id);
+                        setItems((current) => current.filter((session) => session.id !== id));
+                        setNotice(null);
+                    }
+                    catch (error) {
+                        setNotice(error instanceof Error ? error.message : String(error));
+                    }
+                }, onBack: () => {
+                    closeMenu();
+                } }));
+        };
+        const rendered = render(_jsx(AppContainer, {}));
+        closeMenu = rendered.unmount;
+        const { waitUntilExit } = rendered;
+        await waitUntilExit();
+        if (selectedId) {
+            return runInteractive(options, selectedId, undefined, version);
+        }
+        return 0;
+    }
+    catch (error) {
+        process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+    finally {
+        await host.close();
+    }
+}

package/dist/commands/setup.d.ts

@@ -0,0 +1 @@
+export declare function runSetup(force: boolean, explicitPath?: string): Promise<number>;