qlogicagent 2.11.14 → 2.12.2

package/dist/types/runtime/infra/media-persistence.d.ts

@@ -5,13 +5,14 @@
  * cloud URLs, this service downloads them to a persistent local directory
  * so the user can access them offline without manual intervention.
  *
- * Storage layout (per persistence-storage-rules.md):
- *   <project>/.qlogicagent/sessions/<sessionId>/media/
- *   ├── image_20260520_143022_abc.png
- *   ├── video_20260520_143055_def.mp4
- *   └── audio_20260520_143100_ghi.mp3
+ * Storage layout:
+ *   <project>/assets/images/image_20260520_143022_abc.png
+ *   <project>/assets/videos/video_20260520_143055_def.mp4
+ *   <project>/assets/audio/audio_20260520_143100_ghi.mp3
+ *   <project>/assets/models/  <project>/assets/files/
  *
- * Media files belong to their session. No global media storage.
+ * 产出归项目工作区可见的 assets/ 目录(按类型分),项目级、所有会话共享 —— 文件树可见可
+ * 管理。文件名带时间戳+随机后缀保证多会话不冲突。(旧版曾存于 .qlogicagent/sessions/<id>/media/)
  *
  * Integration:
  *   Called from the tool result pipeline in tool-loop.ts.
@@ -31,8 +32,8 @@ export interface MediaDownloadResult {
 export interface MediaPersistenceConfig {
     /**
      * Project working directory. Media downloads to:
-     *   `{projectDir}/.qlogicagent/sessions/{sessionId}/media/`
-     * This is the only correct location per persistence-storage-rules.
+     *   `{projectDir}/assets/{images|videos|audio|models|files}/`
+     * 项目工作区可见目录,所有会话共享。
      */
     projectDir?: string;
     /** Maximum file size to download (bytes). Default: 500MB. */
@@ -48,8 +49,11 @@ export declare class MediaPersistence {
     /** Update project root directory. */
     setProjectDir(projectDir: string): void;
     /**
-     * Resolve the media directory for a given session.
-     * Path: <project>/.qlogicagent/sessions/<sessionId>/media/
+     * Resolve the media directory for a given media type.
+     * Path: <project>/assets/<typeSubdir>/   (项目工作区可见目录,文件树可见可管理)
+     *
+     * 产出归项目级 assets 目录(images/videos/audio/models/files),所有会话共享 —— 一个项目
+     * 不同会话的产出始终在工作区可见目录,而非会话级隐藏目录。文件名带时间戳+随机后缀保证不冲突。
      */
     private resolveMediaDir;
     /**
@@ -75,8 +79,8 @@ export declare class MediaPersistence {
     }, log?: {
         warn: (msg: string) => void;
     }): Promise<MediaDownloadResult[]>;
-    /** Get the media directory path for a session. */
-    getMediaDir(sessionId?: string): string;
+    /** Get the project-level assets root (<project>/assets). */
+    getMediaDir(): string;
     /** Get the project directory (for testing/inspection). */
     getProjectDir(): string | null;
 }

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

@@ -13,5 +13,9 @@ export interface WebSearchBackend {
         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

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

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

@@ -67,6 +67,8 @@ export interface WebFetchToolDeps {
         maxChars?: number;
         query?: string;
         extract?: boolean;
+        /** 调用方取消信号(§15-1):用户中断后抓取必须随之中止,不再烧带宽/时间 */
+        signal?: AbortSignal;
     }): Promise<WebFetchResult>;
     /**
      * Optional: summarize long content using a small/cheap model.

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

@@ -3,6 +3,12 @@ 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";
@@ -11,9 +17,32 @@ export declare const WEB_RESEARCH_TOOL_SCHEMA: {
             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:search / fetchUrl / generate(host LLM 累加)。 */
-export type WebResearchToolDeps = WebAnswerToolDeps;
+/** 与 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

@@ -5,6 +5,7 @@ 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";
@@ -27,6 +28,11 @@ export declare const WEB_SEARCH_TOOL_SCHEMA: {
             };
             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"];
 };

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

@@ -1,13 +1,13 @@
 import type { RawHit } from "../../runtime/ports/source-provider.js";
-import { type EmbeddingProvider } from "../memory/local-embedding.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;
+    /** embedding provider 工厂(调用方注入,可异步懒解析)。dimensions=0 视为无模型 → 原序。 */
+    getProvider: () => EmbeddingProvider | Promise<EmbeddingProvider>;
     /** 每条 hit 文本(title+snippet)最大字符,控 token。默认 512。 */
     maxTextChars?: number;
 }
-export declare function createEmbeddingReranker(deps?: EmbeddingRerankerDeps): Reranker;
+export declare function createEmbeddingReranker(deps: EmbeddingRerankerDeps): Reranker;

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.11.14",
+  "version": "2.12.2",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -92,6 +92,7 @@
     "@xiaozhiclaw/provider-core": "0.1.7",
     "better-sqlite3": "^12.10.0",
     "dotenv": "^17.3.1",
+    "ioredis": "^5.11.1",
     "nanoid": "^5.1.5",
     "pino": "^9.6.0",
     "pino-pretty": "^13.0.0"