pi2web 0.2.1 → 0.2.6

package/dist/http/system-prompt-routes.js

@@ -0,0 +1,52 @@
+import { readPiPromptFiles, writePiPromptFile } from '../agent-templates.js';
+import { json } from './utils.js';
+const invalid = (message) => Object.assign(new Error(message), { code: 'INVALID_REQUEST' });
+/**
+ * `/api/v1/system-prompt` exposes Pi's own global prompt files (`~/.pi/agent/SYSTEM.md`, `APPEND_SYSTEM.md`) and a
+ * preview of the effective prompt; `/api/v1/agent-templates` manages the shareable template files in the data dir.
+ */
+export async function handleSystemPromptRoutes(ctx, req, res, u, parts) {
+    const send = (status, data) => {
+        json(res, status, data);
+        return true;
+    };
+    if (u.pathname === '/api/v1/system-prompt') {
+        if (req.method === 'GET')
+            return send(200, { data: readPiPromptFiles() });
+        if (req.method === 'PUT') {
+            const b = await ctx.body();
+            if (b.kind !== 'system' && b.kind !== 'append')
+                throw invalid('kind must be system or append');
+            if (typeof b.content !== 'string')
+                throw invalid('content must be a string');
+            writePiPromptFile(b.kind, b.content);
+            return send(200, { data: readPiPromptFiles() });
+        }
+    }
+    if (req.method === 'GET' && u.pathname === '/api/v1/system-prompt/preview') {
+        const workspaceId = u.searchParams.get('workspaceId') ?? '', relativeCwd = u.searchParams.get('relativeCwd') ?? '.', templateId = u.searchParams.get('templateId') || '', piDefaultPrompt = u.searchParams.get('source') === 'pi-default';
+        const template = templateId && !piDefaultPrompt ? ctx.templates.snapshot(templateId) : undefined;
+        return send(200, {
+            data: {
+                ...(await ctx.agents.systemPromptPreview(workspaceId, relativeCwd, { template, piDefaultPrompt })),
+                template: template ?? null
+            }
+        });
+    }
+    if (parts[2] === 'agent-templates') {
+        if (parts.length === 3 && req.method === 'GET')
+            return send(200, { data: { dir: ctx.templates.dir, ...ctx.templates.list() } });
+        if (parts.length === 4) {
+            const id = decodeURIComponent(parts[3]);
+            if (req.method === 'GET')
+                return send(200, { data: ctx.templates.get(id) });
+            if (req.method === 'PUT')
+                return send(200, { data: ctx.templates.save(id, await ctx.body()) });
+            if (req.method === 'DELETE') {
+                ctx.templates.remove(id);
+                return send(200, { data: { deleted: true } });
+            }
+        }
+    }
+    return false;
+}

package/dist/http/utils.js

@@ -0,0 +1,43 @@
+export const LOOPBACK_HOSTS = ['127.0.0.1', '::1', 'localhost'];
+export const isLoopbackHost = (value) => {
+    try {
+        return LOOPBACK_HOSTS.includes(new URL(`http://${value}`).hostname.replace(/^\[|\]$/g, ''));
+    }
+    catch {
+        return false;
+    }
+};
+export const json = (res, status, data) => {
+    res.statusCode = status;
+    res.setHeader('content-type', 'application/json');
+    res.end(JSON.stringify(data));
+};
+export async function readBinaryBody(req, maxBytes = 25 * 1024 * 1024) {
+    const chunks = [];
+    let size = 0;
+    for await (const value of req) {
+        const chunk = Buffer.isBuffer(value) ? value : Buffer.from(value);
+        size += chunk.length;
+        if (size > maxBytes)
+            throw Object.assign(new Error('Request too large'), { code: 'REQUEST_TOO_LARGE' });
+        chunks.push(chunk);
+    }
+    return Buffer.concat(chunks);
+}
+/** Reads a JSON body as bytes so the size limit applies while streaming and multi-byte characters are never split across chunks. */
+export async function readJsonBody(req, maxBytes = 2 * 1024 * 1024) {
+    const raw = await readBinaryBody(req, maxBytes);
+    return raw.length ? JSON.parse(raw.toString('utf8')) : {};
+}
+/** Maps a thrown error's `code` to the HTTP status used by every REST endpoint. */
+export function errorStatus(code) {
+    if (code === 'WORKSPACE_PATH_OUTSIDE_ROOT')
+        return 403;
+    if (code === 'FILE_TOO_LARGE' || code === 'REQUEST_TOO_LARGE')
+        return 413;
+    if (code === 'VOICE_DISABLED' || code === 'VOICE_STT_DISABLED' || code === 'MAIL_NOTIFICATIONS_DISABLED')
+        return 503;
+    if (code?.endsWith('NOT_FOUND'))
+        return 404;
+    return 400;
+}

