@qlingzzy/qling 1.0.0

package/dist/channels/types.d.ts

@@ -0,0 +1,31 @@
+export interface ChannelMessage {
+    id: string;
+    role: "user" | "assistant" | "system";
+    content: string;
+    timestamp: number;
+    metadata?: Record<string, unknown>;
+}
+export interface ApprovalRequest {
+    id: string;
+    toolName: string;
+    arguments: Record<string, unknown>;
+    reason: string;
+    timestamp: number;
+}
+export interface ApprovalResponse {
+    requestId: string;
+    decision: "allow" | "deny";
+    timestamp: number;
+}
+export interface Channel {
+    name: string;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    sendText(text: string): Promise<void>;
+    sendToolStart(toolName: string, args: Record<string, unknown>): Promise<void>;
+    sendToolResult(toolName: string, output: string, isError: boolean): Promise<void>;
+    sendError(text: string): Promise<void>;
+    onUserMessage(handler: (msg: string) => Promise<void>): void;
+    requestApproval(request: ApprovalRequest): Promise<ApprovalResponse>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/channels/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/channels/types.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,aAAa,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7D,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACtE"}

package/dist/channels/types.js

@@ -0,0 +1,4 @@
+// ============================================================
+// 轻灵 - Channel 接口
+// ============================================================
+export {};

package/dist/cli/bootstrap.d.ts

@@ -0,0 +1,39 @@
+export type BootstrapBrowserMode = "auto" | "with" | "none";
+export type BootstrapProfile = "minimal" | "dev";
+export interface BootstrapArgs {
+    yes: boolean;
+    browser: BootstrapBrowserMode;
+    profile: BootstrapProfile;
+}
+export interface BootstrapReportInput {
+    args: BootstrapArgs;
+    env?: Record<string, string | undefined>;
+    stateDir?: string;
+    nodeVersion?: string;
+    npmVersion?: string;
+}
+export interface BootstrapReport {
+    profile: BootstrapProfile;
+    stateDir: string;
+    nodeVersion: string;
+    npmVersion: string;
+    apiKeyConfigured: boolean;
+    browserMode: BootstrapBrowserMode;
+    advancedDefaults: {
+        dashboard: boolean;
+        semanticMemory: boolean;
+        dynamicDiscovery: boolean;
+    };
+    nextSteps: string[];
+    plaintextSecretFiles: string[];
+}
+export declare function parseBootstrapArgs(args: string[]): BootstrapArgs;
+export declare function buildBootstrapReport(input: BootstrapReportInput): BootstrapReport;
+export declare function formatBootstrapReport(report: BootstrapReport): string[];
+export declare function runBootstrap(rawArgs: string[], options: {
+    setupRunner: () => Promise<void>;
+    doctorRunner: () => Promise<string[]>;
+    stateDir?: string;
+    npmVersion?: string;
+}): Promise<void>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/cli/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/cli/bootstrap.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,KAAK,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,oBAAoB,CAAC;IAC9B,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,aAAa,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,oBAAoB,CAAC;IAClC,gBAAgB,EAAE;QAChB,SAAS,EAAE,OAAO,CAAC;QACnB,cAAc,EAAE,OAAO,CAAC;QACxB,gBAAgB,EAAE,OAAO,CAAC;KAC3B,CAAC;IACF,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAcD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAShE;AAUD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe,CAuCjF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,CA6BvE;AAeD,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE;IACP,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACA,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/cli/bootstrap.js

@@ -0,0 +1,138 @@
+import * as fs from "fs/promises";
+import { execFileSync } from "child_process";
+import * as os from "os";
+import * as path from "path";
+import * as readline from "readline/promises";
+import { stdin as input, stdout as output } from "process";
+import { scanRuntimeDotEnvSecrets } from "../config.js";
+import { getLocalizedText } from "../i18n/index.js";
+function readNpmVersion() {
+    try {
+        return execFileSync("npm", ["--version"], { encoding: "utf8", shell: process.platform === "win32" }).trim() || "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+function normalizeProfile(value) {
+    return value === "dev" ? "dev" : "minimal";
+}
+export function parseBootstrapArgs(args) {
+    return args.reduce((acc, arg, index) => {
+        if (arg === "--yes" || arg === "-y")
+            return { ...acc, yes: true };
+        if (arg === "--with-browser")
+            return { ...acc, browser: "with" };
+        if (arg === "--no-browser")
+            return { ...acc, browser: "none" };
+        if (arg === "--profile")
+            return { ...acc, profile: normalizeProfile(args[index + 1]) };
+        if (arg.startsWith("--profile="))
+            return { ...acc, profile: normalizeProfile(arg.slice("--profile=".length)) };
+        return acc;
+    }, { yes: false, browser: "auto", profile: "minimal" });
+}
+function hasApiKey(env) {
+    return Boolean(env.QLING_LLM_API_KEY?.trim() ||
+        env.DEEPSEEK_API_KEY?.trim() ||
+        env.OPENAI_API_KEY?.trim());
+}
+export function buildBootstrapReport(input) {
+    const env = input.env ?? process.env;
+    const text = getLocalizedText();
+    const stateDir = input.stateDir ?? path.join(os.homedir(), ".qling");
+    const apiKeyConfigured = hasApiKey(env);
+    const nextSteps = [
+        apiKeyConfigured ? "运行 `qling` 进入 TUI。" : "运行 `qling setup` 配置 Provider / Model / Endpoint，再按提示把 API key 写入系统环境变量。",
+        "运行 `qling doctor` 查看本地诊断。",
+        "在 TUI 输入 `/` 打开命令面板，输入 `/privacy` 查看本地边界。",
+    ];
+    if (!apiKeyConfigured) {
+        nextSteps.push(text.boundaries.setupSecret);
+        nextSteps.push(text.setup.windowsEnvExample);
+    }
+    if (input.args.browser !== "with") {
+        nextSteps.push("如需浏览器抓取能力，重新运行 `qling bootstrap --with-browser`。");
+    }
+    if (input.args.profile === "dev") {
+        nextSteps.push("dev profile 仅提示 dashboard / semantic / discovery 等高级能力；默认不自动开启。");
+    }
+    return {
+        profile: input.args.profile,
+        stateDir,
+        nodeVersion: input.nodeVersion ?? process.versions.node,
+        npmVersion: input.npmVersion ?? "unknown",
+        apiKeyConfigured,
+        browserMode: input.args.browser,
+        advancedDefaults: {
+            dashboard: false,
+            semanticMemory: false,
+            dynamicDiscovery: false,
+        },
+        nextSteps,
+        plaintextSecretFiles: [],
+    };
+}
+export function formatBootstrapReport(report) {
+    const secretNote = [];
+    if (report.plaintextSecretFiles && report.plaintextSecretFiles.length > 0) {
+        secretNote.push("");
+        secretNote.push("⚠️  检测到 .env 中包含明文密钥（仅路径）：");
+        report.plaintextSecretFiles.forEach((f) => secretNote.push(`    ${f}`));
+        secretNote.push("   请轮换密钥并迁移至系统环境变量。");
+    }
+    return [
+        "",
+        "🚀 轻灵 Bootstrap（本机一键启动）",
+        "-----------------------------------------",
+        `Profile   : ${report.profile}`,
+        `Node      : v${report.nodeVersion}`,
+        `npm       : ${report.npmVersion}`,
+        `State     : ${report.stateDir}`,
+        `API key   : ${report.apiKeyConfigured ? "system env set(redacted)" : "missing"}`,
+        `Browser   : ${report.browserMode === "with" ? "install requested" : report.browserMode === "none" ? "skipped" : "optional"}`,
+        `Advanced  : dashboard=${report.advancedDefaults.dashboard} semantic=${report.advancedDefaults.semanticMemory} discovery=${report.advancedDefaults.dynamicDiscovery}`,
+        ...secretNote,
+        "",
+        "Next steps:",
+        ...report.nextSteps.map((step) => `- ${step}`),
+        "-----------------------------------------",
+        "说明: bootstrap 只做本机初始化和诊断引导；不上传数据、不调用模型。",
+        `边界: ${getLocalizedText().boundaries.localNoModel}`,
+        "",
+    ];
+}
+async function maybeRunSetup(args, report, setupRunner) {
+    if (report.apiKeyConfigured || args.yes || !input.isTTY)
+        return;
+    const rl = readline.createInterface({ input, output });
+    try {
+        const answer = await rl.question("检测到 API key 未配置。是否先运行 qling setup 配置 Provider/模型? (Y/n): ");
+        if (answer.trim().toLowerCase() !== "n") {
+            await setupRunner();
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function runBootstrap(rawArgs, options) {
+    const args = parseBootstrapArgs(rawArgs);
+    const stateDir = options.stateDir ?? path.join(os.homedir(), ".qling");
+    await fs.mkdir(stateDir, { recursive: true });
+    let report = buildBootstrapReport({
+        args,
+        stateDir,
+        npmVersion: options.npmVersion ?? readNpmVersion(),
+    });
+    // Async secret file scan for bootstrap (best effort, names only)
+    try {
+        const hits = await scanRuntimeDotEnvSecrets(stateDir);
+        const files = Array.from(new Set(hits.map((h) => h.file)));
+        report = { ...report, plaintextSecretFiles: files };
+    }
+    catch { }
+    console.log(formatBootstrapReport(report).join("\n"));
+    await maybeRunSetup(args, report, options.setupRunner);
+    console.log((await options.doctorRunner()).join("\n"));
+}

package/dist/cli/channel-bootstrap.d.ts

@@ -0,0 +1,23 @@
+import type { Channel } from "../channels/types.js";
+export type CliModeForChannel = "help" | "run" | "chat" | "repl";
+export interface ChannelConfigView {
+    default: string;
+    telegram: {
+        token: string;
+        poll_interval_ms: number;
+        allowed_chat_ids: string[];
+    };
+    slack: {
+        bot_token: string;
+        app_token: string;
+        channel_ids: string[];
+        poll_interval_ms: number;
+    };
+}
+export type CliChannelBootstrapErrorCode = "CLI_CHANNEL_MISSING_CREDENTIALS" | "CLI_INVALID_CHANNEL_DEFAULT" | "CLI_CHANNEL_INIT_FAILED";
+export declare class CliChannelBootstrapError extends Error {
+    code: CliChannelBootstrapErrorCode;
+    constructor(code: CliChannelBootstrapErrorCode, message: string);
+}
+export declare function resolveRunModeChannel(mode: CliModeForChannel, channels: ChannelConfigView): Channel | null;
+//# sourceMappingURL=channel-bootstrap.d.ts.map

package/dist/cli/channel-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-bootstrap.d.ts","sourceRoot":"","sources":["../../src/cli/channel-bootstrap.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;IACF,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,MAAM,4BAA4B,GACpC,iCAAiC,GACjC,6BAA6B,GAC7B,yBAAyB,CAAC;AAE9B,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,IAAI,EAAE,4BAA4B,CAAC;gBAEvB,IAAI,EAAE,4BAA4B,EAAE,OAAO,EAAE,MAAM;CAKhE;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,GAAG,IAAI,CA4ChB"}

package/dist/cli/channel-bootstrap.js

@@ -0,0 +1,46 @@
+import { ConsoleChannel } from "../channels/console-channel.js";
+import { SlackChannel } from "../channels/slack-channel.js";
+import { TelegramChannel } from "../channels/telegram-channel.js";
+export class CliChannelBootstrapError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "CliChannelBootstrapError";
+        this.code = code;
+    }
+}
+export function resolveRunModeChannel(mode, channels) {
+    if (mode !== "run") {
+        return null;
+    }
+    const channelDefault = String(channels.default ?? "").trim().toLowerCase();
+    switch (channelDefault) {
+        case "console":
+            return new ConsoleChannel();
+        case "telegram": {
+            const token = String(channels.telegram.token ?? "").trim();
+            if (!token) {
+                throw new CliChannelBootstrapError("CLI_CHANNEL_MISSING_CREDENTIALS", "channels.telegram.token is required when channels.default=telegram");
+            }
+            return new TelegramChannel({
+                token,
+                pollIntervalMs: channels.telegram.poll_interval_ms,
+                allowedChatIds: channels.telegram.allowed_chat_ids,
+            });
+        }
+        case "slack": {
+            const botToken = String(channels.slack.bot_token ?? "").trim();
+            if (!botToken) {
+                throw new CliChannelBootstrapError("CLI_CHANNEL_MISSING_CREDENTIALS", "channels.slack.bot_token is required when channels.default=slack");
+            }
+            return new SlackChannel({
+                botToken,
+                appToken: channels.slack.app_token,
+                channelIds: channels.slack.channel_ids,
+                pollIntervalMs: channels.slack.poll_interval_ms,
+            });
+        }
+        default:
+            throw new CliChannelBootstrapError("CLI_INVALID_CHANNEL_DEFAULT", `unsupported channels.default: ${channels.default}`);
+    }
+}

package/dist/cli/daemon-control.d.ts

@@ -0,0 +1,31 @@
+export interface DaemonControlOptions {
+    stateDir: string;
+    port: number;
+    daemonEntry: string;
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    waitMs?: number;
+}
+export interface DaemonStatus {
+    running: boolean;
+    healthy: boolean;
+    managed: boolean;
+    stalePidFile: boolean;
+    pid: number | null;
+    port: number;
+    pidFile: string;
+    logFile: string;
+    health: Record<string, unknown> | null;
+}
+export interface StartDaemonResult {
+    started: boolean;
+    status: DaemonStatus;
+}
+export interface StopDaemonResult {
+    stopped: boolean;
+    status: DaemonStatus;
+}
+export declare function getDaemonStatus(options: DaemonControlOptions): Promise<DaemonStatus>;
+export declare function startDaemon(options: DaemonControlOptions): Promise<StartDaemonResult>;
+export declare function stopDaemon(options: DaemonControlOptions): Promise<StopDaemonResult>;
+//# sourceMappingURL=daemon-control.d.ts.map

package/dist/cli/daemon-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-control.d.ts","sourceRoot":"","sources":["../../src/cli/daemon-control.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,CAoB1F;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmD3F;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAqBzF"}

package/dist/cli/daemon-control.js

@@ -0,0 +1,177 @@
+import axios from "axios";
+import * as fs from "fs";
+import * as fsp from "fs/promises";
+import * as path from "path";
+import { spawn, spawnSync } from "child_process";
+const HEALTH_POLL_INTERVAL_MS = 150;
+export async function getDaemonStatus(options) {
+    await fsp.mkdir(options.stateDir, { recursive: true });
+    const pidFile = getPidFile(options.stateDir);
+    const logFile = getLogFile(options.stateDir);
+    const pid = await readPid(pidFile);
+    const pidAlive = pid !== null ? isProcessAlive(pid) : false;
+    const probe = await probeHealth(options.port);
+    return {
+        running: pidAlive || probe.healthy,
+        healthy: probe.healthy,
+        managed: pid !== null,
+        stalePidFile: pid !== null && !pidAlive,
+        pid,
+        port: options.port,
+        pidFile,
+        logFile,
+        health: probe.payload,
+    };
+}
+export async function startDaemon(options) {
+    await fsp.mkdir(options.stateDir, { recursive: true });
+    const pidFile = getPidFile(options.stateDir);
+    const logFile = getLogFile(options.stateDir);
+    const status = await getDaemonStatus(options);
+    if (status.healthy) {
+        return { started: false, status };
+    }
+    if (status.running && status.managed && !status.stalePidFile) {
+        return { started: false, status };
+    }
+    if (status.stalePidFile) {
+        await removeIfExists(pidFile);
+    }
+    const logFd = fs.openSync(logFile, "a");
+    const child = spawn(process.execPath, [options.daemonEntry], {
+        cwd: options.cwd,
+        env: {
+            ...options.env,
+            QLING_FILE_STATE_DIR: options.stateDir,
+            QLING_DAEMON_PORT: String(options.port),
+        },
+        detached: true,
+        stdio: ["ignore", logFd, logFd],
+        windowsHide: true,
+    });
+    child.unref();
+    fs.closeSync(logFd);
+    if (!child.pid) {
+        throw new Error("failed to spawn daemon process");
+    }
+    await fsp.writeFile(pidFile, `${child.pid}\n`, "utf-8");
+    const waitMs = options.waitMs ?? 10_000;
+    const started = await waitForHealthy(options.port, waitMs);
+    if (!started) {
+        await terminateProcess(child.pid);
+        await removeIfExists(pidFile);
+        throw new Error(`daemon did not become healthy within ${waitMs}ms`);
+    }
+    return {
+        started: true,
+        status: await getDaemonStatus(options),
+    };
+}
+export async function stopDaemon(options) {
+    const status = await getDaemonStatus(options);
+    if (status.pid === null) {
+        return {
+            stopped: false,
+            status,
+        };
+    }
+    if (isProcessAlive(status.pid)) {
+        await terminateProcess(status.pid);
+    }
+    await waitForDown(options.port, options.waitMs ?? 10_000);
+    await removeIfExists(status.pidFile);
+    return {
+        stopped: true,
+        status: await getDaemonStatus(options),
+    };
+}
+function getPidFile(stateDir) {
+    return path.join(stateDir, "daemon.pid");
+}
+function getLogFile(stateDir) {
+    return path.join(stateDir, "daemon.log");
+}
+async function readPid(pidFile) {
+    try {
+        const raw = await fsp.readFile(pidFile, "utf-8");
+        const pid = Number(raw.trim());
+        return Number.isInteger(pid) && pid > 0 ? pid : null;
+    }
+    catch {
+        return null;
+    }
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function probeHealth(port) {
+    try {
+        const response = await axios.get(`http://127.0.0.1:${port}/health`, {
+            timeout: 800,
+            validateStatus: () => true,
+        });
+        if (response.status >= 200 && response.status < 300 && response.data && typeof response.data === "object") {
+            return {
+                healthy: true,
+                payload: response.data,
+            };
+        }
+        return { healthy: false, payload: null };
+    }
+    catch {
+        return { healthy: false, payload: null };
+    }
+}
+async function waitForHealthy(port, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const probe = await probeHealth(port);
+        if (probe.healthy) {
+            return true;
+        }
+        await sleep(HEALTH_POLL_INTERVAL_MS);
+    }
+    return false;
+}
+async function waitForDown(port, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const probe = await probeHealth(port);
+        if (!probe.healthy) {
+            return;
+        }
+        await sleep(HEALTH_POLL_INTERVAL_MS);
+    }
+}
+async function terminateProcess(pid) {
+    try {
+        process.kill(pid, "SIGTERM");
+    }
+    catch {
+        if (process.platform === "win32") {
+            spawnSync("taskkill", ["/PID", String(pid), "/T", "/F"], { stdio: "ignore", windowsHide: true });
+            return;
+        }
+        throw new Error(`failed to terminate daemon pid ${pid}`);
+    }
+    if (process.platform === "win32" && isProcessAlive(pid)) {
+        spawnSync("taskkill", ["/PID", String(pid), "/T", "/F"], { stdio: "ignore", windowsHide: true });
+    }
+}
+async function removeIfExists(filePath) {
+    try {
+        await fsp.rm(filePath, { force: true });
+    }
+    catch {
+        // ignore
+    }
+}
+async function sleep(ms) {
+    await new Promise((resolve) => setTimeout(resolve, ms));
+}

package/dist/cli/guidance-panel.d.ts

@@ -0,0 +1,11 @@
+export interface LocalGuidancePanelInput {
+    title: string;
+    reason: string;
+    next: string;
+    example: string;
+    boundary?: string;
+    localExecution?: boolean;
+    modelCall?: boolean;
+}
+export declare function formatLocalGuidancePanel(input: LocalGuidancePanelInput): string;
+//# sourceMappingURL=guidance-panel.d.ts.map

package/dist/cli/guidance-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidance-panel.d.ts","sourceRoot":"","sources":["../../src/cli/guidance-panel.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAe/E"}

package/dist/cli/guidance-panel.js

@@ -0,0 +1,16 @@
+import { getLocalizedText } from "../i18n/index.js";
+export function formatLocalGuidancePanel(input) {
+    const t = getLocalizedText();
+    const localExecution = input.localExecution ?? true;
+    const modelCall = input.modelCall ?? false;
+    const boundary = input.boundary ?? t.boundaries.localNoModel;
+    return [
+        input.title,
+        `${t.labels.reason}: ${input.reason}`,
+        `${t.labels.next}: ${input.next}`,
+        `${t.labels.example}: ${input.example}`,
+        `${t.labels.localExecution}: ${localExecution ? t.labels.yes : t.labels.no}`,
+        `${t.labels.modelCall}: ${modelCall ? t.labels.yes : t.labels.no}`,
+        `${t.labels.boundary}: ${boundary}`,
+    ].join("\n");
+}

package/dist/cli/mcp-control.d.ts

@@ -0,0 +1,7 @@
+import type { QlingConfig } from "../config.js";
+export declare function handleMcpCli(subArgs: string[], options: {
+    mcpConfig: QlingConfig["mcp"];
+    env?: Record<string, string | undefined>;
+    stateDir?: string;
+}): Promise<number>;
+//# sourceMappingURL=mcp-control.d.ts.map

package/dist/cli/mcp-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-control.d.ts","sourceRoot":"","sources":["../../src/cli/mcp-control.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE;IACP,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,MAAM,CAAC,CAmGjB"}