qlogicagent 2.11.11 → 2.11.13

package/dist/types/cli/base-tool-bootstrap.d.ts

@@ -1,9 +1,16 @@
 import type { NotificationMethod, NotificationMethodMap } from "../protocol/notifications.js";
 import type { ToolBootstrap } from "../runtime/ports/index.js";
+import type { ModelPurpose } from "../runtime/infra/model-registry.js";
+import type { LLMTransport } from "./provider-core-facade.js";
 export interface BaseToolBootstrapDeps {
     verbose: boolean;
     toolBootstrap: ToolBootstrap;
     log(message: string): void;
     sendNotification<M extends NotificationMethod>(method: M, params: NotificationMethodMap[M]): void;
+    resolveClientForPurpose?(purpose: ModelPurpose): {
+        transport: LLMTransport;
+        apiKey: string;
+        model: string;
+    } | null;
 }
 export declare function configureBaseToolBootstrap(deps: BaseToolBootstrapDeps): void;

package/dist/types/cli/handlers/files-handler.d.ts

@@ -11,6 +11,7 @@ export interface FilesHandlerHost {
 export declare function resolveProjectDir(projectId: string): string | null;
 export declare function handleFilesList(this: FilesHandlerHost, msg: AgentRpcRequest): Promise<void>;
 export declare function handleFilesCreate(this: FilesHandlerHost, msg: AgentRpcRequest): Promise<void>;
+export declare function handleFilesRead(this: FilesHandlerHost, msg: AgentRpcRequest): Promise<void>;
 export declare function handleFilesRename(this: FilesHandlerHost, msg: AgentRpcRequest): Promise<void>;
 export declare function handleFilesDelete(this: FilesHandlerHost, msg: AgentRpcRequest): Promise<void>;
 export declare function handleFilesGitStatus(this: FilesHandlerHost, msg: AgentRpcRequest): Promise<void>;

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

@@ -2,6 +2,8 @@ import type { PortableTool } from "../skills/portable-tool.js";
 import type { PermissionMode } from "../runtime/ports/permission-contracts.js";
 import { type TaskToolHooks } from "../skills/tools/task-tool.js";
 import { type ExecProgress } from "../skills/tools/exec-tool.js";
+import type { ModelPurpose } from "../runtime/infra/model-registry.js";
+import type { LLMTransport } from "./provider-core-facade.js";
 import type { AgentLogger } from "../agent/types.js";
 import { type AskUserQuestion } from "../skills/tools/ask-user-tool.js";
 import type { PathService, ToolCatalog } from "../runtime/ports/index.js";
@@ -65,6 +67,12 @@ export interface BootstrapConfig {
     log?: AgentLogger;
     /** Called during foreground shell execution with incremental progress. */
     onExecProgress?(progress: ExecProgress): void;
+    /** host 多档 LLM 解析(web_answer/web_research 用);未提供则不注册这些工具(零孤立)。 */
+    resolveClientForPurpose?(purpose: ModelPurpose): {
+        transport: LLMTransport;
+        apiKey: string;
+        model: string;
+    } | null;
 }
 /**
  * Create all locally-executable tools and install into centralized tool pool.

package/dist/types/protocol/methods.d.ts

@@ -172,6 +172,8 @@ export interface ToolsListParams {
     category?: ToolCapabilityCategory;
     /** Include tools that are normally deferred until activated. */
     includeDeferred?: boolean;
+    /** Include tools that are installed but currently disabled by provider/config availability. */
+    includeUnavailable?: boolean;
 }
 export interface ToolsListResult {
     tools: Array<{
@@ -185,6 +187,7 @@ export interface ToolsListResult {
         description: string;
         source: "builtin";
         deferred: boolean;
+        enabled?: boolean;
         parameters?: Record<string, unknown>;
     }>;
     total: number;

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

@@ -0,0 +1,39 @@
+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/skills/tools/web-answer-tool.d.ts

@@ -0,0 +1,27 @@
+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-research-tool.d.ts

@@ -0,0 +1,19 @@
+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;
+}
+export declare const WEB_RESEARCH_TOOL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly task: {
+            readonly type: "string";
+            readonly description: string;
+        };
+    };
+    readonly required: readonly ["task"];
+};
+/** 与 web_answer 同 deps:search / fetchUrl / generate(host LLM 累加)。 */
+export type WebResearchToolDeps = WebAnswerToolDeps;
+export declare function createWebResearchTool(deps: WebResearchToolDeps): PortableTool<WebResearchToolParams>;

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

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

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

