@robosystems/client 1.11.0 → 1.12.1

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/types.gen.d.ts CHANGED
@@ -690,6 +690,12 @@ export type BackfillPlanHistoryOperation = {
690
690
  * Override the stranded-obligation gate on each reclose. Only needed when a matured classified obligation without a drafted entry exists inside the backfill window and you have decided not to draft or void it first.
691
691
  */
692
692
  allow_stranded_obligations?: boolean;
693
+ /**
694
+ * Allow Reconciling Items
695
+ *
696
+ * Override the reconciling-item gate on each reclose. Only needed when an event inside the backfill window is still flagged as changed upstream and you have decided not to resolve it first.
697
+ */
698
+ allow_reconciling_items?: boolean;
693
699
  /**
694
700
  * Restamp
695
701
  *
@@ -1616,6 +1622,12 @@ export type ClosePeriodOperation = {
1616
1622
  * Override the stranded-obligation gate — close even though matured classified obligations have no drafted closing entry, knowingly omitting those adjusting entries from the period. Prefer running promote-obligations with dispatch_handlers=true (which drafts them) or voiding the obligations instead. The override is recorded in the close audit note.
1617
1623
  */
1618
1624
  allow_stranded_obligations?: boolean;
1625
+ /**
1626
+ * Allow Reconciling Items
1627
+ *
1628
+ * Override the reconciling-item gate — close even though posted events in the period are still flagged as changed in the source system, leaving those differences undecided. The next sync will still report them, and the statements stamped by this close may disagree with the source. Prefer resolve-reconciling-item on each first. The override is recorded in the close audit note.
1629
+ */
1630
+ allow_reconciling_items?: boolean;
1619
1631
  /**
1620
1632
  * Period
1621
1633
  *
@@ -4078,7 +4090,7 @@ export type DeleteSubgraphOp = {
4078
4090
  /**
4079
4091
  * Backup First
4080
4092
  *
4081
- * Create a backup before deleting
4093
+ * Take a full backup of the subgraph before deleting it. The backup is registered on the parent graph's backup list, where it can be listed and downloaded after the subgraph is gone. If the backup fails the subgraph is not deleted.
4082
4094
  */
4083
4095
  backup_first?: boolean;
4084
4096
  };
