@qlingzzy/qling 1.0.0

package/dist/cli/mcp-control.js

@@ -0,0 +1,119 @@
+// ============================================================
+// 轻灵 - 顶层 qling mcp 子命令
+// ============================================================
+import { formatMcpPresetTable, getMcpPreset, listMcpPresets, } from "../mcp/presets.js";
+import { addMcpPresetToStore, defaultMcpStorePath, loadMcpStore, removeMcpFromStore, } from "../mcp/store.js";
+import { buildLocalMcpReport, formatLocalMcpReport } from "../mcp-report.js";
+export async function handleMcpCli(subArgs, options) {
+    const env = options.env ?? process.env;
+    const [subRaw, ...rest] = subArgs;
+    const sub = (subRaw ?? "status").toLowerCase();
+    if (sub === "help" || sub === "-h" || sub === "--help") {
+        printHelp();
+        return 0;
+    }
+    if (sub === "presets" || sub === "preset" || sub === "ls-presets") {
+        console.log("");
+        console.log("可用 MCP 预设（qling mcp add <id>）:");
+        console.log("-----------------------------------------");
+        for (const line of formatMcpPresetTable()) {
+            console.log(line);
+        }
+        console.log("-----------------------------------------");
+        console.log("说明: 预设使用 npx 拉取社区包；首次运行需网络。");
+        console.log("");
+        return 0;
+    }
+    if (sub === "list" || sub === "ls") {
+        const store = await loadMcpStore(defaultMcpStorePath(options.stateDir));
+        const names = Object.keys(store.servers).sort();
+        console.log("");
+        console.log("本机 MCP store (~/.qling/mcp-servers.json):");
+        console.log("-----------------------------------------");
+        if (names.length === 0) {
+            console.log("(空) 使用 qling mcp add <preset> 添加");
+        }
+        else {
+            for (const name of names) {
+                const s = store.servers[name];
+                console.log(`- ${name}: enabled=${s.enabled} transport=${s.transport ?? "stdio"} command=${s.command} preset=${s.preset ?? "-"}`);
+            }
+        }
+        console.log("-----------------------------------------");
+        console.log("");
+        return 0;
+    }
+    if (sub === "add") {
+        const presetId = rest[0];
+        if (!presetId) {
+            console.error("用法: qling mcp add <preset> [--name <serverName>]");
+            return 2;
+        }
+        let name;
+        for (let i = 1; i < rest.length; i++) {
+            if (rest[i] === "--name" && rest[i + 1]) {
+                name = rest[i + 1];
+                i++;
+            }
+            else if (rest[i]?.startsWith("--name=")) {
+                name = rest[i].slice("--name=".length);
+            }
+        }
+        if (!getMcpPreset(presetId)) {
+            console.error(`未知预设 '${presetId}'。运行: qling mcp presets`);
+            return 2;
+        }
+        const result = await addMcpPresetToStore(presetId, {
+            name,
+            stateDir: options.stateDir,
+        });
+        console.log(result.ok ? `✅ ${result.message}` : `❌ ${result.message}`);
+        return result.ok ? 0 : 1;
+    }
+    if (sub === "remove" || sub === "rm" || sub === "delete") {
+        const name = rest[0];
+        if (!name) {
+            console.error("用法: qling mcp remove <serverName>");
+            return 2;
+        }
+        const result = await removeMcpFromStore(name, { stateDir: options.stateDir });
+        console.log(result.ok ? `✅ ${result.message}` : `❌ ${result.message}`);
+        return result.ok ? 0 : 1;
+    }
+    // status / default: 合并后的可见配置摘要（env 优先）
+    const store = await loadMcpStore(defaultMcpStorePath(options.stateDir));
+    const report = buildLocalMcpReport({
+        ...options.mcpConfig,
+        servers: {
+            ...store.servers,
+            ...options.mcpConfig.servers,
+        },
+    }, env);
+    console.log(formatLocalMcpReport(report).join("\n"));
+    if (Object.keys(store.servers).length > 0) {
+        console.log(`(store: ${defaultMcpStorePath(options.stateDir)}; presets: ${listMcpPresets().length})`);
+    }
+    return 0;
+}
+function printHelp() {
+    console.log(`
+qling mcp — 本地 MCP 配置
+
+用法:
+  qling mcp                 # 状态摘要（config + store）
+  qling mcp status
+  qling mcp list            # 仅本机 store
+  qling mcp presets         # 可用预设
+  qling mcp add <preset> [--name <serverName>]
+  qling mcp remove <name>
+
+预设示例:
+  qling mcp add filesystem
+  qling mcp add memory
+
+边界:
+  - 配置写入 ~/.qling/mcp-servers.json
+  - 不保存 API 密钥
+  - 首次 npx 拉取可能需要网络
+`);
+}

