@qlingzzy/qling 1.0.0

package/dist/mcp/stdio-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-transport.d.ts","sourceRoot":"","sources":["../../src/mcp/stdio-transport.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;AACvD,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;AAChD,MAAM,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC;AAEtC,qBAAa,cAAc;IASvB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,GAAG,CAAC;IAVd,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,YAAY,CAAgB;gBAG1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,YAAA;IAmChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,IAAI,OAAO;IAIlB,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAO3B,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIxC,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAIpC,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAI9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,OAAO,CAAC,aAAa;CAetB"}

package/dist/mcp/stdio-transport.js

@@ -0,0 +1,92 @@
+// ============================================================
+// 轻灵 - MCP stdio transport
+// JSON-RPC 2.0 over stdin/stdout via child_process
+// ============================================================
+import { spawn } from "child_process";
+export class StdioTransport {
+    command;
+    args;
+    env;
+    proc = null;
+    buffer = "";
+    messageHandler = null;
+    errorHandler = null;
+    closeHandler = null;
+    spawnPromise;
+    constructor(command, args, env) {
+        this.command = command;
+        this.args = args;
+        this.env = env;
+        this.spawnPromise = new Promise((resolve, reject) => {
+            this.proc = spawn(this.command, this.args, {
+                stdio: ["pipe", "pipe", "pipe"],
+                env: { ...process.env, ...this.env },
+            });
+            this.proc.on("error", (err) => {
+                if (this.errorHandler)
+                    this.errorHandler(err);
+                reject(err);
+            });
+            this.proc.on("spawn", () => {
+                resolve();
+            });
+            // Fallback: if no spawn event within 1s, assume spawned
+            setTimeout(() => resolve(), 1000);
+            this.proc.stdout?.on("data", (chunk) => {
+                this.buffer += chunk.toString();
+                this.processBuffer();
+            });
+            this.proc.stderr?.on("data", (chunk) => {
+                process.stderr.write("[MCP:stdio] " + chunk.toString());
+            });
+            this.proc.on("close", () => {
+                if (this.closeHandler)
+                    this.closeHandler();
+            });
+        });
+    }
+    async ready() {
+        await this.spawnPromise;
+    }
+    isAlive() {
+        return this.proc !== null && !this.proc.killed && this.proc.stdin !== null && !this.proc.stdin.destroyed;
+    }
+    send(msg) {
+        if (!this.proc?.stdin || this.proc.stdin.destroyed) {
+            throw new Error("MCP stdin not available");
+        }
+        this.proc.stdin.write(JSON.stringify(msg) + "\n");
+    }
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    onError(handler) {
+        this.errorHandler = handler;
+    }
+    onClose(handler) {
+        this.closeHandler = handler;
+    }
+    async close() {
+        if (this.proc) {
+            this.proc.kill();
+            this.proc = null;
+        }
+    }
+    processBuffer() {
+        const lines = this.buffer.split("\n");
+        this.buffer = lines.pop() ?? "";
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const msg = JSON.parse(trimmed);
+                if (this.messageHandler)
+                    this.messageHandler(msg);
+            }
+            catch {
+                // skip malformed JSON
+            }
+        }
+    }
+}

package/dist/mcp/store.d.ts

@@ -0,0 +1,41 @@
+import type { McpPreset } from "./presets.js";
+export interface StoredMcpServer {
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+    enabled: boolean;
+    transport?: "stdio" | "http";
+    url?: string;
+    headers?: Record<string, string>;
+    /** 来源 preset id（若有） */
+    preset?: string;
+    addedAt?: string;
+}
+export interface McpStoreFile {
+    version: 1;
+    servers: Record<string, StoredMcpServer>;
+}
+export declare function defaultMcpStorePath(stateDir?: string): string;
+export declare function loadMcpStore(storePath?: string): Promise<McpStoreFile>;
+export declare function saveMcpStore(store: McpStoreFile, storePath?: string): Promise<string>;
+export declare function addMcpPresetToStore(presetId: string, options?: {
+    name?: string;
+    storePath?: string;
+    stateDir?: string;
+}): Promise<{
+    ok: boolean;
+    name: string;
+    message: string;
+    storePath: string;
+}>;
+export declare function removeMcpFromStore(name: string, options?: {
+    storePath?: string;
+    stateDir?: string;
+}): Promise<{
+    ok: boolean;
+    message: string;
+}>;
+/** 将 store 合并进 config.servers（不覆盖已有同名；env JSON 仍优先于调用方） */
+export declare function mergeMcpServers(base: Record<string, StoredMcpServer>, store: McpStoreFile): Record<string, StoredMcpServer>;
+export declare function presetToStored(preset: McpPreset): StoredMcpServer;
+//# sourceMappingURL=store.d.ts.map

