qlogicagent 2.13.5 → 2.13.6

package/dist/skills/web-search/embedding-rerank.js

@@ -1,44 +0,0 @@
-export function createEmbeddingReranker(deps) {
-    const maxTextChars = deps.maxTextChars ?? 512;
-    return {
-        async rerank(query, hits) {
-            if (hits.length <= 1)
-                return hits;
-            let provider;
-            try {
-                provider = await deps.getProvider();
-            }
-            catch {
-                return hits; // 解析失败 → 原序
-            }
-            if (provider.dimensions === 0)
-                return hits; // NullEmbeddingProvider(无 embedding 模型)→ 原序
-            try {
-                const texts = [query, ...hits.map((h) => `${h.title} ${h.snippet}`.trim().slice(0, maxTextChars))];
-                const vecs = await provider.embedBatch(texts);
-                if (vecs.length !== texts.length || vecs[0].length === 0)
-                    return hits; // 形状不符 → 原序
-                const qv = vecs[0];
-                const scored = hits.map((h, i) => ({ h, score: cosineSim(qv, vecs[i + 1]) }));
-                scored.sort((a, b) => b.score - a.score);
-                return scored.map((s) => s.h);
-            }
-            catch {
-                return hits; // embedding 调用失败/超时 → 原序(不破坏召回)
-            }
-        },
-    };
-}
-/** 余弦相似度;维度为 0 或不匹配返回 0。 */
-function cosineSim(a, b) {
-    if (a.length === 0 || b.length === 0 || a.length !== b.length)
-        return 0;
-    let dot = 0, na = 0, nb = 0;
-    for (let i = 0; i < a.length; i++) {
-        const x = a[i], y = b[i];
-        dot += x * y;
-        na += x * x;
-        nb += y * y;
-    }
-    return na && nb ? dot / (Math.sqrt(na) * Math.sqrt(nb)) : 0;
-}

package/dist/skills/web-search/exa-source.d.ts

@@ -1,2 +0,0 @@
-import type { SourceProvider } from "../../runtime/ports/source-provider.js";
-export declare function createExaSource(): SourceProvider;

package/dist/skills/web-search/exa-source.js

@@ -1,43 +0,0 @@
-const EXA_ID = "exa";
-async function resolveKey() {
-    const { getModelRegistry } = await import("../../runtime/infra/model-registry.js");
-    return getModelRegistry().getTunable("exaApiKey") ?? process.env.EXA_API_KEY?.trim();
-}
-export function createExaSource() {
-    return {
-        id: EXA_ID,
-        kind: "neural",
-        capabilities: { semantic: true, freshness: true, domainFilter: true },
-        search: async (query, opts, signal) => {
-            const key = await resolveKey();
-            if (!key)
-                return []; // 可选源:未配置 key → 静默跳过
-            const body = {
-                query,
-                numResults: opts.maxResults ?? 10,
-                contents: { text: { maxCharacters: 500 } },
-            };
-            if (opts.allowedDomains?.length)
-                body.includeDomains = opts.allowedDomains;
-            if (opts.blockedDomains?.length)
-                body.excludeDomains = opts.blockedDomains;
-            const res = await fetch("https://api.exa.ai/search", {
-                method: "POST",
-                signal,
-                headers: { "Content-Type": "application/json", "x-api-key": key },
-                body: JSON.stringify(body),
-            });
-            if (!res.ok)
-                throw new Error(`[exa-source] HTTP ${res.status}`);
-            const data = (await res.json());
-            return (data.results ?? []).map((r) => ({
-                title: r.title ?? "",
-                url: r.url ?? "",
-                snippet: r.text ?? "",
-                publishedAt: r.publishedDate,
-                rawScore: r.score,
-                source: EXA_ID,
-            }));
-        },
-    };
-}

package/dist/skills/web-search/multi-source-backend.d.ts

