@robosystems/client 2.26.1 → 2.28.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.
package/sdk/types.gen.ts CHANGED
@@ -501,8 +501,6 @@ export type ArtifactResponse = {
501
501
  } & StatementMechanics) | ({
502
502
  kind: 'metric';
503
503
  } & MetricMechanics) | ({
504
- kind: 'rollforward';
505
- } & RollforwardMechanics) | ({
506
504
  kind: 'forecast';
507
505
  } & ForecastMechanics) | ({
508
506
  kind: 'reconciliation';
@@ -740,41 +738,6 @@ export type AssociationResponse = {
740
738
  reclassified_periods?: Array<string>;
741
739
  };
742
740
 
743
- /**
744
- * AttributionFilter
745
- *
746
- * One flow-concept attribution rule on a rollforward IB.
747
- *
748
- * Pairs a target concept (the flow leaf the matched amount counts
749
- * toward) with a predicate (which LineItems match). The rollforward's
750
- * `attribution_filters: list[AttributionFilter]` declares every flow
751
- * the BS source decomposes into; the renderer evaluates them all per
752
- * period.
753
- *
754
- * `target_element_id` is resolved at create time from `target_qname`
755
- * via the rs-gaap library + tenant taxonomy lookup. Authors only need
756
- * to provide the qname; the element_id is filled in by the create
757
- * handler and the resolved value is what the envelope round-trips.
758
- */
759
- export type AttributionFilter = {
760
- /**
761
- * Target Qname
762
- *
763
- * QName of the flow concept this filter produces facts for — e.g. `rs-gaap:ProceedsFromIssuanceOfCommonStock`. Resolved to `target_element_id` at create time.
764
- */
765
- target_qname: string;
766
- /**
767
- * Target Element Id
768
- *
769
- * Resolved element id for `target_qname`. Null at create time; populated by the handler before persistence. Round-tripped in the envelope.
770
- */
771
- target_element_id?: string | null;
772
- /**
773
- * Predicate that determines which LineItems match this filter.
774
- */
775
- predicate: LineItemMetadataPredicate;
776
- };
777
-
778
741
  /**
779
742
  * AuthProvidersResponse
780
743
  *
@@ -3698,8 +3661,6 @@ export type CreateGraphRequest = {
3698
3661
  export type CreateInformationBlockRequest = ({
3699
3662
  block_type: 'schedule';
3700
3663
  } & CreateScheduleArm) | ({
3701
- block_type: 'rollforward';
3702
- } & CreateRollforwardArm) | ({
3703
3664
  block_type: 'forecast';
3704
3665
  } & CreateForecastArm) | ({
3705
3666
  block_type: 'balance_sheet' | 'cash_flow_statement' | 'comprehensive_income' | 'equity_statement' | 'income_statement' | 'metric' | 'reconciliation' | 'regulatory_disclosure';
@@ -3929,56 +3890,6 @@ export type CreateRepositorySubscriptionRequest = {
3929
3890
  user_id?: string | null;
3930
3891
  };
3931
3892
 
3932
- /**
3933
- * CreateRollforwardRequest
3934
- *
3935
- * Create a rollforward Information Block.
3936
- *
3937
- * Mirrors :class:`CreateScheduleRequest` in shape. The block decomposes
3938
- * the period change in `bs_source_qname` across the declared
3939
- * attribution filters. Residual (Δ BS - Σ filter matches) falls back to
3940
- * the default change tag — or, if no default is declared, surfaces as
3941
- * an unattributed fact tagged with a synthetic residual concept.
3942
- */
3943
- export type CreateRollforwardRequest = {
3944
- /**
3945
- * Name
3946
- *
3947
- * Human-readable block name.
3948
- */
3949
- name: string;
3950
- /**
3951
- * Bs Source Qname
3952
- *
3953
- * QName of the balance-sheet element whose period delta this block decomposes. Resolved to `bs_source_element_id` at create time.
3954
- */
3955
- bs_source_qname: string;
3956
- /**
3957
- * Default Change Tag Qname
3958
- *
3959
- * QName of the fallback flow concept (Tier 1 default change tag). Residual amount — Δ BS minus the sum of filter-matched amounts — is attributed to this concept. When omitted, residual surfaces unattributed; the validation_mode setting governs whether that's a hard error.
3960
- */
3961
- default_change_tag_qname?: string | null;
3962
- /**
3963
- * Attribution Filters
3964
- *
3965
- * Filter predicates routing LineItems to flow concepts.
3966
- */
3967
- attribution_filters?: Array<AttributionFilter>;
3968
- /**
3969
- * Validation Mode
3970
- *
3971
- * How the renderer arbitrates when Σ filter matches != Δ BS. `strict` raises; `residual_as_default` emits the residual as a default-tag fact (the common case); `warn_only` logs and lets the imbalance pass.
3972
- */
3973
- validation_mode?: 'strict' | 'residual_as_default' | 'warn_only';
3974
- /**
3975
- * Taxonomy Id
3976
- *
3977
- * Owning taxonomy id (auto-resolved from `bs_source_qname` when omitted).
3978
- */
3979
- taxonomy_id?: string | null;
3980
- };
3981
-
3982
3893
  /**
3983
3894
  * CreateScheduleRequest
3984
3895
  */
@@ -4844,8 +4755,6 @@ export type DeleteGraphOp = {
4844
4755
  export type DeleteInformationBlockRequest = ({
4845
4756
  block_type: 'schedule';
4846
4757
  } & DeleteScheduleArm) | ({
4847
- block_type: 'rollforward';
4848
- } & DeleteRollforwardArm) | ({
4849
4758
  block_type: 'forecast';
4850
4759
  } & DeleteForecastArm) | ({
4851
4760
  block_type: 'balance_sheet' | 'cash_flow_statement' | 'comprehensive_income' | 'equity_statement' | 'income_statement' | 'metric' | 'reconciliation' | 'regulatory_disclosure';
@@ -5017,24 +4926,6 @@ export type DeleteResult = {
5017
4926
  deleted: boolean;
5018
4927
  };
5019
4928
 
5020
- /**
5021
- * DeleteRollforwardRequest
5022
- *
5023
- * Delete a rollforward block.
5024
- *
5025
- * Cascades through any synthetic facts produced by this block's filter
5026
- * evaluations. The underlying ledger LineItems are not touched — only
5027
- * the rollforward IB's projection of them.
5028
- */
5029
- export type DeleteRollforwardRequest = {
5030
- /**
5031
- * Structure Id
5032
- *
5033
- * Structure ID of the rollforward block.
5034
- */
5035
- structure_id: string;
5036
- };
5037
-
5038
4929
  /**
5039
4930
  * DeleteScheduleRequest
5040
4931
  *
@@ -6502,90 +6393,138 @@ export type EventBlockEnvelope = {
6502
6393
 
6503
6394
  /**
6504
6395
  * EventHandlerResponse
6396
+ *
6397
+ * A rule that turns a matching event into GL rows.
6505
6398
  */
6506
6399
  export type EventHandlerResponse = {
6507
6400
  /**
6508
6401
  * Id
6402
+ *
6403
+ * Handler id (`hdl_`-prefixed).
6509
6404
  */
6510
6405
  id: string;
6511
6406
  /**
6512
6407
  * Name
6408
+ *
6409
+ * Human-readable handler name.
6513
6410
  */
6514
6411
  name: string;
6515
6412
  /**
6516
6413
  * Description
6414
+ *
6415
+ * What the handler is for.
6517
6416
  */
6518
6417
  description?: string | null;
6519
6418
  /**
6520
6419
  * Event Type
6420
+ *
6421
+ * The event type the handler matches.
6521
6422
  */
6522
6423
  event_type: string;
6523
6424
  /**
6524
6425
  * Event Category
6426
+ *
6427
+ * Match on the event's category; null matches any.
6525
6428
  */
6526
6429
  event_category?: string | null;
6527
6430
  /**
6528
6431
  * Match Source
6432
+ *
6433
+ * Match on the event's source system; null matches any.
6529
6434
  */
6530
6435
  match_source?: string | null;
6531
6436
  /**
6532
6437
  * Match Agent Type
6438
+ *
6439
+ * Match on the counterparty's role; null matches any.
6533
6440
  */
6534
6441
  match_agent_type?: string | null;
6535
6442
  /**
6536
6443
  * Match Resource Type
6444
+ *
6445
+ * Match on the resource type; null matches any.
6537
6446
  */
6538
6447
  match_resource_type?: string | null;
6539
6448
  /**
6540
6449
  * Match Metadata Expression
6450
+ *
6451
+ * Equality matches against the event's metadata.
6541
6452
  */
6542
6453
  match_metadata_expression?: {
6543
6454
  [key: string]: unknown;
6544
6455
  } | null;
6545
6456
  /**
6546
6457
  * Transaction Template
6458
+ *
6459
+ * The GL rows the handler books: its DSL template, as JSON.
6547
6460
  */
6548
6461
  transaction_template: {
6549
6462
  [key: string]: unknown;
6550
6463
  };
6551
6464
  /**
6552
6465
  * Priority
6466
+ *
6467
+ * Among handlers that match, the highest priority wins.
6553
6468
  */
6554
6469
  priority: number;
6555
6470
  /**
6556
6471
  * Is Active
6472
+ *
6473
+ * Whether the handler takes part in matching at all.
6557
6474
  */
6558
6475
  is_active: boolean;
6559
6476
  /**
6560
6477
  * Origin
6478
+ *
6479
+ * `hub` for a platform-shipped handler, `tenant` otherwise.
6561
6480
  */
6562
6481
  origin: string;
6563
6482
  /**
6564
6483
  * Suggested By
6484
+ *
6485
+ * `ai` when an AI client created the handler or last changed what it matches or books; null when a person did.
6565
6486
  */
6566
6487
  suggested_by?: string | null;
6567
6488
  /**
6568
6489
  * Confidence
6490
+ *
6491
+ * The suggesting AI's confidence, when it gave one.
6569
6492
  */
6570
6493
  confidence?: number | null;
6571
6494
  /**
6572
6495
  * Approved By
6496
+ *
6497
+ * The user who approved an AI-suggested handler.
6573
6498
  */
6574
6499
  approved_by?: string | null;
6575
6500
  /**
6576
6501
  * Approved At
6502
+ *
6503
+ * When it was approved.
6577
6504
  */
6578
6505
  approved_at?: string | null;
6506
+ /**
6507
+ * Awaiting Approval
6508
+ *
6509
+ * True for an AI-suggested handler no one has approved: it takes no part in matching until a person approves it.
6510
+ */
6511
+ awaiting_approval?: boolean;
6579
6512
  /**
6580
6513
  * Created At
6514
+ *
6515
+ * When it was created.
6581
6516
  */
6582
6517
  created_at?: string | null;
6583
6518
  /**
6584
6519
  * Updated At
6520
+ *
6521
+ * When it last changed.
6585
6522
  */
6586
6523
  updated_at?: string | null;
6587
6524
  /**
6588
6525
  * Created By
6526
+ *
6527
+ * The user who created it.
6589
6528
  */
6590
6529
  created_by?: string | null;
6591
6530
  };
@@ -10188,44 +10127,6 @@ export type LineGrowthRequest = {
10188
10127
  } | null;
10189
10128
  };
10190
10129
 
10191
- /**
10192
- * LineItemMetadataPredicate
10193
- *
10194
- * Filter ledger LineItems by flow concept.
10195
- *
10196
- * The single predicate kind shipped to date. `values` are flow-concept
10197
- * qnames — mini's `TransactionDescriptionCode` values, rs-gaap flow
10198
- * concepts (what the enrichment classifier emits for QuickBooks data),
10199
- * future XBRL GL `GenericFlowCategory` codes. The engine resolves them
10200
- * to element_ids and matches the first-class `LineItem.flow_element_id`
10201
- * FK; matched lines aggregate signed into the attributed fact for the
10202
- * period.
10203
- *
10204
- * `field` is accepted but ignored: the flow tag lives in the typed
10205
- * `flow_element_id` FK, not in JSONB metadata. It stays on the wire so
10206
- * existing request bodies keep validating.
10207
- */
10208
- export type LineItemMetadataPredicate = {
10209
- /**
10210
- * Kind
10211
- *
10212
- * Discriminator value selecting this predicate shape.
10213
- */
10214
- kind?: 'line_item_metadata_field';
10215
- /**
10216
- * Field
10217
- *
10218
- * Accepted but ignored. The flow tag lives in the typed `flow_element_id` FK, not JSONB metadata. Retained for wire-compatibility.
10219
- */
10220
- field?: string;
10221
- /**
10222
- * Values
10223
- *
10224
- * Flow-concept qnames that route to this filter's target concept. A LineItem matches when its `flow_element_id` is one of the elements named here AND the line falls within the rollforward's period.
10225
- */
10226
- values: Array<string>;
10227
- };
10228
-
10229
10130
  /**
10230
10131
  * LinkBankAccountRequest
10231
10132
  *
@@ -18212,66 +18113,6 @@ export type RevokeReportShareResponse = {
18212
18113
  copy_deleted: boolean;
18213
18114
  };
18214
18115
 
18215
- /**
18216
- * RollforwardMechanics
18217
- *
18218
- * Filter-based attribution mechanics for `block_type='rollforward'`.
18219
- *
18220
- * Filter-based attribution: each block decomposes one BS source
18221
- * element's period delta into a list of flow concepts via declared
18222
- * :class:`AttributionFilter` predicates. The renderer evaluates the
18223
- * filters against ledger LineItems at envelope-build time, emits one
18224
- * attributed fact per filter per period, and arbitrates any residual
18225
- * against the default change tag fallback.
18226
- *
18227
- * Reads directly from the typed `structures.artifact_mechanics` JSONB
18228
- * column. `attribution_filters` rides as nested JSON; the predicate
18229
- * union widens as new predicate shapes are added — currently only
18230
- * `line_item_metadata_field` is carried.
18231
- */
18232
- export type RollforwardMechanics = {
18233
- /**
18234
- * Kind
18235
- */
18236
- kind?: 'rollforward';
18237
- /**
18238
- * Bs Source Element Id
18239
- *
18240
- * Element id of the balance-sheet source whose period delta this block decomposes. Resolved from `bs_source_qname` at create time.
18241
- */
18242
- bs_source_element_id: string;
18243
- /**
18244
- * Bs Source Qname
18245
- *
18246
- * QName of the BS source element (e.g. `mini:CashAndCashEquivalents`). Round-tripped for caller convenience; `bs_source_element_id` is authoritative.
18247
- */
18248
- bs_source_qname: string;
18249
- /**
18250
- * Default Change Tag Element Id
18251
- *
18252
- * Element id of the default change tag — the fallback flow concept that receives any residual (Δ BS − Σ filter matches). Null when no default is declared; behavior on residual then follows `validation_mode`.
18253
- */
18254
- default_change_tag_element_id?: string | null;
18255
- /**
18256
- * Default Change Tag Qname
18257
- *
18258
- * QName of the default change tag (e.g. `rs-gaap:IncreaseDecreaseInCashAndCashEquivalents`). Round-tripped for caller convenience and operator-readable envelopes; `default_change_tag_element_id` is authoritative. Null iff `default_change_tag_element_id` is null.
18259
- */
18260
- default_change_tag_qname?: string | null;
18261
- /**
18262
- * Attribution Filters
18263
- *
18264
- * Filter predicates routing LineItems to flow concepts. The renderer evaluates each filter against the period's LineItems, aggregates signed amounts, and emits one fact per filter per period.
18265
- */
18266
- attribution_filters?: Array<AttributionFilter>;
18267
- /**
18268
- * Validation Mode
18269
- *
18270
- * Renderer arbitration policy when Σ filter matches != Δ BS. `strict` raises; `residual_as_default` emits the residual as a default-tag fact (the common case); `warn_only` logs and lets the imbalance pass.
18271
- */
18272
- validation_mode?: 'strict' | 'residual_as_default' | 'warn_only';
18273
- };
18274
-
18275
18116
  /**
18276
18117
  * RuleLite
18277
18118
  *
@@ -21779,8 +21620,6 @@ export type UpdateGraphMetadataOp = {
21779
21620
  export type UpdateInformationBlockRequest = ({
21780
21621
  block_type: 'schedule';
21781
21622
  } & UpdateScheduleArm) | ({
21782
- block_type: 'rollforward';
21783
- } & UpdateRollforwardArm) | ({
21784
21623
  block_type: 'forecast';
21785
21624
  } & UpdateForecastArm) | ({
21786
21625
  block_type: 'balance_sheet' | 'cash_flow_statement' | 'comprehensive_income' | 'equity_statement' | 'income_statement' | 'metric' | 'reconciliation' | 'regulatory_disclosure';
@@ -21994,50 +21833,6 @@ export type UpdatePublishListOperation = {
21994
21833
  list_id: string;
21995
21834
  };
21996
21835
 
21997
- /**
21998
- * UpdateRollforwardRequest
21999
- *
22000
- * Update mutable fields on a rollforward block.
22001
- *
22002
- * Editable: name, default_change_tag_qname, attribution_filters,
22003
- * validation_mode. The BS source is fixed at creation — changing it would
22004
- * invalidate every period already rendered — so switching BS source means
22005
- * delete and re-create.
22006
- *
22007
- * **Partial-update semantics**: an omitted (`None`) field means "leave
22008
- * unchanged". There is no wire-level way to *clear* the default change tag or
22009
- * empty the attribution_filters list; delete and re-create the block instead.
22010
- * The asymmetry is deliberate — a clear-sentinel costs wire-shape complexity
22011
- * for a case that rarely arises, since default tags get swapped rather than
22012
- * removed.
22013
- */
22014
- export type UpdateRollforwardRequest = {
22015
- /**
22016
- * Structure Id
22017
- *
22018
- * Structure ID of the rollforward block.
22019
- */
22020
- structure_id: string;
22021
- /**
22022
- * Name
22023
- */
22024
- name?: string | null;
22025
- /**
22026
- * Default Change Tag Qname
22027
- *
22028
- * New default change tag qname. Pass a value to *change* the default; omit (`None`) to leave unchanged. There is no wire-level way to clear the default — see the class docstring.
22029
- */
22030
- default_change_tag_qname?: string | null;
22031
- /**
22032
- * Attribution Filters
22033
- */
22034
- attribution_filters?: Array<AttributionFilter> | null;
22035
- /**
22036
- * Validation Mode
22037
- */
22038
- validation_mode?: 'strict' | 'residual_as_default' | 'warn_only' | null;
22039
- };
22040
-
22041
21836
  /**
22042
21837
  * UpdateScheduleRequest
22043
21838
  *
@@ -22873,28 +22668,6 @@ export type CreateLegacyArm = {
22873
22668
  };
22874
22669
  };
22875
22670
 
22876
- /**
22877
- * _CreateRollforwardArm
22878
- *
22879
- * Create-information-block body for `block_type="rollforward"`.
22880
- *
22881
- * Carries a typed rollforward payload. The block decomposes the period
22882
- * change in a BS source element across the declared attribution
22883
- * filters.
22884
- */
22885
- export type CreateRollforwardArm = {
22886
- /**
22887
- * Block Type
22888
- *
22889
- * Discriminator value selecting this arm.
22890
- */
22891
- block_type: 'rollforward';
22892
- /**
22893
- * Rollforward creation payload.
22894
- */
22895
- payload: CreateRollforwardRequest;
22896
- };
22897
-
22898
22671
  /**
22899
22672
  * _CreateScheduleArm
22900
22673
  *
@@ -22964,27 +22737,6 @@ export type DeleteLegacyArm = {
22964
22737
  };
22965
22738
  };
22966
22739
 
22967
- /**
22968
- * _DeleteRollforwardArm
22969
- *
22970
- * Delete-information-block body for `block_type="rollforward"`.
22971
- *
22972
- * Cascades through any synthetic facts produced by this block's filter
22973
- * evaluations. The underlying ledger LineItems are not touched.
22974
- */
22975
- export type DeleteRollforwardArm = {
22976
- /**
22977
- * Block Type
22978
- *
22979
- * Discriminator value selecting this arm.
22980
- */
22981
- block_type: 'rollforward';
22982
- /**
22983
- * Rollforward delete payload.
22984
- */
22985
- payload: DeleteRollforwardRequest;
22986
- };
22987
-
22988
22740
  /**
22989
22741
  * _DeleteScheduleArm
22990
22742
  *
@@ -23054,27 +22806,6 @@ export type UpdateLegacyArm = {
23054
22806
  };
23055
22807
  };
23056
22808
 
23057
- /**
23058
- * _UpdateRollforwardArm
23059
- *
23060
- * Update-information-block body for `block_type="rollforward"`.
23061
- *
23062
- * Carries a typed rollforward update payload. Mutable fields: name,
23063
- * default_change_tag_qname, attribution_filters, validation_mode.
23064
- */
23065
- export type UpdateRollforwardArm = {
23066
- /**
23067
- * Block Type
23068
- *
23069
- * Discriminator value selecting this arm.
23070
- */
23071
- block_type: 'rollforward';
23072
- /**
23073
- * Rollforward update payload.
23074
- */
23075
- payload: UpdateRollforwardRequest;
23076
- };
23077
-
23078
22809
  /**
23079
22810
  * _UpdateScheduleArm
23080
22811
  *
package/sdk.gen.d.ts CHANGED
@@ -1094,7 +1094,7 @@ export declare const executeEventBlock: <ThrowOnError extends boolean = false>(o
1094
1094
  /**
1095
1095
  * Create Event Handler
1096
1096
  *
1097
- * Define a rule that fires GL transactions when a matching event block is created with apply_handlers=True. Match criteria (event_type, event_category, match_source, match_agent_type, etc.) act as AND-joined filters — null fields match anything. The highest-priority matching handler wins. AI-suggested handlers (suggested_by='ai') require approval before they are eligible for matching.
1097
+ * Define a rule that fires GL transactions when a matching event block is created with apply_handlers=True. Match criteria (event_type, event_category, match_source, match_agent_type, etc.) act as AND-joined filters — null fields match anything. The highest-priority matching handler wins. A handler created through an AI client is the AI's suggestion (suggested_by='ai'): it takes no part in matching until a person approves it in the app or the API.
1098
1098
  *
1099
1099
  * **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
1100
1100
  */
@@ -1102,7 +1102,7 @@ export declare const createEventHandler: <ThrowOnError extends boolean = false>(
1102
1102
  /**
1103
1103
  * Update Event Handler
1104
1104
  *
1105
- * Patch an event handler's match criteria, template, priority, or active state. Pass approve=true to approve an AI-suggested handler; approve=false to revoke approval. Only supplied fields are updated.
1105
+ * Patch an event handler's match criteria, template, priority, or active state. Pass approve=true to approve an AI-suggested handler; approve=false to revoke approval. Only supplied fields are updated. Through an AI client, approve=true is refused, and a change to what the handler matches or books makes it a suggestion again, out of matching until a person approves it.
1106
1106
  *
1107
1107
  * **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
1108
1108
  */
package/sdk.gen.js CHANGED
@@ -2249,7 +2249,7 @@ exports.executeEventBlock = executeEventBlock;
2249
2249
  /**
2250
2250
  * Create Event Handler
2251
2251
  *
2252
- * Define a rule that fires GL transactions when a matching event block is created with apply_handlers=True. Match criteria (event_type, event_category, match_source, match_agent_type, etc.) act as AND-joined filters — null fields match anything. The highest-priority matching handler wins. AI-suggested handlers (suggested_by='ai') require approval before they are eligible for matching.
2252
+ * Define a rule that fires GL transactions when a matching event block is created with apply_handlers=True. Match criteria (event_type, event_category, match_source, match_agent_type, etc.) act as AND-joined filters — null fields match anything. The highest-priority matching handler wins. A handler created through an AI client is the AI's suggestion (suggested_by='ai'): it takes no part in matching until a person approves it in the app or the API.
2253
2253
  *
2254
2254
  * **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
2255
2255
  */
@@ -2266,7 +2266,7 @@ exports.createEventHandler = createEventHandler;
2266
2266
  /**
2267
2267
  * Update Event Handler
2268
2268
  *
2269
- * Patch an event handler's match criteria, template, priority, or active state. Pass approve=true to approve an AI-suggested handler; approve=false to revoke approval. Only supplied fields are updated.
2269
+ * Patch an event handler's match criteria, template, priority, or active state. Pass approve=true to approve an AI-suggested handler; approve=false to revoke approval. Only supplied fields are updated. Through an AI client, approve=true is refused, and a change to what the handler matches or books makes it a suggestion again, out of matching until a person approves it.
2270
2270
  *
2271
2271
  * **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
2272
2272
  */
package/sdk.gen.ts CHANGED
@@ -2260,7 +2260,7 @@ export const executeEventBlock = <ThrowOnError extends boolean = false>(options:
2260
2260
  /**
2261
2261
  * Create Event Handler
2262
2262
  *
2263
- * Define a rule that fires GL transactions when a matching event block is created with apply_handlers=True. Match criteria (event_type, event_category, match_source, match_agent_type, etc.) act as AND-joined filters — null fields match anything. The highest-priority matching handler wins. AI-suggested handlers (suggested_by='ai') require approval before they are eligible for matching.
2263
+ * Define a rule that fires GL transactions when a matching event block is created with apply_handlers=True. Match criteria (event_type, event_category, match_source, match_agent_type, etc.) act as AND-joined filters — null fields match anything. The highest-priority matching handler wins. A handler created through an AI client is the AI's suggestion (suggested_by='ai'): it takes no part in matching until a person approves it in the app or the API.
2264
2264
  *
2265
2265
  * **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
2266
2266
  */
@@ -2277,7 +2277,7 @@ export const createEventHandler = <ThrowOnError extends boolean = false>(options
2277
2277
  /**
2278
2278
  * Update Event Handler
2279
2279
  *
2280
- * Patch an event handler's match criteria, template, priority, or active state. Pass approve=true to approve an AI-suggested handler; approve=false to revoke approval. Only supplied fields are updated.
2280
+ * Patch an event handler's match criteria, template, priority, or active state. Pass approve=true to approve an AI-suggested handler; approve=false to revoke approval. Only supplied fields are updated. Through an AI client, approve=true is refused, and a change to what the handler matches or books makes it a suggestion again, out of matching until a person approves it.
2281
2281
  *
2282
2282
  * **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
2283
2283
  */