@@ -4534,15 +4546,15 @@ export type ElementSummary = {
4534
4546
  /**
4535
4547
  * Total
4536
4548
  *
4537
- * Sum of values across the returned facts
4549
+ * Sum of values across the returned facts. Duration elements only — a balance summed across periods is not a balance, so instants omit it.
4538
4550
  */
4539
- total: number;
4551
+ total?: number | null;
4540
4552
  /**
4541
4553
  * Average
4542
4554
  *
4543
- * Mean value across the returned facts
4555
+ * Mean value across the returned facts. Duration elements only; omitted for instants.
4544
4556
  */
4545
- average: number;
4557
+ average?: number | null;
4546
4558
  /**
4547
4559
  * Min
4548
4560
  *
@@ -5719,6 +5731,18 @@ export type FiscalCalendarResponse = {
5719
5731
  * Sample of up to 5 stranded obligations (schedule_id, schedule_name, period, event_id) ordered by occurred_at.
5720
5732
  */
5721
5733
  stranded_obligation_sample?: Array<PendingObligationDetailResponse>;
5734
+ /**
5735
+ * Reconciling Item Count
5736
+ *
5737
+ * Posted events in or before this period whose source payload changed afterwards and that nobody has dispositioned — differences between the books and the source system. Resolve each with resolve-reconciling-item, or close over them knowingly with allow_reconciling_items.
5738
+ */
5739
+ reconciling_item_count?: number;
5740
+ /**
5741
+ * Reconciling Item Sample
5742
+ *
5743
+ * Source identifiers (or event ids) of up to 5 unresolved reconciling items, so the blocker names what is holding the close.
5744
+ */
5745
+ reconciling_item_sample?: Array<string>;
5722
5746
  /**
5723
5747
  * Last Close At
5724
5748
  */
@@ -8315,7 +8339,7 @@ export type LiveFinancialStatementRequest = {
8315
8339
  /**
8316
8340
  * Statement Type
8317
8341
  *
8318
- * income_statement | balance_sheet | cash_flow_statement | equity_statement
8342
+ * income_statement | balance_sheet | cash_flow_statement | equity_statement. ``equity_statement`` is provisional — equity balances, not a rollforward — and is not offered on the MCP surface until it articulates.
8319
8343
  */
8320
8344
  statement_type: string;
8321
8345
  /**
@@ -8345,7 +8369,7 @@ export type LiveFinancialStatementRequest = {
8345
8369
  /**
8346
8370
  * Limit
8347
8371
  *
8348
- * Max fact rows returned
8372
+ * Max fact rows returned. Defaults to the ceiling so a statement is never cut mid-section — visible rows would stop footing to visible subtotals. Lower it only for a preview.
8349
8373
  */
8350
8374
  limit?: number;
8351
8375
  };
@@ -8365,6 +8389,8 @@ export type LiveFinancialStatementResponse = {
8365
8389
  statement_type: string;
8366
8390
  /**
8367
8391
  * Periods
8392
+ *
8393
+ * Rendered columns, aligned with each row's ``values``. Current and prior for income_statement and balance_sheet; current only for cash_flow_statement — the prior period is pivoted as the indirect-method delta basis and not rendered.
8368
8394
  */
8369
8395
  periods: Array<PeriodSpec>;
8370
8396
  /**
@@ -8375,6 +8401,10 @@ export type LiveFinancialStatementResponse = {
8375
8401
  * Fact Count
8376
8402
  */
8377
8403
  fact_count: number;
8404
+ /**
8405
+ * Guard-rail outcome for the rendered columns — accounting equation, net-income equation, totals footing, operating-plug size. Null only when no structure rendered.
8406
+ */
8407
+ validation?: ValidationCheckResponse | null;
8378
8408
  /**
8379
8409
  * Unmapped Count
8380
8410
  */
@@ -8434,48 +8464,6 @@ export type LoginRequest = {
8434
8464
  */
8435
8465
  password: string;
8436
8466
  };
8437
- /**
8438
- * MCPToolCall
8439
- *
8440
- * Request model for MCP tool execution.
8441
- */
8442
- export type McpToolCall = {
8443
- /**
8444
- * Name
8445
- *
8446
- * Name of the MCP tool to execute
8447
- */
8448
- name: string;
8449
- /**
8450
- * Arguments
8451
- *
8452
- * Arguments to pass to the tool
8453
- */
8454
- arguments?: {
8455
- [key: string]: unknown;
8456
- };
8457
- };
8458
- /**
8459
- * MCPToolsResponse
8460
- *
8461
- * Response model for MCP tools listing.
8462
- */
8463
- export type McpToolsResponse = {
8464
- /**
8465
- * Tools
8466
- *
8467
- * List of available MCP tools with their schemas
8468
- */
8469
- tools: Array<{
8470
- [key: string]: unknown;
8471
- }>;
8472
- /**
8473
- * Instructions
8474
- *
8475
- * Per-graph routing guidance for MCP clients, tailored to the graph's category and live tool set. Clients should pass this to the MCP server's `instructions` handshake field so it is always in the agent's context.
8476
- */
8477
- instructions?: string | null;
8478
- };
8479
8467
  /**
8480
8468
  * MaterializeOp
8481
8469
  *
@@ -8812,6 +8800,86 @@ export type OAuthCallbackResponse = {
8812
8800
  */
8813
8801
  auto_sync_task_id?: string | null;
8814
8802
  };
8803
+ /**
8804
+ * OAuthGrantInfo
8805
+ *
8806
+ * A connected app: one OAuth consent for one client on one graph.
8807
+ */
8808
+ export type OAuthGrantInfo = {
8809
+ /**
8810
+ * Id
8811
+ *
8812
+ * Grant ID
8813
+ */
8814
+ id: string;
8815
+ /**
8816
+ * Client Name
8817
+ *
8818
+ * The connected client's display name
8819
+ */
8820
+ client_name: string;
8821
+ /**
8822
+ * Client Uri
8823
+ *
8824
+ * The client's homepage, if declared
8825
+ */
8826
+ client_uri?: string | null;
8827
+ /**
8828
+ * Client Is Trusted
8829
+ *
8830
+ * Whether the client is on the trusted list (pre-registered, or a known metadata-document host). Untrusted clients registered themselves.
8831
+ */
8832
+ client_is_trusted: boolean;
8833
+ /**
8834
+ * Graph Id
8835
+ *
8836
+ * The one graph this consent reaches
8837
+ */
8838
+ graph_id: string;
8839
+ /**
8840
+ * Graph Name
8841
+ *
8842
+ * The graph's display name, when the graph still exists
8843
+ */
8844
+ graph_name?: string | null;
8845
+ /**
8846
+ * Resource
8847
+ *
8848
+ * The MCP URL the grant's tokens are bound to (their audience)
8849
+ */
8850
+ resource: string;
8851
+ /**
8852
+ * Scope
8853
+ *
8854
+ * Granted scopes, space-separated
8855
+ */
8856
+ scope: string;
8857
+ /**
8858
+ * Created At
8859
+ *
8860
+ * When the user consented
8861
+ */
8862
+ created_at: string;
8863
+ /**
8864
+ * Last Used At
8865
+ *
8866
+ * Last token use, if any
8867
+ */
8868
+ last_used_at?: string | null;
8869
+ };
8870
+ /**
8871
+ * OAuthGrantsResponse
8872
+ *
8873
+ * Response model for listing connected apps.
8874
+ */
8875
+ export type OAuthGrantsResponse = {
8876
+ /**
8877
+ * Grants
8878
+ *
8879
+ * Active OAuth grants, newest first
8880
+ */
8881
+ grants: Array<OAuthGrantInfo>;
8882
+ };
8815
8883
  /**
8816
8884
  * OAuthInitRequest
8817
8885
  *
@@ -10479,6 +10547,51 @@ export type OperationEnvelopePublishListResponse = {
10479
10547
  */
10480
10548
  idempotentReplay?: boolean;
10481
10549
  };
10550
+ /**
10551
+ * OperationEnvelope[ReconcilingItemPlan]
10552
+ */
10553
+ export type OperationEnvelopeReconcilingItemPlan = {
10554
+ /**
10555
+ * Operation
10556
+ *
10557
+ * Kebab-case operation name
10558
+ */
10559
+ operation: string;
10560
+ /**
10561
+ * Operationid
10562
+ *
10563
+ * op_-prefixed ULID for audit and SSE correlation
10564
+ */
10565
+ operationId: string;
10566
+ /**
10567
+ * Status
10568
+ *
10569
+ * Operation lifecycle state
10570
+ */
10571
+ status: 'completed' | 'pending' | 'failed';
10572
+ /**
10573
+ * Command-specific result payload
10574
+ */
10575
+ result?: ReconcilingItemPlan | null;
10576
+ /**
10577
+ * At
10578
+ *
10579
+ * ISO-8601 UTC timestamp
10580
+ */
10581
+ at: string;
10582
+ /**
10583
+ * Createdby
10584
+ *
10585
+ * User ID that initiated the operation (null for legacy callers)
10586
+ */
10587
+ createdBy?: string | null;
10588
+ /**
10589
+ * Idempotentreplay
10590
+ *
10591
+ * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
10592
+ */
10593
+ idempotentReplay?: boolean;
10594
+ };
10482
10595
  /**
10483
10596
  * OperationEnvelope[ReportResponse]
10484
10597
  */
@@ -10524,6 +10637,51 @@ export type OperationEnvelopeReportResponse = {
10524
10637
  */
10525
10638
  idempotentReplay?: boolean;
10526
10639
  };