@@ -1,23 +0,0 @@
-import type { WebSearchBackend } from "../../runtime/ports/web-search-contracts.js";
-import type { SourceProvider, SourceQueryOptions } from "../../runtime/ports/source-provider.js";
-import type { SourceCache, CircuitBreaker } from "./stability.js";
-import type { Reranker } from "./embedding-rerank.js";
-export interface SourceRouter {
-    pick(query: string, sources: SourceProvider[], opts: SourceQueryOptions): SourceProvider[];
-}
-/** V0 默认路由:全部 source 都打(已被熔断器在调用前过滤)。L1 分类器路由留 V1。 */
-export declare const allSourcesRouter: SourceRouter;
-export interface MultiSourceConfig {
-    sources: SourceProvider[];
-    router?: SourceRouter;
-    cache?: SourceCache;
-    breaker?: CircuitBreaker;
-    /** 每个 source 的硬超时(ms);实测起点 4–5s */
-    perSourceTimeoutMs?: number;
-    cacheTtlMs?: number;
-    dedupe?: boolean;
-    maxResults?: number;
-    /** L3 语义重排器(可选);dedupe 后、截断前对 hits 按 query 相关性重排。 */
-    rerank?: Reranker;
-}
-export declare function createMultiSourceBackend(cfg: MultiSourceConfig): WebSearchBackend;

package/dist/skills/web-search/multi-source-backend.js

@@ -1,99 +0,0 @@
-// 多源后端 —— 组合多个 SourceProvider + 稳定性层,对外实现 WebSearchBackend(契约不变)。
-// 流程:router.pick → 熔断过滤 → 各 source(缓存命中?否则带硬超时并发 search)→ 合并去重 → 截断。
-// 硬超时在此用 AbortController 强制(实测唯一能砍下 23s 的层)。
-/** V0 默认路由:全部 source 都打(已被熔断器在调用前过滤)。L1 分类器路由留 V1。 */
-export const allSourcesRouter = {
-    pick: (_query, sources) => sources,
-};
-export function createMultiSourceBackend(cfg) {
-    const router = cfg.router ?? allSourcesRouter;
-    const perSourceTimeoutMs = cfg.perSourceTimeoutMs ?? 5_000;
-    const cacheTtlMs = cfg.cacheTtlMs ?? 10 * 60_000;
-    const defaultMax = cfg.maxResults ?? 10;
-    const dedupe = cfg.dedupe ?? true;
-    return {
-        search: async (query, options) => {
-            const opts = {
-                maxResults: options?.maxResults ?? defaultMax,
-                allowedDomains: options?.allowedDomains,
-                blockedDomains: options?.blockedDomains,
-                freshness: options?.freshness,
-                lang: options?.lang,
-            };
-            const picked = router.pick(query, cfg.sources, opts);
-            const eligible = picked.filter((s) => cfg.breaker?.canRequest(s.id) ?? true);
-            const settled = await Promise.allSettled(eligible.map((s) => searchOneSource(s, query, opts, perSourceTimeoutMs, cacheTtlMs, cfg)));
-            let hits = [];
-            const sourceErrors = [];
-            for (const r of settled) {
-                if (r.status === "fulfilled")
-                    hits.push(...r.value);
-                else
-                    sourceErrors.push(r.reason instanceof Error ? r.reason.message : String(r.reason));
-            }
-            // fail-loud:一无所获且有源失败 → 上抛失败原因(纯 0 结果不抛;部分源失败但有结果仍可用)。
-            if (hits.length === 0 && sourceErrors.length > 0) {
-                throw new Error(`web 搜索失败(${sourceErrors.length}/${eligible.length} 个数据源出错): ${sourceErrors.join(" | ")}`);
-            }
-            if (dedupe)
-                hits = dedupeHits(hits);
-            // L3 语义重排(dedupe 后、截断前):embedding 相关性排序,提升 top-N 精度。fail-loud 内部已兜底原序。
-            if (cfg.rerank && hits.length > 1)
-                hits = await cfg.rerank.rerank(query, hits);
-            const limit = opts.maxResults ?? defaultMax;
-            const results = hits.slice(0, limit).map((h) => ({
-                title: h.title,
-                url: h.url,
-                snippet: h.snippet,
-            }));
-            return { query, results, totalResults: hits.length };
-        },
-    };
-}
-async function searchOneSource(source, query, opts, timeoutMs, cacheTtlMs, cfg) {
-    const cacheKey = `${source.id}::${opts.lang ?? ""}::${opts.maxResults ?? ""}::${query}`;
-    if (cfg.cache) {
-        const cached = await cfg.cache.get(cacheKey);
-        if (cached)
-            return cached;
-    }
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    try {
-        const hits = await source.search(query, opts, controller.signal);
-        cfg.breaker?.recordSuccess(source.id);
-        if (cfg.cache && hits.length > 0) {
-            await cfg.cache.set(cacheKey, hits, cacheTtlMs);
-        }
-        return hits;
-    }
-    catch (err) {
-        // 失败记入熔断器(连续失败即跳过),并上抛由调用方决定:有其他源兜住则可用,全军覆没则 fail-loud。
-        cfg.breaker?.recordFailure(source.id);
-        throw err instanceof Error ? err : new Error(String(err));
-    }
-    finally {
-        clearTimeout(timer);
-    }
-}
-function normalizeUrl(url) {
-    try {
-        const u = new URL(url);
-        return (u.hostname + u.pathname).replace(/\/+$/, "").toLowerCase();
-    }
-    catch {
-        return url.toLowerCase();
-    }
-}
-function dedupeHits(hits) {
-    const seen = new Set();
-    const out = [];
-    for (const h of hits) {
-        const key = normalizeUrl(h.url);
-        if (seen.has(key))
-            continue;
-        seen.add(key);
-        out.push(h);
-    }
-    return out;
-}

