qlogicagent 2.20.2 → 2.20.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.20.2",
+  "version": "2.20.3",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -52,6 +52,14 @@
       "types": "./dist/types/host-contract/index.d.ts",
       "default": "./dist/host-contract.js"
     },
+    "./memory-category-contract": {
+      "types": "./dist/types/host-contract/memory-category.d.ts",
+      "default": "./dist/memory-category-contract.js"
+    },
+    "./skill-category-contract": {
+      "types": "./dist/types/host-contract/skill-category.d.ts",
+      "default": "./dist/skill-category-contract.js"
+    },
     "./host-session-collection-contract": {
       "types": "./dist/types/host-session-collection-contract.d.ts",
       "default": "./dist/host-session-collection-contract.js"
@@ -99,6 +107,12 @@
       "host-contract": [
         "./dist/types/host-contract/index.d.ts"
       ],
+      "memory-category-contract": [
+        "./dist/types/host-contract/memory-category.d.ts"
+      ],
+      "skill-category-contract": [
+        "./dist/types/host-contract/skill-category.d.ts"
+      ],
       "host-session-collection-contract": [
         "./dist/types/host-session-collection-contract.d.ts"
       ],
@@ -111,12 +125,16 @@
     "dev": "tsx watch src/index.ts",
     "build": "node scripts/build.mjs",
     "build:tsc": "tsc --noCheck",
-    "build:search-svc": "node scripts/build-search-svc.mjs",
     "start": "node dist/cli.js",
     "test": "vitest run",
     "test:slow": "vitest run --config vitest.release.config.ts",
     "test:release": "pnpm test && pnpm run test:slow",
     "test:replay": "vitest run benchmarks/transcript-replay",
+    "benchmark:multi-session-real": "tsx benchmarks/multi-session-real/runner.ts",
+    "benchmark:multi-session-live": "tsx benchmarks/multi-session-real/live-runner.ts",
+    "benchmark:multi-session-live:resume": "tsx benchmarks/multi-session-real/live-runner.ts --resume",
+    "benchmark:subagent-delegation-live": "tsx benchmarks/subagent-delegation/live-runner.ts",
+    "benchmark:workflow-authoring": "tsx benchmarks/workflow-authoring/runner.ts",
     "check": "node scripts/run-check.mjs",
     "test:watch": "vitest",
     "benchmark:hermes-superiority": "tsx benchmarks/hermes-superiority/runner.ts",
@@ -145,8 +163,8 @@
   "dependencies": {
     "@agentclientprotocol/sdk": "^0.25.0",
     "@napi-rs/canvas": "0.1.100",
-    "@xiaozhiclaw/module-sdk": "0.2.1",
-    "@xiaozhiclaw/provider-core": "^0.1.28",
+    "@xiaozhiclaw/module-sdk": "0.2.2",
+    "@xiaozhiclaw/provider-core": "^0.1.29",
     "better-sqlite3": "^12.10.0",
     "dotenv": "^17.3.1",
     "ioredis": "^5.11.1",
@@ -154,7 +172,9 @@
     "mcporter": "^0.12.0",
     "nanoid": "^5.1.5",
     "pino": "^9.6.0",
-    "pino-pretty": "^13.0.0"
+    "pino-pretty": "^13.0.0",
+    "typescript": "^5.9.3",
+    "typescript-language-server": "5.3.0"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
@@ -163,7 +183,6 @@
     "javascript-obfuscator": "^5.4.3",
     "oxlint": "1.67.0",
     "tsx": "^4.19.0",
-    "typescript": "^5.9.0",
     "vitest": "^3.1.0"
   }
 }

package/dist/types/cli/tool-bootstrap-web-registration.d.ts

@@ -1,14 +0,0 @@
-import type { PortableTool } from "../skills/portable-tool.js";
-import type { ModelPurpose } from "../runtime/infra/model-registry.js";
-import type { LLMTransport } from "./provider-core-facade.js";
-export interface LocalWebToolRegistrationContext {
-    tools: PortableTool<any>[];
-    resolveClientForPurpose?(purpose: ModelPurpose): {
-        transport: LLMTransport;
-        apiKey: string;
-        model: string;
-    } | null;
-    loadTunableOverrides?(): Promise<Record<string, unknown>>;
-}
-export declare const localWebToolRegistrationModule: import("../runtime/ports/tool-contracts.js").ToolRegistrationModule<LocalWebToolRegistrationContext>;
-export declare function registerLocalWebTools(context: LocalWebToolRegistrationContext): void;