10640
+ /**
10641
+ * OperationEnvelope[ResolveReconcilingItemResponse]
10642
+ */
10643
+ export type OperationEnvelopeResolveReconcilingItemResponse = {
10644
+ /**
10645
+ * Operation
10646
+ *
10647
+ * Kebab-case operation name
10648
+ */
10649
+ operation: string;
10650
+ /**
10651
+ * Operationid
10652
+ *
10653
+ * op_-prefixed ULID for audit and SSE correlation
10654
+ */
10655
+ operationId: string;
10656
+ /**
10657
+ * Status
10658
+ *
10659
+ * Operation lifecycle state
10660
+ */
10661
+ status: 'completed' | 'pending' | 'failed';
10662
+ /**
10663
+ * Command-specific result payload
10664
+ */
10665
+ result?: ResolveReconcilingItemResponse | null;
10666
+ /**
10667
+ * At
10668
+ *
10669
+ * ISO-8601 UTC timestamp
10670
+ */
10671
+ at: string;
10672
+ /**
10673
+ * Createdby
10674
+ *
10675
+ * User ID that initiated the operation (null for legacy callers)
10676
+ */
10677
+ createdBy?: string | null;
10678
+ /**
10679
+ * Idempotentreplay
10680
+ *
10681
+ * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
10682
+ */
10683
+ idempotentReplay?: boolean;
10684
+ };
10527
10685
  /**
10528
10686
  * OperationEnvelope[RevokeReportShareResponse]
10529
10687
  */
@@ -10886,6 +11044,21 @@ export type OperationEnvelopeListPublishListMemberResponse = {
10886
11044
  */
10887
11045
  idempotentReplay?: boolean;
10888
11046
  };
11047
+ /**
11048
+ * OperationResumeRequest
11049
+ *
11050
+ * Answer for an operation paused at a checkpoint (`awaiting_input`).
11051
+ */
11052
+ export type OperationResumeRequest = {
11053
+ /**
11054
+ * Input
11055
+ *
11056
+ * The decision the paused run asked for, in whatever shape its prompt described. Delivered to the task as `params['resume']['input']`.
11057
+ */
11058
+ input?: {
11059
+ [key: string]: unknown;
11060
+ };
11061
+ };
10889
11062
  /**
10890
11063
  * OperatorListResponse
10891
11064
  *
@@ -11053,6 +11226,12 @@ export type OperatorRequest = {
11053
11226
  * Enable streaming response
11054
11227
  */
11055
11228
  stream?: boolean;
11229
+ /**
11230
+ * Max Credits
11231
+ *
11232
+ * Per-question credit ceiling. Once the run's consumed credits reach this number, no further tool step starts and the operator answers from what it has (the wrap-up itself may carry the total slightly past the ceiling). Omit for the mode's default step-bounded behavior.
11233
+ */
11234
+ max_credits?: number | null;
11056
11235
  };
11057
11236
  /**
11058
11237
  * OperatorResponse
@@ -12327,6 +12506,19 @@ export type PreviewEventBlockResponse = {
12327
12506
  [key: string]: unknown;
12328
12507
  };
12329
12508
  };
12509
+ /**
12510
+ * PreviewReconcilingItemRequest
12511
+ *
12512
+ * Read what changed on a reconciling item, and what resolving it would do.
12513
+ */
12514
+ export type PreviewReconcilingItemRequest = {
12515
+ /**
12516
+ * Event Id
12517
+ *
12518
+ * Event id (evt_ prefixed) to inspect
12519
+ */
12520
+ event_id: string;
12521
+ };
12330
12522
  /**
12331
12523
  * PromoteObligationsRequest
12332
12524
  *
@@ -12593,67 +12785,290 @@ export type RebuildScheduleRequest = {
12593
12785
  structure_id: string;
12594
12786
  };
12595
12787
  /**
12596
- * RecoveryCodesRequest
12788
+ * ReconcilingItemCatchUp
12597
12789
  *
12598
- * Re-authentication proof for regenerating recovery codes.
12790
+ * The catch-up entry a resolution posted.
12599
12791
  */
