@caoruhua/open-claude-remote 0.1.0

package/dist/index.js

@@ -0,0 +1,353 @@
+import { createServer } from 'node:http';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { existsSync, readdirSync, unlinkSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { randomUUID } from 'node:crypto';
+import express from 'express';
+import cors from 'cors';
+import { CLAUDE_REMOTE_DIR, SETTINGS_DIR } from '../shared-dist/index.js';
+import { loadConfig, createSessionCookieName, createClaudeSettings, extractSettingsFromArgs, saveClaudeSettings, ensureDefaultUserConfig } from './config.js';
+import { AuthModule } from './auth/auth-middleware.js';
+import { PtyManager } from './pty/pty-manager.js';
+import { WsServer } from './ws/ws-server.js';
+import { HookReceiver } from './hooks/hook-receiver.js';
+import { SessionController } from './session/session-controller.js';
+import { TerminalRelay } from './terminal/terminal-relay.js';
+import { createApiRouter } from './api/router.js';
+import { PushService } from './push/push-service.js';
+import { DingtalkService } from './notification/dingtalk-service.js';
+import { logger, setInstanceContext } from './logger/logger.js';
+import { getOrCreateSharedToken } from './registry/shared-token.js';
+import { findAvailablePort } from './registry/port-finder.js';
+import { InstanceRegistryManager } from './registry/instance-registry.js';
+import { InstanceSpawner } from './registry/instance-spawner.js';
+import { IpMonitor } from './utils/ip-monitor.js';
+import { printQRCode } from './utils/qrcode-banner.js';
+export async function startServer(cliOverrides = {}) {
+    // 1. Load configuration
+    const config = loadConfig(cliOverrides);
+    const projectRoot = resolve(dirname(fileURLToPath(import.meta.url)), '../..');
+    // 1.5. Ensure default shortcuts/commands in user config
+    await ensureDefaultUserConfig();
+    // 2. Shared config directory and token
+    const sharedConfigDir = resolve(homedir(), CLAUDE_REMOTE_DIR);
+    const { token, source: tokenSource } = getOrCreateSharedToken(sharedConfigDir, config.token ?? undefined);
+    // 3. Instance ID and registry
+    const instanceId = randomUUID();
+    const registry = new InstanceRegistryManager(sharedConfigDir);
+    // 4. Find available port (auto-increment if preferred port is occupied)
+    const actualPort = await findAvailablePort(config.port, config.host);
+    // Update config to reflect the actual port (cookie name must match actual port
+    // to prevent cross-instance cookie collision when port auto-increments)
+    if (actualPort !== config.port) {
+        config.sessionCookieName = createSessionCookieName(actualPort);
+        config.port = actualPort;
+        logger.info({
+            actualPort,
+            sessionCookieName: config.sessionCookieName,
+        }, 'Config updated for actual port');
+    }
+    // 设置日志实例上下文，后续所有日志自动包含 instancePort 字段
+    setInstanceContext(actualPort);
+    // 5. Create Express app
+    const app = express();
+    app.use(express.json());
+    app.use(cors({
+        origin: (origin, callback) => {
+            // Allow same-origin requests (origin is undefined) and requests from LAN
+            if (!origin) {
+                callback(null, true);
+                return;
+            }
+            try {
+                const url = new URL(origin);
+                // 允许同一 host 的任意端口（多实例跨端口访问）
+                const allowedHosts = [config.displayIp, 'localhost', '127.0.0.1'];
+                if (allowedHosts.includes(url.hostname)) {
+                    callback(null, true);
+                    return;
+                }
+            }
+            catch {
+                // invalid origin
+            }
+            callback(new Error('Not allowed by CORS'));
+        },
+        credentials: true,
+    }));
+    // 6. Create HTTP server
+    const httpServer = createServer(app);
+    // 7. Setup auth module
+    const authModule = new AuthModule({
+        token,
+        sessionTtlMs: config.sessionTtlMs,
+        rateLimitPerMinute: config.authRateLimit,
+        cookieName: config.sessionCookieName,
+    });
+    // 8. Setup Hook receiver
+    const hookReceiver = new HookReceiver();
+    // 9. Setup Push service
+    const pushService = new PushService(sharedConfigDir);
+    // 9.5. Setup Dingtalk service (if configured)
+    const userConfigPath = resolve(sharedConfigDir, 'config.json');
+    let dingtalkService = null;
+    try {
+        if (existsSync(userConfigPath)) {
+            const userConfigContent = readFileSync(userConfigPath, 'utf-8');
+            const userConfig = JSON.parse(userConfigContent);
+            if (userConfig.dingtalk?.webhookUrl) {
+                dingtalkService = new DingtalkService(userConfig.dingtalk.webhookUrl);
+                logger.info('Dingtalk notification service initialized');
+            }
+        }
+    }
+    catch (err) {
+        logger.warn({ err }, 'Failed to load dingtalk config, skipping');
+    }
+    // 10. Session controller reference (set after PTY spawn)
+    let sessionController = null;
+    // 10.5. Create Instance Spawner (for creating new instances via API)
+    const instanceSpawner = new InstanceSpawner();
+    // 11. Mount REST API (with instance routes)
+    app.use('/api', createApiRouter({
+        authModule,
+        hookReceiver,
+        getController: () => sessionController,
+        pushService,
+        listInstances: () => registry.list(),
+        currentInstanceId: instanceId,
+        instanceSpawner,
+    }));
+    // 12. Serve frontend static files (if built)
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    // 发布包中 frontend-dist 在 dist 同级，开发时在 frontend/dist
+    const publishFrontendDist = resolve(__dirname, '../frontend-dist');
+    const devFrontendDist = resolve(__dirname, '../../frontend/dist');
+    const frontendDist = existsSync(publishFrontendDist)
+        ? publishFrontendDist
+        : devFrontendDist;
+    if (existsSync(frontendDist)) {
+        app.use(express.static(frontendDist));
+        // SPA fallback — skip /api and /ws paths to avoid hijacking backend routes
+        app.get('*', (req, res, next) => {
+            if (req.path.startsWith('/api') || req.path.startsWith('/ws')) {
+                return next();
+            }
+            res.sendFile(resolve(frontendDist, 'index.html'));
+        });
+        logger.info({ path: frontendDist }, 'Serving frontend static files');
+    }
+    else {
+        logger.warn('Frontend dist not found, skipping static file serving');
+    }
+    // 13. Create WebSocket server
+    const wsServer = new WsServer(httpServer, authModule);
+    // 14. Spawn PTY with Claude Code CLI
+    const ptyManager = new PtyManager();
+    // 15. Terminal Relay (条件启动，headless 模式跳过)
+    const noTerminal = process.env.NO_TERMINAL === 'true';
+    const relay = (!noTerminal && process.stdin.isTTY) ? new TerminalRelay(ptyManager) : undefined;
+    // 16. Create Session Controller (with relay for dynamic master switch)
+    sessionController = new SessionController(ptyManager, wsServer, hookReceiver, config.maxBufferLines, relay);
+    sessionController.setPushService(pushService);
+    if (dingtalkService) {
+        sessionController.setDingtalkService(dingtalkService);
+    }
+    // 17. Spawn Claude Code with instance-specific hook settings
+    // 检查用户是否传了 --settings 参数，如果有则合并 hooks
+    const extracted = extractSettingsFromArgs(config.claudeArgs);
+    let finalArgs;
+    // 生成最终的 settings 对象
+    const finalSettings = createClaudeSettings(actualPort, extracted?.settingsValue);
+    // 保存到文件并通过文件路径传递给 Claude
+    const settingsPath = saveClaudeSettings(finalSettings, actualPort, sharedConfigDir);
+    if (extracted) {
+        finalArgs = [...extracted.otherArgs, '--settings', settingsPath];
+        logger.info({ port: actualPort, originalSettingsPath: extracted.settingsPath, savedSettingsPath: settingsPath }, 'Merged user settings with hooks');
+    }
+    else {
+        finalArgs = [...config.claudeArgs, '--settings', settingsPath];
+        logger.info({ port: actualPort, savedSettingsPath: settingsPath }, 'Generated Claude settings with instance-specific hook URL');
+    }
+    ptyManager.spawn({
+        command: config.claudeCommand,
+        args: finalArgs,
+        cwd: config.claudeCwd,
+    });
+    // Start relay after spawn (if not headless)
+    if (relay) {
+        relay.start();
+    }
+    sessionController.setStatus('running');
+    // 18. Register instance in shared registry
+    registry.register({
+        instanceId,
+        name: config.instanceName,
+        host: config.displayIp,
+        port: actualPort,
+        pid: process.pid,
+        cwd: config.claudeCwd,
+        startedAt: new Date().toISOString(),
+        headless: noTerminal,
+    });
+    // 18.5. Clean up stale settings files for dead instances
+    try {
+        const settingsDir = resolve(sharedConfigDir, SETTINGS_DIR);
+        if (existsSync(settingsDir)) {
+            const alivePorts = new Set((await registry.list()).map(i => i.port));
+            for (const file of readdirSync(settingsDir)) {
+                const match = file.match(/^(\d+)\.json$/);
+                if (match) {
+                    const port = parseInt(match[1], 10);
+                    if (!alivePorts.has(port)) {
+                        try {
+                            unlinkSync(resolve(settingsDir, file));
+                            logger.info({ file, port }, 'Cleaned up stale settings file');
+                        }
+                        catch {
+                            // 静默处理：清理失败不影响启动
+                        }
+                    }
+                }
+            }
+        }
+    }
+    catch (err) {
+        logger.debug({ err }, 'Settings cleanup skipped');
+    }
+    // 18.6. Start IP monitor
+    const ipMonitor = new IpMonitor((newIp, oldIp) => {
+        const newUrl = `http://${newIp}:${actualPort}`;
+        logger.info({ oldIp, newIp, newUrl }, 'IP change detected');
+        // Update config
+        config.displayIp = newIp;
+        // Update registry
+        registry.updateHost(instanceId, newIp);
+        // Broadcast to all connected clients
+        wsServer.broadcast({
+            type: 'ip_changed',
+            oldIp,
+            newIp,
+            newUrl,
+        });
+    }, 30000, 2); // 30s interval, 2 consecutive detections required
+    ipMonitor.start(config.displayIp);
+    // 19. Unified graceful shutdown
+    let shuttingDown = false;
+    const shutdown = (exitCode = 0) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        logger.info({ exitCode }, 'Shutting down...');
+        // Unregister from shared registry
+        registry.unregister(instanceId);
+        if (relay) {
+            relay.stop();
+        }
+        ipMonitor.stop();
+        // Pause stdin to remove it as an active event loop handle
+        if (!process.stdin.isTTY) {
+            process.stdin.pause();
+        }
+        ptyManager.destroy();
+        wsServer.destroy();
+        authModule.destroy();
+        httpServer.close(() => {
+            process.exit(exitCode);
+        });
+        // Force exit if httpServer.close hangs (ref'd to guarantee it fires)
+        setTimeout(() => process.exit(exitCode), 2000);
+    };
+    // Handle PTY exit → graceful shutdown
+    ptyManager.on('exit', (exitCode) => {
+        logger.info({ exitCode }, 'Claude Code exited');
+        // Give time for WS messages to flush, then shutdown
+        setTimeout(() => shutdown(exitCode), 500);
+    });
+    process.on('SIGINT', () => {
+        logger.info('SIGINT received');
+        shutdown(0);
+    });
+    process.on('SIGTERM', () => {
+        logger.info('SIGTERM received');
+        shutdown(0);
+    });
+    // When running via pnpm dev (stdin is a pipe, not TTY), detect parent process exit
+    // via stdin close event — this fires when concurrently/pnpm terminates
+    // Also handle Ctrl+C which may come through stdin in pipe mode
+    if (!process.stdin.isTTY) {
+        process.stdin.resume();
+        // Kitty keyboard protocol CSI u variants for Ctrl+C:
+        // Match press/repeat (event type 1 or 2) but not release (3)
+        const CTRL_C = '\x03';
+        const KITTY_CTRL_C_RE = /\x1b\[99;5(?::(?:[12]))?(?:;\d+)*u/;
+        // Use 'readable' event for immediate reads without waiting for newline
+        // In pipe mode, 'data' event is line-buffered and waits for Enter
+        process.stdin.on('readable', () => {
+            let chunk;
+            while ((chunk = process.stdin.read()) !== null) {
+                const str = chunk.toString();
+                logger.info({ hex: chunk.toString('hex'), len: chunk.length, str: str.replace(/\x1b/g, 'ESC') }, 'stdin data received in non-TTY mode');
+                // Single Ctrl+C (classic ETX or Kitty protocol) → shutdown immediately
+                if (str === CTRL_C || KITTY_CTRL_C_RE.test(str)) {
+                    logger.info('Ctrl+C detected in pipe mode, initiating shutdown');
+                    shutdown(0);
+                }
+            }
+        });
+        process.stdin.once('close', () => {
+            logger.info('stdin pipe closed (parent process exited), initiating shutdown');
+            shutdown(0);
+        });
+    }
+    // 20. Handle port collision (TOCTOU between findAvailablePort and listen)
+    httpServer.on('error', (err) => {
+        if (err.code === 'EADDRINUSE') {
+            logger.error({ port: actualPort, host: config.host }, 'Port is already in use (TOCTOU race). Another process claimed it between port check and listen.');
+            process.exit(1);
+        }
+        logger.error({ err }, 'HTTP server error');
+        process.exit(1);
+    });
+    // 21. Start listening
+    httpServer.listen(actualPort, config.host, () => {
+        const url = `http://${config.displayIp}:${actualPort}`;
+        const isFirstInstance = tokenSource === 'generated';
+        process.stderr.write('\n');
+        process.stderr.write('╔══════════════════════════════════════════════════╗\n');
+        process.stderr.write('║         Claude Code Remote Proxy Started         ║\n');
+        process.stderr.write('╠══════════════════════════════════════════════════╣\n');
+        process.stderr.write(`║  Instance: ${config.instanceName.padEnd(37)}║\n`);
+        process.stderr.write(`║  URL:      ${url.padEnd(37)}║\n`);
+        if (isFirstInstance) {
+            // 首次启动（生成了新 Token）：完整显示 Token
+            const tokenPreview = token.length >= 16
+                ? `${token.substring(0, 8)}...${token.substring(token.length - 8)}`
+                : token;
+            process.stderr.write(`║  Token:    ${tokenPreview.padEnd(37)}║\n`);
+            process.stderr.write('╠══════════════════════════════════════════════════╣\n');
+            process.stderr.write(`║  Full Token (copy to phone):                     ║\n`);
+            process.stderr.write(`║  ${token.padEnd(48)}║\n`);
+        }
+        else {
+            // 后续启动（读取共享 Token）：简短提示
+            process.stderr.write(`║  Token:    ${'(shared, see first instance)'.padEnd(37)}║\n`);
+        }
+        process.stderr.write('╚══════════════════════════════════════════════════╝\n');
+        // 每次启动都显示二维码，方便手机扫码连接
+        const qrUrl = `${url}?token=${token}`;
+        printQRCode(qrUrl);
+        process.stderr.write('\n');
+        logger.info({ url, host: config.host, port: actualPort, instanceName: config.instanceName, tokenSource }, 'Server started');
+    });
+}
+// Auto-start when run directly (non-CLI mode)
+// CLI mode: cli.ts imports startServer() directly
+if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
+    startServer().catch((err) => {
+        logger.error({ err }, 'Failed to start');
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/logger/logger.d.ts

@@ -0,0 +1,8 @@
+import pino from 'pino';
+export declare let logger: pino.Logger<never, boolean>;
+/**
+ * 设置实例上下文，使后续所有日志自动包含 instancePort 字段。
+ * 在端口确定后调用一次。ESM live binding 确保所有 importer 自动获取新值。
+ */
+export declare function setInstanceContext(port: number): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAyFxB,eAAO,IAAI,MAAM,6BAAiB,CAAC;AAEnC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAErD"}

package/dist/logger/logger.js

@@ -0,0 +1,90 @@
+import pino from 'pino';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { mkdirSync } from 'node:fs';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const projectRoot = resolve(__dirname, '../../..'); // logger/ → src/ → backend/ → root/
+const logDir = process.env.LOG_DIR ?? resolve(projectRoot, 'logs');
+// Ensure log directory exists
+try {
+    mkdirSync(logDir, { recursive: true });
+}
+catch {
+    // ignore - may not have write access in test environment
+}
+const logFilePath = resolve(logDir, 'app.log');
+const errorLogPath = resolve(logDir, 'error.log');
+const isDev = process.env.NODE_ENV !== 'production';
+const isTest = process.env.NODE_ENV === 'test' || process.env.VITEST === 'true';
+const isCli = process.env.CLI_MODE === 'true';
+const isStderrTTY = process.stderr.isTTY === true;
+function createLogger() {
+    if (isTest) {
+        // Silent logger in test environment
+        return pino({ level: 'silent' });
+    }
+    if (isCli) {
+        // CLI mode: only write to files, keep terminal clean
+        return pino({
+            level: 'info',
+            transport: {
+                targets: [
+                    { target: 'pino/file', options: { destination: logFilePath }, level: 'info' },
+                    { target: 'pino/file', options: { destination: errorLogPath }, level: 'error' },
+                ],
+            },
+        });
+    }
+    if (isDev && isStderrTTY) {
+        // Pretty console output in dev (only when stderr is a TTY)
+        return pino({
+            level: 'debug',
+            transport: {
+                targets: [
+                    {
+                        target: 'pino-pretty',
+                        options: { destination: 2 }, // stderr — keep stdout clean for PTY relay
+                        level: 'info',
+                    },
+                    {
+                        target: 'pino/file',
+                        options: { destination: logFilePath },
+                        level: 'info',
+                    },
+                    {
+                        target: 'pino/file',
+                        options: { destination: errorLogPath },
+                        level: 'error',
+                    },
+                ],
+            },
+        });
+    }
+    // Production: JSON to files
+    return pino({
+        level: 'info',
+        transport: {
+            targets: [
+                {
+                    target: 'pino/file',
+                    options: { destination: logFilePath },
+                    level: 'info',
+                },
+                {
+                    target: 'pino/file',
+                    options: { destination: errorLogPath },
+                    level: 'error',
+                },
+            ],
+        },
+    });
+}
+export let logger = createLogger();
+/**
+ * 设置实例上下文，使后续所有日志自动包含 instancePort 字段。
+ * 在端口确定后调用一次。ESM live binding 确保所有 importer 自动获取新值。
+ */
+export function setInstanceContext(port) {
+    logger = logger.child({ instancePort: port });
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"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"}

package/dist/notification/dingtalk-service.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 钉钉群机器人 Webhook 通知服务
+ * 参考文档: https://open.dingtalk.com/document/robots/custom-robot-access
+ */
+export declare class DingtalkService {
+    private webhookUrl;
+    private validatedUrl;
+    constructor(webhookUrl: string);
+    /**
+     * 验证 webhook URL 是否为合法的钉钉域名
+     * 防止 SSRF 攻击
+     */
+    private validateWebhookUrl;
+    /**
+     * 发送钉钉通知
+     * 失败时仅记录日志，不抛出异常
+     *
+     * @param title 消息标题
+     * @param tool 工具名称
+     * @param message 详细消息
+     */
+    sendNotification(title: string, tool: string, message: string): Promise<void>;
+}
+//# sourceMappingURL=dingtalk-service.d.ts.map

package/dist/notification/dingtalk-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dingtalk-service.d.ts","sourceRoot":"","sources":["../../src/notification/dingtalk-service.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,qBAAa,eAAe;IAGd,OAAO,CAAC,UAAU;IAF9B,OAAO,CAAC,YAAY,CAAuB;gBAEvB,UAAU,EAAE,MAAM;IAItC;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;;;;;;OAOG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAwDpF"}

package/dist/notification/dingtalk-service.js

@@ -0,0 +1,94 @@
+import { logger } from '../logger/logger.js';
+/** 钉钉 Webhook 允许的域名 */
+const ALLOWED_HOSTS = ['oapi.dingtalk.com'];
+/** HTTP 请求超时时间（毫秒） */
+const REQUEST_TIMEOUT_MS = 5000;
+/**
+ * 钉钉群机器人 Webhook 通知服务
+ * 参考文档: https://open.dingtalk.com/document/robots/custom-robot-access
+ */
+export class DingtalkService {
+    webhookUrl;
+    validatedUrl = null;
+    constructor(webhookUrl) {
+        this.webhookUrl = webhookUrl;
+        this.validatedUrl = this.validateWebhookUrl(webhookUrl);
+    }
+    /**
+     * 验证 webhook URL 是否为合法的钉钉域名
+     * 防止 SSRF 攻击
+     */
+    validateWebhookUrl(url) {
+        if (!url)
+            return null;
+        try {
+            const parsed = new URL(url);
+            // 只允许钉钉官方域名
+            if (!ALLOWED_HOSTS.includes(parsed.hostname)) {
+                logger.warn({ hostname: parsed.hostname }, 'Invalid dingtalk webhook hostname, rejecting');
+                return null;
+            }
+            return url;
+        }
+        catch {
+            logger.warn({ url }, 'Invalid webhook URL format, rejecting');
+            return null;
+        }
+    }
+    /**
+     * 发送钉钉通知
+     * 失败时仅记录日志，不抛出异常
+     *
+     * @param title 消息标题
+     * @param tool 工具名称
+     * @param message 详细消息
+     */
+    async sendNotification(title, tool, message) {
+        if (!this.validatedUrl) {
+            logger.warn('Dingtalk webhook URL is empty or invalid, skipping notification');
+            return;
+        }
+        const payload = {
+            msgtype: 'markdown',
+            markdown: {
+                title,
+                text: `### ${title}\n\n**工具**: ${tool}\n\n**消息**: ${message}\n\n---\n请及时处理`,
+            },
+        };
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+        try {
+            const response = await fetch(this.validatedUrl, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(payload),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const text = await response.text();
+                logger.error({ status: response.status, body: text }, 'Dingtalk notification failed with HTTP error');
+                return;
+            }
+            const result = (await response.json());
+            if (result.errcode !== 0) {
+                logger.error({ errcode: result.errcode, errmsg: result.errmsg }, 'Dingtalk notification failed with API error');
+                return;
+            }
+            logger.info({ title, tool }, 'Dingtalk notification sent successfully');
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'AbortError') {
+                logger.error({ timeout: REQUEST_TIMEOUT_MS }, 'Dingtalk notification timed out');
+            }
+            else {
+                logger.error({ err, title, tool }, 'Dingtalk notification failed with exception');
+            }
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=dingtalk-service.js.map

package/dist/notification/dingtalk-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dingtalk-service.js","sourceRoot":"","sources":["../../src/notification/dingtalk-service.ts"],"names":[],"mappings":"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"}

package/dist/pty/output-buffer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Ring buffer for PTY output. Stores raw ANSI strings, enforces max line count.
+ * Provides monotonically increasing sequence numbers for reconnection sync.
+ */
+export declare class OutputBuffer {
+    private lines;
+    private partial;
+    private seq;
+    private readonly maxLines;
+    constructor(maxLines?: number);
+    get sequenceNumber(): number;
+    /**
+     * Append raw PTY output data. May contain multiple lines or partial lines.
+     */
+    append(data: string): void;
+    /**
+     * Get full buffered content as a single string (for history_sync).
+     */
+    getFullContent(): string;
+    /**
+     * Clear the buffer.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=output-buffer.d.ts.map

package/dist/pty/output-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-buffer.d.ts","sourceRoot":"","sources":["../../src/pty/output-buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,QAAQ,GAAE,MAAc;IAIpC,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAsB1B;;OAEG;IACH,cAAc,IAAI,MAAM;IAYxB;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}