@ego-z/contracts 0.15.13 → 0.15.14

package/package.json

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

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>;
 }