package/dist/skills/web-search/redis-source-cache.d.ts

@@ -1,6 +0,0 @@
-import type { SourceCache } from "./stability.js";
-export interface RedisSourceCacheHandle extends SourceCache {
-    /** 探活(svc /health 用) */
-    ping(): Promise<boolean>;
-}
-export declare function createRedisSourceCache(redisUrl: string): Promise<RedisSourceCacheHandle>;

package/dist/skills/web-search/redis-source-cache.js

@@ -1,44 +0,0 @@
-const KEY_PREFIX = "xzc:search:src:";
-export async function createRedisSourceCache(redisUrl) {
-    const { Redis } = await import("ioredis");
-    const client = new Redis(redisUrl, {
-        lazyConnect: false,
-        maxRetriesPerRequest: 1,
-        enableOfflineQueue: false,
-        connectTimeout: 5_000,
-    });
-    let errorLogged = false;
-    client.on("error", (err) => {
-        if (!errorLogged) {
-            errorLogged = true;
-            console.error(`[redis-source-cache] redis error (degrading to cache-miss): ${err.message}`);
-        }
-    });
-    return {
-        async get(key) {
-            try {
-                const raw = await client.get(KEY_PREFIX + key);
-                return raw ? JSON.parse(raw) : null;
-            }
-            catch {
-                return null; // Redis 故障 → miss,检索继续
-            }
-        },
-        async set(key, hits, ttlMs) {
-            try {
-                await client.set(KEY_PREFIX + key, JSON.stringify(hits), "PX", ttlMs);
-            }
-            catch {
-                // 写失败不影响检索
-            }
-        },
-        async ping() {
-            try {
-                return (await client.ping()) === "PONG";
-            }
-            catch {
-                return false;
-            }
-        },
-    };
-}

package/dist/skills/web-search/search-svc-source.d.ts

@@ -1,4 +0,0 @@
-import type { SourceProvider } from "../../runtime/ports/source-provider.js";
-/** 解析 search-svc base url:settings tunables → 环境变量。 */
-export declare function resolveSearchSvcBaseUrl(): Promise<string | undefined>;
-export declare function createSearchSvcSource(): SourceProvider;

package/dist/skills/web-search/search-svc-source.js

