@ego-z/contracts 0.15.14 → 0.15.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ego-z/contracts",
-  "version": "0.15.14",
+  "version": "0.15.15",
   "description": "Wire-format type contracts shared between EgoZ backend, SDK, MCP and console. Type-only — no runtime artifacts.",
   "types": "./src/index.d.ts",
   "exports": {

package/src/ask.d.ts

@@ -301,6 +301,49 @@ export interface AskRequestBody {
      * Optional and additive: omit it and nothing changes.
      */
     machineOutput?: AskMachineOutput[];
+
+    /**
+     * A one-shot COMPLETION: `message` is the whole instruction, and EgoZ adds
+     * nothing from the project around it.
+     *
+     * ── What it switches off ─────────────────────────────────────────────
+     *
+     * The project's prompt, personality, session context, greeting, knowledge
+     * base, tools, memory and conversation title. Nothing is stored either:
+     * `true` implies `noStore`. The project still supplies the provider key,
+     * the quota and the model menu, so `model` works as usual.
+     *
+     * What remains is what you put on this request for a program to read:
+     * with `responseFormat: 'json_object'`, the `jsonSchema` instructions; and
+     * any `machineOutput`.
+     *
+     * ── Why it exists ────────────────────────────────────────────────────
+     *
+     * A project that serves a chat agent also answers one-off program calls
+     * (a classifier, a planner). Without this, such a call runs AS the agent —
+     * its persona, every enabled tool, a knowledge-base lookup and the
+     * project's conversation temperature — which is slower, costlier and less
+     * predictable than the call needs.
+     *
+     * ── Why it is explicit ───────────────────────────────────────────────
+     *
+     * A JSON turn is not implicitly a completion, stored or not: testing the
+     * agent itself answering in JSON is a real use. Only `true` changes
+     * anything.
+     *
+     * Optional and additive: omit it and nothing changes.
+     */
+    completion?: boolean;
+
+    /**
+     * The sampling temperature for a `completion`, from 0 to 2. Omit it to use
+     * the project's own.
+     *
+     * Accepted ONLY together with `completion: true`; on any other turn it is a
+     * 400. It is not a general per-call override: a conversation's temperature
+     * belongs to the project.
+     */
+    temperature?: number;
 }
 
 /**