@robosystems/client 1.1.0 → 1.3.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/types.gen.ts CHANGED
@@ -58,6 +58,12 @@ export type ApiKeyInfo = {
58
58
  * Creation timestamp
59
59
  */
60
60
  created_at: string;
61
+ /**
62
+ * Graph Id
63
+ *
64
+ * Graph scope; null means account-wide
65
+ */
66
+ graph_id?: string | null;
61
67
  };
62
68
 
63
69
  /**
@@ -651,6 +657,12 @@ export type BackfillPlanHistoryOperation = {
651
657
  * Override the sync-currency gate on each reclose. Historical months predate the last sync in the normal case, so this is rarely needed.
652
658
  */
653
659
  allow_stale_sync?: boolean;
660
+ /**
661
+ * Allow Stranded Obligations
662
+ *
663
+ * 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.
664
+ */
665
+ allow_stranded_obligations?: boolean;
654
666
  /**
655
667
  * Restamp
656
668
  *
@@ -910,6 +922,12 @@ export type BackupResponse = {
910
922
  * Allow Export
911
923
  */
912
924
  allow_export: boolean;
925
+ /**
926
+ * Download Extension
927
+ *
928
+ * Extension the download will carry, and therefore how to unpack it: '.lbug.zip' is a ZIP holding the LadybugDB database file, '.lbug.zst' is zstd-compressed (`zstd -d`). Null when the backup is encrypted and so cannot be downloaded.
929
+ */
930
+ download_extension?: string | null;
913
931
  /**
914
932
  * Created At
915
933
  */
@@ -978,52 +996,6 @@ export type BackupStatsResponse = {
978
996
  };
979
997
  };
980
998
 
981
- /**
982
- * BatchOperatorRequest
983
- *
984
- * Request for batch processing multiple queries.
985
- */
986
- export type BatchOperatorRequest = {
987
- /**
988
- * Queries
989
- *
990
- * List of queries to process (max 10)
991
- */
992
- queries: Array<OperatorRequest>;
993
- /**
994
- * Parallel
995
- *
996
- * Process queries in parallel
997
- */
998
- parallel?: boolean;
999
- };
1000
-
1001
- /**
1002
- * BatchOperatorResponse
1003
- *
1004
- * Response for batch processing.
1005
- */
1006
- export type BatchOperatorResponse = {
1007
- /**
1008
- * Results
1009
- *
1010
- * List of operator responses (includes successes and failures)
1011
- */
1012
- results: Array<OperatorResponse>;
1013
- /**
1014
- * Total Execution Time
1015
- *
1016
- * Total execution time in seconds
1017
- */
1018
- total_execution_time: number;
1019
- /**
1020
- * Parallel Processed
1021
- *
1022
- * Whether queries were processed in parallel
1023
- */
1024
- parallel_processed: boolean;
1025
- };
1026
-
1027
999
  /**
1028
1000
  * BillingCustomer
1029
1001
  *
@@ -1522,6 +1494,12 @@ export type ClosePeriodOperation = {
1522
1494
  * Override the sync-currency gate. Only use when you have manually verified that the source data for the period is complete.
1523
1495
  */
1524
1496
  allow_stale_sync?: boolean;
1497
+ /**
1498
+ * Allow Stranded Obligations
1499
+ *
1500
+ * 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.
1501
+ */
1502
+ allow_stranded_obligations?: boolean;
1525
1503
  /**
1526
1504
  * Period
1527
1505
  *
@@ -1544,9 +1522,21 @@ export type ClosePeriodResponse = {
1544
1522
  /**
1545
1523
  * Entries Posted
1546
1524
  *
1547
- * Number of draft entries transitioned to posted
1525
+ * Total draft entries the close transitioned to posted, across both post paths (QB pre-publish + local bulk transition). See entries_published_to_qb / entries_posted_locally for the split.
1548
1526
  */
1549
1527
  entries_posted?: number;