@@ -1,64 +0,0 @@
-const SEARCH_SVC_ID = "search-svc";
-/** 解析 search-svc base url:settings tunables → 环境变量。 */
-export async function resolveSearchSvcBaseUrl() {
-    const { getModelRegistry } = await import("../../runtime/infra/model-registry.js");
-    return (getModelRegistry().getTunable("searchSvcBaseUrl") ??
-        process.env.SEARCH_SVC_BASE_URL?.trim());
-}
-export function createSearchSvcSource() {
-    return {
-        id: SEARCH_SVC_ID,
-        kind: "serp",
-        capabilities: { semantic: false, freshness: true, domainFilter: true },
-        search: async (query, opts, signal) => {
-            const base = await resolveSearchSvcBaseUrl();
-            if (!base) {
-                throw new Error("[search-svc-source] SEARCH_SVC_BASE_URL 未配置(tunables.searchSvcBaseUrl 或环境变量;桌面应由 gateway 注入)");
-            }
-            // base 可能带路径前缀(llmrouter /api/websearch),不能用 new URL("/search", base) 的绝对路径覆盖
-            const url = new URL(`${base.replace(/\/+$/, "")}/search`);
-            url.searchParams.set("q", query);
-            if (opts.maxResults)
-                url.searchParams.set("maxResults", String(opts.maxResults));
-            if (opts.freshness && opts.freshness !== "any")
-                url.searchParams.set("freshness", opts.freshness);
-            if (opts.lang)
-                url.searchParams.set("lang", opts.lang);
-            if (opts.allowedDomains?.length)
-                url.searchParams.set("allowedDomains", opts.allowedDomains.join(","));
-            if (opts.blockedDomains?.length)
-                url.searchParams.set("blockedDomains", opts.blockedDomains.join(","));
-            const res = await fetch(url.toString(), { signal, headers: buildHeaders() });
-            if (!res.ok) {
-                throw new Error(`[search-svc-source] HTTP ${res.status}`);
-            }
-            const data = (await res.json());
-            return (data.results ?? []).map((r) => ({
-                title: r.title ?? "",
-                url: r.url ?? "",
-                snippet: r.snippet ?? "",
-                source: SEARCH_SVC_ID,
-            }));
-        },
-        health: async (signal) => {
-            const base = await resolveSearchSvcBaseUrl();
-            if (!base)
-                return false;
-            try {
-                const res = await fetch(`${base.replace(/\/+$/, "")}/health`, { signal, headers: buildHeaders() });
-                return res.ok;
-            }
-            catch {
-                return false;
-            }
-        },
-    };
-}
-/** llmrouter 反代需要 Bearer 鉴权(计费主体);内网直连 svc 忽略该头。 */
-function buildHeaders() {
-    const headers = { Accept: "application/json" };
-    const token = process.env.QLOGIC_LLMROUTER_ACCESS_TOKEN?.trim();
-    if (token)
-        headers.authorization = `Bearer ${token}`;
-    return headers;
-}

package/dist/skills/web-search/searxng-source.d.ts

@@ -1,2 +0,0 @@
-import type { SourceProvider } from "../../runtime/ports/source-provider.js";
-export declare function createSearxngSource(): SourceProvider;

package/dist/skills/web-search/searxng-source.js

@@ -1,91 +0,0 @@
-// SearXNG 数据源 —— 实现 SourceProvider。
-// 由 createWebSearchDeps 装配进多源后端;硬超时由聚合层经 signal 强制(实测 SearXNG
-// settings 砍不下 23s,只能调用方控)。本文件搬自原 tool-bootstrap.ts 的 searxngSearch,
-// 改为返回 RawHit[] 并尊重外部 signal。
-const SEARXNG_ID = "searxng";
-function applyDomainFilter(hits, opts) {
-    if (opts.allowedDomains?.length) {
-        const allowed = new Set(opts.allowedDomains.map((d) => d.toLowerCase()));
-        return hits.filter((h) => {
-            try {
-                return allowed.has(new URL(h.url).hostname.toLowerCase());
-            }
-            catch {
-                return false;
-            }
-        });
-    }
-    if (opts.blockedDomains?.length) {
-        const blocked = new Set(opts.blockedDomains.map((d) => d.toLowerCase()));
-        return hits.filter((h) => {
-            try {
-                return !blocked.has(new URL(h.url).hostname.toLowerCase());
-            }
-            catch {
-                return true;
-            }
-        });
-    }
-    return hits;
-}
-/** 解析 SearXNG base url:settings.json tunables -> 环境变量(向后兼容)。 */
-async function resolveBaseUrl() {
-    const { getModelRegistry } = await import("../../runtime/infra/model-registry.js");
-    return (getModelRegistry().getTunable("searxngBaseUrl") ??
-        process.env.SEARXNG_BASE_URL?.trim());
-}
-export function createSearxngSource() {
-    return {
-        id: SEARXNG_ID,
-        kind: "serp",
-        capabilities: { semantic: false, freshness: true, domainFilter: true },
-        search: async (query, opts, signal) => {
-            const base = await resolveBaseUrl();
-            // fail-loud:未配置 SearXNG 时直接抛,由聚合层熔断/记录(不静默吞成空结果)。
-            if (!base) {
-                throw new Error("[searxng-source] SEARXNG_BASE_URL 未配置(settings.json tunables.searxngBaseUrl 或环境变量)");
-            }
-            const url = new URL("/search", base);
-            url.searchParams.set("q", query);
-            url.searchParams.set("format", "json");
-            url.searchParams.set("pageno", "1");
-            if (opts.lang)
-                url.searchParams.set("language", opts.lang);
-            // 时效过滤(§4.2 freshness):SearXNG 原生 time_range 支持 day/week/month/year
-            if (opts.freshness && opts.freshness !== "any") {
-                url.searchParams.set("time_range", opts.freshness);
-            }
-            const res = await fetch(url.toString(), {
-                signal,
-                headers: { Accept: "application/json" },
-            });
-            if (!res.ok) {
-                throw new Error(`[searxng-source] HTTP ${res.status}`);
-            }
-            const data = (await res.json());
-            const max = opts.maxResults ?? 10;
-            const hits = (data.results ?? [])
-                .slice(0, max)
-                .map((r) => ({
-                title: r.title ?? "",
-                url: r.url ?? "",
-                snippet: r.content ?? "",
-                publishedAt: r.publishedDate,
-                source: SEARXNG_ID,
-            }));
-            return applyDomainFilter(hits, opts);
-        },
-        health: async (signal) => {
-            const base = await resolveBaseUrl();
-            if (!base)
-                return false;
-            try {
-                const res = await fetch(new URL("/healthz", base).toString(), { signal });
-                return res.ok;
-            }
-            catch {
-                return false;
-            }
-        },
-    };
-}

