@zarel-ai/sdk 0.6.0 → 0.7.0

package/dist/types/locale.js

@@ -1,9 +1,11 @@
 "use strict";
+// SPDX-License-Identifier: MIT
+// Copyright 2026 Nicolas Moreno
 /**
- * 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.js.map

@@ -1 +1 @@
-{"version":3,"file":"locale.js","sourceRoot":"","sources":["../../src/types/locale.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG"}
+{"version":3,"file":"locale.js","sourceRoot":"","sources":["../../src/types/locale.ts"],"names":[],"mappings":";AAAA,+BAA+B;AAC/B,gCAAgC;AAChC;;;;;;;;;;;;;GAaG"}

package/dist/types/mcp-and-events-contract.d.ts

@@ -0,0 +1,51 @@
+import type { EventRuleEffectPayload, EventRulePatchPayload, EventRulePayload, EventRuleWritePayload, FlowEventEffectPayload, McpAllowedToolCreatePayload, McpAllowedToolPayload, McpAllowedToolWritePayload, McpRetryPolicyPayload, McpServerCreatePayload, McpServerPayload, McpServerWritePayload, RecordCreatedRulePayload, RecordDeletedRulePayload, RecordUpdatedRulePayload, StateTransitionedRulePayload, SystemEventRulePayload, WebhookEventEffectPayload } from '../generated';
+/** The `retry` object. Two known members over an open bag, because that is what the API accepts and returns. */
+export type McpRetryPolicy = McpRetryPolicyPayload;
+/** One live MCP server, as every `/contract/mcp-servers*` route answers it. */
+export type McpServerRecord = McpServerPayload;
+/** The POST body. An omitted `timeout_ms` takes the server default (`30000`), on a create and on a resurrect. */
+export type McpServerCreate = McpServerCreatePayload;
+/** The PUT/PATCH body. Both verbs MERGE; only `url` and `retry` accept `null` to clear. */
+export type McpServerWrite = McpServerWritePayload;
+/** One live allowed tool of an MCP server. There is no `description`. */
+export type McpAllowedToolRecord = McpAllowedToolPayload;
+/** The POST body — identity is split, `namespace` from the path and `tool_name` from here. */
+export type McpAllowedToolCreate = McpAllowedToolCreatePayload;
+/** The PUT/PATCH body. Both verbs MERGE; the three object-valued properties accept `null` to clear. */
+export type McpAllowedToolWrite = McpAllowedToolWritePayload;
+/** An outbound notification effect. */
+export type WebhookEventEffect = WebhookEventEffectPayload;
+/** A `flow.start` effect, run as the occurrence actor or an opt-in definer-rights role. */
+export type FlowEventEffect = FlowEventEffectPayload;
+/** One `do[]` member — discriminated on `type`. */
+export type EventRuleEffect = EventRuleEffectPayload;
+/**
+ * One live event rule, with its ordered `do[]`.
+ *
+ * A DISCRIMINATED UNION on `on`, not an open bag: the five members below are the five the
+ * contract's `events.rules` section declares, and each is closed. Switching over `rule.on` narrows
+ * to the trigger keys that variant actually carries — `entity` on the three record kinds,
+ * `field`/`from`/`to` on a transition, `event`/`flow` on a system event.
+ */
+export type EventRuleRecord = EventRulePayload;
+export type RecordCreatedRule = RecordCreatedRulePayload;
+export type RecordUpdatedRule = RecordUpdatedRulePayload;
+export type RecordDeletedRule = RecordDeletedRulePayload;
+export type StateTransitionedRule = StateTransitionedRulePayload;
+export type SystemEventRule = SystemEventRulePayload;
+/**
+ * The POST and PUT body — a rule is written WHOLE by both.
+ *
+ * `PUT` is a TOTAL write: the server clears every trigger key the new rule does not carry, so
+ * an omitted `condition` is CLEARED and read-modify-PUT must send back everything it
+ * means to keep. This is the one granular collection where `replace` is not a merge.
+ */
+export type EventRuleWrite = EventRuleWritePayload;
+/**
+ * The PATCH body — merged onto the STORED rule before the union judges the result whole.
+ *
+ * Wider than any single variant on purpose: which keys are legal depends on the stored `on`,
+ * which no request schema can see. Changing `on` is refused by name.
+ */
+export type EventRulePatch = EventRulePatchPayload;
+//# sourceMappingURL=mcp-and-events-contract.d.ts.map