package/dist/cli/mission-views.d.ts

@@ -0,0 +1,13 @@
+import type { Mission, MissionEvent, MissionStatus } from "../mission/types.js";
+interface MissionReader {
+    getMission: () => Promise<Mission>;
+    getLogs: () => Promise<MissionEvent[]>;
+}
+export declare function isTerminalMissionStatus(status: MissionStatus): boolean;
+export declare function renderAgentsView(missions: Mission[]): string;
+export declare function renderMissionEvents(events: MissionEvent[]): string;
+export declare function followMissionAttach(missionId: string, reader: MissionReader, options?: {
+    pollMs?: number;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=mission-views.d.ts.map

package/dist/cli/mission-views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-views.d.ts","sourceRoot":"","sources":["../../src/cli/mission-views.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMhF,UAAU,aAAa;IACrB,UAAU,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO,EAAE,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACxC;AAMD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAEtE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CA2B5D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAGlE;AAED,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CAAC,IAAI,CAAC,CA6Bf"}

package/dist/cli/mission-views.js

@@ -0,0 +1,82 @@
+const TERMINAL_STATUSES = new Set(["succeeded", "failed", "canceled"]);
+function formatTimestamp(value) {
+    return new Date(value).toLocaleString();
+}
+export function isTerminalMissionStatus(status) {
+    return TERMINAL_STATUSES.has(status);
+}
+export function renderAgentsView(missions) {
+    const buckets = {
+        Working: [],
+        "Needs Input": [],
+        Completed: [],
+    };
+    for (const mission of missions) {
+        buckets[classifyMissionBucket(mission.status)].push(mission);
+    }
+    const lines = ["📂 【Agents】"];
+    for (const bucket of ["Working", "Needs Input", "Completed"]) {
+        lines.push(`\n${bucket}`);
+        lines.push("-----------------------------------------");
+        const items = buckets[bucket].sort((a, b) => b.createdAt - a.createdAt);
+        if (items.length === 0) {
+            lines.push("(无)");
+            continue;
+        }
+        for (const mission of items) {
+            lines.push(`- [${mission.status.toUpperCase()}] ${mission.id} | ${mission.name}`);
+            lines.push(`  时间: ${formatTimestamp(mission.createdAt)}`);
+            lines.push(`  任务: ${mission.description.slice(0, 80)}`);
+        }
+    }
+    return lines.join("\n");
+}
+export function renderMissionEvents(events) {
+    if (events.length === 0)
+        return "(无日志)";
+    return events.map(renderMissionEvent).join("\n");
+}
+export async function followMissionAttach(missionId, reader, options = {}) {
+    const pollMs = options.pollMs ?? 500;
+    let lastStatus = null;
+    let lastEventCount = 0;
+    console.log(`🔗 以只读跟随模式 attach 到使命 ${missionId}`);
+    console.log("提示: 这不是交互式接管，只会持续打印新增日志与状态变化。\n");
+    while (true) {
+        const [mission, logs] = await Promise.all([reader.getMission(), reader.getLogs()]);
+        if (mission.status !== lastStatus) {
+            console.log(`[status] ${mission.status} @ ${formatTimestamp(mission.updatedAt)}`);
+            lastStatus = mission.status;
+        }
+        if (logs.length > lastEventCount) {
+            const newEvents = logs.slice(lastEventCount);
+            console.log(renderMissionEvents(newEvents));
+            lastEventCount = logs.length;
+        }
+        if (isTerminalMissionStatus(mission.status)) {
+            console.log(`\n✅ attach 结束，最终状态: ${mission.status}`);
+            return;
+        }
+        await sleep(pollMs);
+    }
+}
+function classifyMissionBucket(status) {
+    if (status === "queued" || status === "running")
+        return "Working";
+    if (status === "blocked" || status === "paused")
+        return "Needs Input";
+    return "Completed";
+}
+function renderMissionEvent(event) {
+    const timestamp = formatTimestamp(event.timestamp);
+    if (event.type === "state_changed") {
+        return `[${timestamp}] state ${String(event.data.from ?? "null")} -> ${String(event.data.to)}`;
+    }
+    if (event.type === "control") {
+        return `[${timestamp}] control ${String(event.data.action)} from ${String(event.data.from)} reason=${String(event.data.reason ?? "")}`;
+    }
+    return `[${timestamp}] log ${String(event.data.message ?? "")}`;
+}
+async function sleep(ms) {
+    await new Promise((resolve) => setTimeout(resolve, ms));
+}

package/dist/cli/setup.d.ts

@@ -0,0 +1,9 @@
+export interface SetupEnvInput {
+    provider: string;
+    endpoint: string;
+    model: string;
+}
+export declare function buildSetupEnvLines(input: SetupEnvInput): string[];
+export declare function formatSetupApiKeyInstructions(keyProvided: boolean): string[];
+export declare function runSetup(): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,EAAE,CAMjE;AAED,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,EAAE,CAY5E;AAED,wBAAsB,QAAQ,kBA2H7B"}

package/dist/cli/setup.js

@@ -0,0 +1,140 @@
+// ============================================================
+// 轻灵 - 初始配置向导 (v0.3)
+// 提供交互式命令行，快速配置国内主流 LLM Provider
+// ============================================================
+import * as readline from "readline/promises";
+import { stdin as input, stdout as output } from "process";
+import * as fs from "fs/promises";
+import * as path from "path";
+import * as os from "os";
+import { getLocalizedText } from "../i18n/index.js";
+import { getProviderPreset, listProviderPresets } from "../providers/presets.js";
+export function buildSetupEnvLines(input) {
+    return [
+        `QLING_LLM_PROVIDER=${input.provider}`,
+        `QLING_LLM_ENDPOINT=${input.endpoint}`,
+        `QLING_LLM_MODEL=${input.model}`,
+    ];
+}
+export function formatSetupApiKeyInstructions(keyProvided) {
+    const t = getLocalizedText();
+    const lines = [
+        "",
+        keyProvided ? t.setup.keyNotSaved : t.setup.keyNotConfigured,
+        t.setup.windowsPowershellPersistent,
+        `  ${t.setup.windowsEnvExample}`,
+        t.setup.windowsPowershellTemp,
+        "  $env:QLING_LLM_API_KEY='<your-key>'",
+        t.setup.keyEnvNote,
+    ];
+    return lines;
+}
+export async function runSetup() {
+    const rl = readline.createInterface({ input, output });
+    const t = getLocalizedText();
+    console.log("\n=========================================");
+    console.log(t.setup.title);
+    console.log("=========================================\n");
+    console.log(t.setup.quickPath);
+    console.log("\n" + t.setup.chooseProvider);
+    const providerList = t.setup.providers;
+    console.log("1. " + providerList["1"]);
+    console.log("2. " + providerList["2"]);
+    console.log("3. " + providerList["3"]);
+    console.log("4. " + providerList["4"]);
+    console.log("5. " + providerList["5"]);
+    console.log("6. " + providerList["6"]);
+    console.log("7. " + providerList["7"]);
+    console.log("8. " + providerList["8"]);
+    console.log("9. " + providerList["9"]);
+    console.log("10. " + providerList["10"]);
+    console.log("11. " + providerList["11"]);
+    const choice = (await rl.question("\n您的选择 [默认: 1]: ")).trim() || "1";
+    const orderedPresets = listProviderPresets();
+    const customChoice = String(orderedPresets.length + 1);
+    let pName = "";
+    let pEndpoint = "";
+    let pModel = "";
+    let selectedPreset = getProviderPreset(choice);
+    if (choice === customChoice || !selectedPreset) {
+        pName = (await rl.question(t.setup.customPrompts.providerName)).trim() || "custom";
+        pEndpoint = (await rl.question(t.setup.customPrompts.endpoint)).trim();
+        pModel = (await rl.question(t.setup.customPrompts.model)).trim();
+        selectedPreset = undefined;
+    }
+    else {
+        pName = selectedPreset.provider;
+        const epPrompt = (t.setup.configEndpointPrompt || "配置 Endpoint URL [默认: {endpoint}]: ").replace("{endpoint}", selectedPreset.endpoint);
+        const modelPrompt = (t.setup.configModelPrompt || "配置 Model 名称 [默认: {model}]: ").replace("{model}", selectedPreset.model);
+        pEndpoint = (await rl.question(epPrompt)).trim() || selectedPreset.endpoint;
+        pModel = (await rl.question(modelPrompt)).trim() || selectedPreset.model;
+    }
+    const keyHint = selectedPreset?.keyHint ? ` (${selectedPreset.keyHint})` : "";
+    const apiKey = await rl.question(`${getLocalizedText().setup.keyPrompt}${keyHint}: `);
+    const key = apiKey.trim();
+    console.log("\n" + t.setup.summaryHeader);
+    console.log(`Provider : ${pName}`);
+    console.log(`Endpoint : ${pEndpoint}`);
+    console.log(`Model    : ${pModel}`);
+    console.log(`API Key  : ${key ? "未保存到 .env（请配置系统环境变量）" : "(未配置)"}`);
+    console.log(t.setup.summaryFooter);
+    const confirm = await rl.question(t.setup.confirmSave);
+    if (confirm.trim().toLowerCase() === 'n') {
+        console.log(t.setup.canceled);
+        rl.close();
+        return;
+    }
+    // 构造环境变量内容
+    const envLines = buildSetupEnvLines({
+        provider: pName,
+        endpoint: pEndpoint,
+        model: pModel,
+    });
+    const advanced = await rl.question("\n" + t.setup.advancedPrompt);
+    if (advanced.trim().toLowerCase() === "y") {
+        const useForVision = await rl.question(t.setup.advanced.vision);
+        if (useForVision.trim().toLowerCase() === "y") {
+            envLines.push(`QLING_VISION_PROVIDER=${pName}`);
+            envLines.push(`QLING_VISION_MODEL=${pModel}`);
+            envLines.push(`QLING_VISION_ENDPOINT=${pEndpoint}`);
+        }
+        const enableDashboard = await rl.question(t.setup.advanced.dashboard);
+        if (enableDashboard.trim().toLowerCase() === "y") {
+            envLines.push("QLING_FEATURES_DASHBOARD=true");
+            envLines.push("QLING_METRICS_ENABLED=true");
+            const port = await rl.question(t.setup.advanced.dashboardPort);
+            if (port.trim())
+                envLines.push(`QLING_DASHBOARD_PORT=${port.trim()}`);
+        }
+        const enableSemantic = await rl.question(t.setup.advanced.semantic);
+        if (enableSemantic.trim().toLowerCase() === "y") {
+            envLines.push("QLING_FEATURES_SEMANTIC_MEMORY=true");
+        }
+        const enableWorkflow = await rl.question(t.setup.advanced.workflow);
+        if (enableWorkflow.trim().toLowerCase() === "y") {
+            envLines.push("QLING_FEATURES_WORKFLOW_RUNTIME=true");
+        }
+        const enableSpecBoost = await rl.question(t.setup.advanced.specBoost);
+        if (enableSpecBoost.trim().toLowerCase() === "y") {
+            envLines.push("QLING_FEATURES_TOOL_SPEC_BOOST=true");
+        }
+        const enableDiscovery = await rl.question(t.setup.advanced.discovery);
+        if (enableDiscovery.trim().toLowerCase() === "y") {
+            envLines.push("QLING_FEATURES_DYNAMIC_DISCOVERY=true");
+        }
+    }
+    const globalEnvPath = path.join(os.homedir(), ".qling", ".env");
+    await fs.mkdir(path.dirname(globalEnvPath), { recursive: true });
+    await fs.writeFile(globalEnvPath, envLines.join("\n") + "\n", "utf-8");
+    console.log(`\n${t.setup.savedTo}${globalEnvPath}`);
+    for (const line of formatSetupApiKeyInstructions(Boolean(key))) {
+        console.log(line);
+    }
+    console.log(t.setup.summaryFooter);
+    console.log(t.setup.nextStepsHeader);
+    for (const s of t.setup.nextSteps) {
+        console.log(s);
+    }
+    console.log(t.setup.summaryFooter);
+    rl.close();
+}

package/dist/cli/startup-contract.d.ts

@@ -0,0 +1,23 @@
+import type { CliGlobalOptions } from "../config.js";
+export type CliMode = "help" | "version" | "run" | "chat" | "repl" | "workflow" | "memory" | "dashboard" | "discovery" | "setup" | "bootstrap" | "mission" | "daemon" | "agents" | "logs" | "doctor" | "status" | "storage" | "exports" | "sessions" | "checkpoint" | "tasks" | "goal" | "privacy" | "context" | "shortcuts" | "statusline" | "recap" | "permissions" | "config" | "mcp" | "hooks" | "knowledge" | "connect";
+/** 打印给 stdout 的版本行（qling/1.0.0） */
+export declare function buildVersionText(binName?: string): string;
+export interface CliResolutionOk {
+    kind: "ok";
+    mode: CliMode;
+    task?: string;
+    subArgs: string[];
+    global: CliGlobalOptions;
+    warnings: string[];
+}
+export interface CliResolutionErr {
+    kind: "error";
+    code: "CLI_INVALID_MODE_COMBINATION" | "CLI_MISSING_TASK" | "CLI_INVALID_OPTION_VALUE" | "CLI_UNKNOWN_COMMAND_SUGGESTION";
+    message: string;
+    exitCode: 2;
+}
+export type CliResolution = CliResolutionOk | CliResolutionErr;
+export declare function formatCliError(code: string, message: string): string;
+export declare function parseCliArgs(args: string[]): CliResolution;
+export declare function buildHelpText(binName?: string, topic?: string): string;
+//# sourceMappingURL=startup-contract.d.ts.map

package/dist/cli/startup-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-contract.d.ts","sourceRoot":"","sources":["../../src/cli/startup-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAMrD,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;AAiF7Z,mCAAmC;AACnC,wBAAgB,gBAAgB,CAAC,OAAO,SAAU,GAAG,MAAM,CAE1D;AAyFD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EACA,8BAA8B,GAC9B,kBAAkB,GAClB,0BAA0B,GAC1B,gCAAgC,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,CAAC,CAAC;CACb;AAED,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAE/D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAYpE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAiX1D;AAED,wBAAgB,aAAa,CAAC,OAAO,SAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAkHvE"}