package/dist/types/orchestration/tool-cascade.d.ts

@@ -1,49 +0,0 @@
-/**
- * Tool Cascade — provider-native tool augmentation layer.
- *
- * When a provider (e.g. Zhipu GLM) offers native utility APIs (web search, reader,
- * tokenizer, etc.), the tool cascade automatically routes through the provider API
- * first, falling back to the host-provided implementation (e.g. SearXNG) on failure.
- *
- * ## Architecture
- *
- * Two levels of provider tool integration:
- *
- * 1. **D-level (builtin tools)**: Injected directly into chat completion request
- *    via `builtinWebSearch` / `builtinCodeInterpreter` / `builtinUrlContext` / `builtinMapsGrounding` / `builtinFileSearch` quirks.
- *    The LLM decides to use these inline during generation — no agent intervention.
- *    → Handled by openai-chat.ts (GLM/Kimi) and gemini-generatecontent.ts (Google) transport layers.
- *
- * 2. **C-level (independent APIs)**: Discrete API endpoints the agent calls explicitly
- *    as tool steps (web_search, reader, tokenizer, moderations).
- *    → Handled by this cascade layer — wraps host-provided tool deps with
- *      provider-native backends, falling back on error.
- *
- * ## Usage
- *
- * ```ts
- * import { cascadeWebSearch } from "./tool-cascade.js";
- * const providerApi = host.resolveProviderToolApi();
- *
- * const providerApi = new ZhipuToolAPI({ baseUrl, apiKey });
- * const cascadedSearch = cascadeWebSearch(providerApi, fallbackSearchFn);
- * const tool = createWebSearchTool({ search: cascadedSearch });
- * ```
- */
-import type { WebSearchBackend } from "../runtime/ports/web-search-contracts.js";
-export interface ProviderToolApiPort {
-    capabilities: readonly string[];
-    webSearch?(query: string, options?: {
-        maxResults?: number;
-    }): Promise<Array<{
-        title: string;
-        url: string;
-        snippet: string;
-    }>>;
-}
-/**
- * Cascade web search: provider-native search → host fallback.
- * Returns a WebSearchToolDeps.search function that tries the provider's
- * webSearch API first, falling back to the host's search on error.
- */
-export declare function cascadeWebSearch(providerApi: ProviderToolApiPort | undefined, fallbackSearch: WebSearchBackend["search"]): WebSearchBackend["search"];

package/dist/types/protocol/wire/channel-ingress.d.ts

@@ -1,29 +0,0 @@
-export type GatewayChannelExecutionIngressSource = "channel-ingress";
-export type GatewayChannelExecutionEgressKind = "partial" | "final" | "approval" | "error" | "artifact" | "control";
-export interface GatewayChannelExecutionIngressBindingContract {
-    requestId: string;
-    gatewayTargetRef: string;
-    channelRequestId: string;
-    replyTargetRef: string;
-    channelType: string;
-    channelConversationId: string;
-    channelUserId: string;
-    dedupeKey: string;
-    receivedAt: string;
-    source: GatewayChannelExecutionIngressSource;
-}
-export interface GatewayChannelExecutionEgressContract {
-    requestId: string;
-    replyTargetRef: string;
-    channelRequestId?: string;
-    sessionId?: string;
-    turnId?: string;
-    executionId?: string;
-    rootExecutionId?: string;
-    parentExecutionId?: string;
-    sidechainId?: string;
-    attemptId?: string;
-    envelopeKind: GatewayChannelExecutionEgressKind;
-    emittedAt: string;
-    terminal: boolean;
-}

package/dist/types/protocol/wire/channel.d.ts

