@dsh-plus/web-search-services 0.1.1 → 0.1.3

package/lib/index.js

@@ -118,6 +118,12 @@ function asNonEmptyString(value) {
 function asArray(value) {
 	return Array.isArray(value) ? value : [];
 }
+/** snippet 截断上限：官方 deepseek provider 的摘录是短引文；Tavily content /
+*  Exa highlights 原始值可达整页文本，直接透传会撑爆工具结果上下文。 */
+const SNIPPET_MAX_CHARS = 500;
+function truncateSnippet(text) {
+	return text.length <= SNIPPET_MAX_CHARS ? text : `${text.slice(0, SNIPPET_MAX_CHARS)}…`;
+}
 function makeSource(url, title, snippet, publishedAt) {
 	return {
 		url,
@@ -126,6 +132,12 @@ function makeSource(url, title, snippet, publishedAt) {
 		...publishedAt !== void 0 ? { publishedAt } : {}
 	};
 }
+/** skill 各服务 request() 统一信封 {ok, service, status, data: <API 响应>}；
+* 取 data 为业务 payload，data 缺失/空对象时回退顶层（旧形状容差）。 */
+function payloadOf(raw) {
+	const data = asObject(raw.data);
+	return Object.keys(data).length > 0 ? data : raw;
+}
 function finish(content, sources) {
 	const seen = /* @__PURE__ */ new Set();
 	const deduped = sources.filter((source) => {
@@ -148,19 +160,21 @@ function sourcesFromResults(results, pick) {
 	return out;
 }
 function normalizeTavily(raw) {
-	const sources = sourcesFromResults(raw.results, (item) => {
+	const payload = payloadOf(raw);
+	const sources = sourcesFromResults(payload.results, (item) => {
 		const url = asNonEmptyString(item.url);
+		const content = asNonEmptyString(item.content);
 		if (url === void 0) return void 0;
-		return makeSource(url, asNonEmptyString(item.title), asNonEmptyString(item.content), asNonEmptyString(item.published_date));
+		return makeSource(url, asNonEmptyString(item.title), content !== void 0 ? truncateSnippet(content) : void 0, asNonEmptyString(item.published_date));
 	});
-	return finish(asNonEmptyString(raw.answer), sources);
+	return finish(asNonEmptyString(payload.answer), sources);
 }
 function normalizeExa(raw) {
-	return finish(void 0, sourcesFromResults(raw.results, (item) => {
+	return finish(void 0, sourcesFromResults(payloadOf(raw).results, (item) => {
 		const url = asNonEmptyString(item.url) ?? asNonEmptyString(item.id);
 		if (url === void 0) return void 0;
 		const highlights = asArray(item.highlights).map((h) => asNonEmptyString(h)).filter((h) => h !== void 0);
-		return makeSource(url, asNonEmptyString(item.title), highlights.length > 0 ? highlights.join(" ") : void 0, asNonEmptyString(item.publishedDate));
+		return makeSource(url, asNonEmptyString(item.title), highlights.length > 0 ? truncateSnippet(highlights.join(" ")) : void 0, asNonEmptyString(item.publishedDate));
 	}));
 }
 const MARKDOWN_LINK = /\[([^\]]*)\]\((https?:\/\/[^)\s]+)\)/g;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/web-search-services",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "dsh-plus service plugin: web_search 免费后端聚合——经官方 ctx.web provider 扩展点桥接 search-services skill（Tavily/Exa/OpenAI Chat 免费额度，优先级+自动回退+key 配置），官方 web_search 工具与输出格式零修改",
   "type": "module",
   "main": "lib/index.js",

package/src/normalize.ts

@@ -1,9 +1,10 @@
 /**
  * search.py 输出 → dsh-web 标准 WebSearchResult 归一化（纯函数）。
  *
- * skill 各后端 payload 形状不同：tavily/exa 是原生 API 形状（results[]），
- * openai-chat 是生成式回答（data.answer）。按 selectedService 归一；
- * 字段缺失降级而非报错（对 skill 脚本版本漂移保持容差）。
+ * skill 各服务 request() 统一信封 {ok, service, status, data: <API 原始响应>}：
+ * tavily/exa 业务字段在 data 下（results/answer），openai-chat 回答在
+ * data.answer。按 selectedService 归一；字段缺失降级而非报错（对 skill
+ * 脚本版本漂移保持容差）。
  * @module web-search-services/normalize
  */
 import type { WebSearchResult, WebSearchSource } from '@deepseek-ai/dsh-web'
@@ -24,6 +25,14 @@ function asArray(value: unknown): unknown[] {
   return Array.isArray(value) ? value : []
 }
 
+/** snippet 截断上限：官方 deepseek provider 的摘录是短引文；Tavily content /
+ *  Exa highlights 原始值可达整页文本，直接透传会撑爆工具结果上下文。 */
+const SNIPPET_MAX_CHARS = 500
+
+export function truncateSnippet(text: string): string {
+  return text.length <= SNIPPET_MAX_CHARS ? text : `${text.slice(0, SNIPPET_MAX_CHARS)}…`
+}
+
 function makeSource(
   url: string,
   title?: string,
@@ -38,6 +47,13 @@ function makeSource(
   }
 }
 
+/** skill 各服务 request() 统一信封 {ok, service, status, data: <API 响应>}；
+ * 取 data 为业务 payload，data 缺失/空对象时回退顶层（旧形状容差）。 */
+function payloadOf(raw: JsonObject): JsonObject {
+  const data = asObject(raw.data)
+  return Object.keys(data).length > 0 ? data : raw
+}
+
 function finish(content: string | undefined, sources: WebSearchSource[]): WebSearchResult {
   const seen = new Set<string>()
   const deduped = sources.filter((source) => {
@@ -65,21 +81,24 @@ function sourcesFromResults(
 }
 
 function normalizeTavily(raw: JsonObject): WebSearchResult {
-  const sources = sourcesFromResults(raw.results, (item) => {
+  const payload = payloadOf(raw)
+  const sources = sourcesFromResults(payload.results, (item) => {
     const url = asNonEmptyString(item.url)
+    const content = asNonEmptyString(item.content)
     if (url === undefined) return undefined
     return makeSource(
       url,
       asNonEmptyString(item.title),
-      asNonEmptyString(item.content),
+      content !== undefined ? truncateSnippet(content) : undefined,
       asNonEmptyString(item.published_date),
     )
   })
-  return finish(asNonEmptyString(raw.answer), sources)
+  return finish(asNonEmptyString(payload.answer), sources)
 }
 
 function normalizeExa(raw: JsonObject): WebSearchResult {
-  const sources = sourcesFromResults(raw.results, (item) => {
+  const payload = payloadOf(raw)
+  const sources = sourcesFromResults(payload.results, (item) => {
     const url = asNonEmptyString(item.url) ?? asNonEmptyString(item.id)
     if (url === undefined) return undefined
     const highlights = asArray(item.highlights)
@@ -88,7 +107,7 @@ function normalizeExa(raw: JsonObject): WebSearchResult {
     return makeSource(
       url,
       asNonEmptyString(item.title),
-      highlights.length > 0 ? highlights.join(' ') : undefined,
+      highlights.length > 0 ? truncateSnippet(highlights.join(' ')) : undefined,
       asNonEmptyString(item.publishedDate),
     )
   })