@ego-z/contracts 0.15.13 → 0.15.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ego-z/contracts",
-  "version": "0.15.13",
+  "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

@@ -6,7 +6,7 @@
  */
 
 import type { Intent, JsonSchemaDefinition, ResponseFormat, TokenUsage } from './envelope';
-import type { InitContextItem, InitContextItemAccepted, InitContextUi } from './draft-conv';
+import type { InitContextItem, InitContextItemAccepted, InitContextTenant, InitContextUi } from './draft-conv';
 import type { AskQuestionSet } from './questions';
 
 // ============================================================================
@@ -242,6 +242,32 @@ export interface AskRequestBody {
      */
     contextItems?: InitContextItem[];
 
+    /**
+     * The tenant AS IT IS NOW — sent when it may have changed since the
+     * conversation began.
+     *
+     * ── Why per-turn ─────────────────────────────────────────────────────
+     *
+     * The draft's `initContext.tenant` is captured once, and its `features`
+     * are rendered to the agent as a hard rule on every turn: disabled means
+     * "never offer". A tenant whose features change mid-conversation — a setup
+     * flow switching bookings on — would otherwise be told, turn after turn,
+     * that the thing it just enabled is off.
+     *
+     * ── Merged, and kept ─────────────────────────────────────────────────
+     *
+     * The keys you SEND replace the stored ones; keys you omit keep their
+     * stored value, and `null` clears one. `features` is replaced as a whole
+     * map — send the complete current set, not a delta. The merged block is
+     * kept on the conversation (except for a no-store tenant), so a later
+     * turn that omits this field still sees it.
+     *
+     * Validated exactly like `initContext.tenant`: an invalid block is a 400.
+     *
+     * Optional and additive: omit it and nothing changes.
+     */
+    tenant?: InitContextTenant;
+
     /**
      * Output a MACHINE produced for this turn — the result of something the
      * user asked to have run, not anything the user said.
@@ -275,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;
 }
 
 /**

package/src/draft-conv.d.ts

@@ -456,6 +456,8 @@ export interface InitContextTenant {
     name?: string | null;
     description?: string | null;
     category?: string | null;
+    /** What the business is, in the caller's words — finer than `category` ("barbershop"). */
+    niche?: string | null;
     /** Enabled-feature flags, e.g. `{ products: true, booking: false }`. */
     features?: Record<string, boolean>;
 }