@zarel-ai/sdk 0.6.0 → 0.7.0

package/dist/types/conversation-sessions.d.ts

@@ -33,7 +33,7 @@ export interface ConversationActionRecord {
 export interface ConversationSessionDetail {
     session: ConversationSessionSummary & {
         /**
-         * Session-level snapshot of the actor's roles (Spec-019 FR-A07). NOT
+         * Session-level snapshot of the actor's roles. NOT
          * a security gate — exposed for observability / UI display only.
          */
         roles_snapshot: string[];

package/dist/types/conversation-sessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-sessions.d.ts","sourceRoot":"","sources":["../../src/types/conversation-sessions.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,0BAA0B;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,yBAAyB,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACtC,OAAO,EAAE,0BAA0B,GAAG;QAClC;;;WAGG;QACH,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC,OAAO,EAAE,wBAAwB,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,6BAA6B;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,yBAAyB,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,+BAA+B,GAAG,0BAA0B,EAAE,CAAC;AAE3E,MAAM,MAAM,iCAAiC,GAAG,yBAAyB,CAAC;AAE1E,MAAM,MAAM,kCAAkC,GAAG,wBAAwB,EAAE,CAAC"}
+{"version":3,"file":"conversation-sessions.d.ts","sourceRoot":"","sources":["../../src/types/conversation-sessions.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,0BAA0B;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,yBAAyB,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACtC,OAAO,EAAE,0BAA0B,GAAG;QAClC;;;WAGG;QACH,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC,OAAO,EAAE,wBAAwB,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,6BAA6B;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,yBAAyB,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,+BAA+B,GAAG,0BAA0B,EAAE,CAAC;AAE3E,MAAM,MAAM,iCAAiC,GAAG,yBAAyB,CAAC;AAE1E,MAAM,MAAM,kCAAkC,GAAG,wBAAwB,EAAE,CAAC"}

package/dist/types/conversation-sessions.js

@@ -1,6 +1,8 @@
 "use strict";
+// SPDX-License-Identifier: MIT
+// Copyright 2026 Nicolas Moreno
 // ═══════════════════════════════════════════════════════════════════════════
-// Conversation session history types — derived from docs/api/openapi-v1.yaml
+// Conversation session history types — derived from the runtime API's OpenAPI document
 // ═══════════════════════════════════════════════════════════════════════════
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=conversation-sessions.js.map

package/dist/types/conversation-sessions.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-sessions.js","sourceRoot":"","sources":["../../src/types/conversation-sessions.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,6EAA6E;AAC7E,8EAA8E"}
+{"version":3,"file":"conversation-sessions.js","sourceRoot":"","sources":["../../src/types/conversation-sessions.ts"],"names":[],"mappings":";AAAA,+BAA+B;AAC/B,gCAAgC;AAChC,8EAA8E;AAC9E,uFAAuF;AACvF,8EAA8E"}

package/dist/types/conversation.d.ts

@@ -1,43 +1,16 @@
 import type { operations } from '../generated/runtime';
+import type { ConversationSendBodyPayload } from '../generated';
 export type Channel = NonNullable<NonNullable<operations['listConversationSessions']['parameters']['query']>['channel_name']>;
-export interface InteractionContext {
-    channel_name?: Channel;
-    audience?: 'human' | 'machine';
-    modality?: 'synchronous' | 'asynchronous';
-    platform?: string;
-}
-export interface ConversationRequest {
-    message: string;
-    role?: string;
-    interaction?: InteractionContext;
-    /** SpecKit 010 / FR-C07 (T077): explicit session lookup — sessions must be created first via `client.runtime.conversationSessions.create`. */
-    session_key?: string;
-    /** SpecKit 010 / FR-C04 (T077): per-turn LLM service override. Must be authorized for the actor in the session's scope. */
-    llm_service?: string;
-    /**
-     * ADR-0133 §B.4 / FR-C03: the inbound at-most-once dedupe token
-     * `deriveIdempotencyKey(channel, channel_message_id)` (a public sha256 hex).
-     * Set by a channel adapter's party turn so a redelivered provider message
-     * (a re-fired WhatsApp `wamid`) never creates a second turn; the runtime
-     * enforces it unique per `(tenant, channel)` — the channel is trust-rooted
-     * from the credential, never this body. Omit on ordinary tenant turns.
-     */
-    idempotency_key?: string;
-    /**
-     * ADR-0133 §B.7 / FR-E01: the edge-attestation of the inbound boundary crossing,
-     * from which the runtime builds the `channel.ingress` audit row — whether the
-     * adapter verified the provider signature, who attests the crossing (runtime vs
-     * channel_provider), the provider's clock, and the opaque provider message id (which
-     * MUST be hashed by the adapter if address-shaped, FR-E03). Set by a channel
-     * adapter's party turn; omit on ordinary tenant turns.
-     */
-    channel_attestation?: {
-        signature_verified: boolean;
-        attested_by: 'runtime' | 'channel_provider';
-        provider_timestamp?: string;
-        channel_message_id?: string;
-    };
-}
+/**
+ * THE TURN BODY, DERIVED from the runtime API's OpenAPI document, so there is one description
+ * of it.
+ *
+ * `session_key` is REQUIRED: the route does not create a session lazily, and answers 400
+ * without one. There is no `role` key.
+ */
+export type ConversationRequest = ConversationSendBodyPayload;
+/** The per-turn treatment overrides, as the published body declares them. */
+export type InteractionContext = NonNullable<ConversationRequest['interaction']>;
 export interface ConversationDebugInfo {
     enabled?: boolean;
     system_prompt?: string;
@@ -66,9 +39,9 @@ export interface ConversationResponse {
     options?: string[];
     suggestions?: string[];
     error?: string;
-    /** Desk Spec 3 (US2): the turn's correlation id, to tie it to its receipts. */
+    /** The turn's correlation id, to tie it to its receipts. */
     trace_id?: string;
-    /** ADR-0133 §B.7: the inbound turn's sequence number (present on channel party turns). */
+    /** The inbound turn's sequence number (present on channel party turns). */
     conversation_turn_seq?: number;
     _debug?: ConversationDebugInfo;
 }

package/dist/types/conversation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../src/types/conversation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../src/types/conversation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAShE,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,WAAW,CAAC,UAAU,CAAC,0BAA0B,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;AAE9H;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAE9D,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC,CAAC;AAMjF,MAAM,WAAW,qBAAqB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,MAAM,CAAC,EAAE,KAAK,CAAC;QACX,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,CAAC,CAAC;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE;QACV,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACL;AAED,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,mBAAmB,CAAC,EAAE;YAClB,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,aAAa,CAAC,EAAE,MAAM,CAAC;SAC1B,CAAC;KACL,CAAC;CACL;AAED,MAAM,WAAW,2BAA2B;IACxC,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC/B"}

package/dist/types/entities.d.ts

@@ -1,19 +1,55 @@
-export interface EntityInput {
-    name: string;
-    label?: string;
-    description?: string;
-}
-export interface FieldDefinitionInput {
-    name: string;
-    field_type: string;
-    label?: string;
-    description?: string;
-    is_required?: boolean;
-    config?: Record<string, unknown>;
-    options?: string[];
-    default_value?: unknown;
-    position?: number;
-}
+import type { EntityCreateBodyPayload, EntityFieldCreateBodyPayload, EntityFieldListPayload, EntityFieldPayload, EntityFieldRecordPayload, EntityFieldRefPayload, EntityFieldPatchBodyPayload, EntityFieldReplaceBodyPayload, EntityListPayload, EntityPayload, EntityRecordPayload, EntityPatchBodyPayload, EntityReplaceBodyPayload, EntitySummaryPayload, FieldTransitionPayload } from '../generated';
+/** One entity in `GET /contract/entities`. */
+export type ContractEntitySummary = EntitySummaryPayload;
+/** The payload of `GET /contract/entities`. */
+export type ContractEntityList = EntityListPayload;
+/** The payload of `GET /contract/entities/{entity_name}`. */
+export type ContractEntity = EntityPayload;
+/** A field as every READ answers it. */
+export type ContractEntityField = EntityFieldPayload;
+/** A field as the entity LIST names it — `{name, type}`. */
+export type ContractEntityFieldRef = EntityFieldRefPayload;
+/** The payload of `GET /contract/entities/{entity_name}/fields`. */
+export type ContractEntityFieldList = EntityFieldListPayload;
+/** An entity as every MUTATION answers it — the stored definition, `i18n` hydrated. */
+export type ContractEntityRecord = EntityRecordPayload;
+/** A field as every MUTATION answers it — the stored definition, `i18n` hydrated. */
+export type ContractEntityFieldRecord = EntityFieldRecordPayload;
+/** One transition edge, as the `/transitions*` routes answer it. */
+export type ContractFieldTransition = FieldTransitionPayload;
+/** `POST /contract/entities`. */
+export type EntityInput = EntityCreateBodyPayload;
+/**
+ * `PUT /contract/entities/{entity_name}` — a TOTAL declaration.
+ *
+ * Every mutable property is REQUIRED, and that is not pedantry: no read on this surface returns
+ * `display_field`, `semantic_triggers`, `tool_hints` or `checks`, so a caller cannot GET-edit-PUT
+ * and an omitted key read as "clear it" would destroy an entity's write-time verdicts
+ * with nothing in any response to show it. `null` clears, explicitly.
+ */
+export type EntityReplaceInput = EntityReplaceBodyPayload;
+/**
+ * `PATCH /contract/entities/{entity_name}` — a partial. An absent key is untouched; `null` clears.
+ *
+ * A separate type from {@link EntityInput}, not `Partial<EntityInput>`: `name` is the PATH identity
+ * on this side, optional and not mutable, while it is required on create. `Partial<>` said neither.
+ */
+export type EntityWriteInput = EntityPatchBodyPayload;
+/** `POST /contract/entities/{entity_name}/fields`. */
+export type FieldDefinitionInput = EntityFieldCreateBodyPayload;
+/**
+ * `PUT /contract/entities/{entity_name}/fields/{field_name}` — a TOTAL declaration, every mutable
+ * property required. See {@link EntityReplaceInput} for why; `ContractEntityField` returns neither
+ * `position` nor `transitions`, so an omission cannot mean "clear it".
+ */
+export type FieldReplaceInput = EntityFieldReplaceBodyPayload;
+/**
+ * `PATCH /contract/entities/{entity_name}/fields/{field_name}` — a partial.
+ *
+ * `name` and `field_type` are identity here — a body may repeat either and is REFUSED when it
+ * disagrees, because no update path writes a field's type.
+ */
+export type FieldWriteInput = EntityFieldPatchBodyPayload;
 export interface ToolExecutionResult {
     success: boolean;
     data?: unknown;

package/dist/types/entities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/types/entities.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAUD,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/types/entities.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACR,uBAAuB,EACvB,4BAA4B,EAC5B,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,2BAA2B,EAC3B,6BAA6B,EAC7B,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACzB,MAAM,cAAc,CAAC;AAetB,8CAA8C;AAC9C,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AACzD,+CAA+C;AAC/C,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AACnD,6DAA6D;AAC7D,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC;AAC3C,wCAAwC;AACxC,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AACrD,4DAA4D;AAC5D,MAAM,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AAC3D,oEAAoE;AACpE,MAAM,MAAM,uBAAuB,GAAG,sBAAsB,CAAC;AAC7D,uFAAuF;AACvF,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AACvD,qFAAqF;AACrF,MAAM,MAAM,yBAAyB,GAAG,wBAAwB,CAAC;AACjE,oEAAoE;AACpE,MAAM,MAAM,uBAAuB,GAAG,sBAAsB,CAAC;AAE7D,iCAAiC;AACjC,MAAM,MAAM,WAAW,GAAG,uBAAuB,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEtD,sDAAsD;AACtD,MAAM,MAAM,oBAAoB,GAAG,4BAA4B,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,6BAA6B,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,2BAA2B,CAAC;AAO1D,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/entities.js

@@ -1,4 +1,16 @@
 "use strict";
+// SPDX-License-Identifier: MIT
+// Copyright 2026 Nicolas Moreno
 // ── Entities ─────────────────────────────────────────────────────────────
+//
+// EVERY SHAPE HERE IS DERIVED from the contract API's OpenAPI document (through
+// `generated/contract.ts`), so there is one description of the `/contract/entities*` wire, as in
+// `types/flows-contract.ts`.
+//
+// `label` and `description` are not accepted on these bodies: an entity's semantic content is
+// written by a contract publish.
+//
+// The bodies are published and CLOSED now (`additionalProperties: false`, enforced by the route,
+// which names every key it refuses), so these are aliases rather than declarations.
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=entities.js.map

package/dist/types/entities.js.map

@@ -1 +1 @@
-{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../src/types/entities.ts"],"names":[],"mappings":";AAAA,4EAA4E"}
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../src/types/entities.ts"],"names":[],"mappings":";AAAA,+BAA+B;AAC/B,gCAAgC;AAChC,4EAA4E;AAC5E,EAAE;AACF,gFAAgF;AAChF,iGAAiG;AACjG,6BAA6B;AAC7B,EAAE;AACF,8FAA8F;AAC9F,iCAAiC;AACjC,EAAE;AACF,iGAAiG;AACjG,oFAAoF"}

package/dist/types/events-stream.d.ts

@@ -1,5 +1,5 @@
 import type { SseConversationTurnCreatedData, SseConversationTurnCreatedPayload } from '../generated';
-/** Metadata-only payload of a `conversation.turn_created` event (ADR-0104). */
+/** Metadata-only payload of a `conversation.turn_created` event. */
 export type ConversationTurnCreatedPayload = SseConversationTurnCreatedPayload;
 /** The SSE bridge wraps every event's data as `{entity, record_id, payload, timestamp}`. */
 export type ConversationTurnCreatedData = SseConversationTurnCreatedData;
@@ -68,7 +68,7 @@ export interface EventIterateOptions extends EventStreamOptions {
 }
 /**
  * Runtime type-guard for a `conversation.turn_created` event's `data` envelope (the
- * single boundary-validation authority for the typed arm — QI-004, ADR-0038, no `as`).
+ * single boundary-validation authority for the typed arm — no `as`).
  */
 export declare function isConversationTurnCreatedData(data: unknown): data is ConversationTurnCreatedData;
 /** Narrowing guard so consumers get the typed `conversation.turn_created` `data` shape. */

package/dist/types/events-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events-stream.d.ts","sourceRoot":"","sources":["../../src/types/events-stream.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,8BAA8B,EAAE,iCAAiC,EAAE,MAAM,cAAc,CAAC;AAQtG,+EAA+E;AAC/E,MAAM,MAAM,8BAA8B,GAAG,iCAAiC,CAAC;AAE/E,4FAA4F;AAC5F,MAAM,MAAM,2BAA2B,GAAG,8BAA8B,CAAC;AAEzE,gHAAgH;AAChH,MAAM,WAAW,4BAA4B;IACzC,KAAK,EAAE,2BAA2B,CAAC;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,2BAA2B,CAAC;CACrC;AAED,kEAAkE;AAClE,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,4BAA4B,GAAG,kBAAkB,CAAC;AAEnF,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAChC,6EAA6E;IAC7E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC9C,mEAAmE;IACnE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IAC/B,uDAAuD;IACvD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAC9B,oFAAoF;IACpF,KAAK,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC3D;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAQD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,2BAA2B,CAWhG;AAED,2FAA2F;AAC3F,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,kBAAkB,GAAG,KAAK,IAAI,4BAA4B,CAE/G;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAChC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,EACb,EAAE,EAAE,MAAM,GAAG,SAAS,GACvB,kBAAkB,GAAG,SAAS,CAQhC"}
+{"version":3,"file":"events-stream.d.ts","sourceRoot":"","sources":["../../src/types/events-stream.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,8BAA8B,EAAE,iCAAiC,EAAE,MAAM,cAAc,CAAC;AAQtG,oEAAoE;AACpE,MAAM,MAAM,8BAA8B,GAAG,iCAAiC,CAAC;AAE/E,4FAA4F;AAC5F,MAAM,MAAM,2BAA2B,GAAG,8BAA8B,CAAC;AAEzE,gHAAgH;AAChH,MAAM,WAAW,4BAA4B;IACzC,KAAK,EAAE,2BAA2B,CAAC;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,2BAA2B,CAAC;CACrC;AAED,kEAAkE;AAClE,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,4BAA4B,GAAG,kBAAkB,CAAC;AAEnF,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAChC,6EAA6E;IAC7E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC9C,mEAAmE;IACnE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IAC/B,uDAAuD;IACvD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAC9B,oFAAoF;IACpF,KAAK,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC3D;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAQD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,2BAA2B,CAWhG;AAED,2FAA2F;AAC3F,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,kBAAkB,GAAG,KAAK,IAAI,4BAA4B,CAE/G;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAChC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,EACb,EAAE,EAAE,MAAM,GAAG,SAAS,GACvB,kBAAkB,GAAG,SAAS,CAQhC"}

package/dist/types/events-stream.js

@@ -1,7 +1,9 @@
 "use strict";
-// G3 — typed runtime SSE event map for `client.runtime.events.stream`.
+// SPDX-License-Identifier: MIT
+// Copyright 2026 Nicolas Moreno
+// Typed runtime SSE event map for `client.runtime.events.stream`.
 //
-// The runtime event stream (`GET /runtime/events/stream`, ADR-0104) emits NAMED
+// The runtime event stream (`GET /runtime/events/stream`) emits NAMED
 // SSE frames. `conversation.turn_created` carries a fixed metadata-only envelope; all
 // other named events (record mutations, state transitions, …) pass through as
 // the generic arm with `data: unknown`.
@@ -10,7 +12,7 @@
 // ships ZERO runtime dependencies, so it follows the hand-written envelope-shape
 // guard precedent in `fetch-client.ts`. A frame whose JSON is malformed or whose shape
 // fails the guard is dropped (never thrown into `onEvent`) — the leg is
-// loss-tolerant, matching the dashboard's prior raw-EventSource behavior.
+// loss-tolerant.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isConversationTurnCreatedData = isConversationTurnCreatedData;
 exports.isConversationTurnCreatedEvent = isConversationTurnCreatedEvent;
@@ -21,7 +23,7 @@ function isRecord(value) {
 }
 /**
  * Runtime type-guard for a `conversation.turn_created` event's `data` envelope (the
- * single boundary-validation authority for the typed arm — QI-004, ADR-0038, no `as`).
+ * single boundary-validation authority for the typed arm — no `as`).
  */
 function isConversationTurnCreatedData(data) {
     if (!isRecord(data))

package/dist/types/events-stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"events-stream.js","sourceRoot":"","sources":["../../src/types/events-stream.ts"],"names":[],"mappings":";AAAA,uEAAuE;AACvE,EAAE;AACF,gFAAgF;AAChF,sFAAsF;AACtF,8EAA8E;AAC9E,wCAAwC;AACxC,EAAE;AACF,gFAAgF;AAChF,iFAAiF;AACjF,uFAAuF;AACvF,wEAAwE;AACxE,0EAA0E;;AAgG1E,sEAWC;AAGD,wEAEC;AAOD,oDAYC;AA7CD,MAAM,yBAAyB,GAAG,2BAA2B,CAAC;AAE9D,SAAS,QAAQ,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,SAAgB,6BAA6B,CAAC,IAAa;IACvD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1D,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1D,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACnD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,2FAA2F;AAC3F,SAAgB,8BAA8B,CAAC,KAAyB;IACpE,OAAO,KAAK,CAAC,KAAK,KAAK,yBAAyB,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB,CAChC,SAAiB,EACjB,IAAa,EACb,EAAsB;IAEtB,IAAI,SAAS,KAAK,yBAAyB,EAAE,CAAC;QAC1C,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3D,OAAO,EAAE,KAAK,SAAS;YACnB,CAAC,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,EAAE,EAAE,IAAI,EAAE;YAChD,CAAC,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,IAAI,EAAE,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC1F,CAAC"}
+{"version":3,"file":"events-stream.js","sourceRoot":"","sources":["../../src/types/events-stream.ts"],"names":[],"mappings":";AAAA,+BAA+B;AAC/B,gCAAgC;AAChC,kEAAkE;AAClE,EAAE;AACF,sEAAsE;AACtE,sFAAsF;AACtF,8EAA8E;AAC9E,wCAAwC;AACxC,EAAE;AACF,gFAAgF;AAChF,iFAAiF;AACjF,uFAAuF;AACvF,wEAAwE;AACxE,iBAAiB;;AAgGjB,sEAWC;AAGD,wEAEC;AAOD,oDAYC;AA7CD,MAAM,yBAAyB,GAAG,2BAA2B,CAAC;AAE9D,SAAS,QAAQ,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,SAAgB,6BAA6B,CAAC,IAAa;IACvD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1D,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1D,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACnD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,2FAA2F;AAC3F,SAAgB,8BAA8B,CAAC,KAAyB;IACpE,OAAO,KAAK,CAAC,KAAK,KAAK,yBAAyB,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB,CAChC,SAAiB,EACjB,IAAa,EACb,EAAsB;IAEtB,IAAI,SAAS,KAAK,yBAAyB,EAAE,CAAC;QAC1C,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3D,OAAO,EAAE,KAAK,SAAS;YACnB,CAAC,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,EAAE,EAAE,IAAI,EAAE;YAChD,CAAC,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,IAAI,EAAE,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC1F,CAAC"}

package/dist/types/flows-contract.d.ts

@@ -1,8 +1,29 @@
-export interface ContractFlowListItem {
-    readonly name: string;
-    readonly version?: string;
-    readonly description?: string;
-    readonly [key: string]: unknown;
-}
-export type ContractFlowInput = Record<string, unknown>;
+import type { FlowPatchPayload, FlowWritePayload, ContractDeletedAckPayload, ContractFlowOnCompletionCreatePayload, ContractFlowOnCompletionInlinePayload, ContractFlowOnCompletionPayload, ContractFlowOnCompletionWritePayload, ContractFlowPayload, ContractFlowStepCreatePayload, ContractFlowStepInlinePayload, ContractFlowStepPayload, ContractFlowStepWritePayload } from '../generated';
+/** One flow, as every `/contract/flows*` parent route answers it — list, get, create, replace
+ *  and patch all send this same shape. */
+export type ContractFlow = ContractFlowPayload;
+/** A step nested inside a flow object: no `tenant_name` or `flow_name`, no `position`. */
+export type ContractFlowStepInline = ContractFlowStepInlinePayload;
+/** A step from the dedicated `/steps` routes: with `tenant_name`, `flow_name` and `position`. */
+export type ContractFlowStep = ContractFlowStepPayload;
+/** An on_completion entry nested inside a flow object. */
+export type ContractFlowOnCompletionInline = ContractFlowOnCompletionInlinePayload;
+/** An on_completion entry from the dedicated routes: the full stored entry. */
+export type ContractFlowOnCompletion = ContractFlowOnCompletionPayload;
+/** What a contract DELETE answers — flow, skill, action and the two flow children.
+ *  Not an empty body. */
+export type ContractDeletedAck = ContractDeletedAckPayload;
+/** The upsert body `POST /contract/flows` and `PUT /contract/flows/{flow_name}` accept.
+ *  DERIVED from the contract API's OpenAPI document. */
+export type ContractFlowInput = FlowWritePayload;
+/** `PATCH /contract/flows/{flow_name}` — every key optional, `name` restatable and not changeable. */
+export type ContractFlowPatchInput = FlowPatchPayload;
+/** `POST /contract/flows/{flow_name}/steps`. `flow_name` may be echoed and must agree. */
+export type ContractFlowStepCreate = ContractFlowStepCreatePayload;
+/** `PUT` / `PATCH` on one step — one shape for both, because both MERGE. */
+export type ContractFlowStepWrite = ContractFlowStepWritePayload;
+/** `POST /contract/flows/{flow_name}/on-completion`. */
+export type ContractFlowOnCompletionCreate = ContractFlowOnCompletionCreatePayload;
+/** `PUT` / `PATCH` on one on-completion entry. */
+export type ContractFlowOnCompletionWrite = ContractFlowOnCompletionWritePayload;
 //# sourceMappingURL=flows-contract.d.ts.map

package/dist/types/flows-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flows-contract.d.ts","sourceRoot":"","sources":["../../src/types/flows-contract.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,oBAAoB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}
+{"version":3,"file":"flows-contract.d.ts","sourceRoot":"","sources":["../../src/types/flows-contract.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACR,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,qCAAqC,EACrC,qCAAqC,EACrC,+BAA+B,EAC/B,oCAAoC,EACpC,mBAAmB,EACnB,6BAA6B,EAC7B,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,EAC/B,MAAM,cAAc,CAAC;AAEtB;0CAC0C;AAC1C,MAAM,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAE/C,0FAA0F;AAC1F,MAAM,MAAM,sBAAsB,GAAG,6BAA6B,CAAC;AACnE,iGAAiG;AACjG,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAEvD,0DAA0D;AAC1D,MAAM,MAAM,8BAA8B,GAAG,qCAAqC,CAAC;AACnF,+EAA+E;AAC/E,MAAM,MAAM,wBAAwB,GAAG,+BAA+B,CAAC;AAEvE;yBACyB;AACzB,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,CAAC;AAE3D;wDACwD;AACxD,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AACjD,sGAAsG;AACtG,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,CAAC;AAEtD,0FAA0F;AAC1F,MAAM,MAAM,sBAAsB,GAAG,6BAA6B,CAAC;AACnE,4EAA4E;AAC5E,MAAM,MAAM,qBAAqB,GAAG,4BAA4B,CAAC;AACjE,wDAAwD;AACxD,MAAM,MAAM,8BAA8B,GAAG,qCAAqC,CAAC;AACnF,kDAAkD;AAClD,MAAM,MAAM,6BAA6B,GAAG,oCAAoC,CAAC"}

package/dist/types/flows-contract.js

@@ -1,7 +1,14 @@
 "use strict";
-// Types for the contract.flows resource (A4). Flow *definitions* live on the
-// contract plane (`contract.flows`); flow *instances/runs* are runtime-plane
-// and typed separately in `./flows`. Kept intentionally open (index signature)
-// pending the full flow-definition schema — broad typing is track G (NG-005).
+// SPDX-License-Identifier: MIT
+// Copyright 2026 Nicolas Moreno
+// Types for the `contract.flows` resource. Flow *definitions* live on the contract plane
+// (`contract.flows`); flow *instances/runs* are runtime-plane and typed in `./flows`.
+//
+// EVERY SHAPE HERE IS DERIVED from the contract API's OpenAPI document (through
+// `generated/contract.ts`), so there is one description of the `/contract/flows*` wire.
+//
+// A step has TWO shapes: nested inside a flow it carries no `tenant_name`, `flow_name` or
+// `position`; from `/contract/flows/{f}/steps` it carries all three. On-completion entries
+// likewise. The child DELETEs answer `{success, data: {message}}`, not an empty body.
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=flows-contract.js.map

package/dist/types/flows-contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"flows-contract.js","sourceRoot":"","sources":["../../src/types/flows-contract.ts"],"names":[],"mappings":";AAAA,6EAA6E;AAC7E,6EAA6E;AAC7E,+EAA+E;AAC/E,8EAA8E"}
+{"version":3,"file":"flows-contract.js","sourceRoot":"","sources":["../../src/types/flows-contract.ts"],"names":[],"mappings":";AAAA,+BAA+B;AAC/B,gCAAgC;AAChC,yFAAyF;AACzF,sFAAsF;AACtF,EAAE;AACF,gFAAgF;AAChF,wFAAwF;AACxF,EAAE;AACF,0FAA0F;AAC1F,2FAA2F;AAC3F,sFAAsF"}

package/dist/types/flows.d.ts

@@ -1,66 +1,35 @@
-/** A flow run. Mirrors `FlowInstanceRow` — every field the route actually sends. */
-export interface FlowInstance {
-    id: string;
-    tenant_name: string;
-    flow_name: string;
-    session_id: string;
-    /** Who started the run. `'anonymous'` for every channel party — see `party_ref`. */
-    actor: string;
-    /** ADR-0133 §B.5 — the party pair that owns the run; null for a non-party actor. */
-    party_ref?: string | null;
-    channel_name?: string | null;
-    status: 'running' | 'paused' | 'resuming' | 'completed' | 'failed';
-    trigger_data?: Record<string, unknown>;
-    final_state?: Record<string, unknown>;
-    error?: string;
-    /** When the run started. This is the column the table has; there is no `started_at`. */
-    created_at: string;
-    /**
-     * Last write to the row. For a run in a TERMINAL status (`completed` / `failed`)
-     * this is when it ended — the terminal status write is the last one — so
-     * `updated_at - created_at` is the run's duration. It is NOT a completion
-     * timestamp for a run still in flight; check `status` before reading it as one.
-     * For an exact per-run figure prefer the `FlowCompleted` / `FlowFailed` event's
-     * `duration_ms`, which the engine measures rather than infers.
-     */
-    updated_at: string;
-}
+import type { FlowCallbackPayload, FlowCallbackResolveBodyPayload, FlowEventKindPayload, FlowEventPayload, FlowInstancePayload } from '../generated';
+/** A flow run, as the route sends it. */
+export type FlowInstance = FlowInstancePayload;
 /**
- * One appended flow lifecycle event. Mirrors `FlowEventRow`.
+ * One appended flow lifecycle event — where per-step history lives. A step is an
+ * event whose `step_name` is set and whose `event_type` is one of the `FlowStep*`
+ * kinds.
+ */
+export type FlowEvent = FlowEventPayload;
+/**
+ * The persisted flow-event vocabulary, as a union.
+ *
+ * Derived from the runtime API's OpenAPI enum, not copied by hand: the SDK is
+ * dependency-free and does not import `@zarel-ai/contract`, where the vocabulary
+ * is defined.
+ */
+export type FlowEventKind = FlowEventKindPayload;
+/** A suspended flow's resumption point. The `id` is the capability token. */
+export type FlowCallback = FlowCallbackPayload;
+/**
+ * The body `PATCH /runtime/flows/callbacks/{id}` accepts — a CLOSED, enumerable pair, which is
+ * why it is a union and not a bag. DERIVED from the runtime API's OpenAPI document.
  *
- * This is where per-step history lives — the thing `FlowInstance.steps` claimed to
- * be. A step appears as an event whose `step_name` is set and whose `event_type` is
- * one of the `FlowStep*` kinds.
+ * The route refuses anything whose `action` is not `'complete'` or `'fail'`, and for `complete`
+ * requires `payload` to be a plain object. It settles the callback in opposite directions
+ * depending on `action`.
  */
-export interface FlowEvent {
-    id: string;
-    tenant_name: string;
-    instance_id: string;
-    /**
-     * The lifecycle kind: `FlowStarted`, `FlowStepCompleted`, `FlowStepFailed`,
-     * `FlowStepSkipped`, `FlowStepAlreadyCompleted`, `FlowPaused`, `FlowResumed`,
-     * `FlowCompleted`, `FlowFailed`, `FlowConstraintViolated`,
-     * `FlowConstraintUnverifiable`.
-     *
-     * Deliberately `string` and not a union. The vocabulary is owned by
-     * `FlowEventKind` in `@zarel-ai/contract`, which this package cannot import —
-     * the SDK is dependency-free by design. A union here would be a FOURTH
-     * hand-synced copy of that list, and `flow-vocabulary-parity.ts` exists in
-     * `data-access` precisely because copies of it had already drifted twice.
-     */
-    event_type: string;
-    /** Present on the per-step kinds; absent on run-level ones (`FlowStarted`, …). */
-    step_name?: string;
-    output_key?: string;
-    payload?: Record<string, unknown>;
-    /** Measured elapsed time for the step, or for the whole run on a terminal event. */
-    duration_ms?: number;
-    /** Which run of the instance appended this row (resume increments it). */
-    attempt: number;
-    created_at: string;
-}
+export type FlowCallbackResolution = FlowCallbackResolveBodyPayload;
 export type FlowInstanceListResponse = FlowInstance[];
 export type FlowInstanceResponse = FlowInstance;
 export type FlowEventListResponse = FlowEvent[];
 export type FlowEventResponse = FlowEvent;
+export type FlowCallbackListResponse = FlowCallback[];
+export type FlowCallbackResponse = FlowCallback;
 //# sourceMappingURL=flows.d.ts.map

package/dist/types/flows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../../src/types/flows.ts"],"names":[],"mappings":"AAuBA,oFAAoF;AACpF,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;IACd,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wFAAwF;IACxF,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;;OAWG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACtB;AAID,MAAM,MAAM,wBAAwB,GAAG,YAAY,EAAE,CAAC;AACtD,MAAM,MAAM,oBAAoB,GAAG,YAAY,CAAC;AAChD,MAAM,MAAM,qBAAqB,GAAG,SAAS,EAAE,CAAC;AAChD,MAAM,MAAM,iBAAiB,GAAG,SAAS,CAAC"}
+{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../../src/types/flows.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACR,mBAAmB,EACnB,8BAA8B,EAC9B,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACtB,MAAM,cAAc,CAAC;AAEtB,yCAAyC;AACzC,MAAM,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,gBAAgB,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAEjD,6EAA6E;AAC7E,MAAM,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,MAAM,sBAAsB,GAAG,8BAA8B,CAAC;AAIpE,MAAM,MAAM,wBAAwB,GAAG,YAAY,EAAE,CAAC;AACtD,MAAM,MAAM,oBAAoB,GAAG,YAAY,CAAC;AAChD,MAAM,MAAM,qBAAqB,GAAG,SAAS,EAAE,CAAC;AAChD,MAAM,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAC1C,MAAM,MAAM,wBAAwB,GAAG,YAAY,EAAE,CAAC;AACtD,MAAM,MAAM,oBAAoB,GAAG,YAAY,CAAC"}

package/dist/types/flows.js

@@ -1,25 +1,13 @@
 "use strict";
+// SPDX-License-Identifier: MIT
+// Copyright 2026 Nicolas Moreno
 // ── Flows ────────────────────────────────────────────────────────────────
 //
-// Canonical runtime-scope flow types. Backing tables:
-//   runtime."flows/instances"   (readonly)
-//   runtime."flows/events"      (readonly)
-//   runtime."flows/callbacks"   (mutable — PATCH to resolve a pending callback)
-//
-// THESE TYPES ARE THE WIRE, and until now they were not. `FlowInstance` declared
-// `started_at: string` (required), `completed_at`, and a `steps: FlowStep[]`
-// collection. The route returns the repository row verbatim
-// (`FlowInstanceRepository.mapRow`) and that row has none of the three: the table
-// carries `created_at` / `updated_at` and keeps per-step history in the SIBLING
-// `flows/events` table. So every consumer that read `started_at` got `undefined`
-// (`new Date(undefined)` → "Invalid Date") and every consumer that mapped `steps`
-// crashed on `undefined`.
-//
-// Nothing caught it because the OpenAPI types both responses as a bare
-// `$ref: OkEnvelope` with no schema, so there is no generated type to disagree
-// with and no parity gate that could compare them. The hand-written declaration
-// was the only description of the shape, and it described a shape that never
-// existed. Keep this file matched to `FlowInstanceRow` / `FlowEventRow` in
-// `@zarel-ai/data-access`; those are the producers.
+// THIS FILE DECLARES NO SHAPE. Every type below is the generated projection of
+// the published response schema (the runtime API's OpenAPI document →
+// `generated/runtime.ts`), so there is exactly one description of the
+// `/runtime/flows/*` wire and the SDK cannot disagree with it. Nullable fields
+// such as `error`, `step_name`, `output_key` and `duration_ms` arrive as `null`,
+// not absent.
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=flows.js.map

package/dist/types/flows.js.map

@@ -1 +1 @@
-{"version":3,"file":"flows.js","sourceRoot":"","sources":["../../src/types/flows.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,EAAE;AACF,sDAAsD;AACtD,2CAA2C;AAC3C,2CAA2C;AAC3C,gFAAgF;AAChF,EAAE;AACF,iFAAiF;AACjF,6EAA6E;AAC7E,4DAA4D;AAC5D,kFAAkF;AAClF,gFAAgF;AAChF,iFAAiF;AACjF,kFAAkF;AAClF,0BAA0B;AAC1B,EAAE;AACF,uEAAuE;AACvE,+EAA+E;AAC/E,gFAAgF;AAChF,6EAA6E;AAC7E,2EAA2E;AAC3E,oDAAoD"}
+{"version":3,"file":"flows.js","sourceRoot":"","sources":["../../src/types/flows.ts"],"names":[],"mappings":";AAAA,+BAA+B;AAC/B,gCAAgC;AAChC,4EAA4E;AAC5E,EAAE;AACF,+EAA+E;AAC/E,sEAAsE;AACtE,sEAAsE;AACtE,+EAA+E;AAC/E,iFAAiF;AACjF,cAAc"}

package/dist/types/imports.d.ts

@@ -42,6 +42,15 @@ export interface SnapshotImportFile {
         data: Record<string, unknown>;
     }>>;
 }
+/**
+ * NARROWER THAN THE WIRE ON `data`, for the reason `WorkflowReplayRequest` states: the published
+ * `SnapshotImportBody.data` is an open bag — a tenant's own records, judged against that tenant's
+ * contract — and `SnapshotImportFile` is the useful shape a caller wants help with. Not derived.
+ *
+ * The two MODES are the wire's exactly, and both are optional here and there: the published body
+ * carries no `default:` keywords, because openapi-typescript emits a property carrying one as
+ * REQUIRED, which had made the generated type disagree with this one.
+ */
 export interface SnapshotImportRequest {
     data: SnapshotImportFile;
     mode?: 'clean' | 'restore';

package/dist/types/imports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../src/types/imports.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,EAAE;QACN,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,KAAK,EAAE,KAAK,CAAC;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;KAChC,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;QACnB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC,CAAC,CAAC;CACP;AAED,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,eAAe,CAAC,EAAE,WAAW,GAAG,gBAAgB,CAAC;CACpD;AAED,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB"}
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../src/types/imports.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,EAAE;QACN,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,KAAK,EAAE,KAAK,CAAC;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;KAChC,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;QACnB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC,CAAC,CAAC;CACP;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,eAAe,CAAC,EAAE,WAAW,GAAG,gBAAgB,CAAC;CACpD;AAED,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/types/index.d.ts

@@ -3,11 +3,15 @@ export type { ActionDispatchParams, ActionDispatchSuccessResponse, } from './act
 export type { ConfirmationGuard, ConfirmationChallenge, ConfirmationRetryOptions, } from './confirmation';
 export type { ToolCatalogResponse, McpToolsResponse, ToolCallRequest, ToolCallResponse, UserToolCatalog, UserVisibleEntityTool, UserVisibleAction, UserVisibleTransitionTool, TransitionEdge, UserVisibleActionTool, FieldToolDefinition, McpToolDefinition, } from './tools';
 export type { WorkflowReplayRequest, WorkflowReplayResponse, WorkflowReplayResult, WorkflowReplayEmptyResult, WorkflowReplayEventResult, WorkflowStateMachineConfig, WorkflowTransitionConfig, WorkflowTransitionRule, } from './workflows';
-export type { StateMachineInstance, StateMachineInstanceListResponse, StateMachineInstanceResponse, StateMachineEventListParams, StateMachineEvent, StateMachineEventListResponse, StateMachineEventResponse, TransitionRequestStatus, TransitionRequestListParams, TransitionRequestItem, TransitionRequestListResponse, TransitionRequestResponse, TransitionRequestCreateBody, TransitionRequestPatchBody, TransitionRequestPatchResponse, } from './state-machine';
-export type { FlowInstance, FlowInstanceListResponse, FlowInstanceResponse, FlowEvent, FlowEventListResponse, FlowEventResponse, } from './flows';
+export type { StateMachineInstance, StateMachineInstanceListResponse, StateMachineInstanceResponse, StateMachineEventListParams, StateMachineEvent, StateMachineEventListResponse, StateMachineEventResponse, TransitionRequestStatus, TransitionRequestListParams, TransitionRequestItem, TransitionRequestListResponse, TransitionRequestResponse, TransitionRequestCreateBody, TransitionRequestPatchBody, TransitionRequestResolveInput, TransitionRequestPatchResponse, } from './state-machine';
+export type { FlowInstance, FlowInstanceListResponse, FlowInstanceResponse, FlowEvent, FlowEventKind, FlowEventListResponse, FlowEventResponse, FlowCallback, FlowCallbackListResponse, FlowCallbackResolution, FlowCallbackResponse, } from './flows';
 export type { RecordData, RefLabel, RecordListParams, RecordListResponse, RecordResponse, } from './records';
-export type { EntityInput, FieldDefinitionInput, ToolExecutionResult, } from './entities';
-export type { RoleAssignRequest, EventRecord, EventListResponse, EventSubscriptionInput, FlowCallbackResponse, ErrorBody, } from './platform';
+export type { ContractFlow, ContractFlowInput, ContractFlowStep, ContractFlowStepInline, ContractFlowOnCompletion, ContractFlowOnCompletionInline, ContractDeletedAck, } from './flows-contract';
+export type { ContractTreatment, ContractTreatmentWrite, ContractTreatmentRails, ContractVocabularyEntry, ContractVocabularyCreate, ContractVocabularyWrite, ContractProfile, ContractProfileWrite, ContractProfileCreate, ContractTenantMetadata, ContractTenantMetadataWrite, } from './treatment-contract';
+export type { CapabilityRecord, CapabilityCreate, CapabilityWrite, SchemaRecord, SchemaCreate, SchemaWrite, ConstraintRecord, ConstraintCreate, ConstraintWrite, PhaseRecord, PhaseCreate, PhaseWrite, PhaseEntryCondition, PhaseActionScope, } from './collections-contract';
+export type { McpRetryPolicy, McpServerRecord, McpServerCreate, McpServerWrite, McpAllowedToolRecord, McpAllowedToolCreate, McpAllowedToolWrite, WebhookEventEffect, FlowEventEffect, EventRuleEffect, EventRuleRecord, RecordCreatedRule, RecordUpdatedRule, RecordDeletedRule, StateTransitionedRule, SystemEventRule, EventRuleWrite, EventRulePatch, } from './mcp-and-events-contract';
+export type { ContractEntity, ContractEntityField, ContractEntityFieldList, ContractEntityFieldRecord, ContractEntityFieldRef, ContractEntityList, ContractEntityRecord, ContractEntitySummary, ContractFieldTransition, EntityInput, EntityReplaceInput, EntityWriteInput, FieldDefinitionInput, FieldReplaceInput, FieldWriteInput, ToolExecutionResult, } from './entities';
+export type { RoleAssignRequest, EventRecord, EventListResponse, EventSubscriptionInput, ErrorBody, } from './platform';
 export type { HealthResponse, MetricsResponse, ApiKeyCreateRequest, ApiKeyCreateResponse, ApiKeyListItem, ApiKeyListResponse, ApiKeyDeleteResponse, } from './system';
 export type { ImportExecutionMode, BulkImportItem, BulkImportRequest, BulkImportItemResult, BulkImportResponse, SnapshotImportFile, SnapshotImportRequest, SnapshotImportResponse, } from './imports';
 export type { Trace, TraceEvent, TraceEventError, TraceOutcome, TraceStage, TraceSummary, TraceUserRef, TraceListParams, TraceListResponse, } from './traces';

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/locale.d.ts

@@ -1,8 +1,8 @@
 /**
- * spec-039 T089-T090 — Locale option for SDK methods that hit
+ * Locale option for SDK methods that hit
  * locale-aware GET endpoints.
  *
- * Per FR-023: when locale is omitted the SDK MUST omit the `?locale=`
+ * When locale is omitted the SDK MUST omit the `?locale=`
  * query param entirely; the server then applies its own resolution chain
  * (JWT preferences.language → canonical). Setting locale to an
  * explicit value sends `?locale=<value>`.

package/dist/types/locale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/types/locale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEpD,MAAM,WAAW,aAAa;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;CACtB"}
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/types/locale.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEpD,MAAM,WAAW,aAAa;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;CACtB"}