package/dist/types/mcp-and-events-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-and-events-contract.d.ts","sourceRoot":"","sources":["../../src/types/mcp-and-events-contract.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACR,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,4BAA4B,EAC5B,sBAAsB,EACtB,yBAAyB,EAC5B,MAAM,cAAc,CAAC;AAEtB,gHAAgH;AAChH,MAAM,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAEnD,+EAA+E;AAC/E,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAE/C,iHAAiH;AACjH,MAAM,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAErD,2FAA2F;AAC3F,MAAM,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAEnD,yEAAyE;AACzE,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAEzD,8FAA8F;AAC9F,MAAM,MAAM,oBAAoB,GAAG,2BAA2B,CAAC;AAE/D,uGAAuG;AACvG,MAAM,MAAM,mBAAmB,GAAG,0BAA0B,CAAC;AAE7D,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,CAAC;AAE3D,2FAA2F;AAC3F,MAAM,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAErD,mDAAmD;AACnD,MAAM,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAE/C,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AACzD,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AACzD,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AACzD,MAAM,MAAM,qBAAqB,GAAG,4BAA4B,CAAC;AACjE,MAAM,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,qBAAqB,CAAC"}

package/dist/types/mcp-and-events-contract.js

@@ -0,0 +1,20 @@
+"use strict";
+// SPDX-License-Identifier: MIT
+// Copyright 2026 Nicolas Moreno
+// Types for `mcp-servers`, its nested `allowed-tools`, and `events/rules`.
+//
+// EVERY SHAPE HERE IS DERIVED from the contract API's OpenAPI document (through
+// `generated/contract.ts`), so there is one description of these eighteen operations' wire.
+// Do not hand-write these types or add a `[key: string]: unknown` index signature: it admits
+// every property, so no field could be missing and no field could be wrong.
+//
+// There is no `description` on an allowed tool: semantic content is written by a contract
+// publish. `tenant_name` and `is_active` are always on the wire, and `McpServerRecord.timeout_ms`
+// is always present (the server default is `30000`). The DELETEs answer
+// `{success, data: {message}}`, not an empty body.
+//
+// The READ and the WRITE are different shapes, but a GET body IS a legal write body:
+// `tenant_name` and the path keys are accepted on the write verbs as an identity ECHO, refused
+// when they DISAGREE with the request, and never merely ignored.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=mcp-and-events-contract.js.map

package/dist/types/mcp-and-events-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-and-events-contract.js","sourceRoot":"","sources":["../../src/types/mcp-and-events-contract.ts"],"names":[],"mappings":";AAAA,+BAA+B;AAC/B,gCAAgC;AAChC,2EAA2E;AAC3E,EAAE;AACF,gFAAgF;AAChF,4FAA4F;AAC5F,6FAA6F;AAC7F,4EAA4E;AAC5E,EAAE;AACF,0FAA0F;AAC1F,kGAAkG;AAClG,wEAAwE;AACxE,mDAAmD;AACnD,EAAE;AACF,qFAAqF;AACrF,+FAA+F;AAC/F,iEAAiE"}

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

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/types/mcp.ts"],"names":[],"mappings":"AAUA,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,iCAAiC;IACjC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,2DAA2D;IAC3D,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC5D;AAED,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAAG,eAAe,CAAC"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/types/mcp.ts"],"names":[],"mappings":"AAYA,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,iCAAiC;IACjC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,2DAA2D;IAC3D,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC5D;AAED,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAAG,eAAe,CAAC"}

package/dist/types/mcp.js

@@ -1,5 +1,7 @@
 "use strict";
-// Spec 2 (track G, MCP transport follow-up) — MCP JSON-RPC transport types.
+// SPDX-License-Identifier: MIT
+// Copyright 2026 Nicolas Moreno
+// MCP JSON-RPC transport types.
 //
 // `client.runtime.mcp.call` speaks the MCP "Streamable HTTP" transport
 // (POST /runtime/mcp, stateless, one logical JSON-RPC response per request).