@@ -0,0 +1,15 @@
+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(): boolean;
+}
+export declare function createCrawl4aiExtractor(): Crawl4aiExtractor;

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

@@ -0,0 +1,13 @@
+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 工厂(默认复用 memory 的 embedding 解析)。测试/ECS 可替换。 */
+    getProvider?: () => 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

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

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

@@ -0,0 +1,7 @@
+import type { SourceProvider } from "../../runtime/ports/source-provider.js";
+/**
+ * 组装 web_search 的 L0 数据源集合。
+ * SearXNG 为默认主源;Exa/Brave/Serper 为 BYOK(凭证读 settings tunables / env),
+ * 未配置 key 时其 search 返回空数组,不影响整体召回。
+ */
+export declare function buildWebSearchSources(): SourceProvider[];

package/dist/types/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/types/transport/acp-server.d.ts

@@ -156,8 +156,10 @@ export declare class AcpServer {
     private onSessionPrompt;
     private onSessionClose;
     private onSessionSetConfig;
+    private onSessionSetModel;
     private onSessionSetMode;
     private onAbort;
+    private onSessionCancel;
     private onCancel;
     private onDream;
     private sendResult;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.11.11",
+  "version": "2.11.13",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -62,6 +62,26 @@
       ]
     }
   },
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "node scripts/build.mjs",
+    "build:tsc": "tsc --noCheck",
+    "start": "node dist/cli.js",
+    "test": "vitest run",
+    "check": "tsc --noEmit && pnpm test && pnpm run check:architecture-boundaries && pnpm run check:provider-core-boundary && pnpm run check:pet-core-boundary && pnpm run check:workspace-hygiene && pnpm run check:package-artifact",
+    "test:watch": "vitest",
+    "lint": "oxlint .",
+    "check:architecture-boundaries": "node scripts/check-architecture-boundaries.mjs",
+    "check:provider-core-boundary": "node scripts/check-provider-core-boundary.mjs",
+    "check:pet-core-boundary": "node scripts/check-pet-core-boundary.mjs",
+    "check:workspace-hygiene": "node scripts/check-workspace-hygiene.mjs",
+    "check:workspace-hygiene:strict": "node scripts/check-workspace-hygiene.mjs --strict",
+    "check:package-artifact": "npm run build && node scripts/check-package-artifact.mjs",
+    "redteam:community-desensitization": "tsx src/runtime/community/community-desensitization-red-team-cli.ts",
+    "redteam:community-sandbox": "tsx src/skills/permissions/community-sandbox-red-team-cli.ts",
+    "clean:workspace-hygiene": "node scripts/clean-workspace-hygiene.mjs",
+    "release": "node scripts/release.mjs"
+  },
   "engines": {
     "node": ">=22.0.0"
   },
@@ -84,25 +104,5 @@
     "tsx": "^4.19.0",
     "typescript": "^5.9.0",
     "vitest": "^3.1.0"
-  },
-  "scripts": {
-    "dev": "tsx watch src/index.ts",
-    "build": "node scripts/build.mjs",
-    "build:tsc": "tsc --noCheck",
-    "start": "node dist/cli.js",
-    "test": "vitest run",
-    "check": "tsc --noEmit && pnpm test && pnpm run check:architecture-boundaries && pnpm run check:provider-core-boundary && pnpm run check:pet-core-boundary && pnpm run check:workspace-hygiene && pnpm run check:package-artifact",
-    "test:watch": "vitest",
-    "lint": "oxlint .",
-    "check:architecture-boundaries": "node scripts/check-architecture-boundaries.mjs",
-    "check:provider-core-boundary": "node scripts/check-provider-core-boundary.mjs",
-    "check:pet-core-boundary": "node scripts/check-pet-core-boundary.mjs",
-    "check:workspace-hygiene": "node scripts/check-workspace-hygiene.mjs",
-    "check:workspace-hygiene:strict": "node scripts/check-workspace-hygiene.mjs --strict",
-    "check:package-artifact": "npm run build && node scripts/check-package-artifact.mjs",
-    "redteam:community-desensitization": "tsx src/runtime/community/community-desensitization-red-team-cli.ts",
-    "redteam:community-sandbox": "tsx src/skills/permissions/community-sandbox-red-team-cli.ts",
-    "clean:workspace-hygiene": "node scripts/clean-workspace-hygiene.mjs",
-    "release": "node scripts/release.mjs"
   }
-}
+}