qlogicagent 2.13.3 → 2.13.5

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

@@ -0,0 +1,44 @@
+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

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

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

@@ -0,0 +1,43 @@
+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

@@ -0,0 +1,23 @@
+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

@@ -0,0 +1,99 @@
+// 多源后端 —— 组合多个 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

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1,44 @@
+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

@@ -0,0 +1,4 @@
+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

@@ -0,0 +1,64 @@
+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

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

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

@@ -0,0 +1,91 @@
+// 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

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

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

@@ -0,0 +1,33 @@
+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

@@ -0,0 +1,5 @@
+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

@@ -0,0 +1,15 @@
+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

@@ -0,0 +1,26 @@
+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

@@ -0,0 +1,57 @@
+// 稳定性层 —— 直接落地 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

@@ -0,0 +1,21 @@
+/**
+ * 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;