package/dist/mcp/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/mcp/store.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED,wBAAsB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAkB5E;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,YAAY,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CASjB;AAED,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GACrE,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAqC5E;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAS3C;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACrC,KAAK,EAAE,YAAY,GAClB,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAEjC;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,eAAe,CAOjE"}

package/dist/mcp/store.js

@@ -0,0 +1,100 @@
+// ============================================================
+// 轻灵 - 本机 MCP server 配置存储 (~/.qling/mcp-servers.json)
+// ============================================================
+import { readFile, writeFile, mkdir } from "fs/promises";
+import { existsSync } from "fs";
+import * as os from "os";
+import * as path from "path";
+import { getMcpPreset } from "./presets.js";
+export function defaultMcpStorePath(stateDir) {
+    const root = stateDir
+        ? path.resolve(stateDir)
+        : path.join(os.homedir(), ".qling");
+    return path.join(root, "mcp-servers.json");
+}
+export async function loadMcpStore(storePath) {
+    const file = storePath ?? defaultMcpStorePath();
+    try {
+        if (!existsSync(file)) {
+            return { version: 1, servers: {} };
+        }
+        const raw = await readFile(file, "utf8");
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object" || !parsed.servers) {
+            return { version: 1, servers: {} };
+        }
+        return {
+            version: 1,
+            servers: parsed.servers ?? {},
+        };
+    }
+    catch {
+        return { version: 1, servers: {} };
+    }
+}
+export async function saveMcpStore(store, storePath) {
+    const file = storePath ?? defaultMcpStorePath();
+    await mkdir(path.dirname(file), { recursive: true });
+    const payload = {
+        version: 1,
+        servers: store.servers,
+    };
+    await writeFile(file, JSON.stringify(payload, null, 2) + "\n", "utf8");
+    return file;
+}
+export async function addMcpPresetToStore(presetId, options = {}) {
+    const preset = getMcpPreset(presetId);
+    const storePath = options.storePath ?? defaultMcpStorePath(options.stateDir);
+    if (!preset) {
+        return {
+            ok: false,
+            name: "",
+            message: `未知 MCP 预设 '${presetId}'。运行 qling mcp presets 查看。`,
+            storePath,
+        };
+    }
+    const name = (options.name ?? preset.id).trim();
+    if (!name) {
+        return { ok: false, name: "", message: "server 名称不能为空", storePath };
+    }
+    const store = await loadMcpStore(storePath);
+    store.servers[name] = {
+        ...preset.server,
+        env: preset.server.env ? { ...preset.server.env } : undefined,
+        args: [...preset.server.args],
+        preset: preset.id,
+        addedAt: new Date().toISOString(),
+    };
+    await saveMcpStore(store, storePath);
+    const envHint = preset.requiredEnv && preset.requiredEnv.length > 0
+        ? ` 需要环境变量: ${preset.requiredEnv.join(", ")}`
+        : "";
+    return {
+        ok: true,
+        name,
+        message: `已添加 MCP server '${name}' (preset=${preset.id}) → ${storePath}.${envHint}`,
+        storePath,
+    };
+}
+export async function removeMcpFromStore(name, options = {}) {
+    const storePath = options.storePath ?? defaultMcpStorePath(options.stateDir);
+    const store = await loadMcpStore(storePath);
+    if (!store.servers[name]) {
+        return { ok: false, message: `store 中不存在 server '${name}'` };
+    }
+    delete store.servers[name];
+    await saveMcpStore(store, storePath);
+    return { ok: true, message: `已移除 MCP server '${name}'` };
+}
+/** 将 store 合并进 config.servers（不覆盖已有同名；env JSON 仍优先于调用方） */
+export function mergeMcpServers(base, store) {
+    return { ...store.servers, ...base };
+}
+export function presetToStored(preset) {
+    return {
+        ...preset.server,
+        args: [...preset.server.args],
+        env: preset.server.env ? { ...preset.server.env } : undefined,
+        preset: preset.id,
+    };
+}

package/dist/mcp/types.d.ts