@@ -1,89 +0,0 @@
-export type NormalizedChannelType = "telegram" | "slack" | "whatsapp" | "discord" | "wechat" | "custom";
-export type NormalizedChannelMessagePartType = "text" | "image" | "audio" | "video" | "file" | "location" | "event" | "custom";
-export type NormalizedChannelRetryBackoffPolicy = "fixed" | "exponential" | "provider-managed";
-export type NormalizedChannelIdempotencyScope = "reply-target" | "conversation" | "channel-request";
-export type NormalizedChannelDeliveryStatus = "pending" | "delivered" | "retrying" | "failed" | "expired" | "cancelled";
-export interface NormalizedChannelMessagePart {
-    partType: NormalizedChannelMessagePartType;
-    text?: string;
-    mimeType?: string;
-    assetRef?: string;
-    sizeBytes?: number;
-    data?: Record<string, unknown>;
-}
-export interface NormalizedChannelAttachment {
-    attachmentId: string;
-    mimeType?: string;
-    filename?: string;
-    downloadUrl?: string;
-    assetRef?: string;
-    sizeBytes?: number;
-}
-export interface NormalizedChannelExecutionHints {
-    intent?: string;
-    locale?: string;
-    expectsReply?: boolean;
-    data?: Record<string, unknown>;
-}
-export interface NormalizedChannelDeliveryPolicy {
-    allowEdit?: boolean;
-    allowReplyThread?: boolean;
-    maxRetryCount?: number;
-    retryBackoffPolicy?: NormalizedChannelRetryBackoffPolicy;
-    idempotencyScope?: NormalizedChannelIdempotencyScope;
-}
-export interface NormalizedChannelInboundRequest {
-    channelRequestId: string;
-    channelType: NormalizedChannelType;
-    channelTenantId?: string;
-    channelConversationId: string;
-    channelUserId: string;
-    receivedAt: string;
-    dedupeKey: string;
-    gatewayTargetRef: string;
-    replyTargetRef: string;
-    messageParts: NormalizedChannelMessagePart[];
-    attachments?: NormalizedChannelAttachment[];
-    executionHints?: NormalizedChannelExecutionHints;
-}
-export interface NormalizedChannelReplyTarget {
-    replyTargetRef: string;
-    channelType: NormalizedChannelType;
-    channelTenantId?: string;
-    channelConversationId: string;
-    channelMessageRef?: string;
-    recipientRef: string;
-    threadRef?: string;
-    expiresAt?: string;
-    deliveryPolicy?: NormalizedChannelDeliveryPolicy;
-    data?: Record<string, unknown>;
-}
-export interface NormalizedChannelReplyRequest {
-    deliveryAttemptId: string;
-    replyTargetRef: string;
-    channelType: NormalizedChannelType;
-    channelTenantId?: string;
-    channelConversationId: string;
-    recipientRef: string;
-    threadRef?: string;
-    replyToMessageId: string;
-    gatewayId: string;
-    text?: string;
-    mediaUrl?: string;
-    mediaUrls?: string[];
-    fileName?: string;
-    mimeType?: string;
-    data?: Record<string, unknown>;
-}
-export interface NormalizedChannelDeliveryOutcome {
-    deliveryAttemptId: string;
-    replyTargetRef: string;
-    deliveryStatus: NormalizedChannelDeliveryStatus;
-    providerMessageRef?: string;
-    providerErrorCode?: string;
-    providerErrorMessage?: string;
-    attemptedAt: string;
-    ackedAt?: string;
-    retryCount: number;
-    nextRetryAt?: string;
-}

package/dist/types/runtime/infra/native-mcp-config-sync.d.ts

@@ -1,16 +0,0 @@
-export type NativeMcpSyncStatus = "updated" | "unchanged" | "unsupported" | "skipped";
-export interface NativeMcpSyncInput {
-    agentId: string;
-    projectRoot: string;
-    serverScriptPath: string;
-    nodePath?: string;
-    homeDir?: string;
-    codexHome?: string;
-}
-export interface NativeMcpSyncResult {
-    agentId: string;
-    status: NativeMcpSyncStatus;
-    configPath?: string;
-    reason?: string;
-}
-export declare function syncAstraClawNativeMcpConfig(input: NativeMcpSyncInput): NativeMcpSyncResult;

package/dist/types/runtime/memory/categories.d.ts

@@ -1,5 +0,0 @@
-/**
- * Memory categories for QMemory writes.
- * Each has different value thresholds and retention policies.
- */
-export type QMemoryCategory = "lesson" | "preference" | "pattern" | "fact" | "decision" | "skill-learning";

package/dist/types/runtime/memory/recall-category-filter.d.ts