package/dist/http/web-assets.js

@@ -0,0 +1,63 @@
+import path from 'node:path';
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { createRequire } from 'node:module';
+import { createHash } from 'node:crypto';
+import { json } from './utils.js';
+const webRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../web'), require = createRequire(import.meta.url);
+const markedBrowser = path.join(path.dirname(require.resolve('marked/package.json')), 'lib', 'marked.umd.js');
+const webFiles = {
+    '/': { file: 'index.html', type: 'text/html; charset=utf-8' },
+    '/index.html': { file: 'index.html', type: 'text/html; charset=utf-8' },
+    '/app.js': { file: 'app.js', type: 'text/javascript; charset=utf-8' },
+    '/backend-state.js': { file: 'backend-state.js', type: 'text/javascript; charset=utf-8' },
+    '/hid-keyboard.js': { file: 'hid-keyboard.js', type: 'text/javascript; charset=utf-8' },
+    '/activity-view.js': { file: 'activity-view.js', type: 'text/javascript; charset=utf-8' },
+    '/collab': { file: 'collab.html', type: 'text/html; charset=utf-8' },
+    '/collab.html': { file: 'collab.html', type: 'text/html; charset=utf-8' },
+    '/collab.js': { file: 'collab.js', type: 'text/javascript; charset=utf-8' },
+    '/styles.css': { file: 'styles.css', type: 'text/css; charset=utf-8' },
+    '/icon.svg': { file: 'icon.svg', type: 'image/svg+xml' },
+    '/favicon.ico': { file: 'icon.svg', type: 'image/svg+xml' },
+    '/vendor/xterm.js': { file: require.resolve('@xterm/xterm'), type: 'text/javascript; charset=utf-8' },
+    '/vendor/xterm.css': { file: require.resolve('@xterm/xterm/css/xterm.css'), type: 'text/css; charset=utf-8' },
+    '/vendor/addon-fit.js': { file: require.resolve('@xterm/addon-fit'), type: 'text/javascript; charset=utf-8' },
+    '/vendor/marked.js': { file: markedBrowser, type: 'text/javascript; charset=utf-8' },
+    '/vendor/dompurify.js': {
+        file: require.resolve('dompurify/purify.min.js'),
+        type: 'text/javascript; charset=utf-8'
+    }
+};
+/** Serves a bundled Web UI or vendor file. Returns false when `pathname` is not a static asset. */
+export async function serveWebAsset(pathname, req, res, options) {
+    const asset = webFiles[pathname];
+    if (!asset)
+        return false;
+    try {
+        const content = await readFile(path.isAbsolute(asset.file) ? asset.file : path.join(webRoot, asset.file)), etag = `"${createHash('sha256').update(content).digest('base64url')}"`, ifNoneMatch = String(req.headers['if-none-match'] ?? '')
+            .split(',')
+            .map(value => value.trim().replace(/^W\//, ''));
+        res.setHeader('content-type', asset.type);
+        res.setHeader('cache-control', pathname.startsWith('/vendor/') ? 'public, max-age=86400' : 'no-cache');
+        res.setHeader('etag', etag);
+        res.setHeader('x-content-type-options', 'nosniff');
+        if (options.noAuth && asset.type.startsWith('text/html'))
+            res.setHeader('content-security-policy', "frame-ancestors 'self'");
+        if (ifNoneMatch.includes(etag) || ifNoneMatch.includes('*')) {
+            res.statusCode = 304;
+            res.end();
+            return true;
+        }
+        res.statusCode = 200;
+        res.end(content);
+    }
+    catch {
+        json(res, 500, {
+            error: {
+                code: 'WEB_UI_UNAVAILABLE',
+                message: 'Web UI files are missing. Reinstall the pi2web package.'
+            }
+        });
+    }
+    return true;
+}

package/dist/http/workspace-routes.js

@@ -0,0 +1,58 @@
+import { json, readJsonBody } from './utils.js';
+/** Handles Workspace files, the Session index and Terminal REST routes. Returns false for any other route. */
+export async function handleWorkspaceRoutes(ctx, req, res, u, parts, requestId) {
+    const send = (status, data) => {
+        json(res, status, data);
+        return true;
+    };
+    if (req.method === 'GET' && u.pathname === '/api/v1/workspaces')
+        return send(200, { data: ctx.workspaces.list() });
+    if (req.method === 'POST' && u.pathname === '/api/v1/workspaces') {
+        const b = await readJsonBody(req);
+        if (typeof b.label !== 'string' || typeof b.rootPath !== 'string')
+            return send(400, {
+                error: { code: 'INVALID_REQUEST', message: 'label and rootPath required', requestId }
+            });
+        const workspace = ctx.workspaces.add(b.label, b.rootPath);
+        ctx.metadata.saveWorkspace(workspace);
+        return send(201, { data: workspace });
+    }
+    if (parts[2] === 'workspaces' && parts[4] === 'tree' && req.method === 'GET')
+        return send(200, {
+            data: await ctx.workspaces.tree(parts[3], u.searchParams.get('path') ?? '.')
+        });
+    if (parts[2] === 'workspaces' && parts[4] === 'file' && req.method === 'GET')
+        return send(200, {
+            data: await ctx.workspaces.file(parts[3], u.searchParams.get('path') ?? '', Number(u.searchParams.get('offset') ?? 0), Number(u.searchParams.get('limit') ?? 1048576))
+        });
+    if (parts[2] === 'workspaces' && parts[4] === 'stat' && req.method === 'GET')
+        return send(200, {
+            data: await ctx.workspaces.stat(parts[3], u.searchParams.get('path') ?? '.')
+        });
+    if (req.method === 'GET' && u.pathname === '/api/v1/sessions') {
+        const workspace = ctx.workspaces.get(u.searchParams.get('workspaceId') ?? '');
+        if (!workspace)
+            throw Object.assign(new Error('Workspace not found'), { code: 'WORKSPACE_NOT_FOUND' });
+        const cwd = await ctx.workspaces.resolve(workspace, u.searchParams.get('path') ?? '.');
+        await ctx.ensureSessionIndex(workspace, cwd, u.searchParams.get('refresh') === 'true');
+        const limit = u.searchParams.has('limit') ? Number(u.searchParams.get('limit')) : undefined, offset = Number(u.searchParams.get('offset') ?? 0);
+        return send(200, { data: ctx.metadata.listSessions(cwd, limit, offset) });
+    }
+    if (req.method === 'GET' && u.pathname === '/api/v1/terminals')
+        return send(200, { data: ctx.terminals.list() });
+    if (req.method === 'POST' && u.pathname === '/api/v1/terminals') {
+        const b = await readJsonBody(req);
+        const terminal = await ctx.terminals.create(String(b.workspaceId ?? ''), String(b.relativeCwd ?? '.'), Number(b.cols ?? 80), Number(b.rows ?? 24));
+        return send(201, { data: terminal });
+    }
+    if (parts[2] === 'terminals') {
+        const id = parts[3];
+        if (req.method === 'GET' && parts.length === 4)
+            return send(200, { data: ctx.terminals.get(id).record });
+        if (req.method === 'DELETE' && parts.length === 4) {
+            ctx.terminals.close(id);
+            return send(200, { data: { closed: true } });
+        }
+    }
+    return false;
+}

package/dist/mail-notifier.js

@@ -1,8 +1,18 @@
 import { randomUUID } from 'node:crypto';
 import { assistantText } from './voice.js';
-const defaultSettings = { enabled: true, aggregationDelaySeconds: 0, includeResponse: true, includeSessionDetails: true, collabEscalations: true };
+const defaultSettings = {
+    enabled: true,
+    aggregationDelaySeconds: 0,
+    includeResponse: true,
+    includeSessionDetails: true,
+    collabEscalations: true
+};
 const clip = (value, max) => value.length <= max ? value : `${value.slice(0, max)}\n\n[内容过长，已截断]`;
-const oneLine = (value, max) => value.replace(/[\r\n\t]+/g, ' ').replace(/\s{2,}/g, ' ').trim().slice(0, max);
+const oneLine = (value, max) => value
+    .replace(/[\r\n\t]+/g, ' ')
+    .replace(/\s{2,}/g, ' ')
+    .trim()
+    .slice(0, max);
 export class MailNotifier {
     fetcher;
     lastAssistant = new Map();
@@ -18,7 +28,9 @@ export class MailNotifier {
         this.fetcher = fetcher;
         this.config = { priority: 100, timeoutMs: 15_000, ...config };
     }
-    getSettings() { return { ...this.settings }; }
+    getSettings() {
+        return { ...this.settings };
+    }
     updateSettings(value) {
         const next = { ...this.settings, ...value };
         next.enabled = Boolean(next.enabled);
@@ -26,8 +38,12 @@ export class MailNotifier {
         next.includeSessionDetails = Boolean(next.includeSessionDetails);
         next.collabEscalations = Boolean(next.collabEscalations);
         next.aggregationDelaySeconds = Math.trunc(Number(next.aggregationDelaySeconds));
-        if (!Number.isFinite(next.aggregationDelaySeconds) || next.aggregationDelaySeconds < 0 || next.aggregationDelaySeconds > 86400)
-            throw Object.assign(new Error('aggregationDelaySeconds must be an integer between 0 and 86400'), { code: 'INVALID_MAIL_NOTIFICATION_SETTINGS' });
+        if (!Number.isFinite(next.aggregationDelaySeconds) ||
+            next.aggregationDelaySeconds < 0 ||
+            next.aggregationDelaySeconds > 86400)
+            throw Object.assign(new Error('aggregationDelaySeconds must be an integer between 0 and 86400'), {
+                code: 'INVALID_MAIL_NOTIFICATION_SETTINGS'
+            });
         this.settings = next;
         if (!next.enabled) {
             this.clearTimer();
@@ -92,7 +108,10 @@ export class MailNotifier {
             this.startFlush();
             return;
         }
-        this.timer = setTimeout(() => { this.timer = undefined; this.startFlush(); }, delay);
+        this.timer = setTimeout(() => {
+            this.timer = undefined;
+            this.startFlush();
+        }, delay);
         this.timer.unref?.();
     }
     startFlush() {
@@ -108,10 +127,12 @@ export class MailNotifier {
         if (this.queue.length && !this.timer && !this.closed)
             this.scheduleFlush();
     }
-    clearTimer() { if (this.timer) {
-        clearTimeout(this.timer);
-        this.timer = undefined;
-    } }
+    clearTimer() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = undefined;
+        }
+    }
     async sendBatch(items) {
         const includeResponse = this.settings.includeResponse, includeSessionDetails = this.settings.includeSessionDetails, count = items.length;
         const aborted = items.filter(item => item.aborted).length;
@@ -125,10 +146,20 @@ export class MailNotifier {
         }
         let text;
         if (!includeResponse && !includeSessionDetails)
-            text = count > 1 ? `${count} 个 Agent 任务${verb}。` : aborted ? '有 Agent 任务被中断。' : '有 Agent 任务完成。';
+            text =
+                count > 1
+                    ? `${count} 个 Agent 任务${verb}。`
+                    : aborted
+                        ? '有 Agent 任务被中断。'
+                        : '有 Agent 任务完成。';
         else
-            text = items.map((item, index) => {
-                const lines = count > 1 ? [`任务 ${index + 1}${item.aborted ? '（已中断）' : ''}`] : item.aborted ? ['任务已中断'] : [];
+            text = items
+                .map((item, index) => {
+                const lines = count > 1
+                    ? [`任务 ${index + 1}${item.aborted ? '（已中断）' : ''}`]
+                    : item.aborted
+                        ? ['任务已中断']
+                        : [];
                 if (includeSessionDetails) {
                     lines.push(`Session：${item.context.sessionName?.trim() || '未命名'}`);
                     if (item.context.cwd)
@@ -140,17 +171,32 @@ export class MailNotifier {
                     lines.push('Agent 回复：', clip(item.finalOutput.trim() || '（没有可用的最终文本回复）', 24_000));
                 }
                 return lines.join('\n');
-            }).join('\n\n--------------------\n\n');
+            })
+                .join('\n\n--------------------\n\n');
         await this.sendMail(subject, text, { task_count: count, aborted_count: aborted });
     }
     async sendMail(subject, text, metadata = {}) {
         const payload = {
-            to: [this.config.recipient], subject, text, priority: this.config.priority, purpose: 'transactional',
-            metadata: { source: 'remote-pi', ...metadata, notification_id: randomUUID() }
+            to: [this.config.recipient],
+            subject,
+            text,
+            priority: this.config.priority,
+            purpose: 'transactional',
+            metadata: { source: 'pi2web', ...metadata, notification_id: randomUUID() }
         };
         if (this.config.senderId)
             payload.sender_id = this.config.senderId;
-        const response = await this.fetcher(this.config.endpoint, { method: 'POST', signal: AbortSignal.timeout(this.config.timeoutMs), headers: { authorization: `Bearer ${this.config.apiKey}`, 'content-type': 'application/json; charset=utf-8', accept: 'application/json', 'idempotency-key': randomUUID() }, body: JSON.stringify(payload) });
+        const response = await this.fetcher(this.config.endpoint, {
+            method: 'POST',
+            signal: AbortSignal.timeout(this.config.timeoutMs),
+            headers: {
+                authorization: `Bearer ${this.config.apiKey}`,
+                'content-type': 'application/json; charset=utf-8',
+                accept: 'application/json',
+                'idempotency-key': randomUUID()
+            },
+            body: JSON.stringify(payload)
+        });
         if (!response.ok)
             throw new Error(`HTTP ${response.status}: ${(await response.text()).slice(0, 500)}`);
         const result = await response.json().catch(() => undefined);

package/dist/main.js

@@ -1,18 +1,28 @@
 #!/usr/bin/env node
 import { RemotePiServer, LOOPBACK_HOSTS } from './server.js';
+import { defaultDataDir } from './paths.js';
 import { VoiceManager } from './voice.js';
 import { SessionNamer, DEFAULT_SESSION_NAMER } from './session-namer.js';
 import { MailNotifier } from './mail-notifier.js';
 import pkg from '../package.json' with { type: 'json' };
 const args = process.argv.slice(2);
-const value = (name, fallback) => { const i = args.indexOf(name); return i >= 0 ? args[i + 1] ?? fallback : fallback; };
-const envSecret = (flag) => { const name = value(flag, '').trim(); if (!name)
-    return undefined; const result = process.env[name]; if (!result) {
-    console.error(`${flag} references missing environment variable ${name}`);
-    process.exit(1);
-} return result; };
+const value = (name, fallback) => {
+    const i = args.indexOf(name);
+    return i >= 0 ? (args[i + 1] ?? fallback) : fallback;
+};
+const envSecret = (flag) => {
+    const name = value(flag, '').trim();
+    if (!name)
+        return undefined;
+    const result = process.env[name];
+    if (!result) {
+        console.error(`${flag} references missing environment variable ${name}`);
+        process.exit(1);
+    }
+    return result;
+};
 if (args.includes('--help') || args.includes('-h')) {
-    console.log(`pi2web ${pkg.version}\n\nUsage: pi2web [options]\n\nOptions:\n  --host <address>                    Listen address (default: 127.0.0.1)\n  --port <number>                     Listen port (default: 11318)\n  --data-dir <path>                   Metadata directory (default: ~/.pi/remote-pi)\n  --maildispatch-endpoint <url>       MailDispatch message API endpoint\n  --maildispatch-api-key-env <name>   Environment variable containing the MailDispatch API key\n  --maildispatch-notify-to <email>    Email address notified when an Agent task settles\n  --maildispatch-sender-id <id>       Optional MailDispatch sender ID\n  --voice-base-url <url>              OpenAI-compatible TTS endpoint, e.g. Speaches or openai-edge-tts\n  --voice-stt-model <id>              Optional speech-to-text model ID; omit for TTS-only mode\n  --voice-tts-model <id>              Text-to-speech model ID\n  --voice-tts-voice <id>              TTS voice ID\n  --voice-tts-format <pcm|mp3>         TTS response format (default: pcm)\n  --voice-api-key-env <name>          Environment variable containing the speech API key\n  --voice-summary-base-url <url>      OpenAI-compatible summary LLM endpoint\n  --voice-summary-model <id>          Summary LLM model ID\n  --voice-summary-api-key-env <name>  Environment variable containing the summary API key\n  --voice-language <tag>              Spoken summary language (default: zh-CN)\n  --voice-request-timeout <ms>        Speech and summary request timeout (default: 120000)\n  --session-naming <on|off>           Automatic session naming (default: on)\n  --session-name-base-url <url>       OpenAI-compatible naming LLM endpoint (default: ${DEFAULT_SESSION_NAMER.baseUrl})\n  --session-name-model <id>           Naming LLM model ID (default: ${DEFAULT_SESSION_NAMER.model})\n  --session-name-api-key-env <name>   Environment variable containing the naming API key (default: none)\n  --session-name-language <tag>       Session name language (default: zh-CN)\n  --session-name-request-timeout <ms> Naming request timeout (default: 60000)\n  --session-name-max-output-tokens <n> Naming output token budget (default: ${DEFAULT_SESSION_NAMER.maxOutputTokens})\n  --rotate-access-token               Generate a new pairing code and exit\n  --create-voice-token                Create or replace a restricted voice token and exit\n  --revoke-voice-token                Revoke the restricted voice token and exit
+    console.log(`pi2web ${pkg.version}\n\nUsage: pi2web [options]\n\nOptions:\n  --host <address>                    Listen address (default: 127.0.0.1)\n  --port <number>                     Listen port (default: 11318)\n  --data-dir <path>                   Data directory (default: ~/.pi/pi2web, env PI2WEB_DIR)\n  --maildispatch-endpoint <url>       MailDispatch message API endpoint\n  --maildispatch-api-key-env <name>   Environment variable containing the MailDispatch API key\n  --maildispatch-notify-to <email>    Email address notified when an Agent task settles\n  --maildispatch-sender-id <id>       Optional MailDispatch sender ID\n  --voice-base-url <url>              OpenAI-compatible TTS endpoint, e.g. Speaches or openai-edge-tts\n  --voice-stt-model <id>              Optional speech-to-text model ID; omit for TTS-only mode\n  --voice-tts-model <id>              Text-to-speech model ID\n  --voice-tts-voice <id>              TTS voice ID\n  --voice-tts-format <pcm|mp3>         TTS response format (default: pcm)\n  --voice-api-key-env <name>          Environment variable containing the speech API key\n  --voice-summary-base-url <url>      OpenAI-compatible summary LLM endpoint\n  --voice-summary-model <id>          Summary LLM model ID\n  --voice-summary-api-key-env <name>  Environment variable containing the summary API key\n  --voice-language <tag>              Spoken summary language (default: zh-CN)\n  --voice-request-timeout <ms>        Speech and summary request timeout (default: 120000)\n  --session-naming <on|off>           Automatic session naming (default: on)\n  --session-name-base-url <url>       OpenAI-compatible naming LLM endpoint (default: ${DEFAULT_SESSION_NAMER.baseUrl})\n  --session-name-model <id>           Naming LLM model ID (default: ${DEFAULT_SESSION_NAMER.model})\n  --session-name-api-key-env <name>   Environment variable containing the naming API key (default: none)\n  --session-name-language <tag>       Session name language (default: zh-CN)\n  --session-name-request-timeout <ms> Naming request timeout (default: 60000)\n  --session-name-max-output-tokens <n> Naming output token budget (default: ${DEFAULT_SESSION_NAMER.maxOutputTokens})\n  --rotate-access-token               Generate a new pairing code and exit\n  --create-voice-token                Create or replace a restricted voice token and exit\n  --revoke-voice-token                Revoke the restricted voice token and exit
   --set-access-token <token>          Set a specific pairing code and exit
   --set-access-token-env <name>       Set the pairing code from an environment variable and exit\n  --no-auth                           Disable pairing-code auth (loopback only by default)\n  --allow-insecure-no-auth             Allow non-loopback binds and any Host/Origin (requires --no-auth; DANGEROUS)\n  --version                           Print version\n  -h, --help                          Show help\n\nMail notifications require endpoint, API-key environment variable, and recipient. Voice is disabled unless --voice-base-url is set. Automatic session naming is independent of voice and on by default; disable it with --session-naming off. The Web UI is served at the same address. Its pairing code must be entered manually; the browser asks before saving it locally.`);
     process.exit(0);
@@ -38,10 +48,14 @@ if (noAuth && !allowInsecureNoAuth && !LOOPBACK_HOSTS.includes(host.trim())) {
 const voiceBaseUrl = value('--voice-base-url', '');
 let voice;
 if (voiceBaseUrl) {
-    const required = (name) => { const result = value(name, '').trim(); if (!result) {
-        console.error(`${name} is required when voice is enabled`);
-        process.exit(1);
-    } return result; };
+    const required = (name) => {
+        const result = value(name, '').trim();
+        if (!result) {
+            console.error(`${name} is required when voice is enabled`);
+            process.exit(1);
+        }
+        return result;
+    };
     const ttsFormat = value('--voice-tts-format', 'pcm').trim();
     if (ttsFormat !== 'pcm' && ttsFormat !== 'mp3') {
         console.error('--voice-tts-format must be pcm or mp3');
@@ -52,7 +66,19 @@ if (voiceBaseUrl) {
         console.error('--voice-request-timeout must be an integer of at least 1000 milliseconds');
         process.exit(1);
     }
-    const config = { speechBaseUrl: voiceBaseUrl, sttModel: value('--voice-stt-model', '').trim() || undefined, ttsModel: required('--voice-tts-model'), ttsVoice: required('--voice-tts-voice'), ttsFormat, speechApiKey: envSecret('--voice-api-key-env'), summaryBaseUrl: required('--voice-summary-base-url'), summaryModel: required('--voice-summary-model'), summaryApiKey: envSecret('--voice-summary-api-key-env'), language: value('--voice-language', 'zh-CN'), requestTimeoutMs };
+    const config = {
+        speechBaseUrl: voiceBaseUrl,
+        sttModel: value('--voice-stt-model', '').trim() || undefined,
+        ttsModel: required('--voice-tts-model'),
+        ttsVoice: required('--voice-tts-voice'),
+        ttsFormat,
+        speechApiKey: envSecret('--voice-api-key-env'),
+        summaryBaseUrl: required('--voice-summary-base-url'),
+        summaryModel: required('--voice-summary-model'),
+        summaryApiKey: envSecret('--voice-summary-api-key-env'),
+        language: value('--voice-language', 'zh-CN'),
+        requestTimeoutMs
+    };
     voice = new VoiceManager(config);
 }
 const namingMode = value('--session-naming', 'on').trim().toLowerCase();
@@ -101,9 +127,23 @@ if (mailParts === 3) {
         console.error('--maildispatch-endpoint must use http or https');
         process.exit(1);
     }
-    mailNotifier = new MailNotifier({ endpoint: endpoint.toString(), apiKey: envSecret('--maildispatch-api-key-env'), recipient: mailRecipient, senderId: value('--maildispatch-sender-id', '').trim() || undefined });
+    mailNotifier = new MailNotifier({
+        endpoint: endpoint.toString(),
+        apiKey: envSecret('--maildispatch-api-key-env'),
+        recipient: mailRecipient,
+        senderId: value('--maildispatch-sender-id', '').trim() || undefined
+    });
 }
-const server = new RemotePiServer({ host, port, noAuth, allowInsecureNoAuth, dataDir: value('--data-dir', process.env.PI_REMOTE_DIR ?? `${process.env.HOME ?? '.'}/.pi/remote-pi`), voice, sessionNamer, mailNotifier });
+const server = new RemotePiServer({
+    host,
+    port,
+    noAuth,
+    allowInsecureNoAuth,
+    dataDir: value('--data-dir', defaultDataDir()),
+    voice,
+    sessionNamer,
+    mailNotifier
+});
 if (args.includes('--rotate-access-token')) {
     await server.auth.init();
     console.log(await server.auth.rotate());
@@ -158,12 +198,17 @@ try {
     await server.start();
     const address = server.address();
     console.log(`Remote Pi is ready: http://${host}:${address?.port ?? port}`);
-    console.log(noAuth ? 'Auth is disabled (--no-auth). Anyone who can reach this address can control the agents; leave the pairing code empty in the Web UI.' : 'Open this URL and enter the pairing code manually.');
+    console.log(noAuth
+        ? 'Auth is disabled (--no-auth). Anyone who can reach this address can control the agents; leave the pairing code empty in the Web UI.'
+        : 'Open this URL and enter the pairing code manually.');
 }
 catch (error) {
     console.error(`Failed to start Remote Pi: ${error.message}`);
     process.exit(1);
 }
-const shutdown = async () => { await server.stop(); process.exit(0); };
+const shutdown = async () => {
+    await server.stop();
+    process.exit(0);
+};
 process.once('SIGINT', shutdown);
 process.once('SIGTERM', shutdown);

package/dist/mcp.js

@@ -39,7 +39,9 @@ function summarize(entry) {
         enabled: config.enabled !== false,
         exposure: typeof config.exposure === 'string' ? config.exposure : 'codemode',
         transport: http ? 'http' : 'stdio',
-        target: http ? String(config.url) : [config.command, ...(Array.isArray(config.args) ? config.args : [])].filter(Boolean).join(' ').trim(),
+        target: http
+            ? String(config.url)
+            : [config.command, ...(Array.isArray(config.args) ? config.args : [])].filter(Boolean).join(' ').trim(),
         description: typeof config.description === 'string' ? config.description : undefined,
         scope: entry.scope,
         source: entry.source,
@@ -56,7 +58,9 @@ function load(cwd) {
         explicitlyTrusted = new ProjectTrustStore(getAgentDir()).get(cwd) === true;
         projectTrusted = explicitlyTrusted || !hasTrustRequiringProjectResources(cwd);
     }
-    catch { /* Untrusted is the safe default. */ }
+    catch {
+        /* Untrusted is the safe default. */
+    }
     const globals = readConfig(globalFile, errors), project = projectTrusted ? readConfig(projectFile, errors) : {};
     const entries = new Map();
     for (const [name, config] of Object.entries(globals))
@@ -68,12 +72,25 @@ function load(cwd) {
         else
             entries.set(name, { name, config, scope: 'project', source: projectFile });
     }
-    return { entries: [...entries.values()], globalFile, projectFile: projectTrusted ? projectFile : undefined, projectTrusted, explicitlyTrusted, errors };
+    return {
+        entries: [...entries.values()],
+        globalFile,
+        projectFile: projectTrusted ? projectFile : undefined,
+        projectTrusted,
+        explicitlyTrusted,
+        errors
+    };
 }
 /** Every configured MCP server for `cwd`, including disabled ones. */
 export function listMcpServers(cwd) {
     const config = load(cwd);
-    return { servers: config.entries.map(summarize), globalConfig: config.globalFile, projectConfig: config.projectFile, projectTrusted: config.projectTrusted, errors: config.errors };
+    return {
+        servers: config.entries.map(summarize),
+        globalConfig: config.globalFile,
+        projectConfig: config.projectFile,
+        projectTrusted: config.projectTrusted,
+        errors: config.errors
+    };
 }
 /** Write one server's `enabled` flag into `file`, keeping the rest of the file as it is. */
 function writeEnabled(file, name, enabled, explicit = false) {
@@ -87,7 +104,9 @@ function writeEnabled(file, name, enabled, explicit = false) {
             throw error;
     }
     const document = text?.trim() ? JSON.parse(text) : {};
-    const servers = document.mcpServers && typeof document.mcpServers === 'object' ? document.mcpServers : (document.mcpServers = {});
+    const servers = document.mcpServers && typeof document.mcpServers === 'object'
+        ? document.mcpServers
+        : (document.mcpServers = {});
     const current = servers[name] && typeof servers[name] === 'object' ? servers[name] : (servers[name] = {});
     // `enabled: true` is the default, so it is dropped where the server itself is defined. A project
     // override only changes what it states, so there the flag is always written out.