dsh-web-search-workbuddy 0.4.0 → 0.4.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +57 -8
- package/lib/index.js +317 -2
- package/lib/types/index.d.ts +9 -0
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -6,6 +6,11 @@ workbuddy2api-go gateway's agenttool web-search passthrough, with
|
|
|
6
6
|
[workbuddy-manager](https://github.com/WaveBird/workbuddy-manager) as the
|
|
7
7
|
entry proxy — so **one `wbk_` key serves both the chat route and `web_search`**.
|
|
8
8
|
|
|
9
|
+
**v0.4.1**: optionally owns the model-facing `web_search` tool so the model
|
|
10
|
+
itself can choose `allowedDomains` / `blockedDomains` / `freshness` /
|
|
11
|
+
`maxResults` per call — without patching the official `dsh-tool-web` package.
|
|
12
|
+
Original provider-only mode (v0.4.0) remains the default.
|
|
13
|
+
|
|
9
14
|
**v0.4.0**: forwards every parameter `workbuddy.cn/agenttool/v1/search`
|
|
10
15
|
supports (`type`, `max_results`, `allowed_domains`, `blocked_domains`,
|
|
11
16
|
`freshness`) — see [Protocol](#protocol).
|
|
@@ -33,7 +38,7 @@ expecting the gateway key):
|
|
|
33
38
|
|---|---|---|
|
|
34
39
|
| **workbuddy-manager** | **≥ the `feat/web-search-passthrough` branch** ([PR #2](https://github.com/WaveBird/workbuddy-manager/pull/2), upstream [PR #430](https://github.com/ithtelab/workbuddy-manager/pull/430)). Baseline tested: `v2.11.14` + the PR's 3 commits (`dce9acc` route, `5e88629` realm fix, `c33e122` docs). For the v0.4.0 full-parameter set also take the small API follow-up: `/v1/tools/search` validates `type`/`max_results`/`allowed_domains`/`blocked_domains`/`freshness` and forwards the body verbatim. It will ship in a release **after v2.11.14** — until then, deploy the branch or cherry-pick. | The `POST /v1/tools/search` passthrough route **does not exist** in upstream releases ≤ v2.11.14. Older managers return `405` and this provider cannot work through them. |
|
|
35
40
|
| **workbuddy2api-go gateway** | Built from the upstream snapshot **`upstream-id 801cebba` (v2.11.14 / 0056 patches)** plus [`0057-web-search-tool.patch`](https://github.com/WaveBird/workbuddy-manager/blob/feat/web-search-passthrough/dev/upstream-patches/0057-web-search-tool.patch) (shipped inside the manager PR above). | The `POST /v1/tools/search` handler, account-pool rotation, and 15001 quota cooldown live in this patch; the stock gateway has no agenttool route. |
|
|
36
|
-
| **DeepSeek Harness (DSH)** |
|
|
41
|
+
| **DeepSeek Harness (DSH)** | `>=0.2.2-rc.1 <0.3.0-0` (web seam contract `ctx.web.registerSearchProvider` / `WebSearchProvider` shape). Verified against `0.2.2-rc.1` through `0.2.2-rc.5`; any `0.2.x` version keeping that seam shape works. | The provider registers into `ctx.web`; a breaking seam change (e.g. `0.3.x`) would require a plugin update. |
|
|
37
42
|
| **Realm coverage (CN + Global)** | Both realms supported. The gateway routes agenttool by account realm (CN → `www.workbuddy.cn`, Global → `www.workbuddy.ai`, both endpoints probe-verified) — a `global:`-realm key (WorkBuddy AI / international) searches the same way as CN. The plugin itself is realm-agnostic: it follows whatever model route the conversation uses. | International accounts participate in the same account-pool rotation and 15001 quota cooldown as CN. |
|
|
38
43
|
|
|
39
44
|
Quick self-check per component:
|
|
@@ -53,9 +58,14 @@ curl -s -o /dev/null -w '%{http_code}\n' -X POST http://127.0.0.1:7863/v1/tools/
|
|
|
53
58
|
## Install
|
|
54
59
|
|
|
55
60
|
```bash
|
|
56
|
-
|
|
57
|
-
|
|
61
|
+
# Recommended: via the DSH plugin CLI (pass --profile <name> if not using the default profile):
|
|
62
|
+
dsh plugin add dsh-web-search-workbuddy
|
|
63
|
+
# e.g. for the `web` profile:
|
|
64
|
+
dsh plugin --profile web add dsh-web-search-workbuddy
|
|
65
|
+
|
|
66
|
+
# Or directly via pnpm / npm:
|
|
58
67
|
cd ~/.dsh/profiles/web && pnpm add dsh-web-search-workbuddy
|
|
68
|
+
npm install dsh-web-search-workbuddy
|
|
59
69
|
```
|
|
60
70
|
|
|
61
71
|
Peer dependencies (`@deepseek-ai/dsh-web`, `@deepseek-ai/dsh-credentials`,
|
|
@@ -77,6 +87,9 @@ installed this way; `@deepseek-ai/schemastery` ships as a direct dependency.
|
|
|
77
87
|
# allowedDomains: [go.dev] # 只返回这些域
|
|
78
88
|
# blockedDomains: [reddit.com] # 网关拼成 " -site:reddit.com"
|
|
79
89
|
# freshness: d1 # d1 | m1 | y1
|
|
90
|
+
# modelControlled: true # v0.4.1:模型自主控制过滤参数
|
|
91
|
+
# modelMaxQueries: 10 # 一次调用最多几条 query
|
|
92
|
+
# modelSummaryMaxChars: 800 # 每条来源摘要上限
|
|
80
93
|
- id: web
|
|
81
94
|
name: '@deepseek-ai/dsh-web'
|
|
82
95
|
config:
|
|
@@ -84,12 +97,46 @@ installed this way; `@deepseek-ai/schemastery` ships as a direct dependency.
|
|
|
84
97
|
searchProvider: workbuddy-gateway # ← pin this provider
|
|
85
98
|
- id: tool-web
|
|
86
99
|
name: '@deepseek-ai/dsh-tool-web'
|
|
100
|
+
# Default mode (modelControlled: false): keep search: true in EVERY preset.
|
|
87
101
|
config: { fetch: true, search: true, searchTimeoutMs: 60000 }
|
|
88
102
|
# also set search: true in every agent preset's tool-web entry
|
|
89
103
|
```
|
|
90
104
|
|
|
105
|
+
### Model-controlled mode (v0.4.1)
|
|
106
|
+
|
|
107
|
+
With `modelControlled: true`, this plugin registers a replacement `web_search`
|
|
108
|
+
tool whose schema exposes:
|
|
109
|
+
|
|
110
|
+
```json
|
|
111
|
+
{
|
|
112
|
+
"queries": ["go generics"],
|
|
113
|
+
"allowedDomains": ["go.dev"],
|
|
114
|
+
"blockedDomains": ["reddit.com"],
|
|
115
|
+
"freshness": "d1",
|
|
116
|
+
"maxResults": 5
|
|
117
|
+
}
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
The tool forwards those extras into `ctx.web.search()`'s request object; the
|
|
121
|
+
seam passes it through unchanged and the provider maps them onto the gateway
|
|
122
|
+
body (request values win over the config defaults above). No DSH framework
|
|
123
|
+
file is modified. Because `ctx.tools.register()` rejects duplicate names,
|
|
124
|
+
assembly **must** set `search: false` on every `@deepseek-ai/dsh-tool-web`
|
|
125
|
+
entry (the global one and all agent presets); `web_fetch` stays enabled:
|
|
126
|
+
|
|
127
|
+
```yaml
|
|
128
|
+
- id: tool-web
|
|
129
|
+
name: '@deepseek-ai/dsh-tool-web'
|
|
130
|
+
config: { fetch: true, search: false, searchTimeoutMs: 60000 }
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
If any preset still has `search: true`, startup reports a duplicate
|
|
134
|
+
`web_search`; either disable it or set `modelControlled: false` to keep the
|
|
135
|
+
official tool. A system-prompt section teaches the model when to use the four
|
|
136
|
+
optional filters.
|
|
137
|
+
|
|
91
138
|
Fully restart `dsh web` afterwards (patch changes do not HMR). The model's tool
|
|
92
|
-
catalog gains `web_search` in new sessions.
|
|
139
|
+
catalog gains the extended `web_search` in new sessions.
|
|
93
140
|
|
|
94
141
|
### Zero-config credential derivation
|
|
95
142
|
|
|
@@ -136,10 +183,12 @@ for `blocked_domains` (official CLI semantics).
|
|
|
136
183
|
| `blocked_domains` | `blockedDomains` | string[]; same normalization; empty = omitted |
|
|
137
184
|
| `freshness` | `freshness` | `d1` \| `m1` \| `y1`; unset = omitted |
|
|
138
185
|
|
|
139
|
-
The DSH web seam's `WebSearchRequest` carries only `query` + `maxResults
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
186
|
+
The DSH web seam's `WebSearchRequest` carries only `query` + `maxResults` in
|
|
187
|
+
its type, but `ctx.web.search()` passes the request object through untouched.
|
|
188
|
+
In default mode (v0.4.0) the other four parameters are deployment-level
|
|
189
|
+
defaults in this plugin's config. In `modelControlled: true` mode (v0.4.1) the
|
|
190
|
+
plugin-owned tool exposes them to the model per call. For direct callers each
|
|
191
|
+
one also accepts a **per-request override**, in camelCase or the upstream
|
|
143
192
|
snake_case spelling — `type`, `maxResults`/`max_results`,
|
|
144
193
|
`allowedDomains`/`allowed_domains`, `blockedDomains`/`blocked_domains`,
|
|
145
194
|
`freshness`. Request overrides win over config; invalid `freshness` fails
|
package/lib/index.js
CHANGED
|
@@ -47,6 +47,24 @@
|
|
|
47
47
|
* Provider id registers as "workbuddy-gateway"; pin it with
|
|
48
48
|
* `web.searchProvider: workbuddy-gateway` in the profile patch.
|
|
49
49
|
*
|
|
50
|
+
* ## Model-facing tool (v0.4.1, optional)
|
|
51
|
+
*
|
|
52
|
+
* The official `@deepseek-ai/dsh-tool-web` registers `web_search` with only
|
|
53
|
+
* `queries` and drops every other argument before calling `ctx.web.search()`.
|
|
54
|
+
* When `modelControlled: true`, this plugin registers its own `web_search`
|
|
55
|
+
* tool (same name) with the extra agenttool parameters exposed to the model:
|
|
56
|
+
*
|
|
57
|
+
* allowedDomains / blockedDomains / freshness / maxResults
|
|
58
|
+
*
|
|
59
|
+
* Assembly must disable the official registration in every `tool-web` entry
|
|
60
|
+
* (`search: false`) — `ctx.tools.register()` rejects duplicate names. The
|
|
61
|
+
* official `web_fetch` stays untouched. `ctx.web.search()` passes the request
|
|
62
|
+
* object through unchanged, so the provider's per-request overrides map the
|
|
63
|
+
* model's choices onto the gateway body without patching DSH core.
|
|
64
|
+
*
|
|
65
|
+
* When `modelControlled: false` (default), the plugin only registers the
|
|
66
|
+
* provider; the official tool keeps working with the config-level defaults.
|
|
67
|
+
*
|
|
50
68
|
* ## Credential & endpoint resolution (zero-config by default)
|
|
51
69
|
*
|
|
52
70
|
* With no `baseURL`/`apiKeyEnv` in this plugin's config, both are **derived
|
|
@@ -77,7 +95,7 @@ const PROVIDER_ID = "workbuddy-gateway";
|
|
|
77
95
|
/** Cordis plugin name used by loader diagnostics. */
|
|
78
96
|
const name = "web-search-workbuddy";
|
|
79
97
|
|
|
80
|
-
/** The web seam this provider registers into. */
|
|
98
|
+
/** The web seam this provider registers into (tools/systemPrompt are optional). */
|
|
81
99
|
const inject = ["web"];
|
|
82
100
|
|
|
83
101
|
/** Loader package that owns the pi-ai provider profiles. */
|
|
@@ -112,6 +130,16 @@ const Config = z.object({
|
|
|
112
130
|
blockedDomains: z.array(z.string()).volatile(),
|
|
113
131
|
/** Recency filter: d1 | m1 | y1. Omit to leave it unset. */
|
|
114
132
|
freshness: z.union(FRESHNESS_VALUES.map((value) => z.const(value))).volatile(),
|
|
133
|
+
/**
|
|
134
|
+
* Register the plugin-owned `web_search` tool with model-visible filter
|
|
135
|
+
* parameters. Requires `tool-web.search: false` in every preset. Default
|
|
136
|
+
* false = keep the official `@deepseek-ai/dsh-tool-web` tool.
|
|
137
|
+
*/
|
|
138
|
+
modelControlled: z.boolean().default(false).volatile(),
|
|
139
|
+
/** Max queries accepted by one plugin-owned `web_search` call. */
|
|
140
|
+
modelMaxQueries: z.number().step(1).min(1).max(10).default(10).volatile(),
|
|
141
|
+
/** Per-source summary cap for the plugin-owned tool output. */
|
|
142
|
+
modelSummaryMaxChars: z.number().step(1).min(100).default(800).volatile(),
|
|
115
143
|
});
|
|
116
144
|
|
|
117
145
|
/**
|
|
@@ -282,6 +310,289 @@ function clampMaxResults(value, fallback) {
|
|
|
282
310
|
return Math.min(MAX_RESULTS_CAP, Math.max(1, Math.trunc(n)));
|
|
283
311
|
}
|
|
284
312
|
|
|
313
|
+
/**
|
|
314
|
+
* Model-facing `web_search` arguments when `modelControlled` is enabled.
|
|
315
|
+
* `queries` is the official shape; the rest are extras this plugin forwards
|
|
316
|
+
* into `ctx.web.search()`'s request object (which the seam passes through).
|
|
317
|
+
*/
|
|
318
|
+
const MODEL_PARAMETERS = {
|
|
319
|
+
type: "object",
|
|
320
|
+
properties: {
|
|
321
|
+
queries: {
|
|
322
|
+
type: "array",
|
|
323
|
+
items: { type: "string" },
|
|
324
|
+
description: "1–10 search queries; their results are merged.",
|
|
325
|
+
},
|
|
326
|
+
allowedDomains: {
|
|
327
|
+
type: "array",
|
|
328
|
+
items: { type: "string" },
|
|
329
|
+
description: "Only return results from these domains (e.g. [\"go.dev\"]).",
|
|
330
|
+
},
|
|
331
|
+
blockedDomains: {
|
|
332
|
+
type: "array",
|
|
333
|
+
items: { type: "string" },
|
|
334
|
+
description: "Exclude these domains (e.g. [\"reddit.com\"]).",
|
|
335
|
+
},
|
|
336
|
+
freshness: {
|
|
337
|
+
type: "string",
|
|
338
|
+
enum: ["d1", "m1", "y1"],
|
|
339
|
+
description: "Recency filter: d1 = past day, m1 = past month, y1 = past year.",
|
|
340
|
+
},
|
|
341
|
+
maxResults: {
|
|
342
|
+
type: "integer",
|
|
343
|
+
description: "Upper bound on sources returned (1..20). Defaults to the plugin config.",
|
|
344
|
+
},
|
|
345
|
+
},
|
|
346
|
+
required: ["queries"],
|
|
347
|
+
additionalProperties: false,
|
|
348
|
+
};
|
|
349
|
+
|
|
350
|
+
/** The canonical `web_search` output schema (same shape as the official tool). */
|
|
351
|
+
const MODEL_OUTPUT_SCHEMA = {
|
|
352
|
+
type: "object",
|
|
353
|
+
additionalProperties: false,
|
|
354
|
+
properties: {
|
|
355
|
+
content: { type: "string" },
|
|
356
|
+
sources: {
|
|
357
|
+
type: "array",
|
|
358
|
+
items: {
|
|
359
|
+
type: "object",
|
|
360
|
+
additionalProperties: false,
|
|
361
|
+
properties: {
|
|
362
|
+
url: { type: "string" },
|
|
363
|
+
title: { type: "string" },
|
|
364
|
+
snippet: { type: "string" },
|
|
365
|
+
summary: { type: "string" },
|
|
366
|
+
publishedAt: { type: "string" },
|
|
367
|
+
},
|
|
368
|
+
required: ["url"],
|
|
369
|
+
},
|
|
370
|
+
},
|
|
371
|
+
truncated: { type: "boolean" },
|
|
372
|
+
},
|
|
373
|
+
required: ["sources", "truncated"],
|
|
374
|
+
};
|
|
375
|
+
|
|
376
|
+
/** Collapse whitespace and cap one source summary, like the official tool. */
|
|
377
|
+
function boundSummary(summary, cap) {
|
|
378
|
+
const text = String(summary ?? "").replace(/\s+/gu, " ").trim();
|
|
379
|
+
if (text.length === 0) return undefined;
|
|
380
|
+
return text.length <= cap ? text : `${text.slice(0, Math.max(0, cap - 1))}…`;
|
|
381
|
+
}
|
|
382
|
+
|
|
383
|
+
/** Project one seam source into the model-facing (lossless JSON) shape. */
|
|
384
|
+
function modelSource(source, cap) {
|
|
385
|
+
const summary = boundSummary(source.summary, cap);
|
|
386
|
+
const snippet = typeof source.snippet === "string" ? source.snippet.slice(0, 200) : undefined;
|
|
387
|
+
return {
|
|
388
|
+
url: source.url,
|
|
389
|
+
...(source.title !== undefined ? { title: source.title } : {}),
|
|
390
|
+
...(snippet !== undefined && snippet.length > 0 ? { snippet } : {}),
|
|
391
|
+
...(summary !== undefined ? { summary } : {}),
|
|
392
|
+
...(source.publishedAt !== undefined ? { publishedAt: source.publishedAt } : {}),
|
|
393
|
+
};
|
|
394
|
+
}
|
|
395
|
+
|
|
396
|
+
/** Merge per-query seam results round-robin, dedupe by URL, cap at maxResults. */
|
|
397
|
+
function mergeModelResults(queries, results, maxResults) {
|
|
398
|
+
const seen = new Set();
|
|
399
|
+
const sources = [];
|
|
400
|
+
let ranks = 0;
|
|
401
|
+
for (const result of results) ranks = Math.max(ranks, result.sources.length);
|
|
402
|
+
let dropped = false;
|
|
403
|
+
merge: for (let rank = 0; rank < ranks; rank++) {
|
|
404
|
+
for (const result of results) {
|
|
405
|
+
const source = result.sources[rank];
|
|
406
|
+
if (source === undefined || seen.has(source.url)) continue;
|
|
407
|
+
seen.add(source.url);
|
|
408
|
+
if (sources.length === maxResults) { dropped = true; break merge; }
|
|
409
|
+
sources.push(source);
|
|
410
|
+
}
|
|
411
|
+
}
|
|
412
|
+
const contents = results.flatMap((result, index) =>
|
|
413
|
+
result.content !== undefined && result.content.length > 0
|
|
414
|
+
? [`### ${queries[index]}\n\n${result.content}`] : []);
|
|
415
|
+
return {
|
|
416
|
+
...(contents.length > 0 ? { content: contents.join("\n\n") } : {}),
|
|
417
|
+
sources,
|
|
418
|
+
truncated: results.some((result) => result.truncated) || dropped,
|
|
419
|
+
};
|
|
420
|
+
}
|
|
421
|
+
|
|
422
|
+
/** Self-contained fallback when the official renderer helpers are unavailable. */
|
|
423
|
+
function fallbackFormatSearchOutput(result) {
|
|
424
|
+
const parts = ["External web content follows."];
|
|
425
|
+
if (result.content !== undefined && result.content.length > 0) parts.push(result.content);
|
|
426
|
+
const sources = Array.isArray(result.sources) ? result.sources : [];
|
|
427
|
+
if (sources.length > 0) {
|
|
428
|
+
const lines = sources.map((source) => {
|
|
429
|
+
let label = typeof source.title === "string" && source.title.length > 0 ? source.title : undefined;
|
|
430
|
+
if (label === undefined) {
|
|
431
|
+
try { label = new URL(source.url).hostname; } catch { label = source.url; }
|
|
432
|
+
}
|
|
433
|
+
const excerpt = typeof source.summary === "string" && source.summary.length > 0
|
|
434
|
+
? source.summary : (typeof source.snippet === "string" ? source.snippet : undefined);
|
|
435
|
+
const meta = [
|
|
436
|
+
...(excerpt !== undefined && excerpt.length > 0 ? [excerpt] : []),
|
|
437
|
+
...(typeof source.publishedAt === "string" && source.publishedAt.length > 0 ? [`(${source.publishedAt})`] : []),
|
|
438
|
+
];
|
|
439
|
+
return `- [${label}](${source.url})${meta.length > 0 ? ` — ${meta.join(" ")}` : ""}`;
|
|
440
|
+
});
|
|
441
|
+
parts.push(`Sources:\n${lines.join("\n")}`);
|
|
442
|
+
} else if (result.content === undefined || result.content.length === 0) {
|
|
443
|
+
parts.push("No results found.");
|
|
444
|
+
}
|
|
445
|
+
if (result.truncated) parts.push(`(Showing the first ${sources.length} sources. Refine the query for more.)`);
|
|
446
|
+
parts.push("Cite the relevant URLs above as markdown links in your answer.");
|
|
447
|
+
return parts.join("\n\n");
|
|
448
|
+
}
|
|
449
|
+
|
|
450
|
+
/** Validate the plugin-owned tool's arguments; return an Error or undefined. */
|
|
451
|
+
function validateModelArgs(args, maxQueries) {
|
|
452
|
+
if (typeof args !== "object" || args === null || Array.isArray(args)) return new Error("web_search arguments must be an object");
|
|
453
|
+
const a = args;
|
|
454
|
+
if (!Array.isArray(a.queries)) return new Error("queries must be an array of strings");
|
|
455
|
+
if (a.queries.length === 0) return new Error("queries must contain at least one query");
|
|
456
|
+
if (a.queries.length > maxQueries) return new Error(`queries must contain at most ${maxQueries} queries`);
|
|
457
|
+
if (a.queries.some((q) => typeof q !== "string" || q.trim().length === 0)) return new Error("each query must be a non-empty string");
|
|
458
|
+
for (const key of ["allowedDomains", "blockedDomains"]) {
|
|
459
|
+
if (a[key] !== undefined && (!Array.isArray(a[key]) || a[key].some((d) => typeof d !== "string"))) {
|
|
460
|
+
return new Error(`${key} must be an array of strings`);
|
|
461
|
+
}
|
|
462
|
+
}
|
|
463
|
+
if (a.freshness !== undefined && !FRESHNESS_VALUES.includes(a.freshness)) {
|
|
464
|
+
return new Error(`freshness must be one of ${FRESHNESS_VALUES.join(", ")}`);
|
|
465
|
+
}
|
|
466
|
+
if (a.maxResults !== undefined && (!Number.isInteger(a.maxResults) || a.maxResults < 1 || a.maxResults > MAX_RESULTS_CAP)) {
|
|
467
|
+
return new Error(`maxResults must be an integer in 1..${MAX_RESULTS_CAP}`);
|
|
468
|
+
}
|
|
469
|
+
return undefined;
|
|
470
|
+
}
|
|
471
|
+
|
|
472
|
+
/**
|
|
473
|
+
* Replayable presentation meta for the plugin-owned tool, matching the
|
|
474
|
+
* official `WebSearchMeta` shape (structured sources, truncation, answer).
|
|
475
|
+
*/
|
|
476
|
+
function modelSearchMeta(value) {
|
|
477
|
+
const sources = (Array.isArray(value?.sources) ? value.sources : []).map((source) => ({
|
|
478
|
+
url: source.url,
|
|
479
|
+
...(typeof source.title === "string" ? { title: source.title } : {}),
|
|
480
|
+
...(typeof source.snippet === "string" ? { snippet: source.snippet } : {}),
|
|
481
|
+
...(typeof source.publishedAt === "string" ? { publishedAt: source.publishedAt } : {}),
|
|
482
|
+
}));
|
|
483
|
+
return {
|
|
484
|
+
sources,
|
|
485
|
+
truncated: value?.truncated === true,
|
|
486
|
+
...(typeof value?.content === "string" ? { answer: value.content } : {}),
|
|
487
|
+
};
|
|
488
|
+
}
|
|
489
|
+
|
|
490
|
+
/** Pending-call card: same generic search card as the official tool. */
|
|
491
|
+
function modelPresentCall(args) {
|
|
492
|
+
const title = Array.isArray(args?.queries) ? args.queries.join(", ") : "";
|
|
493
|
+
return { card: "generic", title, kind: "search", rawInput: title };
|
|
494
|
+
}
|
|
495
|
+
|
|
496
|
+
/** Completed-call card: same `card: "web"` citation list as the official tool. */
|
|
497
|
+
function modelPresentResult(args, result) {
|
|
498
|
+
if (result.isError) return undefined;
|
|
499
|
+
const meta = result.meta;
|
|
500
|
+
if (typeof meta !== "object" || meta === null || Array.isArray(meta)) return undefined;
|
|
501
|
+
if (!Array.isArray(meta.sources) || typeof meta.truncated !== "boolean") return undefined;
|
|
502
|
+
return {
|
|
503
|
+
card: "web",
|
|
504
|
+
kind: "search",
|
|
505
|
+
title: Array.isArray(args?.queries) ? args.queries.join(", ") : "",
|
|
506
|
+
sources: meta.sources,
|
|
507
|
+
truncated: meta.truncated,
|
|
508
|
+
...(typeof meta.answer === "string" ? { answer: meta.answer } : {}),
|
|
509
|
+
};
|
|
510
|
+
}
|
|
511
|
+
|
|
512
|
+
/**
|
|
513
|
+
* Register the model-facing `web_search` tool. Requires the official tool-web
|
|
514
|
+
* `search` registration to be disabled in every preset; this plugin owns the
|
|
515
|
+
* duplicate name. The extras are passed to `ctx.web.search()` untouched,
|
|
516
|
+
* reaching the provider as per-request overrides (see `buildSearchBody`).
|
|
517
|
+
*
|
|
518
|
+
* Registration is deferred through `ctx.inject(['tools', 'systemPrompt'], …)`
|
|
519
|
+
* so the plugin does not require those services when `modelControlled` is off.
|
|
520
|
+
*/
|
|
521
|
+
function registerModelTool(ctx, config) {
|
|
522
|
+
ctx.inject(["tools", "systemPrompt"], (child) => {
|
|
523
|
+
const tools = child.get("tools");
|
|
524
|
+
const systemPrompt = child.get("systemPrompt");
|
|
525
|
+
if (tools === undefined || systemPrompt === undefined) return;
|
|
526
|
+
const o = {
|
|
527
|
+
modelMaxQueries: config.modelMaxQueries.get(),
|
|
528
|
+
modelSummaryMaxChars: config.modelSummaryMaxChars.get(),
|
|
529
|
+
maxResults: config.maxResults.get(),
|
|
530
|
+
timeoutMs: config.timeoutMs.get(),
|
|
531
|
+
};
|
|
532
|
+
|
|
533
|
+
const disposeTool = tools.register({
|
|
534
|
+
name: "web_search",
|
|
535
|
+
description: "Search the web for current information. Optionally restrict domains, exclude sites, filter by recency, and cap the number of sources.",
|
|
536
|
+
parameters: MODEL_PARAMETERS,
|
|
537
|
+
output: {
|
|
538
|
+
schema: MODEL_OUTPUT_SCHEMA,
|
|
539
|
+
render: (_args, value) => [{ type: "text", text: fallbackFormatSearchOutput(value) }],
|
|
540
|
+
presentationMeta: (_args, value) => modelSearchMeta(value),
|
|
541
|
+
},
|
|
542
|
+
timeoutMs: o.timeoutMs,
|
|
543
|
+
isConcurrencySafe: () => true,
|
|
544
|
+
presentCall: modelPresentCall,
|
|
545
|
+
presentResult: modelPresentResult,
|
|
546
|
+
async execute(args, exec) {
|
|
547
|
+
const invalid = validateModelArgs(args, o.modelMaxQueries);
|
|
548
|
+
if (invalid !== undefined) throw invalid;
|
|
549
|
+
const { queries, allowedDomains, blockedDomains, freshness, maxResults } = args;
|
|
550
|
+
const unique = [...new Set(queries)];
|
|
551
|
+
const bound = clampMaxResults(maxResults, o.maxResults);
|
|
552
|
+
const extras = {
|
|
553
|
+
...(allowedDomains !== undefined ? { allowedDomains } : {}),
|
|
554
|
+
...(blockedDomains !== undefined ? { blockedDomains } : {}),
|
|
555
|
+
...(freshness !== undefined ? { freshness } : {}),
|
|
556
|
+
};
|
|
557
|
+
const run = async (list) => {
|
|
558
|
+
if (list.length === 1) {
|
|
559
|
+
return ctx.web.search({ query: list[0], maxResults: bound, ...extras }, exec.signal);
|
|
560
|
+
}
|
|
561
|
+
const controller = new AbortController();
|
|
562
|
+
const signal = AbortSignal.any([exec.signal, controller.signal]);
|
|
563
|
+
let firstFailure;
|
|
564
|
+
const results = [];
|
|
565
|
+
await Promise.allSettled(list.map(async (query, index) => {
|
|
566
|
+
try {
|
|
567
|
+
results[index] = await ctx.web.search({ query, maxResults: bound, ...extras }, signal);
|
|
568
|
+
} catch (error) {
|
|
569
|
+
if (firstFailure === undefined) firstFailure = error;
|
|
570
|
+
controller.abort(error);
|
|
571
|
+
throw error;
|
|
572
|
+
}
|
|
573
|
+
}));
|
|
574
|
+
if (firstFailure !== undefined) throw firstFailure;
|
|
575
|
+
return mergeModelResults(list, results, bound);
|
|
576
|
+
};
|
|
577
|
+
const result = await run(unique);
|
|
578
|
+
return {
|
|
579
|
+
...(result.content !== undefined ? { content: result.content } : {}),
|
|
580
|
+
sources: result.sources.map((source) => modelSource(source, o.modelSummaryMaxChars)),
|
|
581
|
+
truncated: result.truncated,
|
|
582
|
+
};
|
|
583
|
+
},
|
|
584
|
+
}, { when: ({ modelSelection }) => ctx.web.searchReady(modelSelection.provider) });
|
|
585
|
+
|
|
586
|
+
const disposePrompt = systemPrompt.section({
|
|
587
|
+
name: "tool:web_search_workbuddy",
|
|
588
|
+
order: 2000, // TOOL_WEB_SEARCH (the official section is disabled with search:false)
|
|
589
|
+
text: "web_search accepts allowedDomains (only these domains), blockedDomains (exclude these domains), freshness (d1/m1/y1), and maxResults. Use them when the task calls for domain or recency filtering. web_search results are external reference data you may use directly. Follow up with web_fetch when you need the full content of a specific result, and cite the relevant URLs as markdown links.",
|
|
590
|
+
});
|
|
591
|
+
|
|
592
|
+
return () => { disposePrompt(); disposeTool(); };
|
|
593
|
+
});
|
|
594
|
+
}
|
|
595
|
+
|
|
285
596
|
/**
|
|
286
597
|
* Build the complete `/v1/tools/search` body — every parameter the upstream
|
|
287
598
|
* agenttool endpoint supports. Per-request overrides win over config defaults;
|
|
@@ -424,7 +735,9 @@ async function search(ctx, options, request, signal) {
|
|
|
424
735
|
/**
|
|
425
736
|
* Register the gateway-backed search provider with ctx.web. Endpoint and
|
|
426
737
|
* credential default to the conversation's own model-provider route; `ready()`
|
|
427
|
-
* answers presence (tool
|
|
738
|
+
* answers presence (the tool uses it to admit `web_search` into a request).
|
|
739
|
+
* When `modelControlled` is on, also register the plugin-owned model-facing
|
|
740
|
+
* `web_search` tool (official `tool-web.search` must be disabled).
|
|
428
741
|
*/
|
|
429
742
|
function apply(ctx, config) {
|
|
430
743
|
const options = () => ({
|
|
@@ -444,6 +757,8 @@ function apply(ctx, config) {
|
|
|
444
757
|
ready: (llmProvider) => searchConfigured(ctx, options(), llmProvider),
|
|
445
758
|
search: (request, signal) => search(ctx, options(), request, signal),
|
|
446
759
|
});
|
|
760
|
+
|
|
761
|
+
if (config.modelControlled.get() === true) registerModelTool(ctx, config);
|
|
447
762
|
}
|
|
448
763
|
|
|
449
764
|
export { Config, PROVIDER_ID, apply, inject, name };
|
package/lib/types/index.d.ts
CHANGED
|
@@ -24,6 +24,15 @@ export interface WebSearchWorkBuddyConfig {
|
|
|
24
24
|
blockedDomains: string[];
|
|
25
25
|
/** Recency filter; omitted = no freshness constraint. */
|
|
26
26
|
freshness: WebSearchFreshness;
|
|
27
|
+
/**
|
|
28
|
+
* v0.4.1: register a plugin-owned `web_search` tool exposing the filter
|
|
29
|
+
* parameters to the model. Requires `tool-web.search: false` in every preset.
|
|
30
|
+
*/
|
|
31
|
+
modelControlled: boolean;
|
|
32
|
+
/** Upper bound on queries in one plugin-owned `web_search` call. */
|
|
33
|
+
modelMaxQueries: number;
|
|
34
|
+
/** Per-source summary cap in the plugin-owned tool's output. */
|
|
35
|
+
modelSummaryMaxChars: number;
|
|
27
36
|
}
|
|
28
37
|
/**
|
|
29
38
|
* Optional per-request overrides accepted by the provider's `search()` in
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-web-search-workbuddy",
|
|
3
3
|
"description": "WorkBuddy gateway-backed search provider (agenttool /v1/tools/search passthrough via the account-pool gateway) for the DeepSeek Harness web capability seam (ctx.web)",
|
|
4
|
-
"version": "0.4.
|
|
4
|
+
"version": "0.4.2",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "lib/index.js",
|
|
7
7
|
"types": "lib/types/index.d.ts",
|
|
@@ -23,8 +23,8 @@
|
|
|
23
23
|
"@deepseek-ai/schemastery": "~3.19.0"
|
|
24
24
|
},
|
|
25
25
|
"peerDependencies": {
|
|
26
|
-
"@deepseek-ai/dsh-web": "0.2.2-rc.
|
|
27
|
-
"@deepseek-ai/dsh-credentials": "0.2.2-rc.
|
|
26
|
+
"@deepseek-ai/dsh-web": ">=0.2.2-rc.1 <0.3.0-0",
|
|
27
|
+
"@deepseek-ai/dsh-credentials": ">=0.2.2-rc.1 <0.3.0-0",
|
|
28
28
|
"@deepseek-ai/cordis": "~4.1.0"
|
|
29
29
|
},
|
|
30
30
|
"repository": {
|