@@ -1,42 +0,0 @@
-import type { QMemoryCategory } from "./categories.js";
-/** Detected query scenario with preferred categories. */
-export interface RecallCategoryHint {
-    /** Detected scenario label. */
-    scenario: QueryScenario;
-    /** Preferred categories for this scenario (ordered by priority). */
-    preferred: QMemoryCategory[];
-    /** Categories to deprioritize (still recalled but scored lower). */
-    deprioritized: QMemoryCategory[];
-    /** Confidence of scenario detection (0.0-1.0). */
-    confidence: number;
-}
-/** Known query scenarios. */
-export type QueryScenario = "coding" | "config" | "conversation" | "learning" | "decision" | "general";
-/**
- * Detect the query scenario and return category preferences.
- *
- * Uses pattern matching on the user query to infer intent.
- * Returns "general" (no filtering) when confidence is below threshold.
- *
- * @param query - User query text
- * @returns Category hint with preferred/deprioritized categories
- */
-export declare function detectRecallCategories(query: string): RecallCategoryHint;
-/**
- * Apply category boost/penalty to a recall score.
- *
- * Used by recall hooks to adjust memory scores based on category alignment.
- *
- * @param baseScore - Original relevance score (0.0-1.0)
- * @param memoryCategory - Category of the memory entry (if known)
- * @param hint - Category hint from detectRecallCategories()
- * @returns Adjusted score
- */
-export declare function applyCategoryBoost(baseScore: number, memoryCategory: string | undefined | null, hint: RecallCategoryHint): number;
-/**
- * Infer memory category from filename prefix convention.
- * E.g. "lesson-docker.md" → "lesson", "fact-ports.md" → "fact"
- *
- * Exported for use by recall hooks.
- */
-export declare function inferCategoryFromFilename(filename: string): QMemoryCategory | null;

package/dist/types/runtime/ports/source-provider.d.ts

@@ -1,39 +0,0 @@
-export interface RawHit {
-    title: string;
-    url: string;
-    snippet: string;
-    /** 由 L2 抓取回填(V0 不填) */
-    content?: string;
-    publishedAt?: string;
-    /** source 自带排序分(neural source 用),L3 重排前的参考 */
-    rawScore?: number;
-    /** 命中的 SourceProvider.id */
-    source: string;
-}
-export interface SourceCapabilities {
-    /** 神经/语义召回(Exa=true,SearXNG=false) */
-    semantic: boolean;
-    /** 支持时效过滤 */
-    freshness: boolean;
-    /** 原生支持域名过滤(否则在聚合层兜底) */
-    domainFilter: boolean;
-}
-export interface SourceQueryOptions {
-    maxResults?: number;
-    allowedDomains?: string[];
-    blockedDomains?: string[];
-    freshness?: "day" | "week" | "month" | "year" | "any";
-    lang?: string;
-}
-export interface SourceProvider {
-    readonly id: string;
-    readonly kind: "serp" | "neural" | "provider-native" | "mcp";
-    readonly capabilities: SourceCapabilities;
-    /**
-     * 只负责"召回原始链接+snippet"。
-     * 必须接收并尊重 signal —— 取消/硬超时由聚合层经 AbortSignal 强制透传。
-     */
-    search(query: string, opts: SourceQueryOptions, signal: AbortSignal): Promise<RawHit[]>;
-    /** 可选主动健康检查(熔断器冷却后探活) */
-    health?(signal: AbortSignal): Promise<boolean>;
-}

package/dist/types/runtime/ports/web-search-contracts.d.ts

@@ -1,21 +0,0 @@
-export interface WebSearchResult {
-    title: string;
-    url: string;
-    snippet: string;
-}
-export interface WebSearchOutput {
-    query: string;
-    results: WebSearchResult[];
-    totalResults?: number;
-}
-export interface WebSearchBackend {
-    search(query: string, options?: {
-        allowedDomains?: string[];
-        blockedDomains?: string[];
-        maxResults?: number;
-        /** 时效过滤(§4.2):day/week/month/year;源不支持时由其忽略 */
-        freshness?: "day" | "week" | "month" | "year" | "any";
-        /** 检索语言(如 "zh"/"en");源不支持时由其忽略 */
-        lang?: string;
-    }): Promise<WebSearchOutput>;
-}

package/dist/types/server/search-svc.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/skills/memory/local-embedding.d.ts

