@osdk/internal.foundry.ontologies 2.32.0 → 2.34.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -24,6 +24,38 @@ export interface AbsoluteValuePropertyExpression {
24
24
  * Log Safety: UNSAFE
25
25
  */
26
26
  export type Action = LooselyBrandedString<"Action">;
27
+ /**
28
+ * A detailed operation for an Action
29
+ *
30
+ * Log Safety: UNSAFE
31
+ */
32
+ export type ActionLogicRule = ({
33
+ type: "modifyInterface";
34
+ } & ModifyInterfaceLogicRule) | ({
35
+ type: "createOrModifyObject";
36
+ } & CreateOrModifyObjectLogicRule) | ({
37
+ type: "modifyObject";
38
+ } & ModifyObjectLogicRule) | ({
39
+ type: "deleteLink";
40
+ } & DeleteLinkLogicRule) | ({
41
+ type: "createObject";
42
+ } & CreateObjectLogicRule) | ({
43
+ type: "createLink";
44
+ } & CreateLinkLogicRule) | ({
45
+ type: "batchedFunction";
46
+ } & BatchedFunctionLogicRule) | ({
47
+ type: "createOrModifyObjectV2";
48
+ } & CreateOrModifyObjectLogicRuleV2) | ({
49
+ type: "deleteInterfaceLink";
50
+ } & DeleteInterfaceLinkLogicRule) | ({
51
+ type: "deleteObject";
52
+ } & DeleteObjectLogicRule) | ({
53
+ type: "function";
54
+ } & FunctionLogicRule) | ({
55
+ type: "createInterfaceLink";
56
+ } & CreateInterfaceLinkLogicRule) | ({
57
+ type: "createInterface";
58
+ } & CreateInterfaceLogicRule);
27
59
  /**
28
60
  * Log Safety: SAFE
29
61
  */
@@ -124,6 +156,15 @@ endpoint or check the Ontology Manager.
124
156
  * Log Safety: UNSAFE
125
157
  */
126
158
  export type ActionTypeApiName = LooselyBrandedString<"ActionTypeApiName">;
159
+ /**
160
+ * Returns the full metadata for an Action type in the Ontology.
161
+ *
162
+ * Log Safety: UNSAFE
163
+ */
164
+ export interface ActionTypeFullMetadata {
165
+ actionType: ActionTypeV2;
166
+ fullLogicRule: ActionLogicRule;
167
+ }
127
168
  /**
128
169
  * The unique resource identifier of an action type, useful for interacting with other Foundry APIs.
129
170
  *
@@ -193,6 +234,13 @@ export interface AddObjectEdit {
193
234
  export interface AddPropertyExpression {
194
235
  properties: Array<DerivedPropertyDefinition>;
195
236
  }
237
+ /**
238
+ * Log Safety: UNSAFE
239
+ */
240
+ export interface Affix {
241
+ prefix?: PropertyTypeReferenceOrStringConstant;
242
+ postfix?: PropertyTypeReferenceOrStringConstant;
243
+ }
196
244
  /**
197
245
  * Log Safety: UNSAFE
198
246
  */
@@ -799,6 +847,13 @@ export interface BatchApplyActionResponse {
799
847
  export interface BatchApplyActionResponseV2 {
800
848
  edits?: BatchActionResults;
801
849
  }
850
+ /**
851
+ * Log Safety: UNSAFE
852
+ */
853
+ export interface BatchedFunctionLogicRule {
854
+ objectSetRidInputName: FunctionParameterName;
855
+ functionRule: FunctionLogicRule;
856
+ }
802
857
  /**
803
858
  * Log Safety: SAFE
804
859
  */
@@ -932,12 +987,38 @@ export interface CountAggregationV2 {
932
987
  export interface CountObjectsResponseV2 {
933
988
  count?: number;
934
989
  }
990
+ /**
991
+ * Log Safety: UNSAFE
992
+ */
993
+ export interface CreateInterfaceLinkLogicRule {
994
+ interfaceTypeApiName: InterfaceTypeApiName;
995
+ interfaceLinkTypeApiName: InterfaceLinkTypeApiName;
996
+ sourceObject: ParameterId;
997
+ targetObject: ParameterId;
998
+ }
999
+ /**
1000
+ * Log Safety: UNSAFE
1001
+ */
1002
+ export interface CreateInterfaceLogicRule {
1003
+ interfaceTypeApiName: InterfaceTypeApiName;
1004
+ objectType: ParameterId;
1005
+ sharedPropertyArguments: Record<SharedPropertyTypeApiName, LogicRuleArgument>;
1006
+ structPropertyArguments: Record<SharedPropertyTypeApiName, Record<StructFieldApiName, StructFieldArgument>>;
1007
+ }
935
1008
  /**
936
1009
  * Log Safety: UNSAFE
937
1010
  */
938
1011
  export interface CreateInterfaceObjectRule {
939
1012
  interfaceTypeApiName: InterfaceTypeApiName;
940
1013
  }
1014
+ /**
1015
+ * Log Safety: UNSAFE
1016
+ */
1017
+ export interface CreateLinkLogicRule {
1018
+ linkTypeApiName: LinkTypeApiName;
1019
+ sourceObject: ParameterId;
1020
+ targetObject: ParameterId;
1021
+ }
941
1022
  /**
942
1023
  * Log Safety: UNSAFE
943
1024
  */
@@ -947,12 +1028,36 @@ export interface CreateLinkRule {
947
1028
  aSideObjectTypeApiName: ObjectTypeApiName;
948
1029
  bSideObjectTypeApiName: ObjectTypeApiName;
949
1030
  }
1031
+ /**
1032
+ * Log Safety: UNSAFE
1033
+ */
1034
+ export interface CreateObjectLogicRule {
1035
+ objectTypeApiName: ObjectTypeApiName;
1036
+ propertyArguments: Record<PropertyApiName, LogicRuleArgument>;
1037
+ structPropertyArguments: Record<PropertyApiName, Record<StructFieldApiName, StructFieldArgument>>;
1038
+ }
950
1039
  /**
951
1040
  * Log Safety: UNSAFE
952
1041
  */
953
1042
  export interface CreateObjectRule {
954
1043
  objectTypeApiName: ObjectTypeApiName;
955
1044
  }
1045
+ /**
1046
+ * Log Safety: UNSAFE
1047
+ */
1048
+ export interface CreateOrModifyObjectLogicRule {
1049
+ objectTypeApiName: ObjectTypeApiName;
1050
+ propertyArguments: Record<PropertyApiName, LogicRuleArgument>;
1051
+ structPropertyArguments: Record<PropertyApiName, Record<StructFieldApiName, StructFieldArgument>>;
1052
+ }
1053
+ /**
1054
+ * Log Safety: UNSAFE
1055
+ */
1056
+ export interface CreateOrModifyObjectLogicRuleV2 {
1057
+ objectToModify: ParameterId;
1058
+ propertyArguments: Record<PropertyApiName, LogicRuleArgument>;
1059
+ structPropertyArguments: Record<PropertyApiName, Record<StructFieldApiName, StructFieldArgument>>;
1060
+ }
956
1061
  /**
957
1062
  * Log Safety: UNSAFE
958
1063
  */
@@ -965,6 +1070,20 @@ export interface CreateTemporaryObjectSetRequestV2 {
965
1070
  export interface CreateTemporaryObjectSetResponseV2 {
966
1071
  objectSetRid: ObjectSetRid;
967
1072
  }
1073
+ /**
1074
+ * Represents the current time argument in a logic rule.
1075
+ *
1076
+ * Log Safety: SAFE
1077
+ */
1078
+ export interface CurrentTimeArgument {
1079
+ }
1080
+ /**
1081
+ * Represents the current user argument in a logic rule.
1082
+ *
1083
+ * Log Safety: SAFE
1084
+ */
1085
+ export interface CurrentUserArgument {
1086
+ }
968
1087
  /**
969
1088
  * A UUID representing a custom type in a given Function.
970
1089
  *
@@ -1004,6 +1123,57 @@ export type CustomTypeId = LooselyBrandedString<"CustomTypeId">;
1004
1123
  * Log Safety: UNSAFE
1005
1124
  */
1006
1125
  export type DataValue = any;
1126
+ /**
1127
+ * Log Safety: UNSAFE
1128
+ */
1129
+ export type DatetimeFormat = ({
1130
+ type: "stringFormat";
1131
+ } & DatetimeStringFormat) | ({
1132
+ type: "localizedFormat";
1133
+ } & DatetimeLocalizedFormat);
1134
+ /**
1135
+ * Predefined localized formatting options.
1136
+ *
1137
+ * Log Safety: SAFE
1138
+ */
1139
+ export interface DatetimeLocalizedFormat {
1140
+ format: DatetimeLocalizedFormatType;
1141
+ }
1142
+ /**
1143
+ * Localized date/time format types.
1144
+ *
1145
+ * Log Safety: SAFE
1146
+ */
1147
+ export type DatetimeLocalizedFormatType = "DATE_FORMAT_RELATIVE_TO_NOW" | "DATE_FORMAT_DATE" | "DATE_FORMAT_YEAR_AND_MONTH" | "DATE_FORMAT_DATE_TIME" | "DATE_FORMAT_DATE_TIME_SHORT" | "DATE_FORMAT_TIME" | "DATE_FORMAT_ISO_INSTANT";
1148
+ /**
1149
+ * A strictly specified date format pattern.
1150
+ *
1151
+ * Log Safety: SAFE
1152
+ */
1153
+ export interface DatetimeStringFormat {
1154
+ pattern: string;
1155
+ }
1156
+ /**
1157
+ * Log Safety: UNSAFE
1158
+ */
1159
+ export type DatetimeTimezone = ({
1160
+ type: "static";
1161
+ } & DatetimeTimezoneStatic) | ({
1162
+ type: "user";
1163
+ } & DatetimeTimezoneUser);
1164
+ /**
1165
+ * Log Safety: UNSAFE
1166
+ */
1167
+ export interface DatetimeTimezoneStatic {
1168
+ zoneId: PropertyTypeReferenceOrStringConstant;
1169
+ }
1170
+ /**
1171
+ * The user's local timezone.
1172
+ *
1173
+ * Log Safety: SAFE
1174
+ */
1175
+ export interface DatetimeTimezoneUser {
1176
+ }
1007
1177
  /**
1008
1178
  * The result of a CipherText decryption. If successful, the plaintext decrypted value will be returned. Otherwise, an error will be thrown.
1009
1179
  *
@@ -1012,6 +1182,15 @@ export type DataValue = any;
1012
1182
  export interface DecryptionResult {
1013
1183
  plaintext?: Plaintext;
1014
1184
  }
1185
+ /**
1186
+ * Log Safety: UNSAFE
1187
+ */
1188
+ export interface DeleteInterfaceLinkLogicRule {
1189
+ interfaceTypeApiName: InterfaceTypeApiName;
1190
+ interfaceLinkTypeApiName: InterfaceLinkTypeApiName;
1191
+ sourceObject: ParameterId;
1192
+ targetObject: ParameterId;
1193
+ }
1015
1194
  /**
1016
1195
  * Log Safety: UNSAFE
1017
1196
  */
@@ -1036,6 +1215,14 @@ export interface DeleteLinkEdit {
1036
1215
  linkType: LinkTypeApiName;
1037
1216
  linkedObjectPrimaryKey: PrimaryKeyValue;
1038
1217
  }
1218
+ /**
1219
+ * Log Safety: UNSAFE
1220
+ */
1221
+ export interface DeleteLinkLogicRule {
1222
+ linkTypeApiName: LinkTypeApiName;
1223
+ sourceObject: ParameterId;
1224
+ targetObject: ParameterId;
1225
+ }
1039
1226
  /**
1040
1227
  * Log Safety: UNSAFE
1041
1228
  */
@@ -1059,6 +1246,12 @@ export interface DeleteObjectEdit {
1059
1246
  objectType: ObjectTypeApiName;
1060
1247
  primaryKey: PropertyValue;
1061
1248
  }
1249
+ /**
1250
+ * Log Safety: UNSAFE
1251
+ */
1252
+ export interface DeleteObjectLogicRule {
1253
+ objectToDelete: ParameterId;
1254
+ }
1062
1255
  /**
1063
1256
  * Log Safety: UNSAFE
1064
1257
  */
@@ -1167,6 +1360,26 @@ export interface DoubleVector {
1167
1360
  * Log Safety: UNSAFE
1168
1361
  */
1169
1362
  export type Duration = LooselyBrandedString<"Duration">;
1363
+ /**
1364
+ * Specifies the unit of the input duration value.
1365
+ *
1366
+ * Log Safety: SAFE
1367
+ */
1368
+ export type DurationBaseValue = "SECONDS" | "MILLISECONDS";
1369
+ /**
1370
+ * Log Safety: UNSAFE
1371
+ */
1372
+ export type DurationFormatStyle = ({
1373
+ type: "humanReadable";
1374
+ } & HumanReadableFormat) | ({
1375
+ type: "timecode";
1376
+ } & TimeCodeFormat);
1377
+ /**
1378
+ * Specifies the maximum precision to apply when formatting a duration.
1379
+ *
1380
+ * Log Safety: SAFE
1381
+ */
1382
+ export type DurationPrecision = "DAYS" | "HOURS" | "MINUTES" | "SECONDS" | "AUTO";
1170
1383
  /**
1171
1384
  * Log Safety: UNSAFE
1172
1385
  */
@@ -1274,6 +1487,26 @@ properties.{propertyApiName}.isNull=false.
1274
1487
  * Log Safety: UNSAFE
1275
1488
  */
1276
1489
  export type FilterValue = LooselyBrandedString<"FilterValue">;
1490
+ /**
1491
+ * Integer key for fixed value mapping.
1492
+ *
1493
+ * Log Safety: SAFE
1494
+ */
1495
+ export type FixedValuesMapKey = number;
1496
+ /**
1497
+ * Log Safety: UNSAFE
1498
+ */
1499
+ export interface FunctionLogicRule {
1500
+ functionRid: FunctionRid;
1501
+ functionVersion: FunctionVersion;
1502
+ functionInputValues: Record<FunctionParameterName, LogicRuleArgument>;
1503
+ }
1504
+ /**
1505
+ * The name of an input to a function.
1506
+ *
1507
+ * Log Safety: UNSAFE
1508
+ */
1509
+ export type FunctionParameterName = LooselyBrandedString<"FunctionParameterName">;
1277
1510
  /**
1278
1511
  * The unique resource identifier of a Function, useful for interacting with other Foundry APIs.
1279
1512
  *
@@ -1394,6 +1627,14 @@ export interface GtQueryV2 {
1394
1627
  propertyIdentifier?: PropertyIdentifier;
1395
1628
  value: PropertyValue;
1396
1629
  }
1630
+ /**
1631
+ * Formats the duration as a human-readable written string.
1632
+ *
1633
+ * Log Safety: SAFE
1634
+ */
1635
+ export interface HumanReadableFormat {
1636
+ showFullUnits?: boolean;
1637
+ }
1397
1638
  /**
1398
1639
  * A union currently only consisting of the BlueprintIcon (more icon types may be added in the future).
1399
1640
  *
@@ -1459,6 +1700,15 @@ export type InterfaceLinkTypeLinkedEntityApiName = ({
1459
1700
  * Log Safety: SAFE
1460
1701
  */
1461
1702
  export type InterfaceLinkTypeRid = LooselyBrandedString<"InterfaceLinkTypeRid">;
1703
+ /**
1704
+ * Represents an interface parameter property argument in a logic rule.
1705
+ *
1706
+ * Log Safety: UNSAFE
1707
+ */
1708
+ export interface InterfaceParameterPropertyArgument {
1709
+ parameterId: ParameterId;
1710
+ sharedPropertyTypeRid: string;
1711
+ }
1462
1712
  /**
1463
1713
  * A shared property type with an additional field to indicate whether the property must be included on every
1464
1714
  object type that implements the interface, or whether it is optional.
@@ -1559,6 +1809,16 @@ export interface IsNullQueryV2 {
1559
1809
  propertyIdentifier?: PropertyIdentifier;
1560
1810
  value: boolean;
1561
1811
  }
1812
+ /**
1813
+ * Known Foundry types for specialized formatting:
1814
+
1815
+ userOrGroupRid: Format as user or group RID (both are structurally RIDs)
1816
+ resourceRid: Format as resource RID
1817
+ artifactGid: Format as artifact GID
1818
+ *
1819
+ * Log Safety: SAFE
1820
+ */
1821
+ export type KnownType = "userOrGroupRid" | "resourceRid" | "artifactGid";
1562
1822
  /**
1563
1823
  * Finds least of two or more numeric, date or timestamp values.
1564
1824
  *
@@ -1918,6 +2178,28 @@ export type LogicRule = ({
1918
2178
  } & CreateObjectRule) | ({
1919
2179
  type: "createLink";
1920
2180
  } & CreateLinkRule);
2181
+ /**
2182
+ * Represents an argument for a logic rule operation. An argument can be passed in via the action parameters, as a static value, or as some other value.
2183
+ *
2184
+ * Log Safety: UNSAFE
2185
+ */
2186
+ export type LogicRuleArgument = ({
2187
+ type: "currentTime";
2188
+ } & CurrentTimeArgument) | ({
2189
+ type: "staticValue";
2190
+ } & StaticArgument) | ({
2191
+ type: "currentUser";
2192
+ } & CurrentUserArgument) | ({
2193
+ type: "parameterId";
2194
+ } & ParameterIdArgument) | ({
2195
+ type: "interfaceParameterPropertyValue";
2196
+ } & InterfaceParameterPropertyArgument) | ({
2197
+ type: "synchronousWebhookOutput";
2198
+ } & SynchronousWebhookOutputArgument) | ({
2199
+ type: "objectParameterPropertyValue";
2200
+ } & ObjectParameterPropertyArgument) | ({
2201
+ type: "uniqueIdentifier";
2202
+ } & UniqueIdentifierArgument);
1921
2203
  /**
1922
2204
  * Returns objects where the specified field is less than or equal to a value.
1923
2205
  *
@@ -2012,6 +2294,14 @@ export interface MinAggregationV2 {
2012
2294
  name?: AggregationMetricName;
2013
2295
  direction?: OrderByDirection;
2014
2296
  }
2297
+ /**
2298
+ * Log Safety: UNSAFE
2299
+ */
2300
+ export interface ModifyInterfaceLogicRule {
2301
+ interfaceObjectToModify: ParameterId;
2302
+ sharedPropertyArguments: Record<SharedPropertyTypeApiName, LogicRuleArgument>;
2303
+ structPropertyArguments: Record<SharedPropertyTypeApiName, Record<StructFieldApiName, StructFieldArgument>>;
2304
+ }
2015
2305
  /**
2016
2306
  * Log Safety: UNSAFE
2017
2307
  */
@@ -2033,6 +2323,14 @@ export interface ModifyObjectEdit {
2033
2323
  primaryKey: PropertyValue;
2034
2324
  properties: Record<PropertyApiName, DataValue>;
2035
2325
  }
2326
+ /**
2327
+ * Log Safety: UNSAFE
2328
+ */
2329
+ export interface ModifyObjectLogicRule {
2330
+ objectToModify: ParameterId;
2331
+ propertyArguments: Record<PropertyApiName, LogicRuleArgument>;
2332
+ structPropertyArguments: Record<PropertyApiName, Record<StructFieldApiName, StructFieldArgument>>;
2333
+ }
2036
2334
  /**
2037
2335
  * Log Safety: UNSAFE
2038
2336
  */
@@ -2097,6 +2395,188 @@ export interface NotQuery {
2097
2395
  export interface NotQueryV2 {
2098
2396
  value: SearchJsonQueryV2;
2099
2397
  }
2398
+ /**
2399
+ * Attach arbitrary text before and/or after the formatted number.
2400
+ Example: prefix "USD " and postfix " total" displays as "USD 1,234.56 total"
2401
+ *
2402
+ * Log Safety: UNSAFE
2403
+ */
2404
+ export interface NumberFormatAffix {
2405
+ baseFormatOptions: NumberFormatOptions;
2406
+ affix: Affix;
2407
+ }
2408
+ /**
2409
+ * Display the value as basis points. Multiplies by 10,000 and appends "bps" suffix.
2410
+ Used in finance where 1 basis point = 0.01%.
2411
+ Example: 0.0025 displays as "25 bps", 0.01 displays as "100 bps"
2412
+ *
2413
+ * Log Safety: SAFE
2414
+ */
2415
+ export interface NumberFormatBasisPoints {
2416
+ baseFormatOptions: NumberFormatOptions;
2417
+ }
2418
+ /**
2419
+ * Format numbers as currency values with proper symbols and styling.
2420
+ Example: 1234.56 with currency "USD" displays as "USD 1,234.56" (standard) or "USD 1.2K" (compact)
2421
+ *
2422
+ * Log Safety: UNSAFE
2423
+ */
2424
+ export interface NumberFormatCurrency {
2425
+ baseFormatOptions: NumberFormatOptions;
2426
+ style: NumberFormatCurrencyStyle;
2427
+ currencyCode: PropertyTypeReferenceOrStringConstant;
2428
+ }
2429
+ /**
2430
+ * Currency rendering style options:
2431
+
2432
+ STANDARD: Full currency formatting (e.g., "USD 1,234.56")
2433
+ COMPACT: Abbreviated currency formatting (e.g., "USD 1.2K")
2434
+ *
2435
+ * Log Safety: SAFE
2436
+ */
2437
+ export type NumberFormatCurrencyStyle = "STANDARD" | "COMPACT";
2438
+ /**
2439
+ * Format numbers with custom units not supported by standard formatting.
2440
+ Use this for domain-specific units like "requests/sec", "widgets", etc.
2441
+ Example: 1500 with unit "widgets" displays as "1,500 widgets"
2442
+ *
2443
+ * Log Safety: UNSAFE
2444
+ */
2445
+ export interface NumberFormatCustomUnit {
2446
+ baseFormatOptions: NumberFormatOptions;
2447
+ unit: PropertyTypeReferenceOrStringConstant;
2448
+ }
2449
+ /**
2450
+ * Format numeric values representing time durations.
2451
+
2452
+ Human readable: 3661 seconds displays as "1h 1m 1s"
2453
+ Timecode: 3661 seconds displays as "01:01:01"
2454
+ *
2455
+ * Log Safety: UNSAFE
2456
+ */
2457
+ export interface NumberFormatDuration {
2458
+ formatStyle: DurationFormatStyle;
2459
+ precision?: DurationPrecision;
2460
+ baseValue: DurationBaseValue;
2461
+ }
2462
+ /**
2463
+ * Map integer values to custom human-readable strings.
2464
+ Example: {1: "First", 2: "Second", 3: "Third"} would display 2 as "Second".
2465
+ *
2466
+ * Log Safety: UNSAFE
2467
+ */
2468
+ export interface NumberFormatFixedValues {
2469
+ values: Record<FixedValuesMapKey, string>;
2470
+ }
2471
+ /**
2472
+ * Number notation style options:
2473
+
2474
+ STANDARD: Regular number display ("1,234")
2475
+ SCIENTIFIC: Scientific notation ("1.234E3")
2476
+ ENGINEERING: Engineering notation ("1.234E3")
2477
+ COMPACT: Compact notation ("1.2K")
2478
+ *
2479
+ * Log Safety: SAFE
2480
+ */
2481
+ export type NumberFormatNotation = "STANDARD" | "SCIENTIFIC" | "ENGINEERING" | "COMPACT";
2482
+ /**
2483
+ * Base number formatting options that can be applied to all number formatters.
2484
+ Controls precision, grouping, rounding, and notation. Consistent with JavaScript's Intl.NumberFormat.
2485
+ Examples:
2486
+
2487
+ useGrouping: true makes 1234567 display as "1,234,567"
2488
+ maximumFractionDigits: 2 makes 3.14159 display as "3.14"
2489
+ notation: SCIENTIFIC makes 1234 display as "1.234E3"
2490
+ *
2491
+ * Log Safety: SAFE
2492
+ */
2493
+ export interface NumberFormatOptions {
2494
+ useGrouping?: boolean;
2495
+ convertNegativeToParenthesis?: boolean;
2496
+ minimumIntegerDigits?: number;
2497
+ minimumFractionDigits?: number;
2498
+ maximumFractionDigits?: number;
2499
+ minimumSignificantDigits?: number;
2500
+ maximumSignificantDigits?: number;
2501
+ notation?: NumberFormatNotation;
2502
+ roundingMode?: NumberRoundingMode;
2503
+ }
2504
+ /**
2505
+ * Display the value as a ratio with different scaling factors and suffixes:
2506
+
2507
+ PERCENTAGE: Multiply by 100 and add "%" suffix (0.15 → "15%")
2508
+ PER_MILLE: Multiply by 1000 and add "‰" suffix (0.015 → "15‰")
2509
+ BASIS_POINTS: Multiply by 10000 and add "bps" suffix (0.0015 → "15bps")
2510
+ *
2511
+ * Log Safety: SAFE
2512
+ */
2513
+ export interface NumberFormatRatio {
2514
+ ratioType: NumberRatioType;
2515
+ baseFormatOptions: NumberFormatOptions;
2516
+ }
2517
+ /**
2518
+ * Scale the numeric value by dividing by the specified factor and append an appropriate suffix.
2519
+
2520
+ THOUSANDS: 1500 displays as "1.5K"
2521
+ MILLIONS: 2500000 displays as "2.5M"
2522
+ BILLIONS: 3200000000 displays as "3.2B"
2523
+ *
2524
+ * Log Safety: SAFE
2525
+ */
2526
+ export interface NumberFormatScale {
2527
+ scaleType: NumberScaleType;
2528
+ baseFormatOptions: NumberFormatOptions;
2529
+ }
2530
+ /**
2531
+ * Standard number formatting with configurable options.
2532
+ This provides basic number formatting without any special units, scaling, or transformations.
2533
+ *
2534
+ * Log Safety: SAFE
2535
+ */
2536
+ export interface NumberFormatStandard {
2537
+ baseFormatOptions: NumberFormatOptions;
2538
+ }
2539
+ /**
2540
+ * Format numbers with standard units supported by Intl.NumberFormat.
2541
+ Examples: "meter", "kilogram", "celsius", "percent"
2542
+ Input: 25 with unit "celsius" displays as "25 degrees C"
2543
+ *
2544
+ * Log Safety: UNSAFE
2545
+ */
2546
+ export interface NumberFormatStandardUnit {
2547
+ baseFormatOptions: NumberFormatOptions;
2548
+ unit: PropertyTypeReferenceOrStringConstant;
2549
+ }
2550
+ /**
2551
+ * Ratio format options for displaying proportional values:
2552
+
2553
+ PERCENTAGE: Multiply by 100 and add "%" suffix
2554
+ PER_MILLE: Multiply by 1000 and add "‰" suffix
2555
+ BASIS_POINTS: Multiply by 10000 and add "bps" suffix
2556
+ *
2557
+ * Log Safety: SAFE
2558
+ */
2559
+ export type NumberRatioType = "PERCENTAGE" | "PER_MILLE" | "BASIS_POINTS";
2560
+ /**
2561
+ * Number rounding behavior:
2562
+
2563
+ CEIL: Always round up (3.1 becomes 4)
2564
+ FLOOR: Always round down (3.9 becomes 3)
2565
+ ROUND_CLOSEST: Round to nearest (3.4 becomes 3, 3.6 becomes 4)
2566
+ *
2567
+ * Log Safety: SAFE
2568
+ */
2569
+ export type NumberRoundingMode = "CEIL" | "FLOOR" | "ROUND_CLOSEST";
2570
+ /**
2571
+ * Scale factor options for large numbers:
2572
+
2573
+ THOUSANDS: Divide by 1,000 and add "K" suffix
2574
+ MILLIONS: Divide by 1,000,000 and add "M" suffix
2575
+ BILLIONS: Divide by 1,000,000,000 and add "B" suffix
2576
+ *
2577
+ * Log Safety: SAFE
2578
+ */
2579
+ export type NumberScaleType = "THOUSANDS" | "MILLIONS" | "BILLIONS";
2100
2580
  /**
2101
2581
  * Log Safety: UNSAFE
2102
2582
  */
@@ -2131,6 +2611,15 @@ export interface ObjectLocator {
2131
2611
  objectTypeApiName: ObjectTypeApiName;
2132
2612
  primaryKeyValue: PrimaryKeyValue;
2133
2613
  }
2614
+ /**
2615
+ * Represents an object parameter property argument in a logic rule.
2616
+ *
2617
+ * Log Safety: UNSAFE
2618
+ */
2619
+ export interface ObjectParameterPropertyArgument {
2620
+ parameterId: ParameterId;
2621
+ propertyTypeApiName: PropertyTypeApiName;
2622
+ }
2134
2623
  /**
2135
2624
  * Log Safety: UNSAFE
2136
2625
  */
@@ -2319,6 +2808,7 @@ export interface ObjectSetNearestNeighborsType {
2319
2808
  objectSet: ObjectSet;
2320
2809
  propertyIdentifier: PropertyIdentifier;
2321
2810
  numNeighbors: number;
2811
+ similarityThreshold?: number;
2322
2812
  query: NearestNeighborsQuery;
2323
2813
  }
2324
2814
  /**
@@ -2842,6 +3332,14 @@ Parameters can be viewed and managed in the Ontology Manager.
2842
3332
  * Log Safety: UNSAFE
2843
3333
  */
2844
3334
  export type ParameterId = LooselyBrandedString<"ParameterId">;
3335
+ /**
3336
+ * Represents a parameter ID argument in a logic rule.
3337
+ *
3338
+ * Log Safety: UNSAFE
3339
+ */
3340
+ export interface ParameterIdArgument {
3341
+ parameterId: ParameterId;
3342
+ }
2845
3343
  /**
2846
3344
  * A possible value for the parameter. This is defined in the Ontology Manager by Actions admins.
2847
3345
  *
@@ -2939,6 +3437,23 @@ export type PropertyApiName = LooselyBrandedString<"PropertyApiName">;
2939
3437
  export interface PropertyApiNameSelector {
2940
3438
  apiName: PropertyApiName;
2941
3439
  }
3440
+ /**
3441
+ * Formatting configuration for boolean property values.
3442
+ *
3443
+ * Log Safety: UNSAFE
3444
+ */
3445
+ export interface PropertyBooleanFormattingRule {
3446
+ valueIfTrue: string;
3447
+ valueIfFalse: string;
3448
+ }
3449
+ /**
3450
+ * Formatting configuration for date property values.
3451
+ *
3452
+ * Log Safety: UNSAFE
3453
+ */
3454
+ export interface PropertyDateFormattingRule {
3455
+ format: DatetimeFormat;
3456
+ }
2942
3457
  /**
2943
3458
  * Represents a filter used on properties.
2944
3459
  Endpoints that accept this supports optional parameters that have the form:
@@ -2984,10 +3499,71 @@ export type PropertyIdentifier = ({
2984
3499
  } & PropertyApiNameSelector) | ({
2985
3500
  type: "structField";
2986
3501
  } & StructFieldSelector);
3502
+ /**
3503
+ * Formatting configuration for known Foundry types.
3504
+ *
3505
+ * Log Safety: SAFE
3506
+ */
3507
+ export interface PropertyKnownTypeFormattingRule {
3508
+ knownType: KnownType;
3509
+ }
3510
+ /**
3511
+ * Wrapper for numeric formatting options.
3512
+ *
3513
+ * Log Safety: UNSAFE
3514
+ */
3515
+ export interface PropertyNumberFormattingRule {
3516
+ numberType: PropertyNumberFormattingRuleType;
3517
+ }
3518
+ /**
3519
+ * Log Safety: UNSAFE
3520
+ */
3521
+ export type PropertyNumberFormattingRuleType = ({
3522
+ type: "standard";
3523
+ } & NumberFormatStandard) | ({
3524
+ type: "duration";
3525
+ } & NumberFormatDuration) | ({
3526
+ type: "fixedValues";
3527
+ } & NumberFormatFixedValues) | ({
3528
+ type: "affix";
3529
+ } & NumberFormatAffix) | ({
3530
+ type: "scale";
3531
+ } & NumberFormatScale) | ({
3532
+ type: "currency";
3533
+ } & NumberFormatCurrency) | ({
3534
+ type: "standardUnit";
3535
+ } & NumberFormatStandardUnit) | ({
3536
+ type: "customUnit";
3537
+ } & NumberFormatCustomUnit) | ({
3538
+ type: "ratio";
3539
+ } & NumberFormatRatio);
3540
+ /**
3541
+ * Formatting configuration for timestamp property values.
3542
+ *
3543
+ * Log Safety: UNSAFE
3544
+ */
3545
+ export interface PropertyTimestampFormattingRule {
3546
+ format: DatetimeFormat;
3547
+ displayTimezone: DatetimeTimezone;
3548
+ }
2987
3549
  /**
2988
3550
  * Log Safety: UNSAFE
2989
3551
  */
2990
3552
  export type PropertyTypeApiName = LooselyBrandedString<"PropertyTypeApiName">;
3553
+ /**
3554
+ * Log Safety: UNSAFE
3555
+ */
3556
+ export interface PropertyTypeReference {
3557
+ propertyApiName: string;
3558
+ }
3559
+ /**
3560
+ * Log Safety: UNSAFE
3561
+ */
3562
+ export type PropertyTypeReferenceOrStringConstant = ({
3563
+ type: "constant";
3564
+ } & StringConstant) | ({
3565
+ type: "propertyType";
3566
+ } & PropertyTypeReference);
2991
3567
  /**
2992
3568
  * Log Safety: SAFE
2993
3569
  */
@@ -3023,6 +3599,7 @@ export interface PropertyV2 {
3023
3599
  status?: PropertyTypeStatus;
3024
3600
  visibility?: PropertyTypeVisibility;
3025
3601
  valueTypeApiName?: ValueTypeApiName;
3602
+ valueFormatting?: PropertyValueFormattingRule;
3026
3603
  }
3027
3604
  /**
3028
3605
  * Represents the value of a property in the following format.
@@ -3060,6 +3637,30 @@ export type PropertyValue = any;
3060
3637
  * Log Safety: UNSAFE
3061
3638
  */
3062
3639
  export type PropertyValueEscapedString = LooselyBrandedString<"PropertyValueEscapedString">;
3640
+ /**
3641
+ * This feature is experimental and may change in a future release.
3642
+ Comprehensive formatting configuration for displaying property values in user interfaces.
3643
+ Supports different value types including numbers, dates, timestamps, booleans, and known Foundry types.
3644
+ Each formatter type provides specific options tailored to that data type:
3645
+
3646
+ Numbers: Support for percentages, currencies, units, scaling, and custom formatting
3647
+ Dates/Timestamps: Localized and custom formatting patterns
3648
+ Booleans: Custom true/false display text
3649
+ Known types: Special formatting for Foundry-specific identifiers
3650
+ *
3651
+ * Log Safety: UNSAFE
3652
+ */
3653
+ export type PropertyValueFormattingRule = ({
3654
+ type: "date";
3655
+ } & PropertyDateFormattingRule) | ({
3656
+ type: "number";
3657
+ } & PropertyNumberFormattingRule) | ({
3658
+ type: "boolean";
3659
+ } & PropertyBooleanFormattingRule) | ({
3660
+ type: "knownType";
3661
+ } & PropertyKnownTypeFormattingRule) | ({
3662
+ type: "timestamp";
3663
+ } & PropertyTimestampFormattingRule);
3063
3664
  /**
3064
3665
  * An error indicating that the subscribe request should be attempted on a different node.
3065
3666
  *
@@ -3364,6 +3965,18 @@ export interface RegexConstraint {
3364
3965
  pattern: string;
3365
3966
  partialMatch: boolean;
3366
3967
  }
3968
+ /**
3969
+ * Returns objects where the specified field matches the regex pattern provided. This applies to the non-analyzed
3970
+ form of text fields and supports standard regex syntax of dot (.), star(*) and question mark(?).
3971
+ Either field or propertyIdentifier can be supplied, but not both.
3972
+ *
3973
+ * Log Safety: UNSAFE
3974
+ */
3975
+ export interface RegexQuery {
3976
+ field?: PropertyApiName;
3977
+ propertyIdentifier?: PropertyIdentifier;
3978
+ value: string;
3979
+ }
3367
3980
  /**
3368
3981
  * A relative time, such as "3 days before" or "2 hours after" the current moment.
3369
3982
  *
@@ -3464,42 +4077,24 @@ export type SearchJsonQuery = ({
3464
4077
  * Log Safety: UNSAFE
3465
4078
  */
3466
4079
  export type SearchJsonQueryV2 = ({
3467
- type: "or";
3468
- } & OrQueryV2) | ({
3469
- type: "in";
3470
- } & InQuery) | ({
3471
- type: "doesNotIntersectPolygon";
3472
- } & DoesNotIntersectPolygonQuery) | ({
3473
4080
  type: "lt";
3474
4081
  } & LtQueryV2) | ({
3475
4082
  type: "doesNotIntersectBoundingBox";
3476
4083
  } & DoesNotIntersectBoundingBoxQuery) | ({
3477
- type: "eq";
3478
- } & EqualsQueryV2) | ({
3479
- type: "containsAllTerms";
3480
- } & ContainsAllTermsQuery) | ({
3481
- type: "gt";
3482
- } & GtQueryV2) | ({
3483
4084
  type: "wildcard";
3484
4085
  } & WildcardQuery) | ({
3485
4086
  type: "withinDistanceOf";
3486
4087
  } & WithinDistanceOfQuery) | ({
3487
4088
  type: "withinBoundingBox";
3488
4089
  } & WithinBoundingBoxQuery) | ({
3489
- type: "contains";
3490
- } & ContainsQueryV2) | ({
3491
4090
  type: "not";
3492
4091
  } & NotQueryV2) | ({
3493
4092
  type: "intersectsBoundingBox";
3494
4093
  } & IntersectsBoundingBoxQuery) | ({
3495
4094
  type: "and";
3496
4095
  } & AndQueryV2) | ({
3497
- type: "isNull";
3498
- } & IsNullQueryV2) | ({
3499
4096
  type: "containsAllTermsInOrderPrefixLastTerm";
3500
4097
  } & ContainsAllTermsInOrderPrefixLastTerm) | ({
3501
- type: "containsAnyTerm";
3502
- } & ContainsAnyTermQuery) | ({
3503
4098
  type: "gte";
3504
4099
  } & GteQueryV2) | ({
3505
4100
  type: "containsAllTermsInOrder";
@@ -3510,6 +4105,26 @@ export type SearchJsonQueryV2 = ({
3510
4105
  } & IntersectsPolygonQuery) | ({
3511
4106
  type: "lte";
3512
4107
  } & LteQueryV2) | ({
4108
+ type: "or";
4109
+ } & OrQueryV2) | ({
4110
+ type: "in";
4111
+ } & InQuery) | ({
4112
+ type: "doesNotIntersectPolygon";
4113
+ } & DoesNotIntersectPolygonQuery) | ({
4114
+ type: "eq";
4115
+ } & EqualsQueryV2) | ({
4116
+ type: "containsAllTerms";
4117
+ } & ContainsAllTermsQuery) | ({
4118
+ type: "gt";
4119
+ } & GtQueryV2) | ({
4120
+ type: "contains";
4121
+ } & ContainsQueryV2) | ({
4122
+ type: "regex";
4123
+ } & RegexQuery) | ({
4124
+ type: "isNull";
4125
+ } & IsNullQueryV2) | ({
4126
+ type: "containsAnyTerm";
4127
+ } & ContainsAnyTermQuery) | ({
3513
4128
  type: "startsWith";
3514
4129
  } & StartsWithQuery);
3515
4130
  /**
@@ -3766,6 +4381,7 @@ export interface SharedPropertyType {
3766
4381
  description?: string;
3767
4382
  dataType: ObjectPropertyType;
3768
4383
  valueTypeApiName?: ValueTypeApiName;
4384
+ valueFormatting?: PropertyValueFormattingRule;
3769
4385
  }
3770
4386
  /**
3771
4387
  * The name of the shared property type in the API in lowerCamelCase format. To find the API name for your
@@ -3792,6 +4408,14 @@ export interface StartsWithQuery {
3792
4408
  propertyIdentifier?: PropertyIdentifier;
3793
4409
  value: string;
3794
4410
  }
4411
+ /**
4412
+ * Represents a static argument in a logic rule.
4413
+ *
4414
+ * Log Safety: UNSAFE
4415
+ */
4416
+ export interface StaticArgument {
4417
+ value: DataValue;
4418
+ }
3795
4419
  /**
3796
4420
  * Which format to serialize the binary stream in.
3797
4421
  ARROW is more efficient for streaming a large sized response.
@@ -3836,6 +4460,12 @@ export interface StreamTimeSeriesValuesRequest {
3836
4460
  export interface StreamTimeSeriesValuesResponse {
3837
4461
  data: Array<TimeseriesEntry>;
3838
4462
  }
4463
+ /**
4464
+ * Log Safety: UNSAFE
4465
+ */
4466
+ export interface StringConstant {
4467
+ value: string;
4468
+ }
3839
4469
  /**
3840
4470
  * The parameter value must have a length within the defined range.
3841
4471
  This range is always inclusive.
@@ -3877,6 +4507,16 @@ export interface StructEvaluatedConstraint {
3877
4507
  * Log Safety: UNSAFE
3878
4508
  */
3879
4509
  export type StructFieldApiName = LooselyBrandedString<"StructFieldApiName">;
4510
+ /**
4511
+ * Represents an argument used for an individual struct field.
4512
+ *
4513
+ * Log Safety: UNSAFE
4514
+ */
4515
+ export type StructFieldArgument = ({
4516
+ type: "structListParameterFieldValue";
4517
+ } & StructListParameterFieldArgument) | ({
4518
+ type: "structParameterFieldValue";
4519
+ } & StructParameterFieldArgument);
3880
4520
  /**
3881
4521
  * A constraint that an action struct parameter field value must satisfy in order to be considered valid.
3882
4522
  Constraints can be configured on fields of struct parameters in the Ontology Manager.
@@ -3937,12 +4577,30 @@ export interface StructFieldType {
3937
4577
  * Log Safety: SAFE
3938
4578
  */
3939
4579
  export type StructFieldTypeRid = LooselyBrandedString<"StructFieldTypeRid">;
4580
+ /**
4581
+ * Represents a struct list parameter field argument in a logic rule.
4582
+ *
4583
+ * Log Safety: UNSAFE
4584
+ */
4585
+ export interface StructListParameterFieldArgument {
4586
+ parameterId: ParameterId;
4587
+ structParameterFieldApiName: StructParameterFieldApiName;
4588
+ }
3940
4589
  /**
3941
4590
  * The unique identifier of the struct parameter field.
3942
4591
  *
3943
4592
  * Log Safety: UNSAFE
3944
4593
  */
3945
4594
  export type StructParameterFieldApiName = LooselyBrandedString<"StructParameterFieldApiName">;
4595
+ /**
4596
+ * Represents a struct parameter field argument in a logic rule.
4597
+ *
4598
+ * Log Safety: UNSAFE
4599
+ */
4600
+ export interface StructParameterFieldArgument {
4601
+ parameterId: ParameterId;
4602
+ structParameterFieldApiName: StructParameterFieldApiName;
4603
+ }
3946
4604
  /**
3947
4605
  * Log Safety: UNSAFE
3948
4606
  */
@@ -4030,6 +4688,14 @@ export interface SyncApplyActionResponseV2 {
4030
4688
  validation?: ValidateActionResponseV2;
4031
4689
  edits?: ActionResults;
4032
4690
  }
4691
+ /**
4692
+ * Represents a synchronous webhook output argument in a logic rule.
4693
+ *
4694
+ * Log Safety: UNSAFE
4695
+ */
4696
+ export interface SynchronousWebhookOutputArgument {
4697
+ webhookOutputParamName: string;
4698
+ }
4033
4699
  /**
4034
4700
  * Log Safety: UNSAFE
4035
4701
  */
@@ -4037,6 +4703,13 @@ export interface ThreeDimensionalAggregation {
4037
4703
  keyType: QueryAggregationKeyType;
4038
4704
  valueType: TwoDimensionalAggregation;
4039
4705
  }
4706
+ /**
4707
+ * Formats the duration in a timecode format.
4708
+ *
4709
+ * Log Safety: SAFE
4710
+ */
4711
+ export interface TimeCodeFormat {
4712
+ }
4040
4713
  /**
4041
4714
  * An absolute or relative range for a time series query.
4042
4715
  *
@@ -4193,6 +4866,14 @@ This can happen when a parameter's allowed values are defined by another paramet
4193
4866
  */
4194
4867
  export interface UnevaluableConstraint {
4195
4868
  }
4869
+ /**
4870
+ * Represents a unique identifier argument in a logic rule.
4871
+ *
4872
+ * Log Safety: SAFE
4873
+ */
4874
+ export interface UniqueIdentifierArgument {
4875
+ linkId?: string;
4876
+ }
4196
4877
  /**
4197
4878
  * The string must be a valid UUID (Universally Unique Identifier).
4198
4879
  *