package/dist/types/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/types/mcp.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,EAAE;AACF,uEAAuE;AACvE,6EAA6E;AAC7E,8EAA8E;AAC9E,gFAAgF;AAChF,6EAA6E;AAC7E,0EAA0E;AAC1E,4DAA4D"}
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/types/mcp.ts"],"names":[],"mappings":";AAAA,+BAA+B;AAC/B,gCAAgC;AAChC,gCAAgC;AAChC,EAAE;AACF,uEAAuE;AACvE,6EAA6E;AAC7E,8EAA8E;AAC9E,gFAAgF;AAChF,6EAA6E;AAC7E,0EAA0E;AAC1E,4DAA4D"}

package/dist/types/platform.d.ts

@@ -1,14 +1,16 @@
+import type { EventSubscriptionCreateBodyPayload } from '../generated';
 export interface RoleAssignRequest {
     target_user_name: string;
     role_name: string;
     expires_at?: string;
 }
-export interface EventSubscriptionInput {
-    event_name: string;
-    webhook_url: string;
-    secret?: string;
-    headers?: Record<string, string>;
-}
+/**
+ * DERIVED from the runtime API's OpenAPI document.
+ *
+ * `secret` is the HMAC key that signs deliveries; a non-string `secret` is refused, not
+ * dropped.
+ */
+export type EventSubscriptionInput = EventSubscriptionCreateBodyPayload;
 export interface EventRecord {
     id: string;
     type: string;
@@ -24,9 +26,11 @@ export interface EventSubscription {
     tenant_name?: string;
     event_name: string;
     webhook_url: string;
-    secret?: string | null;
     is_active: boolean;
-    headers?: Record<string, string> | null;
+    /** Whether an HMAC signing key is configured. The KEY itself never leaves the server. */
+    has_secret?: boolean;
+    /** The configured header NAMES. Values never leave the server. */
+    header_names?: string[];
     created_at: string;
     updated_at?: string;
 }
@@ -35,10 +39,6 @@ export type EventSubscriptionListResponse = EventSubscription[];
 export interface EventSubscriptionDeactivateResponse {
     id: number;
 }
-export interface FlowCallbackResponse {
-    success: true;
-    message?: string;
-}
 export interface ErrorBody {
     error: {
         type: string;

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

@@ -1 +1 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/types/platform.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,MAAM,WAAW,sBAAsB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,yBAAyB,GAAG,iBAAiB,CAAC;AAE1D,MAAM,MAAM,6BAA6B,GAAG,iBAAiB,EAAE,CAAC;AAEhE,MAAM,WAAW,mCAAmC;IAChD,EAAE,EAAE,MAAM,CAAC;CACd;AAID,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACL"}
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/types/platform.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,cAAc,CAAC;AAIvE,MAAM,WAAW,iBAAiB;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAID;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,kCAAkC,CAAC;AAOxE,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,yFAAyF;IACzF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,yBAAyB,GAAG,iBAAiB,CAAC;AAE1D,MAAM,MAAM,6BAA6B,GAAG,iBAAiB,EAAE,CAAC;AAEhE,MAAM,WAAW,mCAAmC;IAChD,EAAE,EAAE,MAAM,CAAC;CACd;AASD,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACL"}

package/dist/types/platform.js

@@ -1,4 +1,3 @@
 "use strict";
-// ── Roles ────────────────────────────────────────────────────────────────
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=platform.js.map

package/dist/types/platform.js.map

@@ -1 +1 @@
-{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/types/platform.ts"],"names":[],"mappings":";AAAA,4EAA4E"}
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/types/platform.ts"],"names":[],"mappings":""}

package/dist/types/receipt.d.ts

@@ -1,10 +1,8 @@
 /**
- * Receipt read-surface types (Desk Spec 3 — end-user verifiable receipts).
+ * Receipt read-surface types (end-user verifiable receipts).
  *
- * Wire shapes mirror the runtime contract module's `Receipt` DTO (see
- * authoring/packages/contract/src/domain/types/receipt.ts). Kept as plain
- * interfaces so SDK consumers need not depend on the runtime contract package
- * (same convention as `types/audit.ts`).
+ * Wire shapes of the runtime API's receipt responses, kept as plain interfaces
+ * with no dependencies (same convention as `types/audit.ts`).
  *
  * A `Receipt` is the caller's OWN governance event, normalized over the three
  * audit signals. It carries only a non-reversible proof (hash + masked value +

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

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

package/dist/types/receipt.js

@@ -1,11 +1,11 @@
 "use strict";
+// SPDX-License-Identifier: MIT
+// Copyright 2026 Nicolas Moreno
 /**
- * Receipt read-surface types (Desk Spec 3 — end-user verifiable receipts).
+ * Receipt read-surface types (end-user verifiable receipts).
  *
- * Wire shapes mirror the runtime contract module's `Receipt` DTO (see
- * authoring/packages/contract/src/domain/types/receipt.ts). Kept as plain
- * interfaces so SDK consumers need not depend on the runtime contract package
- * (same convention as `types/audit.ts`).
+ * Wire shapes of the runtime API's receipt responses, kept as plain interfaces
+ * with no dependencies (same convention as `types/audit.ts`).
  *
  * A `Receipt` is the caller's OWN governance event, normalized over the three
  * audit signals. It carries only a non-reversible proof (hash + masked value +

package/dist/types/receipt.js.map

@@ -1 +1 @@
-{"version":3,"file":"receipt.js","sourceRoot":"","sources":["../../src/types/receipt.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG"}
+{"version":3,"file":"receipt.js","sourceRoot":"","sources":["../../src/types/receipt.ts"],"names":[],"mappings":";AAAA,+BAA+B;AAC/B,gCAAgC;AAChC;;;;;;;;;GASG"}

package/dist/types/records.d.ts

@@ -1,7 +1,7 @@
 /**
- * ADR-0134: a resolved reference label as delivered in the `ref_labels` sidecar.
+ * A resolved reference label as delivered in the `ref_labels` sidecar.
  * A `string` for a single `reference`; a positional array (aligned to the id
- * array, `null` where the target row was not visible) for a `reference[]`. This
+ * array, `null` where the target record was not visible) for a `reference[]`. This
  * single-shape union is the wire contract — consumers should read it through the
  * `@zarel-ai/react` `singleRefLabel` / `refLabelAt` accessors rather than
  * hand-narrowing `typeof` / `Array.isArray`.
@@ -13,7 +13,7 @@ export interface RecordData {
     created_at?: string;
     updated_at?: string;
     /**
-     * ADR-0134: resolved reference labels, keyed by reference field name. Absent
+     * Resolved reference labels, keyed by reference field name. Absent
      * when the field has no resolvable label — consumers fall back to `<entity>#<id>`.
      */
     ref_labels?: Record<string, RefLabel>;

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

@@ -1 +1 @@
-{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../src/types/records.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAErD,MAAM,WAAW,UAAU;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,QAAQ,GACd,IAAI,GAAG,KAAK,GACZ,UAAU,GAAG,YAAY,GAAG,UAAU,GACtC,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAC3B,SAAS,GACT,IAAI,GAAG,QAAQ,GACf,QAAQ,GAAG,OAAO,GAClB,UAAU,GAAG,cAAc,CAAC;AAElC,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,EAAE,CAAC;AAEhF,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAErC,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;CACrB;AAID,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC;AAExC,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../src/types/records.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAErD,MAAM,WAAW,UAAU;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,QAAQ,GACd,IAAI,GAAG,KAAK,GACZ,UAAU,GAAG,YAAY,GAAG,UAAU,GACtC,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAC3B,SAAS,GACT,IAAI,GAAG,QAAQ,GACf,QAAQ,GAAG,OAAO,GAClB,UAAU,GAAG,cAAc,CAAC;AAElC,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,EAAE,CAAC;AAEhF,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAErC,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;CACrB;AAID,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC;AAExC,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC"}

package/dist/types/records.js

@@ -1,4 +1,6 @@
 "use strict";
+// SPDX-License-Identifier: MIT
+// Copyright 2026 Nicolas Moreno
 // ── Records ──────────────────────────────────────────────────────────────
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=records.js.map

package/dist/types/records.js.map

@@ -1 +1 @@
-{"version":3,"file":"records.js","sourceRoot":"","sources":["../../src/types/records.ts"],"names":[],"mappings":";AAAA,4EAA4E"}
+{"version":3,"file":"records.js","sourceRoot":"","sources":["../../src/types/records.ts"],"names":[],"mappings":";AAAA,+BAA+B;AAC/B,gCAAgC;AAChC,4EAA4E"}

package/dist/types/spec.d.ts

@@ -1,6 +1,6 @@
 /**
- * Spec-document types (spec-051 US2). Re-exports from contracts.ts which
- * retains the primary type definitions alongside deprecated aliases.
+ * Spec-document types. Re-exports from contracts.ts, which holds the
+ * definitions.
  */
 export type { SpecSection, ChangeKind, ImpactClass, ReviewerRole, SpecHashes, SpecChange, ImpactSummary, SpecDiff, SpecApplyMode, SpecFiles, SpecPublishRequest, SpecPublishResponse, SpecDiffRequest, SpecApplyGating, SpecApplyRequest, SpecApplyResponse, SpecSnapshotV1Response, SpecDryRunStatus, SpecDryRunOutcome, SpecDryRunUnknownCause, SpecDryRunReplayWindow, SpecDryRunFilter, SpecDryRunSubmitRequest, SpecDryRunSubmitResponse, SpecDryRunChangeBreakdown, SpecDryRunUnknown, SpecDryRunAffectedUser, SpecDryRunOperationalImplications, SpecDryRunReport, SpecDryRunJobProgress, SpecDryRunJobFailure, SpecDryRunJob, } from './contracts';
 //# sourceMappingURL=spec.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/types/spec.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EACR,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,UAAU,EACV,aAAa,EACb,QAAQ,EACR,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,iCAAiC,EACjC,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,GAChB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/types/spec.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,YAAY,EACR,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,UAAU,EACV,aAAa,EACb,QAAQ,EACR,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,iCAAiC,EACjC,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,GAChB,MAAM,aAAa,CAAC"}

package/dist/types/state-machine.d.ts

@@ -1,38 +1,18 @@
-export interface StateMachineInstance {
-    id: string;
-    entity_name: string;
-    record_id: number;
-    field_name: string;
-    current_state: string;
-    created_at: string;
-    updated_at?: string;
-}
-export interface StateMachineInstanceListResponse {
-    count: number;
-    instances: StateMachineInstance[];
-}
+import type { StateMachineEventListPayload, StateMachineEventPayload, StateMachineInstanceListPayload, StateMachineInstancePayload, TransitionRequestListPayload, TransitionRequestPayload, TransitionRequestCreateBodyPayload, TransitionRequestResolveBodyPayload, TransitionRequestStatusPayload } from '../generated';
+/** One record-field state machine. Every property is always present and never `null`. */
+export type StateMachineInstance = StateMachineInstancePayload;
+export type StateMachineInstanceListResponse = StateMachineInstanceListPayload;
 export type StateMachineInstanceResponse = StateMachineInstance;
 export interface StateMachineEventListParams {
     entity_name?: string;
     instance_id?: string;
 }
-export interface StateMachineEvent {
-    id: string;
-    instance_id: string;
-    from_state: string;
-    to_state: string;
-    actor?: string;
-    actor_role?: string | null;
-    payload?: Record<string, unknown>;
-    rule_evaluations?: unknown;
-    created_at: string;
-}
-export interface StateMachineEventListResponse {
-    count: number;
-    events: StateMachineEvent[];
-}
+/** One recorded transition. */
+export type StateMachineEvent = StateMachineEventPayload;
+export type StateMachineEventListResponse = StateMachineEventListPayload;
 export type StateMachineEventResponse = StateMachineEvent;
-export type TransitionRequestStatus = 'pending' | 'approved' | 'rejected';
+/** `pending | approved | rejected` — the generated union off the published enum. */
+export type TransitionRequestStatus = TransitionRequestStatusPayload;
 export interface TransitionRequestListParams {
     status?: TransitionRequestStatus;
     /**
@@ -41,60 +21,44 @@ export interface TransitionRequestListParams {
      */
     roles?: string[];
 }
-export interface TransitionRequestItem {
-    transition_request_id: string;
-    entity_name: string;
-    record_id: number;
-    current_state: string;
-    target_state: string;
-    field_name?: string;
-    required_roles: string[];
-    reason?: string;
-    status?: TransitionRequestStatus;
-    created_at: string;
-}
-export interface TransitionRequestListResponse {
-    count: number;
-    transition_requests: TransitionRequestItem[];
-}
+/** A requested transition awaiting a decision. `transition_request_id`, not `id`. */
+export type TransitionRequestItem = TransitionRequestPayload;
+export type TransitionRequestListResponse = TransitionRequestListPayload;
 export type TransitionRequestResponse = TransitionRequestItem;
-export interface TransitionRequestCreateBody {
-    instance_id: string;
-    entity_name: string;
-    record_id: number;
-    field_name: string;
-    current_state: string;
-    requested_transition: string;
-    /**
-     * Server derives `required_roles` from the contract's matching transition
-     * edges (`allowed_roles` union). Clients should normally omit this field;
-     * supplied values are used only when the server has no contract context
-     * (e.g., test stubs) and are otherwise ignored.
-     */
-    required_roles?: string[];
-    reason?: string;
-}
-export interface TransitionRequestPatchBody {
-    decision: 'approved' | 'rejected';
-    role?: string;
-    field_name?: string;
-    decision_notes?: string;
-}
-export interface TransitionRequestPatchResponse {
-    mode?: string;
-    entity_name?: string;
-    record_id?: number;
-    transition_request?: {
-        transition_request_id: string;
-        status: 'approved' | 'rejected';
-        resolved_by: string;
-        entity_name: string;
-        record_id: number;
-    };
-    state_machine_event?: {
-        id: string;
-        from_state: string;
-        to_state: string;
-    } | null;
-}
+/**
+ * DERIVED from the runtime API's OpenAPI document, like everything else here.
+ *
+ * IT CARRIES NEITHER `flow_instance_id` NOR `instance_id` NOR `required_roles`. All three name
+ * something the SERVER owns — the run a request is linked to, the machine it is about, and the
+ * set that decides who may resolve it — and the route refuses each BY NAME with a 400.
+ */
+export type TransitionRequestCreateBody = TransitionRequestCreateBodyPayload;
+/**
+ * What the PATCH accepts, DERIVED from the published schema like everything else here. At
+ * least one key is required — a body carrying none is refused *"patch body requires at least
+ * one mutable field"*.
+ *
+ * `status`, not `decision`, and only `approved` or `rejected`: a resolution goes through
+ * approval (the approver's authority is checked, the transition's rules are re-checked when it
+ * commits, and a waiting flow resumes in the same transaction). `pending` is an outcome rather
+ * than a request, and the route refuses it.
+ *
+ * There is no `resolved_by` or `resolved_at`: the approver is the authenticated caller and the
+ * decision is dated by the server, so the route refuses both.
+ */
+export type TransitionRequestPatchBody = TransitionRequestResolveBodyPayload;
+/**
+ * What `resolveTransitionRequest()` takes: the wire body with the DECISION REQUIRED.
+ *
+ * The wire legitimately accepts a note-only patch — annotating a pending request changes no
+ * state — but a method named `resolve` must resolve: without a required `status`,
+ * `resolve(id, {decision_notes: 'looks good'})` would patch the note, leave the request
+ * `pending`, and still type-check. Narrowing the METHOD is not a fiction about the wire; it is
+ * the method saying what it is for.
+ */
+export type TransitionRequestResolveInput = Omit<TransitionRequestPatchBody, 'status'> & {
+    status: NonNullable<TransitionRequestPatchBody['status']>;
+};
+/** The resolved request, in the same shape `GET` answers. */
+export type TransitionRequestPatchResponse = TransitionRequestItem;
 //# sourceMappingURL=state-machine.d.ts.map

package/dist/types/state-machine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../../src/types/state-machine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../../src/types/state-machine.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACR,4BAA4B,EAC5B,wBAAwB,EACxB,+BAA+B,EAC/B,2BAA2B,EAC3B,4BAA4B,EAC5B,wBAAwB,EACxB,kCAAkC,EAClC,mCAAmC,EACnC,8BAA8B,EACjC,MAAM,cAAc,CAAC;AAEtB,yFAAyF;AACzF,MAAM,MAAM,oBAAoB,GAAG,2BAA2B,CAAC;AAC/D,MAAM,MAAM,gCAAgC,GAAG,+BAA+B,CAAC;AAC/E,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,CAAC;AAEhE,MAAM,WAAW,2BAA2B;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,+BAA+B;AAC/B,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AACzD,MAAM,MAAM,6BAA6B,GAAG,4BAA4B,CAAC;AACzE,MAAM,MAAM,yBAAyB,GAAG,iBAAiB,CAAC;AAI1D,oFAAoF;AACpF,MAAM,MAAM,uBAAuB,GAAG,8BAA8B,CAAC;AAErE,MAAM,WAAW,2BAA2B;IACxC,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,qFAAqF;AACrF,MAAM,MAAM,qBAAqB,GAAG,wBAAwB,CAAC;AAC7D,MAAM,MAAM,6BAA6B,GAAG,4BAA4B,CAAC;AACzE,MAAM,MAAM,yBAAyB,GAAG,qBAAqB,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,MAAM,2BAA2B,GAAG,kCAAkC,CAAC;AAE7E;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,0BAA0B,GAAG,mCAAmC,CAAC;AAE7E;;;;;;;;GAQG;AACH,MAAM,MAAM,6BAA6B,GACrC,IAAI,CAAC,0BAA0B,EAAE,QAAQ,CAAC,GACxC;IAAE,MAAM,EAAE,WAAW,CAAC,0BAA0B,CAAC,QAAQ,CAAC,CAAC,CAAA;CAAE,CAAC;AAEpE,6DAA6D;AAC7D,MAAM,MAAM,8BAA8B,GAAG,qBAAqB,CAAC"}

package/dist/types/state-machine.js

@@ -1,9 +1,14 @@
 "use strict";
+// SPDX-License-Identifier: MIT
+// Copyright 2026 Nicolas Moreno
 // ── State Machine ────────────────────────────────────────────────────────
 //
-// Canonical runtime-scope state-machine types. Backing tables:
-//   runtime."state_machine/instances"          (readonly)
-//   runtime."state_machine/events"             (readonly; was exposed as /workflows/timeline pre-P10)
-//   runtime."state_machine/transition_requests" (mutable)
+// EVERY RESPONSE TYPE HERE IS DERIVED from the runtime API's OpenAPI document (through
+// `generated/runtime.ts`), so there is one description of the `/runtime/state-machine/*` wire:
+//   /runtime/state-machine/instances            (readonly)
+//   /runtime/state-machine/events               (readonly)
+//   /runtime/state-machine/transition-requests  (mutable)
+//
+// An optional key with no value is ABSENT from the response, not `null`.
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=state-machine.js.map

package/dist/types/state-machine.js.map

@@ -1 +1 @@
-{"version":3,"file":"state-machine.js","sourceRoot":"","sources":["../../src/types/state-machine.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,EAAE;AACF,+DAA+D;AAC/D,0DAA0D;AAC1D,sGAAsG;AACtG,0DAA0D"}
+{"version":3,"file":"state-machine.js","sourceRoot":"","sources":["../../src/types/state-machine.ts"],"names":[],"mappings":";AAAA,+BAA+B;AAC/B,gCAAgC;AAChC,4EAA4E;AAC5E,EAAE;AACF,uFAAuF;AACvF,+FAA+F;AAC/F,2DAA2D;AAC3D,2DAA2D;AAC3D,0DAA0D;AAC1D,EAAE;AACF,yEAAyE"}

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

@@ -1 +1 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/types/system.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,kBAAkB,GAAG,cAAc,EAAE,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,IAAI,CAAC;CACjB"}
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/types/system.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,kBAAkB,GAAG,cAAc,EAAE,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,IAAI,CAAC;CACjB"}