@ego-z/contracts 0.15.27 → 0.15.28

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.
Files changed (2) hide show
  1. package/package.json +1 -1
  2. package/src/ask.d.ts +26 -2
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ego-z/contracts",
3
- "version": "0.15.27",
3
+ "version": "0.15.28",
4
4
  "description": "Wire-format type contracts shared between EgoZ backend, SDK, MCP and console. Type-only — no runtime artifacts.",
5
5
  "types": "./src/index.d.ts",
6
6
  "exports": {
package/src/ask.d.ts CHANGED
@@ -279,8 +279,8 @@ export interface AskRequestBody {
279
279
  * built-in its config leaves off, stays off. An unknown name is ignored
280
280
  * rather than refused, because a tool can be disabled after the caller
281
281
  * was written. A classic project's pre-fetched knowledge-base context is
282
- * not a tool and is unaffected; memory the project already injects is
283
- * still read.
282
+ * not a tool and is unaffected (`knowledge: false` turns it off); memory
283
+ * the project already injects is still read.
284
284
  *
285
285
  * An array of non-empty strings, at most 64; anything else is a 400, and
286
286
  * so is `tools` together with `completion: true` (a completion offers no
@@ -290,6 +290,30 @@ export interface AskRequestBody {
290
290
  */
291
291
  tools?: string[];
292
292
 
293
+ /**
294
+ * `false`: this turn reads no knowledge base — no pre-fetched chunks on a
295
+ * classic project, no `search_knowledge_base` tool on an agentic one. The
296
+ * rest of the agent stays: the project's prompt, personality, session
297
+ * context, tools, memory and the conversation. A turn that has no tools
298
+ * then gets the project's base prompt, where it would have defaulted to
299
+ * the RAG one.
300
+ *
301
+ * ── Why it exists ────────────────────────────────────────────────────
302
+ *
303
+ * A program that writes the agent's words for it (AppNA's onboarding:
304
+ * Ana's greeting and the note after the setup) hands the turn everything
305
+ * it needs to say. With no tools and no question in it, such a turn
306
+ * classified as RAG: it got the RAG prompt ("answer using ONLY the
307
+ * provided context") and a knowledge-base passage unrelated to the
308
+ * message, and paid for an embedding and a search on every turn.
309
+ * `completion: true` turns the knowledge base off too, but also the
310
+ * persona, the conversation and storage, which such a turn needs.
311
+ *
312
+ * Only `false` changes anything; `true` and omitted keep the project's
313
+ * setting. Not a boolean: 400.
314
+ */
315
+ knowledge?: boolean;
316
+
293
317
  /**
294
318
  * Tools a turn narrowed by `tools` may still load, by group.
295
319
  *