@@ -0,0 +1,40 @@
+export interface MCPServerConfig {
+    name: string;
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+    enabled: boolean;
+    transport?: "stdio" | "http";
+    url?: string;
+    headers?: Record<string, string>;
+}
+export interface MCPToolDefinition {
+    serverName: string;
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface MCPConnectResult {
+    serverName: string;
+    tools: MCPToolDefinition[];
+    status: "connected" | "failed";
+    error?: string;
+}
+export interface MCPMessage {
+    jsonrpc: "2.0";
+    id?: number | string;
+    method?: string;
+    params?: unknown;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export interface MCPMCPConfig {
+    servers: Record<string, MCPServerConfig>;
+    connection_timeout_ms: number;
+    call_timeout_ms: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3D;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACzC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/mcp/types.js

@@ -0,0 +1,4 @@
+// ============================================================
+// 轻灵 - MCP 协议类型
+// ============================================================
+export {};

package/dist/mcp-report.d.ts

@@ -0,0 +1,30 @@
+import type { QlingConfig } from "./config.js";
+type McpConfig = QlingConfig["mcp"];
+export interface LocalMcpServerReport {
+    name: string;
+    enabled: boolean;
+    transport: string;
+    command: string;
+    args: string[];
+    url: string;
+    env: Array<{
+        key: string;
+        status: "set(redacted)";
+    }>;
+    headers: Array<{
+        key: string;
+        status: "set(redacted)";
+    }>;
+}
+export interface LocalMcpReport {
+    total: number;
+    enabled: number;
+    connectionTimeoutMs: number;
+    callTimeoutMs: number;
+    servers: LocalMcpServerReport[];
+}
+export declare function sanitizeMcpUrl(value: string | null | undefined): string;
+export declare function buildLocalMcpReport(config: McpConfig, env?: Record<string, string | undefined>): LocalMcpReport;
+export declare function formatLocalMcpReport(report: LocalMcpReport): string[];
+export {};
+//# sourceMappingURL=mcp-report.d.ts.map

package/dist/mcp-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-report.d.ts","sourceRoot":"","sources":["../src/mcp-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,KAAK,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;AAEpC,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC;IACrD,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAaD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAgBvE;AAqBD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAM,GAC3C,cAAc,CAwBhB;AAOD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CA8BrE"}

package/dist/mcp-report.js

@@ -0,0 +1,104 @@
+function safeText(value, fallback = "-") {
+    return typeof value === "string" && value.trim() ? value.trim() : fallback;
+}
+function redactQueryLikeSecrets(value) {
+    return value.replace(/([?&](?:api_?key|key|token|secret|password|authorization)=)[^&#\s]*/gi, "$1<redacted>");
+}
+export function sanitizeMcpUrl(value) {
+    const raw = safeText(value, "");
+    if (!raw)
+        return "-";
+    if (/^[a-zA-Z][a-zA-Z\d+.-]*:\/\//.test(raw)) {
+        try {
+            const url = new URL(raw);
+            url.username = "";
+            url.password = "";
+            url.search = "";
+            url.hash = "";
+            return url.toString().replace(/\/$/, url.pathname === "/" ? "/" : "");
+        }
+        catch {
+            return redactQueryLikeSecrets(raw);
+        }
+    }
+    return redactQueryLikeSecrets(raw);
+}
+function redactKeyMap(values) {
+    return Object.keys(values ?? {})
+        .sort((left, right) => left.localeCompare(right))
+        .map((key) => ({ key, status: "set(redacted)" }));
+}
+function parseEnvServers(raw) {
+    if (!raw)
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+export function buildLocalMcpReport(config, env = {}) {
+    const envServers = parseEnvServers(env.QLING_MCP_SERVERS);
+    const serversConfig = envServers ?? config.servers ?? {};
+    const serverEntries = Object.entries(serversConfig);
+    const servers = serverEntries
+        .map(([name, server]) => ({
+        name,
+        enabled: Boolean(server.enabled),
+        transport: safeText(server.transport, server.url ? "http" : "stdio"),
+        command: safeText(server.command, "-"),
+        args: Array.isArray(server.args) ? server.args.map(String) : [],
+        url: sanitizeMcpUrl(server.url),
+        env: redactKeyMap(server.env),
+        headers: redactKeyMap(server.headers),
+    }))
+        .sort((left, right) => left.name.localeCompare(right.name));
+    return {
+        total: servers.length,
+        enabled: servers.filter((server) => server.enabled).length,
+        connectionTimeoutMs: Number(config.connection_timeout_ms ?? 0),
+        callTimeoutMs: Number(config.call_timeout_ms ?? 0),
+        servers,
+    };
+}
+function formatKeyStatuses(values) {
+    if (values.length === 0)
+        return "-";
+    return values.map((item) => `${item.key}=${item.status}`).join(", ");
+}
+export function formatLocalMcpReport(report) {
+    const lines = [
+        "",
+        "🔌 本地 MCP 配置",
+        "-----------------------------------------",
+        `Servers   : enabled=${report.enabled}/${report.total}`,
+        `Timeouts  : connect=${report.connectionTimeoutMs}ms call=${report.callTimeoutMs}ms`,
+        "",
+    ];
+    if (report.servers.length === 0) {
+        lines.push("(无 MCP server)");
+    }
+    else {
+        report.servers.forEach((server, index) => {
+            lines.push(`${index + 1}. ${server.name} | enabled=${server.enabled} | transport=${server.transport}`);
+            if (server.transport === "http") {
+                lines.push(`   url=${server.url}`);
+            }
+            else {
+                lines.push(`   command=${server.command}`);
+                lines.push(`   args=${server.args.length ? server.args.join(" ") : "-"}`);
+            }
+            lines.push(`   env=${formatKeyStatuses(server.env)}`);
+            lines.push(`   headers=${formatKeyStatuses(server.headers)}`);
+        });
+    }
+    lines.push("-----------------------------------------");
+    lines.push("边界      : 只读取当前本地 MCP 配置；不连接 server、不启动子进程、不调用模型、不联网；env/header 值始终脱敏。");
+    lines.push("");
+    return lines;
+}

package/dist/memory/cognitive-index.d.ts

@@ -0,0 +1,56 @@
+import type { PersistedEntry } from "../types.js";
+export interface SemanticSearchResult {
+    entry: PersistedEntry;
+    score: number;
+    source: "vector" | "keyword" | "graph" | "practice";
+}
+export interface distilledPractice {
+    id: string;
+    task_pattern: string;
+    successful_commands: string[];
+    files_involved: string[];
+    confidence: number;
+}
+export declare class CognitiveIndex {
+    private db;
+    private dbPath;
+    constructor(memoryDir: string);
+    init(): Promise<void>;
+    upsertVector(entry: PersistedEntry, vector: number[]): void;
+    searchVector(queryVector: number[], limit?: number): SemanticSearchResult[];
+    link(source: {
+        id: string;
+        type: string;
+        label: string;
+    }, relation: string, target: {
+        id: string;
+        type: string;
+        label: string;
+    }): void;
+    linkSessionToEntities(sessionId: string, summary: string, files: string[], tasks: string[]): void;
+    addPractice(practice: Omit<distilledPractice, "hit_count" | "created_at">): void;
+    getRelatedPractices(query: string): any[];
+    upsertSymbolNode(fileRelativePath: string, symbol: {
+        name: string;
+        type: string;
+        line: number;
+        signature: string;
+    }): void;
+    getSymbolsForFile(fileRelativePath: string): {
+        name: string;
+        type: string;
+        line: number;
+        signature: string;
+    }[];
+    clearSymbolsForFile(fileRelativePath: string): void;
+    getAllSymbols(): {
+        file: string;
+        name: string;
+        type: string;
+        line: number;
+        signature: string;
+    }[];
+    private cosineSimilarity;
+    close(): void;
+}
+//# sourceMappingURL=cognitive-index.d.ts.map

package/dist/memory/cognitive-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitive-index.d.ts","sourceRoot":"","sources":["../../src/memory/cognitive-index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;CACrD;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,EAAE,CAAqB;IAC/B,OAAO,CAAC,MAAM,CAAS;gBAEX,SAAS,EAAE,MAAM;IAIvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6E3B,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAmB3D,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,KAAK,GAAE,MAAW,GAAG,oBAAoB,EAAE;IAyB/E,IAAI,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAqBtI,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAcjG,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,YAAY,CAAC,GAAG,IAAI;IAkBhF,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE;IAWzC,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IA4BzH,iBAAiB,CAAC,gBAAgB,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE;IAoB9G,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAcnD,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE;IAwBhG,OAAO,CAAC,gBAAgB;IAYxB,KAAK,IAAI,IAAI;CAGd"}