qlogicagent 2.20.2 → 2.20.3

package/dist/types/skills/tools/web-research-tool.d.ts

@@ -1,48 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-import type { WebAnswerToolDeps } from "./web-answer-tool.js";
-export declare const WEB_RESEARCH_TOOL_NAME: "web_research";
-export interface WebResearchToolParams {
-    task: string;
-    budget?: {
-        /** 搜-读-反思轮数上限(默认 2:首轮 + 1 轮 reflect 补搜) */
-        maxRounds?: number;
-        /** 墙钟时间上限 ms(默认 120000) */
-        maxWallClockMs?: number;
-    };
-}
-export declare const WEB_RESEARCH_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly task: {
-            readonly type: "string";
-            readonly description: string;
-        };
-        readonly budget: {
-            readonly type: "object";
-            readonly properties: {
-                readonly maxRounds: {
-                    readonly type: "number";
-                    readonly description: "Max search-read-reflect rounds (default 2).";
-                };
-                readonly maxWallClockMs: {
-                    readonly type: "number";
-                    readonly description: "Max wall-clock time in ms (default 120000).";
-                };
-            };
-            readonly description: "Hard budget caps to prevent runaway research.";
-        };
-    };
-    readonly required: readonly ["task"];
-};
-/** 与 web_answer 同 deps + 可选写记忆(host 注入;无则跳过,details 如实标注)。 */
-export interface WebResearchToolDeps extends WebAnswerToolDeps {
-    /**
-     * 可选:把研究结论写入长期记忆(§14)。内部经 consolidator 去重/重要度过滤(§15-7),
-     * 返回是否成功提交(不保证最终入库条数)。
-     */
-    saveMemory?(text: string, meta: {
-        source: string;
-        category: string;
-    }): Promise<boolean>;
-}
-export declare function createWebResearchTool(deps: WebResearchToolDeps): PortableTool<WebResearchToolParams>;

package/dist/types/skills/tools/web-search-tool.d.ts

@@ -1,46 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-import type { WebSearchBackend, WebSearchOutput, WebSearchResult } from "../../runtime/ports/web-search-contracts.js";
-export declare const WEB_SEARCH_TOOL_NAME: "web_search";
-export interface WebSearchToolParams {
-    query: string;
-    allowedDomains?: string[];
-    blockedDomains?: string[];
-    freshness?: "day" | "week" | "month" | "year" | "any";
-}
-export declare const WEB_SEARCH_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly query: {
-            readonly type: "string";
-            readonly description: "Search query string. Be specific and concise for best results.";
-        };
-        readonly allowedDomains: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-            readonly description: string;
-        };
-        readonly blockedDomains: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-            readonly description: "Exclude results from these domains. Cannot be used together with allowedDomains.";
-        };
-        readonly freshness: {
-            readonly type: "string";
-            readonly enum: readonly ["day", "week", "month", "year", "any"];
-            readonly description: string;
-        };
-    };
-    readonly required: readonly ["query"];
-};
-export type { WebSearchOutput, WebSearchResult };
-/**
- * Host-provided web search backend.
- * The host may use any search engine (SearXNG, Brave, Tavily, etc.).
- */
-export interface WebSearchToolDeps extends WebSearchBackend {
-}
-export declare function createWebSearchTool(deps: WebSearchToolDeps): PortableTool<WebSearchToolParams>;

package/dist/types/skills/web-search/brave-source.d.ts

@@ -1,3 +0,0 @@
-import type { SourceProvider } from "../../runtime/ports/source-provider.js";
-import { type WebTunableEnvironment, type WebTunableSnapshotResolver } from "./web-tunable-resolver.js";
-export declare function createBraveSource(resolveTunables: WebTunableSnapshotResolver, env?: WebTunableEnvironment): SourceProvider;

package/dist/types/skills/web-search/crawl4ai-extractor.d.ts

@@ -1,16 +0,0 @@
-import { type WebTunableEnvironment, type WebTunableSnapshotResolver } from "./web-tunable-resolver.js";
-export interface ExtractedContent {
-    content: string;
-    title?: string;
-}
-export interface Crawl4aiExtractor {
-    /** 提取 URL 正文为 markdown;失败/未配置/超时返回 null(让上层回退本地提取)。 */
-    extract(url: string, opts?: {
-        maxChars?: number;
-        timeoutMs?: number;
-        signal?: AbortSignal;
-    }): Promise<ExtractedContent | null>;
-    /** 是否已配置 base url(诊断用)。 */
-    isConfigured(): Promise<boolean>;
-}
-export declare function createCrawl4aiExtractor(resolveTunables: WebTunableSnapshotResolver, env?: WebTunableEnvironment): Crawl4aiExtractor;

