@ego-z/contracts 0.15.20 → 0.15.21
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/package.json +1 -1
- package/src/ask.d.ts +35 -0
package/package.json
CHANGED
package/src/ask.d.ts
CHANGED
|
@@ -231,6 +231,41 @@ export interface AskRequestBody {
|
|
|
231
231
|
*/
|
|
232
232
|
toolHeaders?: Record<string, string>;
|
|
233
233
|
|
|
234
|
+
/**
|
|
235
|
+
* The ONLY tools this turn may be offered, by name.
|
|
236
|
+
*
|
|
237
|
+
* - omitted → every tool the project offers today (unchanged).
|
|
238
|
+
* - a list → the project's enabled tools whose `toolName` is listed,
|
|
239
|
+
* and each built-in only when its function name is listed:
|
|
240
|
+
* `search_knowledge_base`, `remember_fact`, `ask_user`,
|
|
241
|
+
* `web_fetch`, `web_search`.
|
|
242
|
+
* - `[]` → no tools at all.
|
|
243
|
+
*
|
|
244
|
+
* ── Why it exists ────────────────────────────────────────────────────
|
|
245
|
+
*
|
|
246
|
+
* A project's chat agent and a narrow program job can share one project.
|
|
247
|
+
* When the job's input is a stranger's text (an email answered with
|
|
248
|
+
* nobody watching), the turn must not be able to reach a write tool,
|
|
249
|
+
* remember a "fact" for later, or fetch a page the text names, while the
|
|
250
|
+
* same project's chat keeps all of them.
|
|
251
|
+
*
|
|
252
|
+
* ── What it does NOT do ──────────────────────────────────────────────
|
|
253
|
+
*
|
|
254
|
+
* It never adds a tool: a listed name the project has not enabled, or a
|
|
255
|
+
* built-in its config leaves off, stays off. An unknown name is ignored
|
|
256
|
+
* rather than refused, because a tool can be disabled after the caller
|
|
257
|
+
* was written. A classic project's pre-fetched knowledge-base context is
|
|
258
|
+
* not a tool and is unaffected; memory the project already injects is
|
|
259
|
+
* still read.
|
|
260
|
+
*
|
|
261
|
+
* An array of non-empty strings, at most 64; anything else is a 400, and
|
|
262
|
+
* so is `tools` together with `completion: true` (a completion offers no
|
|
263
|
+
* tools). `null` is treated as omitted.
|
|
264
|
+
*
|
|
265
|
+
* Optional and additive: omit it and nothing changes.
|
|
266
|
+
*/
|
|
267
|
+
tools?: string[];
|
|
268
|
+
|
|
234
269
|
/**
|
|
235
270
|
* What the user has on screen RIGHT NOW — sent on every turn, not just
|
|
236
271
|
* when the conversation started.
|