dsh-kenari-plugin 0.1.1

package/lib/web/search.js

@@ -0,0 +1,47 @@
+/**
+ * Kenari web 搜索 provider：`POST /v1/web/search` 映射为 seam 的 WebSearchProvider。
+ * available() 只做本地检查（硬约束 5）；字段映射集中在文件顶部便于跟进 rc 变动。
+ * @module dsh-kenari-plugin/web/search
+ */
+import { kenariPost } from '../http.js';
+/** Kenari `max_results` 上限（OpenAPI 1–10，默认 5）。 */
+const KENARI_MAX_RESULTS = 10;
+const KENARI_DEFAULT_RESULTS = 5;
+/** seam 词汇 → Kenari 请求的映射要点（对照知识库 kenari-api.md）。 */
+export const KENARI_SEARCH_PROVIDER_ID = 'kenari-fallback';
+export class KenariSearchProvider {
+    deps;
+    recordSpend;
+    id = KENARI_SEARCH_PROVIDER_ID;
+    constructor(deps, recordSpend) {
+        this.deps = deps;
+        this.recordSpend = recordSpend;
+    }
+    /** key 现场解析，本地判定可用性；不发网络请求。 */
+    available() {
+        return true;
+    }
+    async search(request, signal) {
+        const maxResults = Math.min(request.maxResults ?? KENARI_DEFAULT_RESULTS, KENARI_MAX_RESULTS);
+        const response = await kenariPost(this.deps, '/web/search', { query: request.query, max_results: maxResults }, signal);
+        if (typeof response.cost_micro_idr === 'number')
+            this.recordSpend?.(response.cost_micro_idr, 'search');
+        const results = response.results ?? [];
+        // content 字段为 Kenari 的条目摘要，映射到 snippet；顶层 content 留空（seam 语义：provider 生成答案）
+        const sources = results.flatMap((item) => {
+            if (item.url === undefined)
+                return [];
+            return [{
+                    url: item.url,
+                    title: item.title,
+                    snippet: item.content,
+                }];
+        });
+        return {
+            sources,
+            // seam 在返回时按 maxResults 截断；provider 未截断则为 false
+            truncated: false,
+        };
+    }
+}
+//# sourceMappingURL=search.js.map

package/lib/web/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/web/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,UAAU,EAA6B,MAAM,YAAY,CAAA;AAElE,kDAAkD;AAClD,MAAM,kBAAkB,GAAG,EAAE,CAAA;AAC7B,MAAM,sBAAsB,GAAG,CAAC,CAAA;AAEhC,qDAAqD;AACrD,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAA;AAK1D,MAAM,OAAO,oBAAoB;IAIZ;IACA;IAJV,EAAE,GAAG,yBAAyB,CAAA;IAEvC,YACmB,IAAoB,EACpB,WAA4B;QAD5B,SAAI,GAAJ,IAAI,CAAgB;QACpB,gBAAW,GAAX,WAAW,CAAiB;IAC5C,CAAC;IAEJ,+BAA+B;IAC/B,SAAS;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAyB,EAAE,MAAoB;QAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,sBAAsB,EAAE,kBAAkB,CAAC,CAAA;QAC7F,MAAM,QAAQ,GAAG,MAAM,UAAU,CAC/B,IAAI,CAAC,IAAI,EACT,aAAa,EACb,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,EACjD,MAAM,CACP,CAAA;QACD,IAAI,OAAO,QAAQ,CAAC,cAAc,KAAK,QAAQ;YAAE,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAA;QACtG,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAA;QACtC,4EAA4E;QAC5E,MAAM,OAAO,GAAsB,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YAC1D,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS;gBAAE,OAAO,EAAE,CAAA;YACrC,OAAO,CAAC;oBACN,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,OAAO,EAAE,IAAI,CAAC,OAAO;iBACtB,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QACF,OAAO;YACL,OAAO;YACP,gDAAgD;YAChD,SAAS,EAAE,KAAK;SACjB,CAAA;IACH,CAAC;CACF"}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "dsh-kenari-plugin",
+  "version": "0.1.1",
+  "description": "Kenari (kenari.id) as a first-class citizen of DeepSeek Harness: session models, web search/fetch provider with fallback, and REST capability tools.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ryan-yuan-dev/dsh-kenari-plugin.git"
+  },
+  "homepage": "https://github.com/ryan-yuan-dev/dsh-kenari-plugin#readme",
+  "bugs": {
+    "url": "https://github.com/ryan-yuan-dev/dsh-kenari-plugin/issues"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./client/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "client",
+    "assets",
+    "cordis.patch.yml",
+    "README.md",
+    "README.en.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/check-client.mjs",
+    "prepublishOnly": "pnpm build",
+    "check:client": "node scripts/check-client.mjs",
+    "test": "node test/real-harness.mjs",
+    "test:default-route": "node test/default-route.mjs",
+    "test:view": "node test/catalog-view.mjs",
+    "test:favicon": "node test/favicon.mjs",
+    "test:session-title": "node test/session-title.mjs"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-settings-models"
+      ],
+      "immediately": true
+    }
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-attachment": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-connection": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-credentials": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-launch-environment": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-llm": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-settings": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-tools": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-util-values": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-web": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-web-fetch-http": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-web-search-deepseek": "0.1.5-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.1-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-agent": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-attachment": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-connection": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-session": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-util-values": "0.1.5-rc.1",
+    "@types/node": "^24",
+    "typescript": "^5.9.2"
+  }
+}