12600
- export type RecoveryCodesRequest = {
12792
+ export type ReconcilingItemCatchUp = {
12601
12793
  /**
12602
- * Password
12603
- *
12604
- * Current password (password-holding users)
12794
+ * Event Id
12605
12795
  */
12606
- password?: string | null;
12796
+ event_id: string;
12607
12797
  /**
12608
- * Assertion
12609
- *
12610
- * Fresh WebAuthn assertion from the re-auth ceremony
12798
+ * Entry Id
12611
12799
  */
12612
- assertion?: {
12613
- [key: string]: unknown;
12614
- } | null;
12615
- };
12616
- /**
12617
- * RecoveryCodesResponse
12618
- *
12619
- * A fresh recovery-code set — shown exactly once.
12620
- */
12621
- export type RecoveryCodesResponse = {
12800
+ entry_id?: string | null;
12622
12801
  /**
12623
- * Codes
12624
- *
12625
- * Single-use recovery codes
12802
+ * Transaction Id
12626
12803
  */
12627
- codes: Array<string>;
12804
+ transaction_id?: string | null;
12805
+ /**
12806
+ * Posting Date
12807
+ */
12808
+ posting_date: string;
12809
+ /**
12810
+ * Status
12811
+ */
12812
+ status: string;
12628
12813
  };
12629
12814
  /**
12630
- * RegenerateReportOperation
12815
+ * ReconcilingItemDeltaLine
12631
12816
  *
12632
- * Regenerate facts for an existing Report. Carries `report_id` from
12633
- * the path-style RPC body; period overrides are inherited from
12634
- * :class:`RegenerateReportRequest`.
12817
+ * One account's net change between the posted entries and the new payload.
12818
+ *
12819
+ * Amounts are signed minor units in debit-positive convention: a positive
12820
+ * figure is a net debit, a negative one a net credit. ``delta`` is what a
12821
+ * catch-up entry would post to bring the books level.
12635
12822
  */
12636
- export type RegenerateReportOperation = {
12823
+ export type ReconcilingItemDeltaLine = {
12637
12824
  /**
12638
- * Period Start
12825
+ * Element Id
12639
12826
  *
12640
- * New current-period start. Optional — omit to keep the existing window.
12827
+ * CoA element id; null when the account is unmapped
12641
12828
  */
12642
- period_start?: string | null;
12829
+ element_id?: string | null;
12643
12830
  /**
12644
- * Period End
12831
+ * Element External Id
12645
12832
  *
12646
- * New current-period end. Optional — omit to keep the existing window.
12833
+ * Source-system account id, when the line carried one
12647
12834
  */
12648
- period_end?: string | null;
12835
+ element_external_id?: string | null;
12649
12836
  /**
12650
- * Periods
12837
+ * Element Code
12651
12838
  *
12652
- * New explicit period columns. Overrides `period_start`/`period_end` when supplied.
12839
+ * Account code
12653
12840
  */
12654
- periods?: Array<PeriodSpec> | null;
12841
+ element_code?: string | null;
12655
12842
  /**
12656
- * Report Id
12843
+ * Element Name
12844
+ *
12845
+ * Account name
12846
+ */
12847
+ element_name?: string | null;
12848
+ /**
12849
+ * Prior Net
12850
+ *
12851
+ * Net of the posted entries, debit-positive
12852
+ */
12853
+ prior_net: number;
12854
+ /**
12855
+ * Accepted Net
12856
+ *
12857
+ * Net of the new payload, debit-positive
12858
+ */
12859
+ accepted_net: number;
12860
+ /**
12861
+ * Delta
12862
+ *
12863
+ * accepted_net - prior_net
12864
+ */
12865
+ delta: number;
12866
+ };
12867
+ /**
12868
+ * ReconcilingItemEntrySummary
12869
+ *
12870
+ * One entry on either side of the comparison.
12871
+ */
12872
+ export type ReconcilingItemEntrySummary = {
12873
+ /**
12874
+ * Entry Id
12875
+ *
12876
+ * Entry id; null for the accepted side, which is not posted yet
12877
+ */
12878
+ entry_id?: string | null;
12879
+ /**
12880
+ * External Id
12881
+ */
12882
+ external_id?: string | null;
12883
+ /**
12884
+ * Posting Date
12885
+ */
12886
+ posting_date?: string | null;
12887
+ /**
12888
+ * Memo
12889
+ */
12890
+ memo?: string | null;
12891
+ /**
12892
+ * Status
12893
+ *
12894
+ * Entry status; null on the accepted side
12895
+ */
12896
+ status?: string | null;
12897
+ /**
12898
+ * Total Debit
12899
+ */
12900
+ total_debit?: number;
12901
+ /**
12902
+ * Total Credit
12903
+ */
12904
+ total_credit?: number;
12905
+ };
12906
+ /**
12907
+ * ReconcilingItemPlan
12908
+ *
12909
+ * What changed upstream, and what each disposition would do about it.
12910
+ */
12911
+ export type ReconcilingItemPlan = {
12912
+ /**
12913
+ * Event Id
12914
+ */
12915
+ event_id: string;
12916
+ /**
12917
+ * External Id
12918
+ */
12919
+ external_id?: string | null;
12920
+ /**
12921
+ * Source
12922
+ */
12923
+ source: string;
12924
+ /**
12925
+ * Event Type
12926
+ */
12927
+ event_type: string;
12928
+ /**
12929
+ * Event Status
12930
+ */
12931
+ event_status: string;
12932
+ /**
12933
+ * Drift Detected At
12934
+ *
12935
+ * When the sync first saw this difference
12936
+ */
12937
+ drift_detected_at?: string | null;
12938
+ /**
12939
+ * Default Disposition
12940
+ *
12941
+ * What resolve would do with no disposition given: restate while every affected period is open, catch_up once one is closed.
12942
+ */
12943
+ default_disposition: 'restate' | 'catch_up' | 'acknowledge';
12944
+ /**
12945
+ * Default Posting Date
12946
+ *
12947
+ * Where a catch-up entry would land by default
12948
+ */
12949
+ default_posting_date?: string | null;
12950
+ /**
12951
+ * Affected Posting Dates
12952
+ *
12953
+ * Posting dates of the event's entries
12954
+ */
12955
+ affected_posting_dates?: Array<string>;
12956
+ /**
12957
+ * Closed Periods
12958
+ *
12959
+ * Names of closed periods the event's entries sit in
12960
+ */
12961
+ closed_periods?: Array<string>;
12962
+ /**
12963
+ * Prior Entries
12964
+ */
12965
+ prior_entries?: Array<ReconcilingItemEntrySummary>;
12966
+ /**
12967
+ * Accepted Entries
12968
+ */
12969
+ accepted_entries?: Array<ReconcilingItemEntrySummary>;
12970
+ /**
12971
+ * Delta
12972
+ *
12973
+ * Per-account net change; empty when none
12974
+ */
12975
+ delta?: Array<ReconcilingItemDeltaLine>;
12976
+ /**
12977
+ * No Gl Effect
12978
+ *
12979
+ * The change moves no money — a memo or reference edit. catch_up posts nothing; restate still regenerates so the entries carry the new text.
12980
+ */
12981
+ no_gl_effect?: boolean;
12982
+ /**
12983
+ * Restate Blockers
12984
+ *
12985
+ * Why restate is unavailable, if it is: a closed period, an entry that was reversed or is not posted, or entries from elsewhere sharing this event's transaction.
12986
+ */
12987
+ restate_blockers?: Array<string>;
12988
+ /**
12989
+ * Unmapped Element External Ids
12990
+ *
12991
+ * Accounts in the new payload with no mapping in this graph. Both dispositions that write need them mapped first.
12992
+ */
12993
+ unmapped_element_external_ids?: Array<string>;
12994
+ };
12995
+ /**
12996
+ * ReconcilingItemRegenerated
12997
+ *
12998
+ * The entries a restate rebuilt.
12999
+ */
13000
+ export type ReconcilingItemRegenerated = {
13001
+ /**
13002
+ * Transaction Ids
13003
+ */
13004
+ transaction_ids?: Array<string>;
13005
+ /**
13006
+ * Entry Ids
13007
+ */
13008
+ entry_ids?: Array<string>;
13009
+ };
13010
+ /**
13011
+ * RecoveryCodesRequest
13012
+ *
13013
+ * Re-authentication proof for regenerating recovery codes.
13014
+ */
13015
+ export type RecoveryCodesRequest = {
13016
+ /**
13017
+ * Password
13018
+ *
13019
+ * Current password (password-holding users)
13020
+ */
13021
+ password?: string | null;
13022
+ /**
13023
+ * Assertion
13024
+ *
13025
+ * Fresh WebAuthn assertion from the re-auth ceremony
13026
+ */
13027
+ assertion?: {
13028
+ [key: string]: unknown;
13029
+ } | null;
13030
+ };
13031
+ /**
13032
+ * RecoveryCodesResponse
13033
+ *
13034
+ * A fresh recovery-code set — shown exactly once.
13035
+ */
13036
+ export type RecoveryCodesResponse = {
13037
+ /**
13038
+ * Codes
13039
+ *
13040
+ * Single-use recovery codes
13041
+ */
13042
+ codes: Array<string>;
13043
+ };
13044
+ /**
13045
+ * RegenerateReportOperation
13046
+ *
13047
+ * Regenerate facts for an existing Report. Carries `report_id` from
13048
+ * the path-style RPC body; period overrides are inherited from
13049
+ * :class:`RegenerateReportRequest`.
13050
+ */
13051
+ export type RegenerateReportOperation = {
13052
+ /**
13053
+ * Period Start
13054
+ *
13055
+ * New current-period start. Optional — omit to keep the existing window.
13056
+ */
13057
+ period_start?: string | null;
13058
+ /**
13059
+ * Period End
13060
+ *
13061
+ * New current-period end. Optional — omit to keep the existing window.
13062
+ */
13063
+ period_end?: string | null;
13064
+ /**
13065
+ * Periods
13066
+ *
13067
+ * New explicit period columns. Overrides `period_start`/`period_end` when supplied.
13068
+ */
13069
+ periods?: Array<PeriodSpec> | null;
13070
+ /**
13071
+ * Report Id
12657
13072
  *
12658
13073
  * The Report to regenerate.
12659
13074
  */
@@ -13167,6 +13582,100 @@ export type ResetPasswordValidateResponse = {
13167
13582
  */
13168
13583
  email?: string | null;
13169
13584
  };
13585
+ /**
13586
+ * ResolveReconcilingItemRequest
13587
+ *
13588
+ * Dispose of one reconciling item and clear its flag.
13589
+ */
13590
+ export type ResolveReconcilingItemRequest = {
13591
+ /**
13592
+ * Event Id
13593
+ *
13594
+ * Event id (evt_ prefixed) to resolve
13595
+ */
13596
+ event_id: string;
13597
+ /**
13598
+ * Disposition
13599
+ *
13600
+ * How to dispose of the difference. Omit to take the default the preview reports: restate when every period the event touches is open, catch_up when any is closed.
13601
+ */
13602
+ disposition?: 'restate' | 'catch_up' | 'acknowledge' | null;
13603
+ /**
13604
+ * Posting Date
13605
+ *
13606
+ * catch_up only: when to post the catch-up entry. Defaults to the end of the earliest open period.
13607
+ */
13608
+ posting_date?: string | null;
13609
+ /**
13610
+ * Status
13611
+ *
13612
+ * catch_up only: whether the catch-up entry is drafted for review at close (default) or posted immediately. A draft appears in list-period-drafts and posts locally when the period closes.
13613
+ */
13614
+ status?: 'draft' | 'posted';
13615
+ /**
13616
+ * Note
13617
+ *
13618
+ * Why this disposition. Required for acknowledge, where it is the only record of what was done instead.
13619
+ */
13620
+ note?: string | null;
13621
+ /**
13622
+ * Reference Event Id
13623
+ *
13624
+ * acknowledge only: the event that already handled this difference (e.g. an alignment entry authored by hand), recorded on the trail.
13625
+ */
13626
+ reference_event_id?: string | null;
13627
+ };
13628
+ /**
13629
+ * ResolveReconcilingItemResponse
13630
+ *
13631
+ * The outcome of resolving one reconciling item.
13632
+ */
13633
+ export type ResolveReconcilingItemResponse = {
13634
+ /**
13635
+ * Event Id
13636
+ */
13637
+ event_id: string;
13638
+ /**
13639
+ * External Id
13640
+ */
13641
+ external_id?: string | null;
13642
+ /**
13643
+ * Disposition
13644
+ */
13645
+ disposition: 'restate' | 'catch_up' | 'acknowledge';
13646
+ /**
13647
+ * Delta
13648
+ */
13649
+ delta?: Array<ReconcilingItemDeltaLine>;
13650
+ /**
13651
+ * No Gl Effect
13652
+ */
13653
+ no_gl_effect?: boolean;
13654
+ /**
13655
+ * Present when the disposition posted a catch-up entry
13656
+ */
13657
+ catch_up?: ReconcilingItemCatchUp | null;
13658
+ /**
13659
+ * Present when the disposition rebuilt the event's entries
13660
+ */
13661
+ regenerated?: ReconcilingItemRegenerated | null;
13662
+ /**
13663
+ * Reference Event Id
13664
+ */
13665
+ reference_event_id?: string | null;
13666
+ /**
13667
+ * Note
13668
+ */
13669
+ note?: string | null;
13670
+ /**
13671
+ * Resolved At
13672
+ */
13673
+ resolved_at: string;
13674
+ /**
13675
+ * Resolved By
13676
+ */
13677
+ resolved_by: string;
13678
+ };
13170
13679
  /**
13171
13680
  * ResolvedReportInfo
13172
13681
  *
@@ -16713,6 +17222,47 @@ export type UserResponse = {
16713
17222
  */
16714
17223
  accounts?: Array<AccountInfo>;
16715
17224
  };
17225
+ /**
17226
+ * ValidationCheckResponse
17227
+ *
17228
+ * Aggregate result of running reporting rules over a structure.
17229
+ *
17230
+ * Every rule runs once per rendered period column; on a multi-column
17231
+ * statement each failure and warning is prefixed with the column it was
17232
+ * found in (``[Prior] …``).
17233
+ */
17234
+ export type ValidationCheckResponse = {
17235
+ /**
17236
+ * Passed
17237
+ *
17238
+ * True iff at least one rule ran and every rule produced zero failures on every rendered column. False when nothing was checked (`status == 'inconclusive'`).
17239
+ */
17240
+ passed: boolean;
17241
+ /**
17242
+ * Status
17243
+ *
17244
+ * `passed` — every rule ran on every column with zero failures; `failed` — at least one rule failed; `inconclusive` — no validation rules exist for this block type, so nothing was checked.
17245
+ */
17246
+ status: string;
17247
+ /**
17248
+ * Checks
17249
+ *
17250
+ * Names of rules that were evaluated.
17251
+ */
17252
+ checks: Array<string>;
17253
+ /**
17254
+ * Failures
17255
+ *
17256
+ * Human-readable descriptions of rule failures.
17257
+ */
17258
+ failures: Array<string>;
17259
+ /**
17260
+ * Warnings
17261
+ *
17262
+ * Non-blocking advisories from rule evaluation.
17263
+ */
17264
+ warnings: Array<string>;
17265
+ };
16716
17266
  /**
16717
17267
  * ValidationError
16718
17268
  */
@@ -16755,6 +17305,10 @@ export type ValidationLite = {
16755
17305
  * Passed
16756
17306
  */
16757
17307
  passed?: boolean;
17308
+ /**
17309
+ * Status
17310
+ */
17311
+ status?: string;
16758
17312
  /**
16759
17313
  * Checks
16760
17314
  */
@@ -17038,7 +17592,7 @@ export type ViewResponse = {
17038
17592
  /**
17039
17593
  * Summary
17040
17594
  *
17041
- * Per-element aggregates, only when include_summary=true. Note that `total` sums across every returned period, which is meaningful for duration facts and not for instants. Overlapping duration windows sharing a period_end (quarter + year-to-date) contribute only the narrowest window, so a quarter is never double-counted inside its own YTD figure.
17595
+ * Per-element aggregates, only when include_summary=true. `total` and `average` span every returned period, so they are present for duration elements only — instants omit both (a balance summed across periods is not a balance). Overlapping duration windows sharing a period_end (quarter + year-to-date) contribute only the narrowest window, so a quarter is never double-counted inside its own YTD figure.
17042
17596
  */
17043
17597
  summary?: {
17044
17598
  [key: string]: ElementSummary;
@@ -18596,7 +19150,92 @@ export type UpdateUserApiKeyResponses = {
18596
19150
  */
18597
19151
  200: ApiKeyInfo;
18598
19152
  };
18599
- export type UpdateUserApiKeyResponse = UpdateUserApiKeyResponses[keyof UpdateUserApiKeyResponses];
19153
+ export type UpdateUserApiKeyResponse = UpdateUserApiKeyResponses[keyof UpdateUserApiKeyResponses];
19154
+ export type ListUserOAuthGrantsData = {
19155
+ body?: never;
19156
+ path?: never;
19157
+ query?: never;
19158
+ url: '/v1/user/oauth/grants';
19159
+ };
19160
+ export type ListUserOAuthGrantsErrors = {
19161
+ /**
19162
+ * Invalid request
19163
+ */
19164
+ 400: ErrorResponse;
19165
+ /**
19166
+ * Authentication required
19167
+ */
19168
+ 401: ErrorResponse;
19169
+ /**
19170
+ * Access denied
19171
+ */
19172
+ 403: ErrorResponse;
19173
+ /**
19174
+ * Rate limit exceeded
19175
+ */
19176
+ 429: ErrorResponse;
19177
+ /**
19178
+ * Internal server error
19179
+ */
19180
+ 500: ErrorResponse;
19181
+ };
19182
+ export type ListUserOAuthGrantsError = ListUserOAuthGrantsErrors[keyof ListUserOAuthGrantsErrors];
19183
+ export type ListUserOAuthGrantsResponses = {
19184
+ /**
19185
+ * Successful Response
19186
+ */
19187
+ 200: OAuthGrantsResponse;
19188
+ };
19189
+ export type ListUserOAuthGrantsResponse = ListUserOAuthGrantsResponses[keyof ListUserOAuthGrantsResponses];
19190
+ export type RevokeUserOAuthGrantData = {
19191
+ body?: never;
19192
+ path: {
19193
+ /**
19194
+ * Grant Id
19195
+ */
19196
+ grant_id: string;
19197
+ };
19198
+ query?: never;
19199
+ url: '/v1/user/oauth/grants/{grant_id}';
19200
+ };
19201
+ export type RevokeUserOAuthGrantErrors = {
19202
+ /**
19203
+ * Invalid request
19204
+ */
19205
+ 400: ErrorResponse;
19206
+ /**
19207
+ * Authentication required
19208
+ */
19209
+ 401: ErrorResponse;
19210
+ /**
19211
+ * Access denied
19212
+ */
19213
+ 403: ErrorResponse;
19214
+ /**
19215
+ * Resource not found
19216
+ */
19217
+ 404: ErrorResponse;
19218
+ /**
19219
+ * Validation Error
19220
+ */
19221
+ 422: HttpValidationError;
19222
+ /**
19223
+ * Rate limit exceeded
19224
+ */
19225
+ 429: ErrorResponse;
19226
+ /**
19227
+ * Internal server error
19228
+ */
19229
+ 500: ErrorResponse;
19230
+ };
19231
+ export type RevokeUserOAuthGrantError = RevokeUserOAuthGrantErrors[keyof RevokeUserOAuthGrantErrors];
19232
+ export type RevokeUserOAuthGrantResponses = {
19233
+ /**
19234
+ * Successful Response
19235
+ */
19236
+ 200: SuccessResponse;
19237
+ };
19238
+ export type RevokeUserOAuthGrantResponse = RevokeUserOAuthGrantResponses[keyof RevokeUserOAuthGrantResponses];
18600
19239
  export type ListUserOrgsData = {
18601
19240
  body?: never;
18602
19241
  path?: never;
@@ -19830,7 +20469,7 @@ export type AutoSelectOperatorData = {
19830
20469
  /**
19831
20470
  * Mode
19832
20471
  *
19833
- * Override execution mode: sync, async, stream, or auto
20472
+ * `sync` waits up to 50s for the answer and returns 200 with it (202 with the operation links if the worker is still busy). Anything else — `async`, `stream`, `auto` or unset — queues the run and returns 202; follow `_links.stream` for progress and the result.
19834
20473
  */
19835
20474
  mode?: ResponseMode | null;
19836
20475
  };
@@ -19877,7 +20516,7 @@ export type AutoSelectOperatorResponses = {
19877
20516
  */
19878
20517
  200: OperatorResponse;
19879
20518
  /**
19880
- * Query queued for async processing
20519
+ * Run queued on the worker — follow `_links.stream`
19881
20520
  */
19882
20521
  202: unknown;
19883
20522
  };
@@ -19953,7 +20592,7 @@ export type ExecuteSpecificOperatorData = {
19953
20592
  /**
19954
20593
  * Mode
19955
20594
  *
19956
- * Override execution mode: sync, async, stream, or auto
20595
+ * `sync` waits up to 50s for the answer and returns 200 with it (202 with the operation links if the worker is still busy). Anything else — `async`, `stream`, `auto` or unset — queues the run and returns 202; follow `_links.stream` for progress and the result.
19957
20596
  */
19958
20597
  mode?: ResponseMode | null;
19959
20598
  };
@@ -20000,133 +20639,11 @@ export type ExecuteSpecificOperatorResponses = {
20000
20639
  */
20001
20640
  200: OperatorResponse;
20002
20641
  /**
20003
- * Query queued for async processing
20642
+ * Run queued on the worker — follow `_links.stream`
20004
20643
  */
20005
20644
  202: unknown;
20006
20645
  };
20007
20646
  export type ExecuteSpecificOperatorResponse = ExecuteSpecificOperatorResponses[keyof ExecuteSpecificOperatorResponses];
20008
- export type ListMcpToolsData = {
20009
- body?: never;
20010
- path: {
20011
- /**
20012
- * Graph Id
20013
- */
20014
- graph_id: string;
20015
- };
20016
- query?: never;
20017
- url: '/v1/graphs/{graph_id}/mcp/tools';
20018
- };
20019
- export type ListMcpToolsErrors = {
20020
- /**
20021
- * Invalid request
20022
- */
20023
- 400: ErrorResponse;
20024
- /**
20025
- * Authentication required
20026
- */
20027
- 401: ErrorResponse;
20028
- /**
20029
- * Access denied
20030
- */
20031
- 403: ErrorResponse;
20032
- /**
20033
- * Resource not found
20034
- */
20035
- 404: ErrorResponse;
20036
- /**
20037
- * Validation Error
20038
- */
20039
- 422: HttpValidationError;
20040
- /**
20041
- * Rate limit exceeded
20042
- */
20043
- 429: ErrorResponse;
20044
- /**
20045
- * Internal server error
20046
- */
20047
- 500: ErrorResponse;
20048
- };
20049
- export type ListMcpToolsError = ListMcpToolsErrors[keyof ListMcpToolsErrors];
20050
- export type ListMcpToolsResponses = {
20051
- /**
20052
- * Successful Response
20053
- */
20054
- 200: McpToolsResponse;
20055
- };
20056
- export type ListMcpToolsResponse = ListMcpToolsResponses[keyof ListMcpToolsResponses];
20057
- export type CallMcpToolData = {
20058
- body: McpToolCall;
20059
- path: {
20060
- /**
20061
- * Graph Id
20062
- */
20063
- graph_id: string;
20064
- };
20065
- query?: {
20066
- /**
20067
- * Format
20068
- *
20069
- * Response format override (json, sse, ndjson)
20070
- */
20071
- format?: string | null;
20072
- /**
20073
- * Test Mode
20074
- *
20075
- * Enable test mode for debugging
20076
- */
20077
- test_mode?: boolean;
20078
- };
20079
- url: '/v1/graphs/{graph_id}/mcp/call-tool';
20080
- };
20081
- export type CallMcpToolErrors = {
20082
- /**
20083
- * Invalid request
20084
- */
20085
- 400: ErrorResponse;
20086
- /**
20087
- * Authentication required
20088
- */
20089
- 401: ErrorResponse;
20090
- /**
20091
- * Access denied
20092
- */
20093
- 403: ErrorResponse;
20094
- /**
20095
- * Resource not found
20096
- */
20097
- 404: ErrorResponse;
20098
- /**
20099
- * Execution timeout
20100
- */
20101
- 408: unknown;
20102
- /**
20103
- * Validation Error
20104
- */
20105
- 422: HttpValidationError;
20106
- /**
20107
- * Rate limit exceeded
20108
- */
20109
- 429: ErrorResponse;
20110
- /**
20111
- * Internal server error
20112
- */
20113
- 500: ErrorResponse;
20114
- /**
20115
- * Service unavailable
20116
- */
20117
- 503: unknown;
20118
- };
20119
- export type CallMcpToolError = CallMcpToolErrors[keyof CallMcpToolErrors];
20120
- export type CallMcpToolResponses = {
20121
- /**
20122
- * Successful Response
20123
- */
20124
- 200: unknown;
20125
- /**
20126
- * Tool queued for execution
20127
- */
20128
- 202: unknown;
20129
- };
20130
20647
  export type ListBackupsData = {
20131
20648
  body?: never;
20132
20649
  path: {
@@ -23447,6 +23964,65 @@ export type CancelOperationResponses = {
23447
23964
  };
23448
23965
  };
23449
23966
  export type CancelOperationResponse = CancelOperationResponses[keyof CancelOperationResponses];
23967
+ export type ResumeOperationData = {
23968
+ body: OperationResumeRequest;
23969
+ path: {
23970
+ /**
23971
+ * Operation Id
23972
+ *
23973
+ * Operation identifier
23974
+ */
23975
+ operation_id: string;
23976
+ };
23977
+ query?: never;
23978
+ url: '/v1/operations/{operation_id}/resume';
23979
+ };
23980
+ export type ResumeOperationErrors = {
23981
+ /**
23982
+ * Invalid request
23983
+ */
23984
+ 400: ErrorResponse;
23985
+ /**
23986
+ * Authentication required
23987
+ */
23988
+ 401: ErrorResponse;
23989
+ /**
23990
+ * Access denied
23991
+ */
23992
+ 403: ErrorResponse;
23993
+ /**
23994
+ * Resource not found
23995
+ */
23996
+ 404: ErrorResponse;
23997
+ /**
23998
+ * Operation is not waiting for input
23999
+ */
24000
+ 409: unknown;
24001
+ /**
24002
+ * Validation Error
24003
+ */
24004
+ 422: HttpValidationError;
24005
+ /**
24006
+ * Rate limit exceeded
24007
+ */
24008
+ 429: ErrorResponse;
24009
+ /**
24010
+ * Internal server error
24011
+ */
24012
+ 500: ErrorResponse;
24013
+ };
24014
+ export type ResumeOperationError = ResumeOperationErrors[keyof ResumeOperationErrors];
24015
+ export type ResumeOperationResponses = {
24016
+ /**
24017
+ * Response Resumeoperation
24018
+ *
24019
+ * Successful Response
24020
+ */
24021
+ 202: {
24022
+ [key: string]: unknown;
24023
+ };
24024
+ };
24025
+ export type ResumeOperationResponse = ResumeOperationResponses[keyof ResumeOperationResponses];
23450
24026
  export type GetOrgBillingCustomerData = {
23451
24027
  body?: never;
23452
24028
  path: {
@@ -25512,6 +26088,124 @@ export type PreviewEventBlockResponses = {
25512
26088
  200: OperationEnvelopePreviewEventBlockResponse;
25513
26089
  };
25514
26090
  export type PreviewEventBlockResponse2 = PreviewEventBlockResponses[keyof PreviewEventBlockResponses];
26091
+ export type PreviewReconcilingItemData = {
26092
+ body: PreviewReconcilingItemRequest;
26093
+ headers?: {
26094
+ /**
26095
+ * Idempotency-Key
26096
+ */
26097
+ 'Idempotency-Key'?: string | null;
26098
+ };
26099
+ path: {
26100
+ /**
26101
+ * Graph Id
26102
+ */
26103
+ graph_id: string;
26104
+ };
26105
+ query?: never;
26106
+ url: '/extensions/roboledger/{graph_id}/operations/preview-reconciling-item';
26107
+ };
26108
+ export type PreviewReconcilingItemErrors = {
26109
+ /**
26110
+ * Invalid request
26111
+ */
26112
+ 400: ErrorResponse;
26113
+ /**
26114
+ * Authentication required
26115
+ */
26116
+ 401: ErrorResponse;
26117
+ /**
26118
+ * Access denied
26119
+ */
26120
+ 403: ErrorResponse;
26121
+ /**
26122
+ * Resource not found
26123
+ */
26124
+ 404: ErrorResponse;
26125
+ /**
26126
+ * Idempotency-Key conflict — key reused with different body
26127
+ */
26128
+ 409: ErrorResponse;
26129
+ /**
26130
+ * Validation error
26131
+ */
26132
+ 422: ErrorResponse;
26133
+ /**
26134
+ * Rate limit exceeded
26135
+ */
26136
+ 429: ErrorResponse;
26137
+ /**
26138
+ * Internal server error
26139
+ */
26140
+ 500: ErrorResponse;
26141
+ };
26142
+ export type PreviewReconcilingItemError = PreviewReconcilingItemErrors[keyof PreviewReconcilingItemErrors];
26143
+ export type PreviewReconcilingItemResponses = {
26144
+ /**
26145
+ * Successful Response
26146
+ */
26147
+ 200: OperationEnvelopeReconcilingItemPlan;
26148
+ };
26149
+ export type PreviewReconcilingItemResponse = PreviewReconcilingItemResponses[keyof PreviewReconcilingItemResponses];
26150
+ export type ResolveReconcilingItemData = {
26151
+ body: ResolveReconcilingItemRequest;
26152
+ headers?: {
26153
+ /**
26154
+ * Idempotency-Key
26155
+ */
26156
+ 'Idempotency-Key'?: string | null;
26157
+ };
26158
+ path: {
26159
+ /**
26160
+ * Graph Id
26161
+ */
26162
+ graph_id: string;
26163
+ };
26164
+ query?: never;
26165
+ url: '/extensions/roboledger/{graph_id}/operations/resolve-reconciling-item';
26166
+ };
26167
+ export type ResolveReconcilingItemErrors = {
26168
+ /**
26169
+ * Invalid request
26170
+ */
26171
+ 400: ErrorResponse;
26172
+ /**
26173
+ * Authentication required
26174
+ */
26175
+ 401: ErrorResponse;
26176
+ /**
26177
+ * Access denied
26178
+ */
26179
+ 403: ErrorResponse;
26180
+ /**
26181
+ * Resource not found
26182
+ */
26183
+ 404: ErrorResponse;
26184
+ /**
26185
+ * Idempotency-Key conflict — key reused with different body
26186
+ */
26187
+ 409: ErrorResponse;
26188
+ /**
26189
+ * Validation error
26190
+ */
26191
+ 422: ErrorResponse;
26192
+ /**
26193
+ * Rate limit exceeded
26194
+ */
26195
+ 429: ErrorResponse;
26196
+ /**
26197
+ * Internal server error
26198
+ */
26199
+ 500: ErrorResponse;
26200
+ };
26201
+ export type ResolveReconcilingItemError = ResolveReconcilingItemErrors[keyof ResolveReconcilingItemErrors];
26202
+ export type ResolveReconcilingItemResponses = {
26203
+ /**
26204
+ * Successful Response
26205
+ */
26206
+ 200: OperationEnvelopeResolveReconcilingItemResponse;
26207
+ };
26208
+ export type ResolveReconcilingItemResponse2 = ResolveReconcilingItemResponses[keyof ResolveReconcilingItemResponses];
25515
26209
  export type UpdateJournalEntryData = {
25516
26210
  body: UpdateJournalEntryRequest;
25517
26211
  headers?: {