package/dist/types/skills/web-search/embedding-rerank.d.ts

@@ -1,13 +0,0 @@
-import type { RawHit } from "../../runtime/ports/source-provider.js";
-import type { EmbeddingProvider } from "../memory/local-embedding.js";
-export interface Reranker {
-    /** 按 query 语义相关性重排 hits;失败/无模型时返回原序(fail-loud,不破坏召回)。 */
-    rerank(query: string, hits: RawHit[]): Promise<RawHit[]>;
-}
-export interface EmbeddingRerankerDeps {
-    /** embedding provider 工厂(调用方注入,可异步懒解析)。dimensions=0 视为无模型 → 原序。 */
-    getProvider: () => EmbeddingProvider | Promise<EmbeddingProvider>;
-    /** 每条 hit 文本(title+snippet)最大字符,控 token。默认 512。 */
-    maxTextChars?: number;
-}
-export declare function createEmbeddingReranker(deps: EmbeddingRerankerDeps): Reranker;

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

@@ -1,3 +0,0 @@
-import type { SourceProvider } from "../../runtime/ports/source-provider.js";
-import { type WebTunableEnvironment, type WebTunableSnapshotResolver } from "./web-tunable-resolver.js";
-export declare function createExaSource(resolveTunables: WebTunableSnapshotResolver, env?: WebTunableEnvironment): SourceProvider;

package/dist/types/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/types/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/types/skills/web-search/search-svc-source.d.ts

@@ -1,5 +0,0 @@
-import type { SourceProvider } from "../../runtime/ports/source-provider.js";
-import { type WebTunableEnvironment, type WebTunableSnapshotResolver } from "./web-tunable-resolver.js";
-/** 解析 search-svc base url:host tunable 非空优先，空 override 才回退环境变量。 */
-export declare function resolveSearchSvcBaseUrl(resolveTunables: WebTunableSnapshotResolver, env?: WebTunableEnvironment): Promise<string | undefined>;
-export declare function createSearchSvcSource(resolveTunables: WebTunableSnapshotResolver, env?: WebTunableEnvironment): SourceProvider;

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

@@ -1,4 +0,0 @@
-import type { SourceProvider } from "../../runtime/ports/source-provider.js";
-import { type WebTunableEnvironment, type WebTunableSnapshotResolver } from "./web-tunable-resolver.js";
-/** 解析 SearXNG base url:host tunable 非空优先，空 override 才回退环境变量。 */
-export declare function createSearxngSource(resolveTunables: WebTunableSnapshotResolver, env?: WebTunableEnvironment): SourceProvider;

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

@@ -1,3 +0,0 @@
-import type { SourceProvider } from "../../runtime/ports/source-provider.js";
-import { type WebTunableEnvironment, type WebTunableSnapshotResolver } from "./web-tunable-resolver.js";
-export declare function createSerperSource(resolveTunables: WebTunableSnapshotResolver, env?: WebTunableEnvironment): SourceProvider;

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

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

package/dist/types/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/types/skills/web-search/web-tunable-resolver.d.ts

@@ -1,16 +0,0 @@
-import { type TunableDefaults } from "../../tunables.js";
-export type WebTunableSnapshot = Readonly<TunableDefaults>;
-export type WebTunableSnapshotResolver = () => Promise<WebTunableSnapshot>;
-export type WebTunableEnvironment = Record<string, string | undefined>;
-/**
- * Build one lazy snapshot for one web-tool invocation/search. The loader is not touched during
- * synchronous registration; the first consumer starts it and all sibling consumers reuse the
- * exact in-flight/settled Promise. Rejections are cached too so a host failure cannot degrade into
- * a later env/local fallback inside the same invocation. Callers construct a fresh resolver for
- * the next invoke so host updates are hot and a rejected request can retry.
- */
-export declare function createWebTunableSnapshotResolver(loadOverrides: () => Promise<Record<string, unknown>>): WebTunableSnapshotResolver;
-/** Explicit standalone-server mode: shared defaults + source-specific env fallback, no local store. */
-export declare function createEnvOnlyWebTunableResolver(): WebTunableSnapshotResolver;
-/** Non-empty host override wins; an empty shared-default/override alone permits the legacy env fallback. */
-export declare function resolveWebTunableString(resolveSnapshot: WebTunableSnapshotResolver, key: keyof Pick<TunableDefaults, "exaApiKey" | "braveApiKey" | "serperApiKey" | "searxngBaseUrl" | "searchSvcBaseUrl" | "crawl4aiBaseUrl">, envName: string, env: WebTunableEnvironment): Promise<string | undefined>;