package/dist/skills/web-search/serper-source.d.ts

@@ -1,2 +0,0 @@
-import type { SourceProvider } from "../../runtime/ports/source-provider.js";
-export declare function createSerperSource(): SourceProvider;

package/dist/skills/web-search/serper-source.js

@@ -1,33 +0,0 @@
-const SERPER_ID = "serper";
-async function resolveKey() {
-    const { getModelRegistry } = await import("../../runtime/infra/model-registry.js");
-    return getModelRegistry().getTunable("serperApiKey") ?? process.env.SERPER_API_KEY?.trim();
-}
-export function createSerperSource() {
-    return {
-        id: SERPER_ID,
-        kind: "serp",
-        capabilities: { semantic: false, freshness: false, domainFilter: false },
-        search: async (query, opts, signal) => {
-            const key = await resolveKey();
-            if (!key)
-                return []; // 可选源:未配置 key → 静默跳过
-            const res = await fetch("https://google.serper.dev/search", {
-                method: "POST",
-                signal,
-                headers: { "Content-Type": "application/json", "X-API-KEY": key },
-                body: JSON.stringify({ q: query, num: opts.maxResults ?? 10 }),
-            });
-            if (!res.ok)
-                throw new Error(`[serper-source] HTTP ${res.status}`);
-            const data = (await res.json());
-            return (data.organic ?? []).slice(0, opts.maxResults ?? 10).map((r) => ({
-                title: r.title ?? "",
-                url: r.link ?? "",
-                snippet: r.snippet ?? "",
-                publishedAt: r.date,
-                source: SERPER_ID,
-            }));
-        },
-    };
-}

package/dist/skills/web-search/source-factory.d.ts

@@ -1,5 +0,0 @@
-import type { SourceProvider } from "../../runtime/ports/source-provider.js";
-/**
- * 组装 web_search 的 L0 数据源集合(运行期各源自行懒解析配置细节)。
- */
-export declare function buildWebSearchSources(): SourceProvider[];

package/dist/skills/web-search/source-factory.js

@@ -1,15 +0,0 @@
-import { createSearchSvcSource } from "./search-svc-source.js";
-import { createExaSource } from "./exa-source.js";
-import { createBraveSource } from "./brave-source.js";
-import { createSerperSource } from "./serper-source.js";
-/**
- * 组装 web_search 的 L0 数据源集合(运行期各源自行懒解析配置细节)。
- */
-export function buildWebSearchSources() {
-    return [
-        createSearchSvcSource(),
-        createExaSource(),
-        createBraveSource(),
-        createSerperSource(),
-    ];
-}

package/dist/skills/web-search/stability.d.ts