1528
+ /**
1529
+ * Entries Published To Qb
1530
+ *
1531
+ * Drafts published to QuickBooks by the close's pre-publish step (each is promoted to posted at publish time).
1532
+ */
1533
+ entries_published_to_qb?: number;
1534
+ /**
1535
+ * Entries Posted Locally
1536
+ *
1537
+ * Drafts posted by the local bulk transition (entries that don't publish to QuickBooks, e.g. native-only graphs or local-only sources).
1538
+ */
1539
+ entries_posted_locally?: number;
1550
1540
  /**
1551
1541
  * Target Auto Advanced
1552
1542
  *
@@ -2126,6 +2116,12 @@ export type CreateApiKeyRequest = {
2126
2116
  * Optional expiration date in ISO format (e.g. 2024-12-31T23:59:59Z)
2127
2117
  */
2128
2118
  expires_at?: string | null;
2119
+ /**
2120
+ * Graph Id
2121
+ *
2122
+ * Optional graph scope. A scoped key works only for this graph (and its subgraphs) and is the only kind of key accepted in an MCP connector URL. Omit for an account-wide key.
2123
+ */
2124
+ graph_id?: string | null;
2129
2125
  };
2130
2126
 
2131
2127
  /**
@@ -4932,6 +4928,12 @@ export type EventBlockEnvelope = {
4932
4928
  metadata: {
4933
4929
  [key: string]: unknown;
4934
4930
  };
4931
+ /**
4932
+ * Payload Drift
4933
+ *
4934
+ * True when a source re-sync surfaced a changed upstream payload for an event whose GL is already posted (committed/fulfilled are immutable to sync). The live payload and GL are untouched; the incoming payload is stashed in `metadata.drift_payload` with `metadata.drift_detected_at`. Drifted events need operator reconciliation — the local books no longer mirror the source.
4935
+ */
4936
+ payload_drift?: boolean;
4935
4937
  /**
4936
4938
  * Dimension Ids
4937
4939
  *
@@ -5642,7 +5644,7 @@ export type FiscalCalendarResponse = {
5642
5644
  /**
5643
5645
  * Blockers
5644
5646
  *
5645
- * Structured blocker codes when closeable_now is False: 'sequence_violation', 'period_incomplete', 'sync_stale', 'calendar_not_initialized', 'period_already_closed', 'pending_obligations'
5647
+ * Structured blocker codes when closeable_now is False: 'sequence_violation', 'period_incomplete', 'sync_stale', 'calendar_not_initialized', 'period_already_closed', 'pending_obligations', 'stranded_obligations'
5646
5648
  */
5647
5649
  blockers?: Array<string>;
5648
5650
  /**
@@ -5669,6 +5671,18 @@ export type FiscalCalendarResponse = {
5669
5671
  * Days the most recent sync is stale relative to the period to close. Populated only when `sync_stale` is in `blockers` and last_sync_at exists (null when there's a connection but no sync has ever run).
5670
5672
  */
5671
5673
  sync_stale_days?: number | null;
5674
+ /**
5675
+ * Stranded Obligation Count
5676
+ *
5677
+ * Matured schedule_entry_due events already at 'classified' with no drafted closing entry for their (schedule, period) — adjusting entries a close would silently omit. Resolve by running promote-obligations with dispatch_handlers=true (which reaches them) or voiding the obligation.
5678
+ */
5679
+ stranded_obligation_count?: number;
5680
+ /**
5681
+ * Stranded Obligation Sample
5682
+ *
5683
+ * Sample of up to 5 stranded obligations (schedule_id, schedule_name, period, event_id) ordered by occurred_at.
5684
+ */
5685
+ stranded_obligation_sample?: Array<PendingObligationDetailResponse>;
5672
5686
  /**
5673
5687
  * Last Close At
5674
5688
  */
