@pear-protocol/types 1.20.0 → 1.22.0

package/dist/notification/entities.d.ts

@@ -5,8 +5,9 @@ import { z } from 'zod';
  * execute; `ATTACHED_TRIGGER_DISCARDED` means requested close protection could
  * not be placed after a position opened; the `AUTO_REBALANCE_*` categories cover
  * an auto-rebalance config acting on, or stopping itself over, the position it
- * watches. Outcome lives here in the category; display details live in the
- * `parameters` payload below.
+ * watches; `TRIGGER_CANCELLED_MIS_SCALED` means the remediation sweep cancelled
+ * an unreachable stop loss. Outcome lives here in the category; display details
+ * live in the `parameters` payload below.
  */
 export declare const NotificationCategory: z.ZodEnum<{
     TAKE_PROFIT_HIT: "TAKE_PROFIT_HIT";
@@ -19,6 +20,7 @@ export declare const NotificationCategory: z.ZodEnum<{
     AUTO_REBALANCE_EXECUTED: "AUTO_REBALANCE_EXECUTED";
     AUTO_REBALANCE_FAILED: "AUTO_REBALANCE_FAILED";
     AUTO_REBALANCE_PAUSED: "AUTO_REBALANCE_PAUSED";
+    TRIGGER_CANCELLED_MIS_SCALED: "TRIGGER_CANCELLED_MIS_SCALED";
 }>;
 export type NotificationCategory = z.infer<typeof NotificationCategory>;
 export declare const NotificationMetric: z.ZodEnum<{
@@ -48,6 +50,10 @@ export declare const NotificationParameters: z.ZodDiscriminatedUnion<[z.ZodObjec
             SELL: "SELL";
         }>;
     }, z.core.$strip>>;
+    semanticBracketType: z.ZodOptional<z.ZodEnum<{
+        STOP_LOSS: "STOP_LOSS";
+        TAKE_PROFIT: "TAKE_PROFIT";
+    }>>;
     metric: z.ZodOptional<z.ZodEnum<{
         price: "price";
         notional: "notional";
@@ -86,6 +92,10 @@ export declare const NotificationParameters: z.ZodDiscriminatedUnion<[z.ZodObjec
             SELL: "SELL";
         }>;
     }, z.core.$strip>>;
+    semanticBracketType: z.ZodOptional<z.ZodEnum<{
+        STOP_LOSS: "STOP_LOSS";
+        TAKE_PROFIT: "TAKE_PROFIT";
+    }>>;
     metric: z.ZodOptional<z.ZodEnum<{
         price: "price";
         notional: "notional";
@@ -323,6 +333,12 @@ export declare const NotificationParameters: z.ZodDiscriminatedUnion<[z.ZodObjec
         LIVE_BETA: "LIVE_BETA";
     }>;
     type: z.ZodLiteral<"auto_rebalance_paused">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"trigger_cancelled_mis_scaled">;
+    triggerId: z.ZodUUID;
+    positionKey: z.ZodString;
+    storedBps: z.ZodNumber;
+    readingMarginPct: z.ZodNumber;
 }, z.core.$strip>], "type">;
 export type NotificationParameters = z.output<typeof NotificationParameters>;
 export declare const Notification: z.ZodObject<{
@@ -338,6 +354,7 @@ export declare const Notification: z.ZodObject<{
         AUTO_REBALANCE_EXECUTED: "AUTO_REBALANCE_EXECUTED";
         AUTO_REBALANCE_FAILED: "AUTO_REBALANCE_FAILED";
         AUTO_REBALANCE_PAUSED: "AUTO_REBALANCE_PAUSED";
+        TRIGGER_CANCELLED_MIS_SCALED: "TRIGGER_CANCELLED_MIS_SCALED";
     }>;
     parameters: z.ZodDiscriminatedUnion<[z.ZodObject<{
         legs: z.ZodArray<z.ZodObject<{
@@ -348,6 +365,10 @@ export declare const Notification: z.ZodObject<{
                 SELL: "SELL";
             }>;
         }, z.core.$strip>>;
+        semanticBracketType: z.ZodOptional<z.ZodEnum<{
+            STOP_LOSS: "STOP_LOSS";
+            TAKE_PROFIT: "TAKE_PROFIT";
+        }>>;
         metric: z.ZodOptional<z.ZodEnum<{
             price: "price";
             notional: "notional";
@@ -386,6 +407,10 @@ export declare const Notification: z.ZodObject<{
                 SELL: "SELL";
             }>;
         }, z.core.$strip>>;
+        semanticBracketType: z.ZodOptional<z.ZodEnum<{
+            STOP_LOSS: "STOP_LOSS";
+            TAKE_PROFIT: "TAKE_PROFIT";
+        }>>;
         metric: z.ZodOptional<z.ZodEnum<{
             price: "price";
             notional: "notional";
@@ -623,6 +648,12 @@ export declare const Notification: z.ZodObject<{
             LIVE_BETA: "LIVE_BETA";
         }>;
         type: z.ZodLiteral<"auto_rebalance_paused">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"trigger_cancelled_mis_scaled">;
+        triggerId: z.ZodUUID;
+        positionKey: z.ZodString;
+        storedBps: z.ZodNumber;
+        readingMarginPct: z.ZodNumber;
     }, z.core.$strip>], "type">;
     isRead: z.ZodBoolean;
     createdAt: z.ZodString;

package/dist/notification/entities.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { Side } from '../common/schema';
 import { Connector } from '../connector';
+import { TpSlBracketType } from '../trigger/common';
 
 const NotificationCategory = z.enum([
   "TAKE_PROFIT_HIT",
@@ -12,7 +13,8 @@ const NotificationCategory = z.enum([
   "ATTACHED_TRIGGER_DISCARDED",
   "AUTO_REBALANCE_EXECUTED",
   "AUTO_REBALANCE_FAILED",
-  "AUTO_REBALANCE_PAUSED"
+  "AUTO_REBALANCE_PAUSED",
+  "TRIGGER_CANCELLED_MIS_SCALED"
 ]);
 const NotificationMetric = z.enum([
   "ratio",
@@ -49,14 +51,18 @@ const TakeProfitNotificationParameters = PositionLegParameters.safeExtend({
   triggerId: z.uuid(),
   positionId: z.uuid(),
   connector: Connector,
-  ...TriggerNotificationEnrichment
+  ...TriggerNotificationEnrichment,
+  // User-facing bracket semantics; absent when a legacy trigger's intent is unknown.
+  semanticBracketType: TpSlBracketType.optional()
 });
 const StopLossNotificationParameters = PositionLegParameters.safeExtend({
   type: z.literal("stop_loss"),
   triggerId: z.uuid(),
   positionId: z.uuid(),
   connector: Connector,
-  ...TriggerNotificationEnrichment
+  ...TriggerNotificationEnrichment,
+  // User-facing bracket semantics; absent when a legacy trigger's intent is unknown.
+  semanticBracketType: TpSlBracketType.optional()
 });
 const TriggerOrderNotificationParameters = PositionLegParameters.safeExtend({
   type: z.literal("trigger_order"),
@@ -124,6 +130,13 @@ const AutoRebalancePausedNotificationParameters = z.object({
   legs: z.array(AutoRebalanceLeg),
   pausedReason: z.enum(["POSITION_CHANGED", "REPEATED_FAILURES", "INVALID_LIVE_BETA_EXPOSURE"])
 });
+const TriggerCancelledMisScaledNotificationParameters = z.object({
+  type: z.literal("trigger_cancelled_mis_scaled"),
+  triggerId: z.uuid(),
+  positionKey: z.string().min(1),
+  storedBps: z.number(),
+  readingMarginPct: z.number()
+});
 const NotificationParameters = z.discriminatedUnion("type", [
   TakeProfitNotificationParameters,
   StopLossNotificationParameters,
@@ -132,7 +145,8 @@ const NotificationParameters = z.discriminatedUnion("type", [
   AttachedTriggerDiscardedNotificationParameters,
   AutoRebalanceExecutedNotificationParameters,
   AutoRebalanceFailedNotificationParameters,
-  AutoRebalancePausedNotificationParameters
+  AutoRebalancePausedNotificationParameters,
+  TriggerCancelledMisScaledNotificationParameters
 ]);
 const Notification = z.object({
   /**

package/dist/notification/responses.d.ts

@@ -13,6 +13,7 @@ export declare const NotificationListResponse: z.ZodObject<{
             AUTO_REBALANCE_EXECUTED: "AUTO_REBALANCE_EXECUTED";
             AUTO_REBALANCE_FAILED: "AUTO_REBALANCE_FAILED";
             AUTO_REBALANCE_PAUSED: "AUTO_REBALANCE_PAUSED";
+            TRIGGER_CANCELLED_MIS_SCALED: "TRIGGER_CANCELLED_MIS_SCALED";
         }>;
         parameters: z.ZodDiscriminatedUnion<[z.ZodObject<{
             legs: z.ZodArray<z.ZodObject<{
@@ -23,6 +24,10 @@ export declare const NotificationListResponse: z.ZodObject<{
                     SELL: "SELL";
                 }>;
             }, z.core.$strip>>;
+            semanticBracketType: z.ZodOptional<z.ZodEnum<{
+                STOP_LOSS: "STOP_LOSS";
+                TAKE_PROFIT: "TAKE_PROFIT";
+            }>>;
             metric: z.ZodOptional<z.ZodEnum<{
                 price: "price";
                 notional: "notional";
@@ -61,6 +66,10 @@ export declare const NotificationListResponse: z.ZodObject<{
                     SELL: "SELL";
                 }>;
             }, z.core.$strip>>;
+            semanticBracketType: z.ZodOptional<z.ZodEnum<{
+                STOP_LOSS: "STOP_LOSS";
+                TAKE_PROFIT: "TAKE_PROFIT";
+            }>>;
             metric: z.ZodOptional<z.ZodEnum<{
                 price: "price";
                 notional: "notional";
@@ -298,6 +307,12 @@ export declare const NotificationListResponse: z.ZodObject<{
                 LIVE_BETA: "LIVE_BETA";
             }>;
             type: z.ZodLiteral<"auto_rebalance_paused">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"trigger_cancelled_mis_scaled">;
+            triggerId: z.ZodUUID;
+            positionKey: z.ZodString;
+            storedBps: z.ZodNumber;
+            readingMarginPct: z.ZodNumber;
         }, z.core.$strip>], "type">;
         isRead: z.ZodBoolean;
         createdAt: z.ZodString;

package/dist/trade/responses.d.ts

@@ -1095,5 +1095,277 @@ export declare const CreateTradeReverseResponse: z.ZodObject<{
     }, z.core.$strip>], "intent">], "orderType">;
 }, z.core.$strip>;
 export type CreateTradeReverseResponse = z.output<typeof CreateTradeReverseResponse>;
-export declare const CreateTradeCloseAllResponse: z.ZodObject<{}, z.core.$strip>;
+export declare const CreateTradeCloseAllResponse: z.ZodObject<{
+    executions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodUUID;
+        connector: z.ZodEnum<{
+            hyperliquid: "hyperliquid";
+            binance: "binance";
+            bybit: "bybit";
+            okx: "okx";
+            lighter: "lighter";
+        }>;
+        status: z.ZodEnum<{
+            CANCELLED: "CANCELLED";
+            IDLE: "IDLE";
+            ACTIVE: "ACTIVE";
+            COMPLETED: "COMPLETED";
+            FAILED: "FAILED";
+        }>;
+        error: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        orders: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            id: z.ZodUUID;
+            connector: z.ZodEnum<{
+                hyperliquid: "hyperliquid";
+                binance: "binance";
+                bybit: "bybit";
+                okx: "okx";
+                lighter: "lighter";
+            }>;
+            status: z.ZodEnum<{
+                PENDING: "PENDING";
+                PARTIAL: "PARTIAL";
+                FILLED: "FILLED";
+                CANCELLED: "CANCELLED";
+                REJECTED: "REJECTED";
+            }>;
+            error: z.ZodOptional<z.ZodString>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+            type: z.ZodLiteral<"MARKET">;
+            symbol: z.ZodString;
+            side: z.ZodEnum<{
+                BUY: "BUY";
+                SELL: "SELL";
+            }>;
+            reduceOnly: z.ZodBoolean;
+            quantity: z.ZodString;
+            price: z.ZodString;
+            filledQuantity: z.ZodString;
+            filledPrice: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "type">>>;
+        intent: z.ZodLiteral<"OPEN">;
+        orderType: z.ZodLiteral<"MARKET">;
+        legs: z.ZodTuple<[z.ZodObject<{
+            symbol: z.ZodString;
+            side: z.ZodEnum<{
+                BUY: "BUY";
+                SELL: "SELL";
+            }>;
+            mode: z.ZodEnum<{
+                QUANTITY: "QUANTITY";
+                USD: "USD";
+            }>;
+            amount: z.ZodString;
+            reduceOnly: z.ZodBoolean;
+        }, z.core.$strip>], z.ZodObject<{
+            symbol: z.ZodString;
+            side: z.ZodEnum<{
+                BUY: "BUY";
+                SELL: "SELL";
+            }>;
+            mode: z.ZodEnum<{
+                QUANTITY: "QUANTITY";
+                USD: "USD";
+            }>;
+            amount: z.ZodString;
+            reduceOnly: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodUUID;
+        connector: z.ZodEnum<{
+            hyperliquid: "hyperliquid";
+            binance: "binance";
+            bybit: "bybit";
+            okx: "okx";
+            lighter: "lighter";
+        }>;
+        status: z.ZodEnum<{
+            CANCELLED: "CANCELLED";
+            IDLE: "IDLE";
+            ACTIVE: "ACTIVE";
+            COMPLETED: "COMPLETED";
+            FAILED: "FAILED";
+        }>;
+        error: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        orders: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            id: z.ZodUUID;
+            connector: z.ZodEnum<{
+                hyperliquid: "hyperliquid";
+                binance: "binance";
+                bybit: "bybit";
+                okx: "okx";
+                lighter: "lighter";
+            }>;
+            status: z.ZodEnum<{
+                PENDING: "PENDING";
+                PARTIAL: "PARTIAL";
+                FILLED: "FILLED";
+                CANCELLED: "CANCELLED";
+                REJECTED: "REJECTED";
+            }>;
+            error: z.ZodOptional<z.ZodString>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+            type: z.ZodLiteral<"MARKET">;
+            symbol: z.ZodString;
+            side: z.ZodEnum<{
+                BUY: "BUY";
+                SELL: "SELL";
+            }>;
+            reduceOnly: z.ZodBoolean;
+            quantity: z.ZodString;
+            price: z.ZodString;
+            filledQuantity: z.ZodString;
+            filledPrice: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "type">>>;
+        intent: z.ZodLiteral<"ADJUST">;
+        orderType: z.ZodLiteral<"MARKET">;
+        position: z.ZodObject<{
+            id: z.ZodUUID;
+            exposure: z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>>;
+        }, z.core.$strip>;
+        legs: z.ZodTuple<[z.ZodObject<{
+            symbol: z.ZodString;
+            side: z.ZodEnum<{
+                BUY: "BUY";
+                SELL: "SELL";
+            }>;
+            mode: z.ZodEnum<{
+                QUANTITY: "QUANTITY";
+                USD: "USD";
+            }>;
+            amount: z.ZodString;
+            reduceOnly: z.ZodBoolean;
+        }, z.core.$strip>], z.ZodObject<{
+            symbol: z.ZodString;
+            side: z.ZodEnum<{
+                BUY: "BUY";
+                SELL: "SELL";
+            }>;
+            mode: z.ZodEnum<{
+                QUANTITY: "QUANTITY";
+                USD: "USD";
+            }>;
+            amount: z.ZodString;
+            reduceOnly: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodUUID;
+        connector: z.ZodEnum<{
+            hyperliquid: "hyperliquid";
+            binance: "binance";
+            bybit: "bybit";
+            okx: "okx";
+            lighter: "lighter";
+        }>;
+        status: z.ZodEnum<{
+            CANCELLED: "CANCELLED";
+            IDLE: "IDLE";
+            ACTIVE: "ACTIVE";
+            COMPLETED: "COMPLETED";
+            FAILED: "FAILED";
+        }>;
+        error: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        orders: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            id: z.ZodUUID;
+            connector: z.ZodEnum<{
+                hyperliquid: "hyperliquid";
+                binance: "binance";
+                bybit: "bybit";
+                okx: "okx";
+                lighter: "lighter";
+            }>;
+            status: z.ZodEnum<{
+                PENDING: "PENDING";
+                PARTIAL: "PARTIAL";
+                FILLED: "FILLED";
+                CANCELLED: "CANCELLED";
+                REJECTED: "REJECTED";
+            }>;
+            error: z.ZodOptional<z.ZodString>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+            type: z.ZodLiteral<"MARKET">;
+            symbol: z.ZodString;
+            side: z.ZodEnum<{
+                BUY: "BUY";
+                SELL: "SELL";
+            }>;
+            reduceOnly: z.ZodBoolean;
+            quantity: z.ZodString;
+            price: z.ZodString;
+            filledQuantity: z.ZodString;
+            filledPrice: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "type">>>;
+        intent: z.ZodLiteral<"CLOSE">;
+        orderType: z.ZodLiteral<"MARKET">;
+        position: z.ZodObject<{
+            id: z.ZodUUID;
+            exposure: z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodUUID;
+        connector: z.ZodEnum<{
+            hyperliquid: "hyperliquid";
+            binance: "binance";
+            bybit: "bybit";
+            okx: "okx";
+            lighter: "lighter";
+        }>;
+        status: z.ZodEnum<{
+            CANCELLED: "CANCELLED";
+            IDLE: "IDLE";
+            ACTIVE: "ACTIVE";
+            COMPLETED: "COMPLETED";
+            FAILED: "FAILED";
+        }>;
+        error: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        orders: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            id: z.ZodUUID;
+            connector: z.ZodEnum<{
+                hyperliquid: "hyperliquid";
+                binance: "binance";
+                bybit: "bybit";
+                okx: "okx";
+                lighter: "lighter";
+            }>;
+            status: z.ZodEnum<{
+                PENDING: "PENDING";
+                PARTIAL: "PARTIAL";
+                FILLED: "FILLED";
+                CANCELLED: "CANCELLED";
+                REJECTED: "REJECTED";
+            }>;
+            error: z.ZodOptional<z.ZodString>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+            type: z.ZodLiteral<"MARKET">;
+            symbol: z.ZodString;
+            side: z.ZodEnum<{
+                BUY: "BUY";
+                SELL: "SELL";
+            }>;
+            reduceOnly: z.ZodBoolean;
+            quantity: z.ZodString;
+            price: z.ZodString;
+            filledQuantity: z.ZodString;
+            filledPrice: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "type">>>;
+        intent: z.ZodLiteral<"REVERSE">;
+        orderType: z.ZodLiteral<"MARKET">;
+        position: z.ZodObject<{
+            id: z.ZodUUID;
+            exposure: z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>], "intent">], "orderType">>;
+}, z.core.$strip>;
 export type CreateTradeCloseAllResponse = z.output<typeof CreateTradeCloseAllResponse>;

package/dist/trade/responses.js

@@ -5,6 +5,6 @@ const CreateTradeOpenResponse = z.object({ execution: Execution });
 const CreateTradeAdjustResponse = z.object({ execution: Execution });
 const CreateTradeCloseResponse = z.object({ execution: Execution });
 const CreateTradeReverseResponse = z.object({ execution: Execution });
-const CreateTradeCloseAllResponse = z.object({});
+const CreateTradeCloseAllResponse = z.object({ executions: z.array(Execution) });
 
 export { CreateTradeAdjustResponse, CreateTradeCloseAllResponse, CreateTradeCloseResponse, CreateTradeOpenResponse, CreateTradeReverseResponse };

package/dist/trigger/entities/index.d.ts

@@ -79,6 +79,11 @@ declare const BaseTrigger: z.ZodObject<{
         TAKE_PROFIT: "TAKE_PROFIT";
         NONE: "NONE";
     }>;
+    semanticBracketType: z.ZodOptional<z.ZodEnum<{
+        STOP_LOSS: "STOP_LOSS";
+        TAKE_PROFIT: "TAKE_PROFIT";
+        NONE: "NONE";
+    }>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, z.core.$strip>;
@@ -161,6 +166,11 @@ export declare const TriggerMarketOpen: z.ZodObject<{
         TAKE_PROFIT: "TAKE_PROFIT";
         NONE: "NONE";
     }>;
+    semanticBracketType: z.ZodOptional<z.ZodEnum<{
+        STOP_LOSS: "STOP_LOSS";
+        TAKE_PROFIT: "TAKE_PROFIT";
+        NONE: "NONE";
+    }>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     intent: z.ZodLiteral<"OPEN">;
@@ -363,6 +373,11 @@ export declare const TriggerMarketAdjust: z.ZodObject<{
         TAKE_PROFIT: "TAKE_PROFIT";
         NONE: "NONE";
     }>;
+    semanticBracketType: z.ZodOptional<z.ZodEnum<{
+        STOP_LOSS: "STOP_LOSS";
+        TAKE_PROFIT: "TAKE_PROFIT";
+        NONE: "NONE";
+    }>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     intent: z.ZodLiteral<"ADJUST">;
@@ -611,6 +626,11 @@ export declare const TriggerMarketClose: z.ZodObject<{
         TAKE_PROFIT: "TAKE_PROFIT";
         NONE: "NONE";
     }>;
+    semanticBracketType: z.ZodOptional<z.ZodEnum<{
+        STOP_LOSS: "STOP_LOSS";
+        TAKE_PROFIT: "TAKE_PROFIT";
+        NONE: "NONE";
+    }>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     intent: z.ZodLiteral<"CLOSE">;
@@ -893,6 +913,11 @@ export declare const TriggerMarket: z.ZodDiscriminatedUnion<[z.ZodObject<{
         TAKE_PROFIT: "TAKE_PROFIT";
         NONE: "NONE";
     }>;
+    semanticBracketType: z.ZodOptional<z.ZodEnum<{
+        STOP_LOSS: "STOP_LOSS";
+        TAKE_PROFIT: "TAKE_PROFIT";
+        NONE: "NONE";
+    }>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     intent: z.ZodLiteral<"OPEN">;
@@ -1094,6 +1119,11 @@ export declare const TriggerMarket: z.ZodDiscriminatedUnion<[z.ZodObject<{
         TAKE_PROFIT: "TAKE_PROFIT";
         NONE: "NONE";
     }>;
+    semanticBracketType: z.ZodOptional<z.ZodEnum<{
+        STOP_LOSS: "STOP_LOSS";
+        TAKE_PROFIT: "TAKE_PROFIT";
+        NONE: "NONE";
+    }>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     intent: z.ZodLiteral<"ADJUST">;
@@ -1341,6 +1371,11 @@ export declare const TriggerMarket: z.ZodDiscriminatedUnion<[z.ZodObject<{
         TAKE_PROFIT: "TAKE_PROFIT";
         NONE: "NONE";
     }>;
+    semanticBracketType: z.ZodOptional<z.ZodEnum<{
+        STOP_LOSS: "STOP_LOSS";
+        TAKE_PROFIT: "TAKE_PROFIT";
+        NONE: "NONE";
+    }>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     intent: z.ZodLiteral<"CLOSE">;
@@ -1623,6 +1658,11 @@ export declare const Trigger: z.ZodDiscriminatedUnion<[z.ZodDiscriminatedUnion<[
         TAKE_PROFIT: "TAKE_PROFIT";
         NONE: "NONE";
     }>;
+    semanticBracketType: z.ZodOptional<z.ZodEnum<{
+        STOP_LOSS: "STOP_LOSS";
+        TAKE_PROFIT: "TAKE_PROFIT";
+        NONE: "NONE";
+    }>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     intent: z.ZodLiteral<"OPEN">;
@@ -1824,6 +1864,11 @@ export declare const Trigger: z.ZodDiscriminatedUnion<[z.ZodDiscriminatedUnion<[
         TAKE_PROFIT: "TAKE_PROFIT";
         NONE: "NONE";
     }>;
+    semanticBracketType: z.ZodOptional<z.ZodEnum<{
+        STOP_LOSS: "STOP_LOSS";
+        TAKE_PROFIT: "TAKE_PROFIT";
+        NONE: "NONE";
+    }>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     intent: z.ZodLiteral<"ADJUST">;
@@ -2071,6 +2116,11 @@ export declare const Trigger: z.ZodDiscriminatedUnion<[z.ZodDiscriminatedUnion<[
         TAKE_PROFIT: "TAKE_PROFIT";
         NONE: "NONE";
     }>;
+    semanticBracketType: z.ZodOptional<z.ZodEnum<{
+        STOP_LOSS: "STOP_LOSS";
+        TAKE_PROFIT: "TAKE_PROFIT";
+        NONE: "NONE";
+    }>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     intent: z.ZodLiteral<"CLOSE">;

package/dist/trigger/entities/index.js

@@ -83,6 +83,13 @@ const BaseTrigger = z.object({
    * Bracket type for trigger behavior
    */
   bracketType: BracketType,
+  /**
+   * User-facing bracket semantics. `bracketType` is the crossing encoding the gateway
+   * fires on (wire-flipped for a price bracket on a short watched leg); this field is
+   * what the user asked for. Absent whenever a legacy client's encoding is
+   * unknowable; do not present `bracketType` as user intent in that case.
+   */
+  semanticBracketType: BracketType.optional(),
   /**
    * Created at timestamp
    */