@@ -1,80 +0,0 @@
-/**
- * Local Embedding — Pluggable embedding interface for local memory.
- *
- * Provides a unified interface for text → vector embedding.
- * If no API config is provided, memory search falls back to FTS-only.
- */
-export interface EmbeddingProvider {
-    readonly dimensions: number;
-    readonly model: string;
-    embed(text: string): Promise<Float32Array>;
-    embedBatch(texts: string[]): Promise<Float32Array[]>;
-}
-export interface EmbeddingApiConfig {
-    /** OpenAI-compatible embedding API base URL */
-    baseUrl: string;
-    /** API key */
-    apiKey: string;
-    /** Model name (e.g. "text-embedding-3-small") */
-    model: string;
-    /** Expected dimensions (default: 1536 for text-embedding-3-small) */
-    dimensions?: number;
-    /** Request timeout in ms (default: 10000) */
-    timeoutMs?: number;
-    /**
-     * Provider-specific API format.
-     * - "openai": Standard /v1/embeddings with input:string[] → data[].embedding (default)
-     * - "minimax": /v1/embeddings with texts:string[] → vectors[]
-     * - "volcengine": /v1/embeddings/multimodal with input:[{type,text}] → data.embedding
-     */
-    format?: "openai" | "minimax" | "volcengine";
-}
-export declare class NullEmbeddingProvider implements EmbeddingProvider {
-    readonly dimensions = 0;
-    readonly model = "none";
-    embed(_text: string): Promise<Float32Array>;
-    embedBatch(_texts: string[]): Promise<Float32Array[]>;
-}
-export declare class ApiEmbeddingProvider implements EmbeddingProvider {
-    readonly dimensions: number;
-    readonly model: string;
-    private baseUrl;
-    private apiKey;
-    private timeoutMs;
-    private format;
-    constructor(config: EmbeddingApiConfig);
-    embed(text: string): Promise<Float32Array>;
-    embedBatch(texts: string[]): Promise<Float32Array[]>;
-    private buildRequest;
-    private parseResponse;
-}
-export interface LocalEmbeddingConfig {
-    api?: EmbeddingApiConfig;
-}
-/**
- * Create an embedding provider based on configuration.
- *
- * Resolution order:
- *   1. API config → ApiEmbeddingProvider
- *   2. No API config → NullEmbeddingProvider (FTS-only)
- */
-export declare function createEmbeddingProvider(config?: LocalEmbeddingConfig): EmbeddingProvider;
-/**
- * Known provider → format mapping.
- * Used only for the explicit ModelRegistry embedding binding.
- */
-export declare const PROVIDER_EMBEDDING_REGISTRY: Record<string, {
-    format: "openai" | "minimax" | "volcengine";
-    baseUrl: string;
-    defaultModel: string;
-    defaultDimensions: number;
-}>;
-/**
- * Resolve EmbeddingApiConfig from a known provider name + API key.
- * Returns null if the provider has no known embedding endpoint.
- */
-export declare function resolveProviderEmbeddingConfig(provider: string, apiKey: string, overrides?: {
-    model?: string;
-    baseUrl?: string;
-    dimensions?: number;
-}): EmbeddingApiConfig | null;

package/dist/types/skills/memory/memory-config-resolver.d.ts

@@ -1,4 +0,0 @@
-import { type MemoryProviderFactoryConfig } from "./memory-embedding-config.js";
-export type { MemoryProviderFactoryConfig } from "./memory-embedding-config.js";
-/** Resolve embedding configuration without constructing or opening a local memories.db provider. */
-export declare function resolveMemoryConfigFromEnv(): MemoryProviderFactoryConfig;

package/dist/types/skills/memory/memory-embedding-config.d.ts

@@ -1,31 +0,0 @@
-import type { ConfigPort, PathService } from "../../runtime/ports/index.js";
-import type { LocalEmbeddingConfig } from "./local-embedding.js";
-export interface MemoryProviderFactoryConfig {
-    /** Active owner profile. All local memory files are physically scoped here. */
-    ownerUserId: string;
-    /** User ID prefix. */
-    userIdPrefix?: string;
-    /** Embedding config for local provider. */
-    embedding?: LocalEmbeddingConfig;
-}
-export interface MemoryEmbeddingModelBinding {
-    provider: string;
-    apiKey: string;
-    model: string;
-    baseUrl?: string;
-    keyHandle: {
-        release(result: {
-            success: boolean;
-        }): void;
-    };
-}
-export interface MemoryEmbeddingModelRegistry {
-    getActiveModel(purpose: "embedding"): MemoryEmbeddingModelBinding | null;
-}
-export interface MemoryConfigResolutionDeps {
-    config: ConfigPort;
-    pathService: PathService;
-    modelRegistry: MemoryEmbeddingModelRegistry;
-}
-export declare function resolveMemoryProviderConfig(deps: MemoryConfigResolutionDeps): MemoryProviderFactoryConfig;
-export type { LocalEmbeddingConfig };

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

