@robosystems/client 0.3.29 → 0.3.31

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
@@ -921,7 +921,7 @@ export type ClassificationLite = {
921
921
  /**
922
922
  * Source
923
923
  *
924
- * Provenance — 'arcrole_analysis', 'disclosure_mechanics', 'us-gaap-metamodel', adapter name, etc.
924
+ * Provenance — 'arcrole_analysis', 'disclosure_mechanics', 'fac-traits', adapter name, etc.
925
925
  */
926
926
  source?: string | null;
927
927
  };
@@ -5628,6 +5628,10 @@ export type InformationBlockEnvelope = {
5628
5628
  * Verification Results
5629
5629
  */
5630
5630
  verification_results?: Array<VerificationResultLite>;
5631
+ /**
5632
+ * Server-computed aggregate over ``verification_results`` — overall pass/fail/error/skip counts plus a per-rule_category breakdown for the grouped Verification Results panel. Null when the block has no verification results.
5633
+ */
5634
+ verification_summary?: VerificationSummary | null;
5631
5635
  /**
5632
5636
  * Server-computed view projections (Charlie's six type-of View arms). ``view.rendering`` carries pre-computed rows + periods + validation for blocks where rendering is deterministic (the statement family today). Other projections come online as their backend support lands — see :class:`ViewProjections`.
5633
5637
  */
@@ -5723,6 +5727,18 @@ export type InitialEntityData = {
5723
5727
  * Employer Identification Number
5724
5728
  */
5725
5729
  ein?: string | null;
5730
+ /**
5731
+ * Entity Type
5732
+ *
5733
+ * Entity legal form (e.g. 'corporation', 'llc' / 'limited_liability_company', 'partnership', 'sole_proprietorship', 'non_profit'). Drives the graph's default Reporting Style at creation — partnership and llc get dedicated equity-form Styles; everything else defaults to corporate. Blank falls back to corporate.
5734
+ */
5735
+ entity_type?: string | null;
5736
+ /**
5737
+ * Reporting Style Id
5738
+ *
5739
+ * Optional explicit Reporting Style Structure id to pin on the graph, overriding the entity_type-derived default. Leave blank to derive from entity_type. Change later via the change-reporting-style operation.
5740
+ */
5741
+ reporting_style_id?: string | null;
5726
5742
  };
5727
5743
 
5728
5744
  /**
@@ -6407,17 +6423,20 @@ export type LedgerEntityResponse = {
6407
6423
  /**
6408
6424
  * LineItemMetadataPredicate
6409
6425
  *
6410
- * Filter ledger LineItems whose ``metadata_[field]`` is in ``values``.
6426
+ * Filter ledger LineItems by flow concept.
6411
6427
  *
6412
- * The single predicate kind shipped in Phase 2 MVP. Sufficient for any
6413
- * source taxonomy that stamps a flow-tag column on each transaction
6414
- * line mini's ``TransactionDescriptionCode``, future XBRL GL
6415
- * ``GenericFlowCategory`` columns, custom tenant tags.
6428
+ * The single predicate kind shipped to date. ``values`` are flow-concept
6429
+ * qnames mini's ``TransactionDescriptionCode`` values, rs-gaap flow
6430
+ * concepts (what the enrichment classifier emits for QuickBooks data),
6431
+ * future XBRL GL ``GenericFlowCategory`` codes. The engine resolves them
6432
+ * to element_ids and matches the first-class ``LineItem.flow_element_id``
6433
+ * FK; matched lines aggregate signed into the attributed fact for the
6434
+ * period.
6416
6435
  *
6417
- * ``field`` is the JSONB key under ``line_items.metadata`` (e.g.
6418
- * ``"transaction_description_code"``). ``values`` is the set of values
6419
- * that route to the filter's target concept; matched LineItems aggregate
6420
- * signed into the attributed fact for the period.
6436
+ * ``field`` is **legacy and ignored** — the flow tag used to live in
6437
+ * ``line_items.metadata[field]`` but has been promoted to the typed
6438
+ * ``flow_element_id`` FK. Retained for wire-compatibility; the engine no
6439
+ * longer reads it.
6421
6440
  */
6422
6441
  export type LineItemMetadataPredicate = {
6423
6442
  /**
@@ -6429,13 +6448,13 @@ export type LineItemMetadataPredicate = {
6429
6448
  /**
6430
6449
  * Field
6431
6450
  *
6432
- * JSONB key under ``line_items.metadata`` to match against e.g. ``transaction_description_code``. The renderer performs an exact-string comparison on the JSONB-extracted text value.
6451
+ * Legacy/ignored. The flow tag now lives in the typed ``flow_element_id`` FK, not JSONB metadata; the engine no longer reads this. Retained for wire-compatibility.
6433
6452
  */
6434
- field: string;
6453
+ field?: string;
6435
6454
  /**
6436
6455
  * Values
6437
6456
  *
6438
- * Metadata values that route to this filter's target concept. A LineItem matches when ``metadata[field] values`` AND the line falls within the rollforward's period.
6457
+ * 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.
6439
6458
  */
6440
6459
  values: Array<string>;
6441
6460
  };
@@ -13393,6 +13412,44 @@ export type ValidationLite = {
13393
13412
  warnings?: Array<string>;
13394
13413
  };
13395
13414
 
13415
+ /**
13416
+ * VerificationCategorySummary
13417
+ *
13418
+ * Pass/fail/skip counts for one ``rule_category`` within a block's
13419
+ * verification results.
13420
+ *
13421
+ * Drives the per-category accordions in the Verification Results panel
13422
+ * (financial-viewer §7.12). ``category`` is the rule's ``rule_category``
13423
+ * (one of the cm:VerificationRule subclasses), resolved by joining each
13424
+ * result to its Rule.
13425
+ */
13426
+ export type VerificationCategorySummary = {
13427
+ /**
13428
+ * Category
13429
+ */
13430
+ category: string;
13431
+ /**
13432
+ * Total
13433
+ */
13434
+ total?: number;
13435
+ /**
13436
+ * Passed
13437
+ */
13438
+ passed?: number;
13439
+ /**
13440
+ * Failed
13441
+ */
13442
+ failed?: number;
13443
+ /**
13444
+ * Errored
13445
+ */
13446
+ errored?: number;
13447
+ /**
13448
+ * Skipped
13449
+ */
13450
+ skipped?: number;
13451
+ };
13452
+
13396
13453
  /**
13397
13454
  * VerificationResultLite
13398
13455
  *
@@ -13444,6 +13501,44 @@ export type VerificationResultLite = {
13444
13501
  evaluated_at?: string | null;
13445
13502
  };
13446
13503
 
13504
+ /**
13505
+ * VerificationSummary
13506
+ *
13507
+ * Server-computed aggregate of a block's ``verification_results``.
13508
+ *
13509
+ * Overall counts plus a per-``rule_category`` breakdown, so the viewer
13510
+ * renders the grouped Verification Results panel (financial-viewer §7.12)
13511
+ * without a client-side results→rules join. Status closure is
13512
+ * ``pass | fail | error | skipped`` (the ``public.verification_results``
13513
+ * CHECK); ``total`` is their sum.
13514
+ */
13515
+ export type VerificationSummary = {
13516
+ /**
13517
+ * Total
13518
+ */
13519
+ total?: number;
13520
+ /**
13521
+ * Passed
13522
+ */
13523
+ passed?: number;
13524
+ /**
13525
+ * Failed
13526
+ */
13527
+ failed?: number;
13528
+ /**
13529
+ * Errored
13530
+ */
13531
+ errored?: number;
13532
+ /**
13533
+ * Skipped
13534
+ */
13535
+ skipped?: number;
13536
+ /**
13537
+ * By Category
13538
+ */
13539
+ by_category?: Array<VerificationCategorySummary>;
13540
+ };
13541
+
13447
13542
  /**
13448
13543
  * ViewAxisConfig
13449
13544
  */
package/types.gen.d.ts CHANGED
@@ -892,7 +892,7 @@ export type ClassificationLite = {
892
892
  /**
893
893
  * Source
894
894
  *
895
- * Provenance — 'arcrole_analysis', 'disclosure_mechanics', 'us-gaap-metamodel', adapter name, etc.
895
+ * Provenance — 'arcrole_analysis', 'disclosure_mechanics', 'fac-traits', adapter name, etc.
896
896
  */
897
897
  source?: string | null;
898
898
  };
@@ -5492,6 +5492,10 @@ export type InformationBlockEnvelope = {
5492
5492
  * Verification Results
5493
5493
  */
5494
5494
  verification_results?: Array<VerificationResultLite>;
5495
+ /**
5496
+ * Server-computed aggregate over ``verification_results`` — overall pass/fail/error/skip counts plus a per-rule_category breakdown for the grouped Verification Results panel. Null when the block has no verification results.
5497
+ */
5498
+ verification_summary?: VerificationSummary | null;
5495
5499
  /**
5496
5500
  * Server-computed view projections (Charlie's six type-of View arms). ``view.rendering`` carries pre-computed rows + periods + validation for blocks where rendering is deterministic (the statement family today). Other projections come online as their backend support lands — see :class:`ViewProjections`.
5497
5501
  */
@@ -5585,6 +5589,18 @@ export type InitialEntityData = {
5585
5589
  * Employer Identification Number
5586
5590
  */
5587
5591
  ein?: string | null;
5592
+ /**
5593
+ * Entity Type
5594
+ *
5595
+ * Entity legal form (e.g. 'corporation', 'llc' / 'limited_liability_company', 'partnership', 'sole_proprietorship', 'non_profit'). Drives the graph's default Reporting Style at creation — partnership and llc get dedicated equity-form Styles; everything else defaults to corporate. Blank falls back to corporate.
5596
+ */
5597
+ entity_type?: string | null;
5598
+ /**
5599
+ * Reporting Style Id
5600
+ *
5601
+ * Optional explicit Reporting Style Structure id to pin on the graph, overriding the entity_type-derived default. Leave blank to derive from entity_type. Change later via the change-reporting-style operation.
5602
+ */
5603
+ reporting_style_id?: string | null;
5588
5604
  };
5589
5605
  /**
5590
5606
  * InitializeLedgerRequest
@@ -6256,17 +6272,20 @@ export type LedgerEntityResponse = {
6256
6272
  /**
6257
6273
  * LineItemMetadataPredicate
6258
6274
  *
6259
- * Filter ledger LineItems whose ``metadata_[field]`` is in ``values``.
6275
+ * Filter ledger LineItems by flow concept.
6260
6276
  *
6261
- * The single predicate kind shipped in Phase 2 MVP. Sufficient for any
6262
- * source taxonomy that stamps a flow-tag column on each transaction
6263
- * line mini's ``TransactionDescriptionCode``, future XBRL GL
6264
- * ``GenericFlowCategory`` columns, custom tenant tags.
6277
+ * The single predicate kind shipped to date. ``values`` are flow-concept
6278
+ * qnames mini's ``TransactionDescriptionCode`` values, rs-gaap flow
6279
+ * concepts (what the enrichment classifier emits for QuickBooks data),
6280
+ * future XBRL GL ``GenericFlowCategory`` codes. The engine resolves them
6281
+ * to element_ids and matches the first-class ``LineItem.flow_element_id``
6282
+ * FK; matched lines aggregate signed into the attributed fact for the
6283
+ * period.
6265
6284
  *
6266
- * ``field`` is the JSONB key under ``line_items.metadata`` (e.g.
6267
- * ``"transaction_description_code"``). ``values`` is the set of values
6268
- * that route to the filter's target concept; matched LineItems aggregate
6269
- * signed into the attributed fact for the period.
6285
+ * ``field`` is **legacy and ignored** — the flow tag used to live in
6286
+ * ``line_items.metadata[field]`` but has been promoted to the typed
6287
+ * ``flow_element_id`` FK. Retained for wire-compatibility; the engine no
6288
+ * longer reads it.
6270
6289
  */
6271
6290
  export type LineItemMetadataPredicate = {
6272
6291
  /**
@@ -6278,13 +6297,13 @@ export type LineItemMetadataPredicate = {
6278
6297
  /**
6279
6298
  * Field
6280
6299
  *
6281
- * JSONB key under ``line_items.metadata`` to match against e.g. ``transaction_description_code``. The renderer performs an exact-string comparison on the JSONB-extracted text value.
6300
+ * Legacy/ignored. The flow tag now lives in the typed ``flow_element_id`` FK, not JSONB metadata; the engine no longer reads this. Retained for wire-compatibility.
6282
6301
  */
6283
- field: string;
6302
+ field?: string;
6284
6303
  /**
6285
6304
  * Values
6286
6305
  *
6287
- * Metadata values that route to this filter's target concept. A LineItem matches when ``metadata[field] values`` AND the line falls within the rollforward's period.
6306
+ * 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.
6288
6307
  */
6289
6308
  values: Array<string>;
6290
6309
  };
@@ -13063,6 +13082,43 @@ export type ValidationLite = {
13063
13082
  */
13064
13083
  warnings?: Array<string>;
13065
13084
  };
13085
+ /**
13086
+ * VerificationCategorySummary
13087
+ *
13088
+ * Pass/fail/skip counts for one ``rule_category`` within a block's
13089
+ * verification results.
13090
+ *
13091
+ * Drives the per-category accordions in the Verification Results panel
13092
+ * (financial-viewer §7.12). ``category`` is the rule's ``rule_category``
13093
+ * (one of the cm:VerificationRule subclasses), resolved by joining each
13094
+ * result to its Rule.
13095
+ */
13096
+ export type VerificationCategorySummary = {
13097
+ /**
13098
+ * Category
13099
+ */
13100
+ category: string;
13101
+ /**
13102
+ * Total
13103
+ */
13104
+ total?: number;
13105
+ /**
13106
+ * Passed
13107
+ */
13108
+ passed?: number;
13109
+ /**
13110
+ * Failed
13111
+ */
13112
+ failed?: number;
13113
+ /**
13114
+ * Errored
13115
+ */
13116
+ errored?: number;
13117
+ /**
13118
+ * Skipped
13119
+ */
13120
+ skipped?: number;
13121
+ };
13066
13122
  /**
13067
13123
  * VerificationResultLite
13068
13124
  *
@@ -13113,6 +13169,43 @@ export type VerificationResultLite = {
13113
13169
  */
13114
13170
  evaluated_at?: string | null;
13115
13171
  };
13172
+ /**
13173
+ * VerificationSummary
13174
+ *
13175
+ * Server-computed aggregate of a block's ``verification_results``.
13176
+ *
13177
+ * Overall counts plus a per-``rule_category`` breakdown, so the viewer
13178
+ * renders the grouped Verification Results panel (financial-viewer §7.12)
13179
+ * without a client-side results→rules join. Status closure is
13180
+ * ``pass | fail | error | skipped`` (the ``public.verification_results``
13181
+ * CHECK); ``total`` is their sum.
13182
+ */
13183
+ export type VerificationSummary = {
13184
+ /**
13185
+ * Total
13186
+ */
13187
+ total?: number;
13188
+ /**
13189
+ * Passed
13190
+ */
13191
+ passed?: number;
13192
+ /**
13193
+ * Failed
13194
+ */
13195
+ failed?: number;
13196
+ /**
13197
+ * Errored
13198
+ */
13199
+ errored?: number;
13200
+ /**
13201
+ * Skipped
13202
+ */
13203
+ skipped?: number;
13204
+ /**
13205
+ * By Category
13206
+ */
13207
+ by_category?: Array<VerificationCategorySummary>;
13208
+ };
13116
13209
  /**
13117
13210
  * ViewAxisConfig
13118
13211
  */
package/types.gen.ts CHANGED
@@ -921,7 +921,7 @@ export type ClassificationLite = {
921
921
  /**
922
922
  * Source
923
923
  *
924
- * Provenance — 'arcrole_analysis', 'disclosure_mechanics', 'us-gaap-metamodel', adapter name, etc.
924
+ * Provenance — 'arcrole_analysis', 'disclosure_mechanics', 'fac-traits', adapter name, etc.
925
925
  */
926
926
  source?: string | null;
927
927
  };
@@ -5628,6 +5628,10 @@ export type InformationBlockEnvelope = {
5628
5628
  * Verification Results
5629
5629
  */
5630
5630
  verification_results?: Array<VerificationResultLite>;
5631
+ /**
5632
+ * Server-computed aggregate over ``verification_results`` — overall pass/fail/error/skip counts plus a per-rule_category breakdown for the grouped Verification Results panel. Null when the block has no verification results.
5633
+ */
5634
+ verification_summary?: VerificationSummary | null;
5631
5635
  /**
5632
5636
  * Server-computed view projections (Charlie's six type-of View arms). ``view.rendering`` carries pre-computed rows + periods + validation for blocks where rendering is deterministic (the statement family today). Other projections come online as their backend support lands — see :class:`ViewProjections`.
5633
5637
  */
@@ -5723,6 +5727,18 @@ export type InitialEntityData = {
5723
5727
  * Employer Identification Number
5724
5728
  */
5725
5729
  ein?: string | null;
5730
+ /**
5731
+ * Entity Type
5732
+ *
5733
+ * Entity legal form (e.g. 'corporation', 'llc' / 'limited_liability_company', 'partnership', 'sole_proprietorship', 'non_profit'). Drives the graph's default Reporting Style at creation — partnership and llc get dedicated equity-form Styles; everything else defaults to corporate. Blank falls back to corporate.
5734
+ */
5735
+ entity_type?: string | null;
5736
+ /**
5737
+ * Reporting Style Id
5738
+ *
5739
+ * Optional explicit Reporting Style Structure id to pin on the graph, overriding the entity_type-derived default. Leave blank to derive from entity_type. Change later via the change-reporting-style operation.
5740
+ */
5741
+ reporting_style_id?: string | null;
5726
5742
  };
5727
5743
 
5728
5744
  /**
@@ -6407,17 +6423,20 @@ export type LedgerEntityResponse = {
6407
6423
  /**
6408
6424
  * LineItemMetadataPredicate
6409
6425
  *
6410
- * Filter ledger LineItems whose ``metadata_[field]`` is in ``values``.
6426
+ * Filter ledger LineItems by flow concept.
6411
6427
  *
6412
- * The single predicate kind shipped in Phase 2 MVP. Sufficient for any
6413
- * source taxonomy that stamps a flow-tag column on each transaction
6414
- * line mini's ``TransactionDescriptionCode``, future XBRL GL
6415
- * ``GenericFlowCategory`` columns, custom tenant tags.
6428
+ * The single predicate kind shipped to date. ``values`` are flow-concept
6429
+ * qnames mini's ``TransactionDescriptionCode`` values, rs-gaap flow
6430
+ * concepts (what the enrichment classifier emits for QuickBooks data),
6431
+ * future XBRL GL ``GenericFlowCategory`` codes. The engine resolves them
6432
+ * to element_ids and matches the first-class ``LineItem.flow_element_id``
6433
+ * FK; matched lines aggregate signed into the attributed fact for the
6434
+ * period.
6416
6435
  *
6417
- * ``field`` is the JSONB key under ``line_items.metadata`` (e.g.
6418
- * ``"transaction_description_code"``). ``values`` is the set of values
6419
- * that route to the filter's target concept; matched LineItems aggregate
6420
- * signed into the attributed fact for the period.
6436
+ * ``field`` is **legacy and ignored** — the flow tag used to live in
6437
+ * ``line_items.metadata[field]`` but has been promoted to the typed
6438
+ * ``flow_element_id`` FK. Retained for wire-compatibility; the engine no
6439
+ * longer reads it.
6421
6440
  */
6422
6441
  export type LineItemMetadataPredicate = {
6423
6442
  /**
@@ -6429,13 +6448,13 @@ export type LineItemMetadataPredicate = {
6429
6448
  /**
6430
6449
  * Field
6431
6450
  *
6432
- * JSONB key under ``line_items.metadata`` to match against e.g. ``transaction_description_code``. The renderer performs an exact-string comparison on the JSONB-extracted text value.
6451
+ * Legacy/ignored. The flow tag now lives in the typed ``flow_element_id`` FK, not JSONB metadata; the engine no longer reads this. Retained for wire-compatibility.
6433
6452
  */
6434
- field: string;
6453
+ field?: string;
6435
6454
  /**
6436
6455
  * Values
6437
6456
  *
6438
- * Metadata values that route to this filter's target concept. A LineItem matches when ``metadata[field] values`` AND the line falls within the rollforward's period.
6457
+ * 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.
6439
6458
  */
6440
6459
  values: Array<string>;
6441
6460
  };
@@ -13393,6 +13412,44 @@ export type ValidationLite = {
13393
13412
  warnings?: Array<string>;
13394
13413
  };
13395
13414
 
13415
+ /**
13416
+ * VerificationCategorySummary
13417
+ *
13418
+ * Pass/fail/skip counts for one ``rule_category`` within a block's
13419
+ * verification results.
13420
+ *
13421
+ * Drives the per-category accordions in the Verification Results panel
13422
+ * (financial-viewer §7.12). ``category`` is the rule's ``rule_category``
13423
+ * (one of the cm:VerificationRule subclasses), resolved by joining each
13424
+ * result to its Rule.
13425
+ */
13426
+ export type VerificationCategorySummary = {
13427
+ /**
13428
+ * Category
13429
+ */
13430
+ category: string;
13431
+ /**
13432
+ * Total
13433
+ */
13434
+ total?: number;
13435
+ /**
13436
+ * Passed
13437
+ */
13438
+ passed?: number;
13439
+ /**
13440
+ * Failed
13441
+ */
13442
+ failed?: number;
13443
+ /**
13444
+ * Errored
13445
+ */
13446
+ errored?: number;
13447
+ /**
13448
+ * Skipped
13449
+ */
13450
+ skipped?: number;
13451
+ };
13452
+
13396
13453
  /**
13397
13454
  * VerificationResultLite
13398
13455
  *
@@ -13444,6 +13501,44 @@ export type VerificationResultLite = {
13444
13501
  evaluated_at?: string | null;
13445
13502
  };
13446
13503
 
13504
+ /**
13505
+ * VerificationSummary
13506
+ *
13507
+ * Server-computed aggregate of a block's ``verification_results``.
13508
+ *
13509
+ * Overall counts plus a per-``rule_category`` breakdown, so the viewer
13510
+ * renders the grouped Verification Results panel (financial-viewer §7.12)
13511
+ * without a client-side results→rules join. Status closure is
13512
+ * ``pass | fail | error | skipped`` (the ``public.verification_results``
13513
+ * CHECK); ``total`` is their sum.
13514
+ */
13515
+ export type VerificationSummary = {
13516
+ /**
13517
+ * Total
13518
+ */
13519
+ total?: number;
13520
+ /**
13521
+ * Passed
13522
+ */
13523
+ passed?: number;
13524
+ /**
13525
+ * Failed
13526
+ */
13527
+ failed?: number;
13528
+ /**
13529
+ * Errored
13530
+ */
13531
+ errored?: number;
13532
+ /**
13533
+ * Skipped
13534
+ */
13535
+ skipped?: number;
13536
+ /**
13537
+ * By Category
13538
+ */
13539
+ by_category?: Array<VerificationCategorySummary>;
13540
+ };
13541
+
13447
13542
  /**
13448
13543
  * ViewAxisConfig
13449
13544
  */