@@ -1,26 +0,0 @@
-import type { RawHit } from "../../runtime/ports/source-provider.js";
-export interface SourceCache {
-    get(key: string): Promise<RawHit[] | null>;
-    set(key: string, hits: RawHit[], ttlMs: number): Promise<void>;
-}
-export declare class InMemorySourceCache implements SourceCache {
-    private readonly maxEntries;
-    private store;
-    constructor(maxEntries?: number);
-    get(key: string): Promise<RawHit[] | null>;
-    set(key: string, hits: RawHit[], ttlMs: number): Promise<void>;
-}
-export interface CircuitBreaker {
-    canRequest(sourceId: string): boolean;
-    recordSuccess(sourceId: string): void;
-    recordFailure(sourceId: string): void;
-}
-export declare class InMemoryCircuitBreaker implements CircuitBreaker {
-    private readonly threshold;
-    private readonly cooldownMs;
-    private state;
-    constructor(threshold?: number, cooldownMs?: number);
-    canRequest(sourceId: string): boolean;
-    recordSuccess(sourceId: string): void;
-    recordFailure(sourceId: string): void;
-}

package/dist/skills/web-search/stability.js

@@ -1,57 +0,0 @@
-// 稳定性层 —— 直接落地 docs §11.1 实测教训:
-//   · 缓存:同 query 不重复打上游(实测没缓存就被限流)
-//   · 熔断:某 source 连续失败/限流 → 临时跳过,冷却后重试
-// 硬超时不在此(在聚合层用 AbortController 强制)。
-// 接口用 Promise,V0 是内存实现,未来可无缝换 Redis(复用 Hub Redis)。
-export class InMemorySourceCache {
-    maxEntries;
-    store = new Map();
-    constructor(maxEntries = 500) {
-        this.maxEntries = maxEntries;
-    }
-    async get(key) {
-        const e = this.store.get(key);
-        if (!e)
-            return null;
-        if (Date.now() > e.expiresAt) {
-            this.store.delete(key);
-            return null;
-        }
-        return e.hits;
-    }
-    async set(key, hits, ttlMs) {
-        // 简单 FIFO 上限淘汰
-        if (this.store.size >= this.maxEntries) {
-            const oldest = this.store.keys().next().value;
-            if (oldest !== undefined)
-                this.store.delete(oldest);
-        }
-        this.store.set(key, { hits, expiresAt: Date.now() + ttlMs });
-    }
-}
-export class InMemoryCircuitBreaker {
-    threshold;
-    cooldownMs;
-    state = new Map();
-    constructor(threshold = 3, cooldownMs = 30_000) {
-        this.threshold = threshold;
-        this.cooldownMs = cooldownMs;
-    }
-    canRequest(sourceId) {
-        const s = this.state.get(sourceId);
-        if (!s)
-            return true;
-        return s.openUntil <= Date.now();
-    }
-    recordSuccess(sourceId) {
-        this.state.delete(sourceId);
-    }
-    recordFailure(sourceId) {
-        const s = this.state.get(sourceId) ?? { failures: 0, openUntil: 0 };
-        s.failures += 1;
-        if (s.failures >= this.threshold) {
-            s.openUntil = Date.now() + this.cooldownMs;
-        }
-        this.state.set(sourceId, s);
-    }
-}

package/dist/transport/acp-event-emitter.d.ts

@@ -1,21 +0,0 @@
-/**
- * ACP Event Emittertranslates internal qlogicagent notifications to ACP
- * session/update notifications.
- *
- * Maps the 47+ internal notification methods (turn.delta, turn.tool_call, etc.)
- * to 9 standard + 19 extended ACP sessionUpdate types.
- *
- * Usage: Called by the StdioServer event loop. Instead of (or in addition to)
- * emitting raw notifications, events are translated and emitted through the
- * AcpServer.emitSessionUpdate() method.
- */
-import type { AcpServer } from "./acp-server.js";
-/**
- * Translates and emits a qlogicagent internal notification as an ACP session/update.
- *
- * @param server The AcpServer instance to emit through
- * @param sessionId Active ACP session ID
- * @param method Internal notification method name
- * @param params Internal notification payload
- */
-export declare function emitAcpUpdate(server: AcpServer, sessionId: string, method: string, params: Record<string, unknown>): boolean;