@confighub/api 0.10.9 → 0.10.10

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.
package/dist/index.d.cts CHANGED
@@ -2688,7 +2688,7 @@ interface paths {
2688
2688
  put?: never;
2689
2689
  /**
2690
2690
  * Set path guards on a unit
2691
- * @description Set or remove guards on the unit's PathAnnotations. A guard names a reason a path's value is what it is, so a later operation can be required to know about that reason before overwriting it. Nothing enforces guards yet: setting one records the reason and changes no behavior. A guard may name a path or resource the unit does not have, since it is policy about the configuration rather than a statement about its current contents. Creates a new revision only if the guards actually change. Requires Edit permission.
2691
+ * @description Set or remove guards on the unit's PathAnnotations. A guard names a reason a path's value is what it is, so a later operation can be required to know about that reason before overwriting it. An operation that is not cleared for the guards at a path does not write it, and reports what it withheld as a conflict; editing the guards at a path that already has some needs a clearance for them, and so does changing whether one is inherited. A guard set through Set stays with this unit; one set through SetInherited is copied to its clones and carried by merges to the units downstream. A guard may name a path or resource the unit does not have, since it is policy about the configuration rather than a statement about its current contents. Creates a new revision only if the guards actually change. Requires Edit permission.
2692
2692
  */
2693
2693
  post: operations["SetUnitGuard"];
2694
2694
  delete?: never;
@@ -4094,6 +4094,8 @@ interface components {
4094
4094
  Guards?: {
4095
4095
  [key: string]: string;
4096
4096
  };
4097
+ /** @description The keys of Guards that are inherited: copied to the unit's clones and carried by merges to the units downstream of it. The others stay with this unit. */
4098
+ InheritedGuards?: string[];
4097
4099
  /** @description The unit's needed paths that are the field: a value it is to take from an upstream unit through a NeedsProvides Link. */
4098
4100
  Needed?: components["schemas"]["BlameNeededPath"][];
4099
4101
  /** @description The field's path, in the syntax functions and Links take. Empty on the row about the resource as a whole, which comes first among the resource's fields and carries what is recorded about the resource rather than one of its fields: the change that added or deleted it, whether it is protected as a whole, its guards, and its conflicts, findings and failed checks that name no path. */
@@ -6067,12 +6069,8 @@ interface components {
6067
6069
  FunctionInvocation: {
6068
6070
  /** @description Function arguments */
6069
6071
  Arguments?: components["schemas"]["FunctionArgument"][] | null;
6070
- /** @description Classes of guarded reason this invocation is cleared for; combined by union with the clearance of whatever drove the execution */
6071
- Clearance?: components["schemas"]["Clearance"];
6072
6072
  /** @description Function name */
6073
6073
  FunctionName?: string;
6074
- /** @description Guards to record on the paths this invocation writes, so a later operation must be cleared for them; combined with the guards of whatever drove the execution, later winning per key */
6075
- Guards?: components["schemas"]["GuardStamp"];
6076
6074
  /** @description Caller-supplied parameter values for expanding templated argument Values; transient, not persisted */
6077
6075
  Params?: {
6078
6076
  [key: string]: unknown;
@@ -6277,11 +6275,11 @@ interface components {
6277
6275
  Version?: number;
6278
6276
  };
6279
6277
  GuardDelta: {
6280
- /** @description The path whose guards changed; empty for the resource as a whole */
6278
+ /** @description The path whose inherited guards changed; empty for the resource as a whole */
6281
6279
  Path?: string;
6282
- /** @description Guard keys removed */
6280
+ /** @description Inherited guard keys removed */
6283
6281
  Remove?: string[];
6284
- /** @description Guard keys added or changed, with their new values */
6282
+ /** @description Inherited guard keys added or changed, with their new values */
6285
6283
  Set?: {
6286
6284
  [key: string]: string;
6287
6285
  };
@@ -6306,6 +6304,8 @@ interface components {
6306
6304
  * @example 248df4b7-aa70-47b8-a036-33ac447e668d
6307
6305
  */
6308
6306
  ChannelID?: string;
6307
+ /** @description Classes of guarded reason this Invocation's functions are cleared for; combined by union with the clearance of the Trigger or API call that runs it */
6308
+ Clearance?: components["schemas"]["Clearance"];
6309
6309
  /**
6310
6310
  * Format: date-time
6311
6311
  * @description The timestamp when the entity was created in "2023-01-01T12:00:00Z" format.
@@ -6321,6 +6321,8 @@ interface components {
6321
6321
  /** @description The type of entity. */
6322
6322
  readonly EntityType?: string;
6323
6323
  FunctionInvocations: components["schemas"]["FunctionInvocationList"];
6324
+ /** @description Guards to record on the paths this Invocation's functions write, so a later operation must be cleared for them; combined with the guards of a Trigger running it, the Trigger's winning per key. Add and overwrite only -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). Clearance must cover them. */
6325
+ Guards?: components["schemas"]["GuardStamp"];
6324
6326
  /** @description SHA256 hash of the functions and their arguments encoded as hexadecimal. */
6325
6327
  readonly Hash?: string;
6326
6328
  /** @description The reason the entity is hidden, if it is. A hidden entity is left out of List and Search results, and of what bulk operations act on, unless the include_hidden parameter names its reason or is *, or the where parameter names the entity by Slug or ID. ConfigHub/YAML Units are created hidden with the reason BackingUnit unless given another. */
@@ -6603,6 +6605,8 @@ interface components {
6603
6605
  * @example 248df4b7-aa70-47b8-a036-33ac447e668d
6604
6606
  */
6605
6607
  ChannelID?: string;
6608
+ /** @description The classes of guarded reason the change was filtered with. On a function invocation that is the request's clearance together with that of every Trigger and Invocation that wrote in the same execution; on a Link's change, the Link's */
6609
+ Clearance?: components["schemas"]["Clearance"];
6606
6610
  /**
6607
6611
  * Format: date-time
6608
6612
  * @description The timestamp when the entity was created in "2023-01-01T12:00:00Z" format.
@@ -6613,8 +6617,12 @@ interface components {
6613
6617
  readonly EntityType?: string;
6614
6618
  /** @description The function invoked if the change was made by a function. */
6615
6619
  FunctionInvocation?: components["schemas"]["FunctionInvocation"];
6620
+ /** @description The guards the change recorded on the paths it wrote: the operation's merged with those of the Trigger, Invocation, or Link that produced it */
6621
+ Guards?: components["schemas"]["GuardStamp"];
6616
6622
  /** @description The reason the entity is hidden, if it is. A hidden entity is left out of List and Search results, and of what bulk operations act on, unless the include_hidden parameter names its reason or is *, or the where parameter names the entity by Slug or ID. ConfigHub/YAML Units are created hidden with the reason BackingUnit unless given another. */
6617
6623
  HiddenReason?: string;
6624
+ /** @description The guards the change recorded as inherited on the paths it wrote, which clones receive and merges carry to the units downstream */
6625
+ InheritedGuards?: components["schemas"]["GuardStamp"];
6618
6626
  /**
6619
6627
  * Format: uuid
6620
6628
  * @description InvocationID is the identifier of the function invoked, if there is a corresponding Invocation.
@@ -7450,12 +7458,18 @@ interface components {
7450
7458
  };
7451
7459
  /** @description The resource whose guards are being edited: ResourceName, its whole name (namespace/name) or a name it had before a rename, or ResourceNameWithoutScope, a name without its namespace that has to match one resource; ResourceType, in any API version, is optional. A resource the unit does not have yet is named by ResourceType and ResourceName. */
7452
7460
  Resource?: components["schemas"]["ResourceInfo"];
7453
- /** @description Guard key/value pairs to add or overwrite, by path. The empty path addresses the resource as a whole. A list element is named by merge key or by position, and * stands for every element or key there is; a path that does not exist yet is kept as written */
7461
+ /** @description Guard key/value pairs to add or overwrite, by path, as guards of this unit alone: clones and downstream units do not receive them, and one that was inherited stops being. The empty path addresses the resource as a whole. A list element is named by merge key or by position, and * stands for every element or key there is; a path that does not exist yet is kept as written */
7454
7462
  Set?: {
7455
7463
  [key: string]: {
7456
7464
  [key: string]: string;
7457
7465
  };
7458
7466
  };
7467
+ /** @description Guard key/value pairs to add or overwrite, by path, as inherited guards: a clone of the unit receives them, and a merge carries them, and any later change to them, to the units downstream of it. Named as in Set; a key may not be in both at the same path */
7468
+ SetInherited?: {
7469
+ [key: string]: {
7470
+ [key: string]: string;
7471
+ };
7472
+ };
7459
7473
  };
7460
7474
  ResourceInfo: {
7461
7475
  /** @description Category of configuration element represented in the configuration data; Kubernetes resources are of category Resource, and application configuration files are of category AppConfig */
@@ -8967,7 +8981,7 @@ interface components {
8967
8981
  UnitID?: string;
8968
8982
  };
8969
8983
  UnitPathReport: {
8970
- /** @description The path's own annotations other than guards and conflict dismissals, by kind. The field's Guards are those that apply to it, its ancestors' and its resource's included. */
8984
+ /** @description The path's own annotations other than guards, their inheritance and conflict dismissals, by kind. The field's Guards are those that apply to it, its ancestors' and its resource's included. */
8971
8985
  Annotations?: {
8972
8986
  [key: string]: {
8973
8987
  [key: string]: string;
@@ -20177,6 +20191,8 @@ interface operations {
20177
20191
  clearance?: string;
20178
20192
  /** @description The guards this operation records on the paths it writes, as a JSON object of guard key to value -- the reasons those paths hold what they hold, so a later operation must be cleared for them before overwriting. The guard analogue of protect: protect claims the paths, this says why. It only ever adds and overwrites the keys it names -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). */
20179
20193
  guards?: string;
20194
+ /** @description The guards this operation records on the paths it writes as inherited guards, in the form guards takes: a clone of the Unit receives them, and a merge carries them, and any later change to them, to the Units downstream of it. Guards set through guards stay with the Unit they are on. A key may not be in both. The clearance has to cover these as it covers guards. */
20195
+ inherited_guards?: string;
20180
20196
  /** @description Must match ChangeSetID of affected Units unless in dry run mode; not valid when invoked on Revisions */
20181
20197
  change_set_id?: string;
20182
20198
  /** @description ChangeOrder to promote, which must have UpdateType Invoke. What runs then comes from the ChangeOrder rather than from the request body, which may not carry functions, triggers or invocations of its own; that is what holds every Space in scope to the same change. Only the Units the ChangeOrder covers are reached, a Unit that has already taken it is passed over, and every Unit reached is marked with the ChangeOrder's start and end Tags -- both on the head, with no Revision made, where the invocation changed nothing. Not valid when invoked on Revisions. */
@@ -20936,7 +20952,7 @@ interface operations {
20936
20952
  * An example conjunction is:
20937
20953
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
20938
20954
  *
20939
- * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
20955
+ * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, Clearance, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Guards, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
20940
20956
  *
20941
20957
  * The functions an Invocation calls are addressed with dot notation into `FunctionInvocations`: `FunctionInvocations.*.FunctionName = 'set-image'` matches an Invocation that calls set-image anywhere in its list, and `FunctionInvocations.0.FunctionName` addresses the first function it calls.
20942
20958
  *
@@ -21160,7 +21176,7 @@ interface operations {
21160
21176
  * An example conjunction is:
21161
21177
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
21162
21178
  *
21163
- * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
21179
+ * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, Clearance, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Guards, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
21164
21180
  *
21165
21181
  * The functions an Invocation calls are addressed with dot notation into `FunctionInvocations`: `FunctionInvocations.*.FunctionName = 'set-image'` matches an Invocation that calls set-image anywhere in its list, and `FunctionInvocations.0.FunctionName` addresses the first function it calls.
21166
21182
  *
@@ -21353,6 +21369,8 @@ interface operations {
21353
21369
  } | null;
21354
21370
  /** Format: uuid */
21355
21371
  ChannelID?: string | null;
21372
+ /** @description Classes of guarded reason this Invocation's functions are cleared for; combined by union with the clearance of the Trigger or API call that runs it */
21373
+ Clearance?: (Record<string, never> | null)[] | null;
21356
21374
  /** @description An optional set of gates that, if any is present, will block deletion */
21357
21375
  DeleteGates?: {
21358
21376
  [key: string]: boolean | null;
@@ -21360,6 +21378,10 @@ interface operations {
21360
21378
  /** @description Friendly name for the entity. */
21361
21379
  DisplayName?: string | null;
21362
21380
  FunctionInvocations?: (Record<string, never> | null)[] | null;
21381
+ /** @description Guards to record on the paths this Invocation's functions write, so a later operation must be cleared for them; combined with the guards of a Trigger running it, the Trigger's winning per key. Add and overwrite only -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). Clearance must cover them. */
21382
+ Guards?: {
21383
+ [key: string]: string | null;
21384
+ } | null;
21363
21385
  /** @description The reason the entity is hidden, if it is. A hidden entity is left out of List and Search results, and of what bulk operations act on, unless the include_hidden parameter names its reason or is *, or the where parameter names the entity by Slug or ID. ConfigHub/YAML Units are created hidden with the reason BackingUnit unless given another. */
21364
21386
  HiddenReason?: string | null;
21365
21387
  /** @description An optional map of Label key/value pairs to specify identifying attributes of entities for the purpose of grouping and filtering them. */
@@ -21511,7 +21533,7 @@ interface operations {
21511
21533
  * An example conjunction is:
21512
21534
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
21513
21535
  *
21514
- * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
21536
+ * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, Clearance, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Guards, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
21515
21537
  *
21516
21538
  * The functions an Invocation calls are addressed with dot notation into `FunctionInvocations`: `FunctionInvocations.*.FunctionName = 'set-image'` matches an Invocation that calls set-image anywhere in its list, and `FunctionInvocations.0.FunctionName` addresses the first function it calls.
21517
21539
  *
@@ -21715,7 +21737,7 @@ interface operations {
21715
21737
  * An example conjunction is:
21716
21738
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
21717
21739
  *
21718
- * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
21740
+ * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, Clearance, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Guards, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
21719
21741
  *
21720
21742
  * The functions an Invocation calls are addressed with dot notation into `FunctionInvocations`: `FunctionInvocations.*.FunctionName = 'set-image'` matches an Invocation that calls set-image anywhere in its list, and `FunctionInvocations.0.FunctionName` addresses the first function it calls.
21721
21743
  *
@@ -21798,6 +21820,8 @@ interface operations {
21798
21820
  } | null;
21799
21821
  /** Format: uuid */
21800
21822
  ChannelID?: string | null;
21823
+ /** @description Classes of guarded reason this Invocation's functions are cleared for; combined by union with the clearance of the Trigger or API call that runs it */
21824
+ Clearance?: (Record<string, never> | null)[] | null;
21801
21825
  /** @description An optional set of gates that, if any is present, will block deletion */
21802
21826
  DeleteGates?: {
21803
21827
  [key: string]: boolean | null;
@@ -21805,6 +21829,10 @@ interface operations {
21805
21829
  /** @description Friendly name for the entity. */
21806
21830
  DisplayName?: string | null;
21807
21831
  FunctionInvocations?: (Record<string, never> | null)[] | null;
21832
+ /** @description Guards to record on the paths this Invocation's functions write, so a later operation must be cleared for them; combined with the guards of a Trigger running it, the Trigger's winning per key. Add and overwrite only -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). Clearance must cover them. */
21833
+ Guards?: {
21834
+ [key: string]: string | null;
21835
+ } | null;
21808
21836
  /** @description The reason the entity is hidden, if it is. A hidden entity is left out of List and Search results, and of what bulk operations act on, unless the include_hidden parameter names its reason or is *, or the where parameter names the entity by Slug or ID. ConfigHub/YAML Units are created hidden with the reason BackingUnit unless given another. */
21809
21837
  HiddenReason?: string | null;
21810
21838
  /** @description An optional map of Label key/value pairs to specify identifying attributes of entities for the purpose of grouping and filtering them. */
@@ -21956,7 +21984,7 @@ interface operations {
21956
21984
  * An example conjunction is:
21957
21985
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
21958
21986
  *
21959
- * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
21987
+ * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, Clearance, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Guards, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
21960
21988
  *
21961
21989
  * The whole string must be query-encoded.
21962
21990
  */
@@ -36014,6 +36042,8 @@ interface operations {
36014
36042
  clearance?: string;
36015
36043
  /** @description The guards this operation records on the paths it writes, as a JSON object of guard key to value -- the reasons those paths hold what they hold, so a later operation must be cleared for them before overwriting. The guard analogue of protect: protect claims the paths, this says why. It only ever adds and overwrites the keys it names -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). */
36016
36044
  guards?: string;
36045
+ /** @description The guards this operation records on the paths it writes as inherited guards, in the form guards takes: a clone of the Unit receives them, and a merge carries them, and any later change to them, to the Units downstream of it. Guards set through guards stay with the Unit they are on. A key may not be in both. The clearance has to cover these as it covers guards. */
36046
+ inherited_guards?: string;
36017
36047
  /** @description Must match ChangeSetID of affected Units unless in dry run mode; not valid when invoked on Revisions */
36018
36048
  change_set_id?: string;
36019
36049
  /** @description ChangeOrder to promote, which must have UpdateType Invoke. What runs then comes from the ChangeOrder rather than from the request body, which may not carry functions, triggers or invocations of its own; that is what holds every Space in scope to the same change. Only the Units the ChangeOrder covers are reached, a Unit that has already taken it is passed over, and every Unit reached is marked with the ChangeOrder's start and end Tags -- both on the head, with no Revision made, where the invocation changed nothing. Not valid when invoked on Revisions. */
@@ -36270,7 +36300,7 @@ interface operations {
36270
36300
  * An example conjunction is:
36271
36301
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
36272
36302
  *
36273
- * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
36303
+ * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, Clearance, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Guards, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
36274
36304
  *
36275
36305
  * The functions an Invocation calls are addressed with dot notation into `FunctionInvocations`: `FunctionInvocations.*.FunctionName = 'set-image'` matches an Invocation that calls set-image anywhere in its list, and `FunctionInvocations.0.FunctionName` addresses the first function it calls.
36276
36306
  *
@@ -36873,6 +36903,8 @@ interface operations {
36873
36903
  } | null;
36874
36904
  /** Format: uuid */
36875
36905
  ChannelID?: string | null;
36906
+ /** @description Classes of guarded reason this Invocation's functions are cleared for; combined by union with the clearance of the Trigger or API call that runs it */
36907
+ Clearance?: (Record<string, never> | null)[] | null;
36876
36908
  /** @description An optional set of gates that, if any is present, will block deletion */
36877
36909
  DeleteGates?: {
36878
36910
  [key: string]: boolean | null;
@@ -36880,6 +36912,10 @@ interface operations {
36880
36912
  /** @description Friendly name for the entity. */
36881
36913
  DisplayName?: string | null;
36882
36914
  FunctionInvocations?: (Record<string, never> | null)[] | null;
36915
+ /** @description Guards to record on the paths this Invocation's functions write, so a later operation must be cleared for them; combined with the guards of a Trigger running it, the Trigger's winning per key. Add and overwrite only -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). Clearance must cover them. */
36916
+ Guards?: {
36917
+ [key: string]: string | null;
36918
+ } | null;
36883
36919
  /** @description The reason the entity is hidden, if it is. A hidden entity is left out of List and Search results, and of what bulk operations act on, unless the include_hidden parameter names its reason or is *, or the where parameter names the entity by Slug or ID. ConfigHub/YAML Units are created hidden with the reason BackingUnit unless given another. */
36884
36920
  HiddenReason?: string | null;
36885
36921
  /** @description An optional map of Label key/value pairs to specify identifying attributes of entities for the purpose of grouping and filtering them. */
@@ -42120,6 +42156,8 @@ interface operations {
42120
42156
  clearance?: string;
42121
42157
  /** @description The guards this operation records on the paths it writes, as a JSON object of guard key to value -- the reasons those paths hold what they hold, so a later operation must be cleared for them before overwriting. The guard analogue of protect: protect claims the paths, this says why. It only ever adds and overwrites the keys it names -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). */
42122
42158
  guards?: string;
42159
+ /** @description The guards this operation records on the paths it writes as inherited guards, in the form guards takes: a clone of the Unit receives them, and a merge carries them, and any later change to them, to the Units downstream of it. Guards set through guards stay with the Unit they are on. A key may not be in both. The clearance has to cover these as it covers guards. */
42160
+ inherited_guards?: string;
42123
42161
  /** @description Merge the range as one rebased diff and record it as one Revision, instead of walking it. By default a merge replays: it takes the source's Revisions in order and, where a Revision records function invocations that can be re-executed, runs them against this Unit rather than rebasing their recorded paths onto it -- so a change lands where this Unit's own structure puts it -- and records each source Revision that has an effect here as a Revision of its own, carrying that Revision's change description, its own conflicts, and one Mutation per source Mutation. Squashing gives up both: the range arrives as a single rebased patch in a single Revision, which is what a merge did before replay existed. Accepted with upgrade, merge_source, and resolve of an UpgradeUnit or MergeUnits Link, and refused elsewhere, since there is no range to walk. A Link can ask for it standingly with its Squash field. */
42124
42162
  squash?: boolean;
42125
42163
  /** @description Upgrade the unit to the latest version of its upstream unit */
@@ -42173,7 +42211,7 @@ interface operations {
42173
42211
  * An example conjunction is:
42174
42212
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
42175
42213
  *
42176
- * Supported attributes for filtering on Mutation: ChannelID, CreatedAt, FunctionInvocation.Arguments, FunctionInvocation.Clearance, FunctionInvocation.FunctionName, FunctionInvocation.Guards, FunctionInvocation.WhereResource, FunctionName, HiddenReason, InvocationID, InvocationParams, LinkID, MergeBaseRevisionNum, MergeEndRevisionNum, MergeSourceID, MutationID, MutationNum, OrganizationID, ReplayOutcome, ReplayReason, RestoredRevisionNum, RevisionID, RevisionNum, SpaceID, Subgroup, TriggerID, UnitID, UpdatedAt.
42214
+ * Supported attributes for filtering on Mutation: ChannelID, Clearance, CreatedAt, FunctionInvocation.Arguments, FunctionInvocation.FunctionName, FunctionInvocation.WhereResource, FunctionName, Guards, HiddenReason, InheritedGuards, InvocationID, InvocationParams, LinkID, MergeBaseRevisionNum, MergeEndRevisionNum, MergeSourceID, MutationID, MutationNum, OrganizationID, ReplayOutcome, ReplayReason, RestoredRevisionNum, RevisionID, RevisionNum, SpaceID, Subgroup, TriggerID, UnitID, UpdatedAt.
42177
42215
  *
42178
42216
  * Selects Mutations of this Unit whose paths the merge must not overwrite, unioned with the Protected values stored on the Unit's MutationSources.
42179
42217
  *
@@ -42435,6 +42473,8 @@ interface operations {
42435
42473
  clearance?: string;
42436
42474
  /** @description The guards this operation records on the paths it writes, as a JSON object of guard key to value -- the reasons those paths hold what they hold, so a later operation must be cleared for them before overwriting. The guard analogue of protect: protect claims the paths, this says why. It only ever adds and overwrites the keys it names -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). */
42437
42475
  guards?: string;
42476
+ /** @description The guards this operation records on the paths it writes as inherited guards, in the form guards takes: a clone of the Unit receives them, and a merge carries them, and any later change to them, to the Units downstream of it. Guards set through guards stay with the Unit they are on. A key may not be in both. The clearance has to cover these as it covers guards. */
42477
+ inherited_guards?: string;
42438
42478
  /** @description Merge the range as one rebased diff and record it as one Revision, instead of walking it. By default a merge replays: it takes the source's Revisions in order and, where a Revision records function invocations that can be re-executed, runs them against this Unit rather than rebasing their recorded paths onto it -- so a change lands where this Unit's own structure puts it -- and records each source Revision that has an effect here as a Revision of its own, carrying that Revision's change description, its own conflicts, and one Mutation per source Mutation. Squashing gives up both: the range arrives as a single rebased patch in a single Revision, which is what a merge did before replay existed. Accepted with upgrade, merge_source, and resolve of an UpgradeUnit or MergeUnits Link, and refused elsewhere, since there is no range to walk. A Link can ask for it standingly with its Squash field. */
42439
42479
  squash?: boolean;
42440
42480
  /** @description Upgrade the unit to the latest version of its upstream unit */
@@ -42488,7 +42528,7 @@ interface operations {
42488
42528
  * An example conjunction is:
42489
42529
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
42490
42530
  *
42491
- * Supported attributes for filtering on Mutation: ChannelID, CreatedAt, FunctionInvocation.Arguments, FunctionInvocation.Clearance, FunctionInvocation.FunctionName, FunctionInvocation.Guards, FunctionInvocation.WhereResource, FunctionName, HiddenReason, InvocationID, InvocationParams, LinkID, MergeBaseRevisionNum, MergeEndRevisionNum, MergeSourceID, MutationID, MutationNum, OrganizationID, ReplayOutcome, ReplayReason, RestoredRevisionNum, RevisionID, RevisionNum, SpaceID, Subgroup, TriggerID, UnitID, UpdatedAt.
42531
+ * Supported attributes for filtering on Mutation: ChannelID, Clearance, CreatedAt, FunctionInvocation.Arguments, FunctionInvocation.FunctionName, FunctionInvocation.WhereResource, FunctionName, Guards, HiddenReason, InheritedGuards, InvocationID, InvocationParams, LinkID, MergeBaseRevisionNum, MergeEndRevisionNum, MergeSourceID, MutationID, MutationNum, OrganizationID, ReplayOutcome, ReplayReason, RestoredRevisionNum, RevisionID, RevisionNum, SpaceID, Subgroup, TriggerID, UnitID, UpdatedAt.
42492
42532
  *
42493
42533
  * Selects Mutations of this Unit whose paths the merge must not overwrite, unioned with the Protected values stored on the Unit's MutationSources.
42494
42534
  *
@@ -42952,6 +42992,8 @@ interface operations {
42952
42992
  clearance?: string;
42953
42993
  /** @description The guards this operation records on the paths it writes, as a JSON object of guard key to value -- the reasons those paths hold what they hold, so a later operation must be cleared for them before overwriting. The guard analogue of protect: protect claims the paths, this says why. It only ever adds and overwrites the keys it names -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). */
42954
42994
  guards?: string;
42995
+ /** @description The guards this operation records on the paths it writes as inherited guards, in the form guards takes: a clone of the Unit receives them, and a merge carries them, and any later change to them, to the Units downstream of it. Guards set through guards stay with the Unit they are on. A key may not be in both. The clearance has to cover these as it covers guards. */
42996
+ inherited_guards?: string;
42955
42997
  /** @description Merge base revision, which provides the base configuration data of the changes to merge. With merge_source, this is a revision of the merge source unit. With merge_external_source, this is a revision of the unit being updated and overrides the default selection of the latest MergeExternal revision. Supports: Named revisions ('HeadRevisionNum', 'LastReleasedRevisionNum'), direct revision number (e.g., '42'), or entity references ('Tag:uuid', 'ChangeSet:uuid', 'ChangeOrder:uuid', 'Revision:uuid'). Can be prefixed with 'Before:' to select the revision immediately before the specified one (e.g., 'Before:LastReleasedRevisionNum', 'Before:42'). When using Tag or ChangeSet references, the latest revision associated with that entity is selected. 'ChangeOrder:uuid' selects the revision the change order ended at on this Unit and 'Before:ChangeOrder:uuid' the one before it began, which is what undoes a promotion however many revisions it made. */
42956
42998
  merge_base?: string;
42957
42999
  /** @description Identifier of the external source for merge-on-update. When set, computes mutations between the last MergeExternal revision and the provided data, then patches the current unit data with those mutations. */
@@ -43279,9 +43321,9 @@ interface operations {
43279
43321
  * An example conjunction is:
43280
43322
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
43281
43323
  *
43282
- * Supported attributes for filtering on Mutation: ChannelID, CreatedAt, FunctionInvocation.Arguments, FunctionInvocation.Clearance, FunctionInvocation.FunctionName, FunctionInvocation.Guards, FunctionInvocation.WhereResource, FunctionName, HiddenReason, InvocationID, InvocationParams, LinkID, MergeBaseRevisionNum, MergeEndRevisionNum, MergeSourceID, MutationID, MutationNum, OrganizationID, ReplayOutcome, ReplayReason, RestoredRevisionNum, RevisionID, RevisionNum, SpaceID, Subgroup, TriggerID, UnitID, UpdatedAt.
43324
+ * Supported attributes for filtering on Mutation: ChannelID, Clearance, CreatedAt, FunctionInvocation.Arguments, FunctionInvocation.FunctionName, FunctionInvocation.WhereResource, FunctionName, Guards, HiddenReason, InheritedGuards, InvocationID, InvocationParams, LinkID, MergeBaseRevisionNum, MergeEndRevisionNum, MergeSourceID, MutationID, MutationNum, OrganizationID, ReplayOutcome, ReplayReason, RestoredRevisionNum, RevisionID, RevisionNum, SpaceID, Subgroup, TriggerID, UnitID, UpdatedAt.
43283
43325
  *
43284
- * The function invoked is returned as a FunctionInvocation object, and `where` names its fields the same way: `FunctionInvocation.FunctionName`, `FunctionInvocation.Guards.<reason>`, and `FunctionInvocation.Arguments`, which is a list addressed with dot notation. `FunctionInvocation.Arguments.?ParameterName=container-image.Value LIKE 'nginx%'` reads the argument bound to a named parameter, `FunctionInvocation.Arguments.*.Value` matches any argument's value, and `FunctionInvocation.Arguments.0.Value` addresses the first argument. Arguments passed positionally have no ParameterName.
43326
+ * The function invoked is returned as a FunctionInvocation object, and `where` names its fields the same way: `FunctionInvocation.FunctionName` and `FunctionInvocation.Arguments`, which is a list addressed with dot notation. `FunctionInvocation.Arguments.?ParameterName=container-image.Value LIKE 'nginx%'` reads the argument bound to a named parameter, `FunctionInvocation.Arguments.*.Value` matches any argument's value, and `FunctionInvocation.Arguments.0.Value` addresses the first argument. Arguments passed positionally have no ParameterName. `Guards.<reason>` reads the guards the change recorded on the paths it wrote, as in `Guards.Link = 'TransformPaths'`, and `Clearance.*.Key = 'RunAsRoot'` finds the changes written under a clearance for that reason.
43285
43327
  *
43286
43328
  * The whole string must be query-encoded.
43287
43329
  */
@@ -51117,6 +51159,8 @@ interface operations {
51117
51159
  clearance?: string;
51118
51160
  /** @description The guards this operation records on the paths it writes, as a JSON object of guard key to value -- the reasons those paths hold what they hold, so a later operation must be cleared for them before overwriting. The guard analogue of protect: protect claims the paths, this says why. It only ever adds and overwrites the keys it names -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). */
51119
51161
  guards?: string;
51162
+ /** @description The guards this operation records on the paths it writes as inherited guards, in the form guards takes: a clone of the Unit receives them, and a merge carries them, and any later change to them, to the Units downstream of it. Guards set through guards stay with the Unit they are on. A key may not be in both. The clearance has to cover these as it covers guards. */
51163
+ inherited_guards?: string;
51120
51164
  /** @description Merge the range as one rebased diff and record it as one Revision, instead of walking it. By default a merge replays: it takes the source's Revisions in order and, where a Revision records function invocations that can be re-executed, runs them against this Unit rather than rebasing their recorded paths onto it -- so a change lands where this Unit's own structure puts it -- and records each source Revision that has an effect here as a Revision of its own, carrying that Revision's change description, its own conflicts, and one Mutation per source Mutation. Squashing gives up both: the range arrives as a single rebased patch in a single Revision, which is what a merge did before replay existed. Accepted with upgrade, merge_source, and resolve of an UpgradeUnit or MergeUnits Link, and refused elsewhere, since there is no range to walk. A Link can ask for it standingly with its Squash field. */
51121
51165
  squash?: boolean;
51122
51166
  /** @description Upgrade the unit to the latest version of its upstream unit */
@@ -51170,7 +51214,7 @@ interface operations {
51170
51214
  * An example conjunction is:
51171
51215
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
51172
51216
  *
51173
- * Supported attributes for filtering on Mutation: ChannelID, CreatedAt, FunctionInvocation.Arguments, FunctionInvocation.Clearance, FunctionInvocation.FunctionName, FunctionInvocation.Guards, FunctionInvocation.WhereResource, FunctionName, HiddenReason, InvocationID, InvocationParams, LinkID, MergeBaseRevisionNum, MergeEndRevisionNum, MergeSourceID, MutationID, MutationNum, OrganizationID, ReplayOutcome, ReplayReason, RestoredRevisionNum, RevisionID, RevisionNum, SpaceID, Subgroup, TriggerID, UnitID, UpdatedAt.
51217
+ * Supported attributes for filtering on Mutation: ChannelID, Clearance, CreatedAt, FunctionInvocation.Arguments, FunctionInvocation.FunctionName, FunctionInvocation.WhereResource, FunctionName, Guards, HiddenReason, InheritedGuards, InvocationID, InvocationParams, LinkID, MergeBaseRevisionNum, MergeEndRevisionNum, MergeSourceID, MutationID, MutationNum, OrganizationID, ReplayOutcome, ReplayReason, RestoredRevisionNum, RevisionID, RevisionNum, SpaceID, Subgroup, TriggerID, UnitID, UpdatedAt.
51174
51218
  *
51175
51219
  * Selects Mutations of this Unit whose paths the merge must not overwrite, unioned with the Protected values stored on the Unit's MutationSources.
51176
51220
  *
package/dist/index.d.ts CHANGED
@@ -2688,7 +2688,7 @@ interface paths {
2688
2688
  put?: never;
2689
2689
  /**
2690
2690
  * Set path guards on a unit
2691
- * @description Set or remove guards on the unit's PathAnnotations. A guard names a reason a path's value is what it is, so a later operation can be required to know about that reason before overwriting it. Nothing enforces guards yet: setting one records the reason and changes no behavior. A guard may name a path or resource the unit does not have, since it is policy about the configuration rather than a statement about its current contents. Creates a new revision only if the guards actually change. Requires Edit permission.
2691
+ * @description Set or remove guards on the unit's PathAnnotations. A guard names a reason a path's value is what it is, so a later operation can be required to know about that reason before overwriting it. An operation that is not cleared for the guards at a path does not write it, and reports what it withheld as a conflict; editing the guards at a path that already has some needs a clearance for them, and so does changing whether one is inherited. A guard set through Set stays with this unit; one set through SetInherited is copied to its clones and carried by merges to the units downstream. A guard may name a path or resource the unit does not have, since it is policy about the configuration rather than a statement about its current contents. Creates a new revision only if the guards actually change. Requires Edit permission.
2692
2692
  */
2693
2693
  post: operations["SetUnitGuard"];
2694
2694
  delete?: never;
@@ -4094,6 +4094,8 @@ interface components {
4094
4094
  Guards?: {
4095
4095
  [key: string]: string;
4096
4096
  };
4097
+ /** @description The keys of Guards that are inherited: copied to the unit's clones and carried by merges to the units downstream of it. The others stay with this unit. */
4098
+ InheritedGuards?: string[];
4097
4099
  /** @description The unit's needed paths that are the field: a value it is to take from an upstream unit through a NeedsProvides Link. */
4098
4100
  Needed?: components["schemas"]["BlameNeededPath"][];
4099
4101
  /** @description The field's path, in the syntax functions and Links take. Empty on the row about the resource as a whole, which comes first among the resource's fields and carries what is recorded about the resource rather than one of its fields: the change that added or deleted it, whether it is protected as a whole, its guards, and its conflicts, findings and failed checks that name no path. */
@@ -6067,12 +6069,8 @@ interface components {
6067
6069
  FunctionInvocation: {
6068
6070
  /** @description Function arguments */
6069
6071
  Arguments?: components["schemas"]["FunctionArgument"][] | null;
6070
- /** @description Classes of guarded reason this invocation is cleared for; combined by union with the clearance of whatever drove the execution */
6071
- Clearance?: components["schemas"]["Clearance"];
6072
6072
  /** @description Function name */
6073
6073
  FunctionName?: string;
6074
- /** @description Guards to record on the paths this invocation writes, so a later operation must be cleared for them; combined with the guards of whatever drove the execution, later winning per key */
6075
- Guards?: components["schemas"]["GuardStamp"];
6076
6074
  /** @description Caller-supplied parameter values for expanding templated argument Values; transient, not persisted */
6077
6075
  Params?: {
6078
6076
  [key: string]: unknown;
@@ -6277,11 +6275,11 @@ interface components {
6277
6275
  Version?: number;
6278
6276
  };
6279
6277
  GuardDelta: {
6280
- /** @description The path whose guards changed; empty for the resource as a whole */
6278
+ /** @description The path whose inherited guards changed; empty for the resource as a whole */
6281
6279
  Path?: string;
6282
- /** @description Guard keys removed */
6280
+ /** @description Inherited guard keys removed */
6283
6281
  Remove?: string[];
6284
- /** @description Guard keys added or changed, with their new values */
6282
+ /** @description Inherited guard keys added or changed, with their new values */
6285
6283
  Set?: {
6286
6284
  [key: string]: string;
6287
6285
  };
@@ -6306,6 +6304,8 @@ interface components {
6306
6304
  * @example 248df4b7-aa70-47b8-a036-33ac447e668d
6307
6305
  */
6308
6306
  ChannelID?: string;
6307
+ /** @description Classes of guarded reason this Invocation's functions are cleared for; combined by union with the clearance of the Trigger or API call that runs it */
6308
+ Clearance?: components["schemas"]["Clearance"];
6309
6309
  /**
6310
6310
  * Format: date-time
6311
6311
  * @description The timestamp when the entity was created in "2023-01-01T12:00:00Z" format.
@@ -6321,6 +6321,8 @@ interface components {
6321
6321
  /** @description The type of entity. */
6322
6322
  readonly EntityType?: string;
6323
6323
  FunctionInvocations: components["schemas"]["FunctionInvocationList"];
6324
+ /** @description Guards to record on the paths this Invocation's functions write, so a later operation must be cleared for them; combined with the guards of a Trigger running it, the Trigger's winning per key. Add and overwrite only -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). Clearance must cover them. */
6325
+ Guards?: components["schemas"]["GuardStamp"];
6324
6326
  /** @description SHA256 hash of the functions and their arguments encoded as hexadecimal. */
6325
6327
  readonly Hash?: string;
6326
6328
  /** @description The reason the entity is hidden, if it is. A hidden entity is left out of List and Search results, and of what bulk operations act on, unless the include_hidden parameter names its reason or is *, or the where parameter names the entity by Slug or ID. ConfigHub/YAML Units are created hidden with the reason BackingUnit unless given another. */
@@ -6603,6 +6605,8 @@ interface components {
6603
6605
  * @example 248df4b7-aa70-47b8-a036-33ac447e668d
6604
6606
  */
6605
6607
  ChannelID?: string;
6608
+ /** @description The classes of guarded reason the change was filtered with. On a function invocation that is the request's clearance together with that of every Trigger and Invocation that wrote in the same execution; on a Link's change, the Link's */
6609
+ Clearance?: components["schemas"]["Clearance"];
6606
6610
  /**
6607
6611
  * Format: date-time
6608
6612
  * @description The timestamp when the entity was created in "2023-01-01T12:00:00Z" format.
@@ -6613,8 +6617,12 @@ interface components {
6613
6617
  readonly EntityType?: string;
6614
6618
  /** @description The function invoked if the change was made by a function. */
6615
6619
  FunctionInvocation?: components["schemas"]["FunctionInvocation"];
6620
+ /** @description The guards the change recorded on the paths it wrote: the operation's merged with those of the Trigger, Invocation, or Link that produced it */
6621
+ Guards?: components["schemas"]["GuardStamp"];
6616
6622
  /** @description The reason the entity is hidden, if it is. A hidden entity is left out of List and Search results, and of what bulk operations act on, unless the include_hidden parameter names its reason or is *, or the where parameter names the entity by Slug or ID. ConfigHub/YAML Units are created hidden with the reason BackingUnit unless given another. */
6617
6623
  HiddenReason?: string;
6624
+ /** @description The guards the change recorded as inherited on the paths it wrote, which clones receive and merges carry to the units downstream */
6625
+ InheritedGuards?: components["schemas"]["GuardStamp"];
6618
6626
  /**
6619
6627
  * Format: uuid
6620
6628
  * @description InvocationID is the identifier of the function invoked, if there is a corresponding Invocation.
@@ -7450,12 +7458,18 @@ interface components {
7450
7458
  };
7451
7459
  /** @description The resource whose guards are being edited: ResourceName, its whole name (namespace/name) or a name it had before a rename, or ResourceNameWithoutScope, a name without its namespace that has to match one resource; ResourceType, in any API version, is optional. A resource the unit does not have yet is named by ResourceType and ResourceName. */
7452
7460
  Resource?: components["schemas"]["ResourceInfo"];
7453
- /** @description Guard key/value pairs to add or overwrite, by path. The empty path addresses the resource as a whole. A list element is named by merge key or by position, and * stands for every element or key there is; a path that does not exist yet is kept as written */
7461
+ /** @description Guard key/value pairs to add or overwrite, by path, as guards of this unit alone: clones and downstream units do not receive them, and one that was inherited stops being. The empty path addresses the resource as a whole. A list element is named by merge key or by position, and * stands for every element or key there is; a path that does not exist yet is kept as written */
7454
7462
  Set?: {
7455
7463
  [key: string]: {
7456
7464
  [key: string]: string;
7457
7465
  };
7458
7466
  };
7467
+ /** @description Guard key/value pairs to add or overwrite, by path, as inherited guards: a clone of the unit receives them, and a merge carries them, and any later change to them, to the units downstream of it. Named as in Set; a key may not be in both at the same path */
7468
+ SetInherited?: {
7469
+ [key: string]: {
7470
+ [key: string]: string;
7471
+ };
7472
+ };
7459
7473
  };
7460
7474
  ResourceInfo: {
7461
7475
  /** @description Category of configuration element represented in the configuration data; Kubernetes resources are of category Resource, and application configuration files are of category AppConfig */
@@ -8967,7 +8981,7 @@ interface components {
8967
8981
  UnitID?: string;
8968
8982
  };
8969
8983
  UnitPathReport: {
8970
- /** @description The path's own annotations other than guards and conflict dismissals, by kind. The field's Guards are those that apply to it, its ancestors' and its resource's included. */
8984
+ /** @description The path's own annotations other than guards, their inheritance and conflict dismissals, by kind. The field's Guards are those that apply to it, its ancestors' and its resource's included. */
8971
8985
  Annotations?: {
8972
8986
  [key: string]: {
8973
8987
  [key: string]: string;
@@ -20177,6 +20191,8 @@ interface operations {
20177
20191
  clearance?: string;
20178
20192
  /** @description The guards this operation records on the paths it writes, as a JSON object of guard key to value -- the reasons those paths hold what they hold, so a later operation must be cleared for them before overwriting. The guard analogue of protect: protect claims the paths, this says why. It only ever adds and overwrites the keys it names -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). */
20179
20193
  guards?: string;
20194
+ /** @description The guards this operation records on the paths it writes as inherited guards, in the form guards takes: a clone of the Unit receives them, and a merge carries them, and any later change to them, to the Units downstream of it. Guards set through guards stay with the Unit they are on. A key may not be in both. The clearance has to cover these as it covers guards. */
20195
+ inherited_guards?: string;
20180
20196
  /** @description Must match ChangeSetID of affected Units unless in dry run mode; not valid when invoked on Revisions */
20181
20197
  change_set_id?: string;
20182
20198
  /** @description ChangeOrder to promote, which must have UpdateType Invoke. What runs then comes from the ChangeOrder rather than from the request body, which may not carry functions, triggers or invocations of its own; that is what holds every Space in scope to the same change. Only the Units the ChangeOrder covers are reached, a Unit that has already taken it is passed over, and every Unit reached is marked with the ChangeOrder's start and end Tags -- both on the head, with no Revision made, where the invocation changed nothing. Not valid when invoked on Revisions. */
@@ -20936,7 +20952,7 @@ interface operations {
20936
20952
  * An example conjunction is:
20937
20953
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
20938
20954
  *
20939
- * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
20955
+ * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, Clearance, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Guards, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
20940
20956
  *
20941
20957
  * The functions an Invocation calls are addressed with dot notation into `FunctionInvocations`: `FunctionInvocations.*.FunctionName = 'set-image'` matches an Invocation that calls set-image anywhere in its list, and `FunctionInvocations.0.FunctionName` addresses the first function it calls.
20942
20958
  *
@@ -21160,7 +21176,7 @@ interface operations {
21160
21176
  * An example conjunction is:
21161
21177
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
21162
21178
  *
21163
- * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
21179
+ * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, Clearance, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Guards, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
21164
21180
  *
21165
21181
  * The functions an Invocation calls are addressed with dot notation into `FunctionInvocations`: `FunctionInvocations.*.FunctionName = 'set-image'` matches an Invocation that calls set-image anywhere in its list, and `FunctionInvocations.0.FunctionName` addresses the first function it calls.
21166
21182
  *
@@ -21353,6 +21369,8 @@ interface operations {
21353
21369
  } | null;
21354
21370
  /** Format: uuid */
21355
21371
  ChannelID?: string | null;
21372
+ /** @description Classes of guarded reason this Invocation's functions are cleared for; combined by union with the clearance of the Trigger or API call that runs it */
21373
+ Clearance?: (Record<string, never> | null)[] | null;
21356
21374
  /** @description An optional set of gates that, if any is present, will block deletion */
21357
21375
  DeleteGates?: {
21358
21376
  [key: string]: boolean | null;
@@ -21360,6 +21378,10 @@ interface operations {
21360
21378
  /** @description Friendly name for the entity. */
21361
21379
  DisplayName?: string | null;
21362
21380
  FunctionInvocations?: (Record<string, never> | null)[] | null;
21381
+ /** @description Guards to record on the paths this Invocation's functions write, so a later operation must be cleared for them; combined with the guards of a Trigger running it, the Trigger's winning per key. Add and overwrite only -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). Clearance must cover them. */
21382
+ Guards?: {
21383
+ [key: string]: string | null;
21384
+ } | null;
21363
21385
  /** @description The reason the entity is hidden, if it is. A hidden entity is left out of List and Search results, and of what bulk operations act on, unless the include_hidden parameter names its reason or is *, or the where parameter names the entity by Slug or ID. ConfigHub/YAML Units are created hidden with the reason BackingUnit unless given another. */
21364
21386
  HiddenReason?: string | null;
21365
21387
  /** @description An optional map of Label key/value pairs to specify identifying attributes of entities for the purpose of grouping and filtering them. */
@@ -21511,7 +21533,7 @@ interface operations {
21511
21533
  * An example conjunction is:
21512
21534
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
21513
21535
  *
21514
- * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
21536
+ * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, Clearance, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Guards, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
21515
21537
  *
21516
21538
  * The functions an Invocation calls are addressed with dot notation into `FunctionInvocations`: `FunctionInvocations.*.FunctionName = 'set-image'` matches an Invocation that calls set-image anywhere in its list, and `FunctionInvocations.0.FunctionName` addresses the first function it calls.
21517
21539
  *
@@ -21715,7 +21737,7 @@ interface operations {
21715
21737
  * An example conjunction is:
21716
21738
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
21717
21739
  *
21718
- * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
21740
+ * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, Clearance, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Guards, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
21719
21741
  *
21720
21742
  * The functions an Invocation calls are addressed with dot notation into `FunctionInvocations`: `FunctionInvocations.*.FunctionName = 'set-image'` matches an Invocation that calls set-image anywhere in its list, and `FunctionInvocations.0.FunctionName` addresses the first function it calls.
21721
21743
  *
@@ -21798,6 +21820,8 @@ interface operations {
21798
21820
  } | null;
21799
21821
  /** Format: uuid */
21800
21822
  ChannelID?: string | null;
21823
+ /** @description Classes of guarded reason this Invocation's functions are cleared for; combined by union with the clearance of the Trigger or API call that runs it */
21824
+ Clearance?: (Record<string, never> | null)[] | null;
21801
21825
  /** @description An optional set of gates that, if any is present, will block deletion */
21802
21826
  DeleteGates?: {
21803
21827
  [key: string]: boolean | null;
@@ -21805,6 +21829,10 @@ interface operations {
21805
21829
  /** @description Friendly name for the entity. */
21806
21830
  DisplayName?: string | null;
21807
21831
  FunctionInvocations?: (Record<string, never> | null)[] | null;
21832
+ /** @description Guards to record on the paths this Invocation's functions write, so a later operation must be cleared for them; combined with the guards of a Trigger running it, the Trigger's winning per key. Add and overwrite only -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). Clearance must cover them. */
21833
+ Guards?: {
21834
+ [key: string]: string | null;
21835
+ } | null;
21808
21836
  /** @description The reason the entity is hidden, if it is. A hidden entity is left out of List and Search results, and of what bulk operations act on, unless the include_hidden parameter names its reason or is *, or the where parameter names the entity by Slug or ID. ConfigHub/YAML Units are created hidden with the reason BackingUnit unless given another. */
21809
21837
  HiddenReason?: string | null;
21810
21838
  /** @description An optional map of Label key/value pairs to specify identifying attributes of entities for the purpose of grouping and filtering them. */
@@ -21956,7 +21984,7 @@ interface operations {
21956
21984
  * An example conjunction is:
21957
21985
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
21958
21986
  *
21959
- * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
21987
+ * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, Clearance, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Guards, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
21960
21988
  *
21961
21989
  * The whole string must be query-encoded.
21962
21990
  */
@@ -36014,6 +36042,8 @@ interface operations {
36014
36042
  clearance?: string;
36015
36043
  /** @description The guards this operation records on the paths it writes, as a JSON object of guard key to value -- the reasons those paths hold what they hold, so a later operation must be cleared for them before overwriting. The guard analogue of protect: protect claims the paths, this says why. It only ever adds and overwrites the keys it names -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). */
36016
36044
  guards?: string;
36045
+ /** @description The guards this operation records on the paths it writes as inherited guards, in the form guards takes: a clone of the Unit receives them, and a merge carries them, and any later change to them, to the Units downstream of it. Guards set through guards stay with the Unit they are on. A key may not be in both. The clearance has to cover these as it covers guards. */
36046
+ inherited_guards?: string;
36017
36047
  /** @description Must match ChangeSetID of affected Units unless in dry run mode; not valid when invoked on Revisions */
36018
36048
  change_set_id?: string;
36019
36049
  /** @description ChangeOrder to promote, which must have UpdateType Invoke. What runs then comes from the ChangeOrder rather than from the request body, which may not carry functions, triggers or invocations of its own; that is what holds every Space in scope to the same change. Only the Units the ChangeOrder covers are reached, a Unit that has already taken it is passed over, and every Unit reached is marked with the ChangeOrder's start and end Tags -- both on the head, with no Revision made, where the invocation changed nothing. Not valid when invoked on Revisions. */
@@ -36270,7 +36300,7 @@ interface operations {
36270
36300
  * An example conjunction is:
36271
36301
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
36272
36302
  *
36273
- * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
36303
+ * Supported attributes for filtering on Invocation: Annotations, BackingUnitID, ChannelID, Clearance, CreatedAt, DeleteGates, DisplayName, FunctionInvocations, Guards, Hash, HiddenReason, InvocationID, Labels, OrganizationID, Parameters, Permissions, Slug, SpaceID, ToolchainType, UpdatedAt, UpstreamInvocationID.
36274
36304
  *
36275
36305
  * The functions an Invocation calls are addressed with dot notation into `FunctionInvocations`: `FunctionInvocations.*.FunctionName = 'set-image'` matches an Invocation that calls set-image anywhere in its list, and `FunctionInvocations.0.FunctionName` addresses the first function it calls.
36276
36306
  *
@@ -36873,6 +36903,8 @@ interface operations {
36873
36903
  } | null;
36874
36904
  /** Format: uuid */
36875
36905
  ChannelID?: string | null;
36906
+ /** @description Classes of guarded reason this Invocation's functions are cleared for; combined by union with the clearance of the Trigger or API call that runs it */
36907
+ Clearance?: (Record<string, never> | null)[] | null;
36876
36908
  /** @description An optional set of gates that, if any is present, will block deletion */
36877
36909
  DeleteGates?: {
36878
36910
  [key: string]: boolean | null;
@@ -36880,6 +36912,10 @@ interface operations {
36880
36912
  /** @description Friendly name for the entity. */
36881
36913
  DisplayName?: string | null;
36882
36914
  FunctionInvocations?: (Record<string, never> | null)[] | null;
36915
+ /** @description Guards to record on the paths this Invocation's functions write, so a later operation must be cleared for them; combined with the guards of a Trigger running it, the Trigger's winning per key. Add and overwrite only -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). Clearance must cover them. */
36916
+ Guards?: {
36917
+ [key: string]: string | null;
36918
+ } | null;
36883
36919
  /** @description The reason the entity is hidden, if it is. A hidden entity is left out of List and Search results, and of what bulk operations act on, unless the include_hidden parameter names its reason or is *, or the where parameter names the entity by Slug or ID. ConfigHub/YAML Units are created hidden with the reason BackingUnit unless given another. */
36884
36920
  HiddenReason?: string | null;
36885
36921
  /** @description An optional map of Label key/value pairs to specify identifying attributes of entities for the purpose of grouping and filtering them. */
@@ -42120,6 +42156,8 @@ interface operations {
42120
42156
  clearance?: string;
42121
42157
  /** @description The guards this operation records on the paths it writes, as a JSON object of guard key to value -- the reasons those paths hold what they hold, so a later operation must be cleared for them before overwriting. The guard analogue of protect: protect claims the paths, this says why. It only ever adds and overwrites the keys it names -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). */
42122
42158
  guards?: string;
42159
+ /** @description The guards this operation records on the paths it writes as inherited guards, in the form guards takes: a clone of the Unit receives them, and a merge carries them, and any later change to them, to the Units downstream of it. Guards set through guards stay with the Unit they are on. A key may not be in both. The clearance has to cover these as it covers guards. */
42160
+ inherited_guards?: string;
42123
42161
  /** @description Merge the range as one rebased diff and record it as one Revision, instead of walking it. By default a merge replays: it takes the source's Revisions in order and, where a Revision records function invocations that can be re-executed, runs them against this Unit rather than rebasing their recorded paths onto it -- so a change lands where this Unit's own structure puts it -- and records each source Revision that has an effect here as a Revision of its own, carrying that Revision's change description, its own conflicts, and one Mutation per source Mutation. Squashing gives up both: the range arrives as a single rebased patch in a single Revision, which is what a merge did before replay existed. Accepted with upgrade, merge_source, and resolve of an UpgradeUnit or MergeUnits Link, and refused elsewhere, since there is no range to walk. A Link can ask for it standingly with its Squash field. */
42124
42162
  squash?: boolean;
42125
42163
  /** @description Upgrade the unit to the latest version of its upstream unit */
@@ -42173,7 +42211,7 @@ interface operations {
42173
42211
  * An example conjunction is:
42174
42212
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
42175
42213
  *
42176
- * Supported attributes for filtering on Mutation: ChannelID, CreatedAt, FunctionInvocation.Arguments, FunctionInvocation.Clearance, FunctionInvocation.FunctionName, FunctionInvocation.Guards, FunctionInvocation.WhereResource, FunctionName, HiddenReason, InvocationID, InvocationParams, LinkID, MergeBaseRevisionNum, MergeEndRevisionNum, MergeSourceID, MutationID, MutationNum, OrganizationID, ReplayOutcome, ReplayReason, RestoredRevisionNum, RevisionID, RevisionNum, SpaceID, Subgroup, TriggerID, UnitID, UpdatedAt.
42214
+ * Supported attributes for filtering on Mutation: ChannelID, Clearance, CreatedAt, FunctionInvocation.Arguments, FunctionInvocation.FunctionName, FunctionInvocation.WhereResource, FunctionName, Guards, HiddenReason, InheritedGuards, InvocationID, InvocationParams, LinkID, MergeBaseRevisionNum, MergeEndRevisionNum, MergeSourceID, MutationID, MutationNum, OrganizationID, ReplayOutcome, ReplayReason, RestoredRevisionNum, RevisionID, RevisionNum, SpaceID, Subgroup, TriggerID, UnitID, UpdatedAt.
42177
42215
  *
42178
42216
  * Selects Mutations of this Unit whose paths the merge must not overwrite, unioned with the Protected values stored on the Unit's MutationSources.
42179
42217
  *
@@ -42435,6 +42473,8 @@ interface operations {
42435
42473
  clearance?: string;
42436
42474
  /** @description The guards this operation records on the paths it writes, as a JSON object of guard key to value -- the reasons those paths hold what they hold, so a later operation must be cleared for them before overwriting. The guard analogue of protect: protect claims the paths, this says why. It only ever adds and overwrites the keys it names -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). */
42437
42475
  guards?: string;
42476
+ /** @description The guards this operation records on the paths it writes as inherited guards, in the form guards takes: a clone of the Unit receives them, and a merge carries them, and any later change to them, to the Units downstream of it. Guards set through guards stay with the Unit they are on. A key may not be in both. The clearance has to cover these as it covers guards. */
42477
+ inherited_guards?: string;
42438
42478
  /** @description Merge the range as one rebased diff and record it as one Revision, instead of walking it. By default a merge replays: it takes the source's Revisions in order and, where a Revision records function invocations that can be re-executed, runs them against this Unit rather than rebasing their recorded paths onto it -- so a change lands where this Unit's own structure puts it -- and records each source Revision that has an effect here as a Revision of its own, carrying that Revision's change description, its own conflicts, and one Mutation per source Mutation. Squashing gives up both: the range arrives as a single rebased patch in a single Revision, which is what a merge did before replay existed. Accepted with upgrade, merge_source, and resolve of an UpgradeUnit or MergeUnits Link, and refused elsewhere, since there is no range to walk. A Link can ask for it standingly with its Squash field. */
42439
42479
  squash?: boolean;
42440
42480
  /** @description Upgrade the unit to the latest version of its upstream unit */
@@ -42488,7 +42528,7 @@ interface operations {
42488
42528
  * An example conjunction is:
42489
42529
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
42490
42530
  *
42491
- * Supported attributes for filtering on Mutation: ChannelID, CreatedAt, FunctionInvocation.Arguments, FunctionInvocation.Clearance, FunctionInvocation.FunctionName, FunctionInvocation.Guards, FunctionInvocation.WhereResource, FunctionName, HiddenReason, InvocationID, InvocationParams, LinkID, MergeBaseRevisionNum, MergeEndRevisionNum, MergeSourceID, MutationID, MutationNum, OrganizationID, ReplayOutcome, ReplayReason, RestoredRevisionNum, RevisionID, RevisionNum, SpaceID, Subgroup, TriggerID, UnitID, UpdatedAt.
42531
+ * Supported attributes for filtering on Mutation: ChannelID, Clearance, CreatedAt, FunctionInvocation.Arguments, FunctionInvocation.FunctionName, FunctionInvocation.WhereResource, FunctionName, Guards, HiddenReason, InheritedGuards, InvocationID, InvocationParams, LinkID, MergeBaseRevisionNum, MergeEndRevisionNum, MergeSourceID, MutationID, MutationNum, OrganizationID, ReplayOutcome, ReplayReason, RestoredRevisionNum, RevisionID, RevisionNum, SpaceID, Subgroup, TriggerID, UnitID, UpdatedAt.
42492
42532
  *
42493
42533
  * Selects Mutations of this Unit whose paths the merge must not overwrite, unioned with the Protected values stored on the Unit's MutationSources.
42494
42534
  *
@@ -42952,6 +42992,8 @@ interface operations {
42952
42992
  clearance?: string;
42953
42993
  /** @description The guards this operation records on the paths it writes, as a JSON object of guard key to value -- the reasons those paths hold what they hold, so a later operation must be cleared for them before overwriting. The guard analogue of protect: protect claims the paths, this says why. It only ever adds and overwrites the keys it names -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). */
42954
42994
  guards?: string;
42995
+ /** @description The guards this operation records on the paths it writes as inherited guards, in the form guards takes: a clone of the Unit receives them, and a merge carries them, and any later change to them, to the Units downstream of it. Guards set through guards stay with the Unit they are on. A key may not be in both. The clearance has to cover these as it covers guards. */
42996
+ inherited_guards?: string;
42955
42997
  /** @description Merge base revision, which provides the base configuration data of the changes to merge. With merge_source, this is a revision of the merge source unit. With merge_external_source, this is a revision of the unit being updated and overrides the default selection of the latest MergeExternal revision. Supports: Named revisions ('HeadRevisionNum', 'LastReleasedRevisionNum'), direct revision number (e.g., '42'), or entity references ('Tag:uuid', 'ChangeSet:uuid', 'ChangeOrder:uuid', 'Revision:uuid'). Can be prefixed with 'Before:' to select the revision immediately before the specified one (e.g., 'Before:LastReleasedRevisionNum', 'Before:42'). When using Tag or ChangeSet references, the latest revision associated with that entity is selected. 'ChangeOrder:uuid' selects the revision the change order ended at on this Unit and 'Before:ChangeOrder:uuid' the one before it began, which is what undoes a promotion however many revisions it made. */
42956
42998
  merge_base?: string;
42957
42999
  /** @description Identifier of the external source for merge-on-update. When set, computes mutations between the last MergeExternal revision and the provided data, then patches the current unit data with those mutations. */
@@ -43279,9 +43321,9 @@ interface operations {
43279
43321
  * An example conjunction is:
43280
43322
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
43281
43323
  *
43282
- * Supported attributes for filtering on Mutation: ChannelID, CreatedAt, FunctionInvocation.Arguments, FunctionInvocation.Clearance, FunctionInvocation.FunctionName, FunctionInvocation.Guards, FunctionInvocation.WhereResource, FunctionName, HiddenReason, InvocationID, InvocationParams, LinkID, MergeBaseRevisionNum, MergeEndRevisionNum, MergeSourceID, MutationID, MutationNum, OrganizationID, ReplayOutcome, ReplayReason, RestoredRevisionNum, RevisionID, RevisionNum, SpaceID, Subgroup, TriggerID, UnitID, UpdatedAt.
43324
+ * Supported attributes for filtering on Mutation: ChannelID, Clearance, CreatedAt, FunctionInvocation.Arguments, FunctionInvocation.FunctionName, FunctionInvocation.WhereResource, FunctionName, Guards, HiddenReason, InheritedGuards, InvocationID, InvocationParams, LinkID, MergeBaseRevisionNum, MergeEndRevisionNum, MergeSourceID, MutationID, MutationNum, OrganizationID, ReplayOutcome, ReplayReason, RestoredRevisionNum, RevisionID, RevisionNum, SpaceID, Subgroup, TriggerID, UnitID, UpdatedAt.
43283
43325
  *
43284
- * The function invoked is returned as a FunctionInvocation object, and `where` names its fields the same way: `FunctionInvocation.FunctionName`, `FunctionInvocation.Guards.<reason>`, and `FunctionInvocation.Arguments`, which is a list addressed with dot notation. `FunctionInvocation.Arguments.?ParameterName=container-image.Value LIKE 'nginx%'` reads the argument bound to a named parameter, `FunctionInvocation.Arguments.*.Value` matches any argument's value, and `FunctionInvocation.Arguments.0.Value` addresses the first argument. Arguments passed positionally have no ParameterName.
43326
+ * The function invoked is returned as a FunctionInvocation object, and `where` names its fields the same way: `FunctionInvocation.FunctionName` and `FunctionInvocation.Arguments`, which is a list addressed with dot notation. `FunctionInvocation.Arguments.?ParameterName=container-image.Value LIKE 'nginx%'` reads the argument bound to a named parameter, `FunctionInvocation.Arguments.*.Value` matches any argument's value, and `FunctionInvocation.Arguments.0.Value` addresses the first argument. Arguments passed positionally have no ParameterName. `Guards.<reason>` reads the guards the change recorded on the paths it wrote, as in `Guards.Link = 'TransformPaths'`, and `Clearance.*.Key = 'RunAsRoot'` finds the changes written under a clearance for that reason.
43285
43327
  *
43286
43328
  * The whole string must be query-encoded.
43287
43329
  */
@@ -51117,6 +51159,8 @@ interface operations {
51117
51159
  clearance?: string;
51118
51160
  /** @description The guards this operation records on the paths it writes, as a JSON object of guard key to value -- the reasons those paths hold what they hold, so a later operation must be cleared for them before overwriting. The guard analogue of protect: protect claims the paths, this says why. It only ever adds and overwrites the keys it names -- retiring a guard is the /guard API (cub unit set-guard --remove-guard). */
51119
51161
  guards?: string;
51162
+ /** @description The guards this operation records on the paths it writes as inherited guards, in the form guards takes: a clone of the Unit receives them, and a merge carries them, and any later change to them, to the Units downstream of it. Guards set through guards stay with the Unit they are on. A key may not be in both. The clearance has to cover these as it covers guards. */
51163
+ inherited_guards?: string;
51120
51164
  /** @description Merge the range as one rebased diff and record it as one Revision, instead of walking it. By default a merge replays: it takes the source's Revisions in order and, where a Revision records function invocations that can be re-executed, runs them against this Unit rather than rebasing their recorded paths onto it -- so a change lands where this Unit's own structure puts it -- and records each source Revision that has an effect here as a Revision of its own, carrying that Revision's change description, its own conflicts, and one Mutation per source Mutation. Squashing gives up both: the range arrives as a single rebased patch in a single Revision, which is what a merge did before replay existed. Accepted with upgrade, merge_source, and resolve of an UpgradeUnit or MergeUnits Link, and refused elsewhere, since there is no range to walk. A Link can ask for it standingly with its Squash field. */
51121
51165
  squash?: boolean;
51122
51166
  /** @description Upgrade the unit to the latest version of its upstream unit */
@@ -51170,7 +51214,7 @@ interface operations {
51170
51214
  * An example conjunction is:
51171
51215
  * `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
51172
51216
  *
51173
- * Supported attributes for filtering on Mutation: ChannelID, CreatedAt, FunctionInvocation.Arguments, FunctionInvocation.Clearance, FunctionInvocation.FunctionName, FunctionInvocation.Guards, FunctionInvocation.WhereResource, FunctionName, HiddenReason, InvocationID, InvocationParams, LinkID, MergeBaseRevisionNum, MergeEndRevisionNum, MergeSourceID, MutationID, MutationNum, OrganizationID, ReplayOutcome, ReplayReason, RestoredRevisionNum, RevisionID, RevisionNum, SpaceID, Subgroup, TriggerID, UnitID, UpdatedAt.
51217
+ * Supported attributes for filtering on Mutation: ChannelID, Clearance, CreatedAt, FunctionInvocation.Arguments, FunctionInvocation.FunctionName, FunctionInvocation.WhereResource, FunctionName, Guards, HiddenReason, InheritedGuards, InvocationID, InvocationParams, LinkID, MergeBaseRevisionNum, MergeEndRevisionNum, MergeSourceID, MutationID, MutationNum, OrganizationID, ReplayOutcome, ReplayReason, RestoredRevisionNum, RevisionID, RevisionNum, SpaceID, Subgroup, TriggerID, UnitID, UpdatedAt.
51174
51218
  *
51175
51219
  * Selects Mutations of this Unit whose paths the merge must not overwrite, unioned with the Protected values stored on the Unit's MutationSources.
51176
51220
  *
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@confighub/api",
3
- "version": "0.10.9",
3
+ "version": "0.10.10",
4
4
  "description": "Typed, framework-agnostic client for the ConfigHub API",
5
5
  "license": "MIT",
6
6
  "repository": {