@@ -1,27 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-import type { WebSearchBackend } from "../../runtime/ports/web-search-contracts.js";
-import type { WebFetchToolDeps } from "./web-fetch-tool.js";
-export declare const WEB_ANSWER_TOOL_NAME: "web_answer";
-export interface WebAnswerToolParams {
-    query: string;
-}
-export declare const WEB_ANSWER_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly query: {
-            readonly type: "string";
-            readonly description: "The question to answer using live web search. Be specific and concise.";
-        };
-    };
-    readonly required: readonly ["query"];
-};
-export interface WebAnswerToolDeps {
-    search: WebSearchBackend["search"];
-    fetchUrl: WebFetchToolDeps["fetchUrl"];
-    /**
-     * host 用指定档位 LLM 生成文本(内部 resolveClientForPurpose + transport.stream 累加)。
-     * 无可用模型时返回 null —— 工具据此 fail-loud 降级,不静默编造。
-     */
-    generate(purpose: "smallModel" | "textGeneration", prompt: string, signal: AbortSignal): Promise<string | null>;
-}
-export declare function createWebAnswerTool(deps: WebAnswerToolDeps): PortableTool<WebAnswerToolParams>;

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

@@ -1,80 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const WEB_FETCH_TOOL_NAME: "web_fetch";
-export interface WebFetchToolParams {
-    url: string;
-    extractMode?: "markdown" | "text" | "json";
-    maxChars?: number;
-    query?: string;
-    extract?: boolean;
-    summarize?: boolean;
-}
-export declare const WEB_FETCH_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly url: {
-            readonly type: "string";
-            readonly description: "HTTP or HTTPS URL to fetch.";
-        };
-        readonly extractMode: {
-            readonly type: "string";
-            readonly enum: readonly ["markdown", "text", "json"];
-            readonly description: "Extraction mode: \"markdown\" (default), \"text\", or \"json\" (LLM-driven structured extraction).";
-        };
-        readonly maxChars: {
-            readonly type: "number";
-            readonly description: "Maximum characters to return (truncates when exceeded).";
-            readonly minimum: 100;
-        };
-        readonly query: {
-            readonly type: "string";
-            readonly description: "Original search query. When provided, returns the most query-relevant sections.";
-        };
-        readonly extract: {
-            readonly type: "boolean";
-            readonly description: "When true, returns structured extraction (title, summary, key facts, entities, topics, sentiment).";
-        };
-        readonly summarize: {
-            readonly type: "boolean";
-            readonly description: string;
-        };
-    };
-    readonly required: readonly ["url"];
-};
-export interface WebFetchResult {
-    content: string;
-    title?: string;
-    relevantExcerpts?: string[];
-    summary?: string;
-    extraction?: {
-        title?: string;
-        summary?: string;
-        keyFacts?: string[];
-        entities?: string[];
-        topics?: string[];
-        sentiment?: string;
-    };
-}
-/** Deps injected by the host runtime for web fetching. */
-export interface WebFetchToolDeps {
-    /**
-     * Fetch a URL and extract content.
-     * The host handles user-agent rotation, anti-block,
-     * JS rendering, caching, and content extraction.
-     */
-    fetchUrl(params: {
-        url: string;
-        extractMode?: "markdown" | "text" | "json";
-        maxChars?: number;
-        query?: string;
-        extract?: boolean;
-        /** 调用方取消信号(§15-1):用户中断后抓取必须随之中止,不再烧带宽/时间 */
-        signal?: AbortSignal;
-    }): Promise<WebFetchResult>;
-    /**
-     * Optional: summarize long content using a small/cheap model.
-     * When provided and summarize=true is requested, called after fetchUrl.
-     * Should return a concise summary (< 500 chars) preserving key information.
-     */
-    summarizeContent?(content: string, query?: string): Promise<string>;
-}
-export declare function createWebFetchTool(deps: WebFetchToolDeps): PortableTool<WebFetchToolParams>;