@@ -6117,6 +6131,10 @@ export type GraphLimitsResponse = {
6117
6131
  * Knowledge-base document usage and tier cap (user graphs only)
6118
6132
  */
6119
6133
  documents?: DocumentLimits | null;
6134
+ /**
6135
+ * Subgraph count and tier cap (parent user graphs only)
6136
+ */
6137
+ subgraphs?: SubgraphLimits | null;
6120
6138
  /**
6121
6139
  * Per-operation materialization limits (if applicable)
6122
6140
  */
@@ -10695,86 +10713,6 @@ export type OperatorMetadataResponse = {
10695
10713
  */
10696
10714
  export type OperatorMode = 'quick' | 'standard' | 'extended' | 'streaming';
10697
10715
 
10698
- /**
10699
- * OperatorRecommendation
10700
- *
10701
- * Single operator recommendation.
10702
- */
10703
- export type OperatorRecommendation = {
10704
- /**
10705
- * Operator Type
10706
- *
10707
- * Operator type identifier
10708
- */
10709
- operator_type: string;
10710
- /**
10711
- * Operator Name
10712
- *
10713
- * Operator display name
10714
- */
10715
- operator_name: string;
10716
- /**
10717
- * Confidence
10718
- *
10719
- * Confidence score (0-1)
10720
- */
10721
- confidence: number;
10722
- /**
10723
- * Capabilities
10724
- *
10725
- * Operator capabilities
10726
- */
10727
- capabilities: Array<string>;
10728
- /**
10729
- * Reason
10730
- *
10731
- * Reason for recommendation
10732
- */
10733
- reason?: string | null;
10734
- };
10735
-
10736
- /**
10737
- * OperatorRecommendationRequest
10738
- *
10739
- * Request for operator recommendations.
10740
- */
10741
- export type OperatorRecommendationRequest = {
10742
- /**
10743
- * Query
10744
- *
10745
- * Query to analyze
10746
- */
10747
- query: string;
10748
- /**
10749
- * Context
10750
- *
10751
- * Additional context
10752
- */
10753
- context?: {
10754
- [key: string]: unknown;
10755
- } | null;
10756
- };
10757
-
10758
- /**
10759
- * OperatorRecommendationResponse
10760
- *
10761
- * Response for operator recommendations.
10762
- */
10763
- export type OperatorRecommendationResponse = {
10764
- /**
10765
- * Recommendations
10766
- *
10767
- * List of operator recommendations sorted by confidence
10768
- */
10769
- recommendations: Array<OperatorRecommendation>;
10770
- /**
10771
- * Query
10772
- *
10773
- * The analyzed query
10774
- */
10775
- query: string;
10776
- };
10777
-
10778
10716
  /**
10779
10717
  * OperatorRequest
10780
10718
  *
@@ -11980,7 +11918,9 @@ export type PreviewEventBlockResponse = {
11980
11918
  * Flips matured ``pending`` ``schedule_entry_due`` events (period boundary
11981
11919
  * passed) to ``classified``; with ``dispatch_handlers`` it also drafts the
11982
11920
  * closing entries in the same transaction (idempotent — reconciles to an
11983
- * existing draft).
11921
+ * existing draft). The sweep also reaches *stranded* obligations —
11922
+ * already ``classified`` (by an earlier flip-only sweep) but with no
11923
+ * closing entry ever drafted — dispatching them in the same pass.
11984
11924
  */
11985
11925
  export type PromoteObligationsRequest = {
11986
11926
  /**
@@ -12015,10 +11955,22 @@ export type PromoteObligationsResponse = {
12015
11955
  * Per-obligation handler errors (non-fatal).
12016
11956
  */
12017
11957
  error_count: number;
11958
+ /**
11959
+ * Stranded Count
11960
+ *
11961
+ * Matured obligations found already at 'classified' with no drafted closing entry. With dispatch_handlers=true they were drafted this run (included in dispatched_count); with dispatch_handlers=false they still have no draft — re-run with dispatch_handlers=true or void them.
11962
+ */
11963
+ stranded_count?: number;
12018
11964
  /**
12019
11965
  * Classified Event Ids
12020
11966
  */
12021
11967
  classified_event_ids?: Array<string>;
11968
+ /**
11969
+ * Stranded Event Ids
11970
+ *
11971
+ * Event ids of the stranded obligations found this sweep.
11972
+ */
11973
+ stranded_event_ids?: Array<string>;
12022
11974
  /**
12023
11975
  * Errors
12024
11976
  *
@@ -14227,53 +14179,39 @@ export type StructureUpdatePatch = {
14227
14179
  };
14228
14180
 
14229
14181
  /**
14230
- * SubgraphQuotaResponse
14182
+ * SubgraphLimits
14183
+ *
14184
+ * Subgraph count against the parent graph tier's cap.
14231
14185
  *
14232
- * Response model for subgraph quota information.
14186
+ * Subgraphs are refused at the tier cap regardless of how small they are,
14187
+ * so this is a count axis independent of the storage one — ``instance``
14188
+ * already itemizes their footprint.
14233
14189
  */
14234
- export type SubgraphQuotaResponse = {
14235
- /**
14236
- * Parent Graph Id
14237
- *
14238
- * Parent graph identifier
14239
- */
14240
- parent_graph_id: string;
14241
- /**
14242
- * Tier
14243
- *
14244
- * Graph tier
14245
- */
14246
- tier: string;
14190
+ export type SubgraphLimits = {
14247
14191
  /**
14248
14192
  * Current Count
14249
14193
  *
14250
- * Current number of subgraphs
14194
+ * Subgraphs currently provisioned under this graph
14251
14195
  */
14252
14196
  current_count: number;
14253
14197
  /**
14254
14198
  * Max Allowed
14255
14199
  *
14256
- * Maximum allowed subgraphs (None = unlimited)
14200
+ * Maximum subgraphs for this tier (null when uncapped)
14257
14201
  */
14258
14202
  max_allowed?: number | null;
14259
14203
  /**
14260
14204
  * Remaining
14261
14205
  *
14262
- * Remaining subgraphs that can be created
14206
+ * Subgraphs that can still be created (null when uncapped)
14263
14207
  */
14264
14208
  remaining?: number | null;
14265
14209
  /**
14266
- * Total Size Mb
14267
- *
14268
- * Total size of all subgraphs
14269
- */
14270
- total_size_mb?: number | null;
14271
- /**
14272
- * Max Size Mb
14210
+ * Approaching Limit
14273
14211
  *
14274
- * Maximum allowed total size
14212
+ * Whether approaching subgraph limit (>80%)
14275
14213
  */
14276
- max_size_mb?: number | null;
14214
+ approaching_limit: boolean;
14277
14215
  };
14278
14216
 
14279
14217
  /**
@@ -19439,118 +19377,6 @@ export type ExecuteSpecificOperatorResponses = {
19439
19377
 
19440
19378
  export type ExecuteSpecificOperatorResponse = ExecuteSpecificOperatorResponses[keyof ExecuteSpecificOperatorResponses];
19441
19379
 
19442
- export type BatchProcessQueriesData = {
19443
- body: BatchOperatorRequest;
19444
- path: {
19445
- /**
19446
- * Graph Id
19447
- */
19448
- graph_id: string;
19449
- };
19450
- query?: never;
19451
- url: '/v1/graphs/{graph_id}/operator/batch';
19452
- };
19453
-
19454
- export type BatchProcessQueriesErrors = {
19455
- /**
19456
- * Invalid request
19457
- */
19458
- 400: ErrorResponse;
19459
- /**
19460
- * Authentication required
19461
- */
19462
- 401: ErrorResponse;
19463
- /**
19464
- * Insufficient credits
19465
- */
19466
- 402: unknown;
19467
- /**
19468
- * Access denied
19469
- */
19470
- 403: ErrorResponse;
19471
- /**
19472
- * Resource not found
19473
- */
19474
- 404: ErrorResponse;
19475
- /**
19476
- * Validation Error
19477
- */
19478
- 422: HttpValidationError;
19479
- /**
19480
- * Rate limit exceeded
19481
- */
19482
- 429: ErrorResponse;
19483
- /**
19484
- * Internal server error
19485
- */
19486
- 500: ErrorResponse;
19487
- };
19488
-
19489
- export type BatchProcessQueriesError = BatchProcessQueriesErrors[keyof BatchProcessQueriesErrors];
19490
-
19491
- export type BatchProcessQueriesResponses = {
19492
- /**
19493
- * Successful Response
19494
- */
19495
- 200: BatchOperatorResponse;
19496
- };
19497
-
19498
- export type BatchProcessQueriesResponse = BatchProcessQueriesResponses[keyof BatchProcessQueriesResponses];
19499
-
19500
- export type RecommendOperatorData = {
19501
- body: OperatorRecommendationRequest;
19502
- path: {
19503
- /**
19504
- * Graph Id
19505
- */
19506
- graph_id: string;
19507
- };
19508
- query?: never;
19509
- url: '/v1/graphs/{graph_id}/operator/recommend';
19510
- };
19511
-
19512
- export type RecommendOperatorErrors = {
19513
- /**
19514
- * Invalid request
19515
- */
19516
- 400: ErrorResponse;
19517
- /**
19518
- * Authentication required
19519
- */
19520
- 401: ErrorResponse;
19521
- /**
19522
- * Access denied
19523
- */
19524
- 403: ErrorResponse;
19525
- /**
19526
- * Resource not found
19527
- */
19528
- 404: ErrorResponse;
19529
- /**
19530
- * Validation Error
19531
- */
19532
- 422: HttpValidationError;
19533
- /**
19534
- * Rate limit exceeded
19535
- */
19536
- 429: ErrorResponse;
19537
- /**
19538
- * Internal server error
19539
- */
19540
- 500: ErrorResponse;
19541
- };
19542
-
19543
- export type RecommendOperatorError = RecommendOperatorErrors[keyof RecommendOperatorErrors];
19544
-
19545
- export type RecommendOperatorResponses = {
19546
- /**
19547
- * Successful Response
19548
- */
19549
- 200: OperatorRecommendationResponse;
19550
- };
19551
-
19552
- export type RecommendOperatorResponse = RecommendOperatorResponses[keyof RecommendOperatorResponses];
19553
-
19554
19380
  export type ListMcpToolsData = {
19555
19381
  body?: never;
19556
19382
  path: {
@@ -20923,60 +20749,6 @@ export type GetSubgraphInfoResponses = {
20923
20749
 
20924
20750
  export type GetSubgraphInfoResponse = GetSubgraphInfoResponses[keyof GetSubgraphInfoResponses];
20925
20751
 
20926
- export type GetSubgraphQuotaData = {
20927
- body?: never;
20928
- path: {
20929
- /**
20930
- * Graph Id
20931
- */
20932
- graph_id: string;
20933
- };
20934
- query?: never;
20935
- url: '/v1/graphs/{graph_id}/subgraphs/quota';
20936
- };
20937
-
20938
- export type GetSubgraphQuotaErrors = {
20939
- /**
20940
- * Invalid request
20941
- */
20942
- 400: ErrorResponse;
20943
- /**
20944
- * Authentication required
20945
- */
20946
- 401: ErrorResponse;
20947
- /**
20948
- * Access denied
20949
- */
20950
- 403: ErrorResponse;
20951
- /**
20952
- * Resource not found
20953
- */
20954
- 404: ErrorResponse;
20955
- /**
20956
- * Validation Error
20957
- */
20958
- 422: HttpValidationError;
20959
- /**
20960
- * Rate limit exceeded
20961
- */
20962
- 429: ErrorResponse;
20963
- /**
20964
- * Internal server error
20965
- */
20966
- 500: ErrorResponse;
20967
- };
20968
-
20969
- export type GetSubgraphQuotaError = GetSubgraphQuotaErrors[keyof GetSubgraphQuotaErrors];
20970
-
20971
- export type GetSubgraphQuotaResponses = {
20972
- /**
20973
- * Successful Response
20974
- */
20975
- 200: SubgraphQuotaResponse;
20976
- };
20977
-
20978
- export type GetSubgraphQuotaResponse = GetSubgraphQuotaResponses[keyof GetSubgraphQuotaResponses];
20979
-
20980
20752
  export type GetGraphSubscriptionData = {
20981
20753
  body?: never;
20982
20754
  path: {