@robosystems/client 0.2.13 → 0.2.15

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
@@ -776,73 +776,6 @@ export type BillingCustomer = {
776
776
  created_at: string;
777
777
  };
778
778
 
779
- /**
780
- * BulkIngestRequest
781
- */
782
- export type BulkIngestRequest = {
783
- /**
784
- * Ignore Errors
785
- * Continue ingestion on row errors
786
- */
787
- ignore_errors?: boolean;
788
- /**
789
- * Rebuild
790
- * Rebuild graph database from scratch before ingestion. Safe operation - staged data is the source of truth, graph can always be regenerated.
791
- */
792
- rebuild?: boolean;
793
- };
794
-
795
- /**
796
- * BulkIngestResponse
797
- */
798
- export type BulkIngestResponse = {
799
- /**
800
- * Status
801
- * Overall ingestion status
802
- */
803
- status: string;
804
- /**
805
- * Graph Id
806
- * Graph database identifier
807
- */
808
- graph_id: string;
809
- /**
810
- * Total Tables
811
- * Total number of tables processed
812
- */
813
- total_tables: number;
814
- /**
815
- * Successful Tables
816
- * Number of successfully ingested tables
817
- */
818
- successful_tables: number;
819
- /**
820
- * Failed Tables
821
- * Number of failed table ingestions
822
- */
823
- failed_tables: number;
824
- /**
825
- * Skipped Tables
826
- * Number of skipped tables (no files)
827
- */
828
- skipped_tables: number;
829
- /**
830
- * Total Rows Ingested
831
- * Total rows ingested across all tables
832
- */
833
- total_rows_ingested: number;
834
- /**
835
- * Total Execution Time Ms
836
- * Total execution time in milliseconds
837
- */
838
- total_execution_time_ms: number;
839
- /**
840
- * Results
841
- * Per-table ingestion results
842
- */
843
- results: Array<TableIngestResult>;
844
- };
845
-
846
779
  /**
847
780
  * CheckoutResponse
848
781
  * Response from checkout session creation.
@@ -1257,6 +1190,40 @@ export type CreateSubgraphRequest = {
1257
1190
  metadata?: {
1258
1191
  [key: string]: unknown;
1259
1192
  } | null;
1193
+ /**
1194
+ * Fork Parent
1195
+ * If true, copy all data from parent graph to create a 'fork'
1196
+ */
1197
+ fork_parent?: boolean;
1198
+ };
1199
+
1200
+ /**
1201
+ * CreateViewRequest
1202
+ */
1203
+ export type CreateViewRequest = {
1204
+ /**
1205
+ * Name
1206
+ * Optional name for the view
1207
+ */
1208
+ name?: string | null;
1209
+ /**
1210
+ * Data source configuration
1211
+ */
1212
+ source: ViewSource;
1213
+ /**
1214
+ * View configuration
1215
+ */
1216
+ view_config?: ViewConfig;
1217
+ /**
1218
+ * Presentation Formats
1219
+ * Presentation formats to generate
1220
+ */
1221
+ presentation_formats?: Array<string>;
1222
+ /**
1223
+ * Mapping Structure Id
1224
+ * Optional mapping structure ID to aggregate Chart of Accounts elements into reporting taxonomy elements
1225
+ */
1226
+ mapping_structure_id?: string | null;
1260
1227
  };
1261
1228
 
1262
1229
  /**
@@ -1608,6 +1575,21 @@ export type DeleteFileResponse = {
1608
1575
  * Operation message
1609
1576
  */
1610
1577
  message: string;
1578
+ /**
1579
+ * Cascade Deleted
1580
+ * Whether cascade deletion was performed
1581
+ */
1582
+ cascade_deleted?: boolean;
1583
+ /**
1584
+ * Tables Affected
1585
+ * Tables from which file data was deleted (if cascade=true)
1586
+ */
1587
+ tables_affected?: Array<string> | null;
1588
+ /**
1589
+ * Graph Marked Stale
1590
+ * Whether graph was marked as stale
1591
+ */
1592
+ graph_marked_stale?: boolean;
1611
1593
  };
1612
1594
 
1613
1595
  /**
@@ -1756,6 +1738,24 @@ export type EnhancedCreditTransactionResponse = {
1756
1738
  user_id?: string | null;
1757
1739
  };
1758
1740
 
1741
+ /**
1742
+ * EnhancedFileStatusLayers
1743
+ */
1744
+ export type EnhancedFileStatusLayers = {
1745
+ /**
1746
+ * S3 layer status (immutable source)
1747
+ */
1748
+ s3: FileLayerStatus;
1749
+ /**
1750
+ * DuckDB layer status (mutable staging)
1751
+ */
1752
+ duckdb: FileLayerStatus;
1753
+ /**
1754
+ * Graph layer status (immutable materialized view)
1755
+ */
1756
+ graph: FileLayerStatus;
1757
+ };
1758
+
1759
1759
  /**
1760
1760
  * ErrorResponse
1761
1761
  * Standard error response format used across all API endpoints.
@@ -1810,6 +1810,40 @@ export type ExchangeTokenRequest = {
1810
1810
  } | null;
1811
1811
  };
1812
1812
 
1813
+ /**
1814
+ * FactDetail
1815
+ */
1816
+ export type FactDetail = {
1817
+ /**
1818
+ * Fact Id
1819
+ */
1820
+ fact_id: string;
1821
+ /**
1822
+ * Element Uri
1823
+ */
1824
+ element_uri: string;
1825
+ /**
1826
+ * Element Name
1827
+ */
1828
+ element_name: string;
1829
+ /**
1830
+ * Numeric Value
1831
+ */
1832
+ numeric_value: number;
1833
+ /**
1834
+ * Unit
1835
+ */
1836
+ unit: string;
1837
+ /**
1838
+ * Period Start
1839
+ */
1840
+ period_start: string;
1841
+ /**
1842
+ * Period End
1843
+ */
1844
+ period_end: string;
1845
+ };
1846
+
1813
1847
  /**
1814
1848
  * FileInfo
1815
1849
  */
@@ -1866,6 +1900,32 @@ export type FileInfo = {
1866
1900
  s3_key: string;
1867
1901
  };
1868
1902
 
1903
+ /**
1904
+ * FileLayerStatus
1905
+ */
1906
+ export type FileLayerStatus = {
1907
+ /**
1908
+ * Status
1909
+ * Layer status
1910
+ */
1911
+ status: string;
1912
+ /**
1913
+ * Timestamp
1914
+ * Status timestamp
1915
+ */
1916
+ timestamp?: string | null;
1917
+ /**
1918
+ * Row Count
1919
+ * Row count (if available)
1920
+ */
1921
+ row_count?: number | null;
1922
+ /**
1923
+ * Size Bytes
1924
+ * Size in bytes (S3 layer only)
1925
+ */
1926
+ size_bytes?: number | null;
1927
+ };
1928
+
1869
1929
  /**
1870
1930
  * FileStatusUpdate
1871
1931
  */
@@ -1875,6 +1935,11 @@ export type FileStatusUpdate = {
1875
1935
  * File status: 'uploaded' (ready for ingest), 'disabled' (exclude from ingest), 'archived' (soft deleted)
1876
1936
  */
1877
1937
  status: string;
1938
+ /**
1939
+ * Ingest To Graph
1940
+ * Auto-ingest to graph after DuckDB staging. Default=false (batch mode). Set to true for real-time incremental updates.
1941
+ */
1942
+ ingest_to_graph?: boolean;
1878
1943
  };
1879
1944
 
1880
1945
  /**
@@ -1891,6 +1956,11 @@ export type FileUploadRequest = {
1891
1956
  * File MIME type
1892
1957
  */
1893
1958
  content_type?: string;
1959
+ /**
1960
+ * Table Name
1961
+ * Table name to associate file with (required for first-class /files endpoint)
1962
+ */
1963
+ table_name?: string | null;
1894
1964
  };
1895
1965
 
1896
1966
  /**
@@ -2000,6 +2070,10 @@ export type GetFileInfoResponse = {
2000
2070
  * S3 object key
2001
2071
  */
2002
2072
  s3_key: string;
2073
+ /**
2074
+ * Multi-layer pipeline status (S3 → DuckDB → Graph). Shows status, timestamps, and row counts for each layer independently.
2075
+ */
2076
+ layers?: EnhancedFileStatusLayers | null;
2003
2077
  };
2004
2078
 
2005
2079
  /**
@@ -2925,9 +2999,9 @@ export type ListTableFilesResponse = {
2925
2999
  graph_id: string;
2926
3000
  /**
2927
3001
  * Table Name
2928
- * Table name
3002
+ * Table name (null if listing all files in graph)
2929
3003
  */
2930
- table_name: string;
3004
+ table_name?: string | null;
2931
3005
  /**
2932
3006
  * Files
2933
3007
  * List of files in the table
@@ -2995,6 +3069,119 @@ export type McpToolsResponse = {
2995
3069
  }>;
2996
3070
  };
2997
3071
 
3072
+ /**
3073
+ * MaterializeRequest
3074
+ */
3075
+ export type MaterializeRequest = {
3076
+ /**
3077
+ * Force
3078
+ * Force materialization even if graph is not stale
3079
+ */
3080
+ force?: boolean;
3081
+ /**
3082
+ * Rebuild
3083
+ * Delete and recreate graph database before materialization
3084
+ */
3085
+ rebuild?: boolean;
3086
+ /**
3087
+ * Ignore Errors
3088
+ * Continue ingestion on row errors
3089
+ */
3090
+ ignore_errors?: boolean;
3091
+ };
3092
+
3093
+ /**
3094
+ * MaterializeResponse
3095
+ */
3096
+ export type MaterializeResponse = {
3097
+ /**
3098
+ * Status
3099
+ * Materialization status
3100
+ */
3101
+ status: string;
3102
+ /**
3103
+ * Graph Id
3104
+ * Graph database identifier
3105
+ */
3106
+ graph_id: string;
3107
+ /**
3108
+ * Was Stale
3109
+ * Whether graph was stale before materialization
3110
+ */
3111
+ was_stale: boolean;
3112
+ /**
3113
+ * Stale Reason
3114
+ * Reason graph was stale
3115
+ */
3116
+ stale_reason?: string | null;
3117
+ /**
3118
+ * Tables Materialized
3119
+ * List of tables successfully materialized
3120
+ */
3121
+ tables_materialized: Array<string>;
3122
+ /**
3123
+ * Total Rows
3124
+ * Total rows materialized across all tables
3125
+ */
3126
+ total_rows: number;
3127
+ /**
3128
+ * Execution Time Ms
3129
+ * Total materialization time
3130
+ */
3131
+ execution_time_ms: number;
3132
+ /**
3133
+ * Message
3134
+ * Human-readable status message
3135
+ */
3136
+ message: string;
3137
+ };
3138
+
3139
+ /**
3140
+ * MaterializeStatusResponse
3141
+ */
3142
+ export type MaterializeStatusResponse = {
3143
+ /**
3144
+ * Graph Id
3145
+ * Graph database identifier
3146
+ */
3147
+ graph_id: string;
3148
+ /**
3149
+ * Is Stale
3150
+ * Whether graph is currently stale
3151
+ */
3152
+ is_stale: boolean;
3153
+ /**
3154
+ * Stale Reason
3155
+ * Reason for staleness if applicable
3156
+ */
3157
+ stale_reason?: string | null;
3158
+ /**
3159
+ * Stale Since
3160
+ * When graph became stale (ISO timestamp)
3161
+ */
3162
+ stale_since?: string | null;
3163
+ /**
3164
+ * Last Materialized At
3165
+ * When graph was last materialized (ISO timestamp)
3166
+ */
3167
+ last_materialized_at?: string | null;
3168
+ /**
3169
+ * Materialization Count
3170
+ * Total number of materializations performed
3171
+ */
3172
+ materialization_count?: number;
3173
+ /**
3174
+ * Hours Since Materialization
3175
+ * Hours since last materialization
3176
+ */
3177
+ hours_since_materialization?: number | null;
3178
+ /**
3179
+ * Message
3180
+ * Human-readable status summary
3181
+ */
3182
+ message: string;
3183
+ };
3184
+
2998
3185
  /**
2999
3186
  * OAuthCallbackRequest
3000
3187
  * OAuth callback parameters.
@@ -3509,17 +3696,17 @@ export type PaymentMethod = {
3509
3696
  brand?: string | null;
3510
3697
  /**
3511
3698
  * Last4
3512
- * Last 4 digits
3699
+ * Last 4 digits of the card or account number
3513
3700
  */
3514
3701
  last4?: string | null;
3515
3702
  /**
3516
3703
  * Exp Month
3517
- * Expiration month
3704
+ * Expiration month of the card
3518
3705
  */
3519
3706
  exp_month?: number | null;
3520
3707
  /**
3521
3708
  * Exp Year
3522
- * Expiration year
3709
+ * Expiration year of the card
3523
3710
  */
3524
3711
  exp_year?: number | null;
3525
3712
  /**
@@ -3908,6 +4095,107 @@ export type SsoTokenResponse = {
3908
4095
  apps: Array<string>;
3909
4096
  };
3910
4097
 
4098
+ /**
4099
+ * SaveViewRequest
4100
+ */
4101
+ export type SaveViewRequest = {
4102
+ /**
4103
+ * Report Id
4104
+ * Existing report ID to update (if provided, deletes existing facts/structures and creates new ones)
4105
+ */
4106
+ report_id?: string | null;
4107
+ /**
4108
+ * Report Type
4109
+ * Type of report (e.g., 'Annual Report', 'Quarterly Report', '10-K')
4110
+ */
4111
+ report_type: string;
4112
+ /**
4113
+ * Period Start
4114
+ * Period start date (YYYY-MM-DD)
4115
+ */
4116
+ period_start: string;
4117
+ /**
4118
+ * Period End
4119
+ * Period end date (YYYY-MM-DD)
4120
+ */
4121
+ period_end: string;
4122
+ /**
4123
+ * Entity Id
4124
+ * Entity identifier (defaults to primary entity)
4125
+ */
4126
+ entity_id?: string | null;
4127
+ /**
4128
+ * Include Presentation
4129
+ * Create presentation structures
4130
+ */
4131
+ include_presentation?: boolean;
4132
+ /**
4133
+ * Include Calculation
4134
+ * Create calculation structures
4135
+ */
4136
+ include_calculation?: boolean;
4137
+ };
4138
+
4139
+ /**
4140
+ * SaveViewResponse
4141
+ */
4142
+ export type SaveViewResponse = {
4143
+ /**
4144
+ * Report Id
4145
+ * Unique report identifier (used as parquet export prefix)
4146
+ */
4147
+ report_id: string;
4148
+ /**
4149
+ * Report Type
4150
+ */
4151
+ report_type: string;
4152
+ /**
4153
+ * Entity Id
4154
+ */
4155
+ entity_id: string;
4156
+ /**
4157
+ * Entity Name
4158
+ */
4159
+ entity_name: string;
4160
+ /**
4161
+ * Period Start
4162
+ */
4163
+ period_start: string;
4164
+ /**
4165
+ * Period End
4166
+ */
4167
+ period_end: string;
4168
+ /**
4169
+ * Fact Count
4170
+ */
4171
+ fact_count: number;
4172
+ /**
4173
+ * Presentation Count
4174
+ */
4175
+ presentation_count: number;
4176
+ /**
4177
+ * Calculation Count
4178
+ */
4179
+ calculation_count: number;
4180
+ /**
4181
+ * Facts
4182
+ */
4183
+ facts: Array<FactDetail>;
4184
+ /**
4185
+ * Structures
4186
+ */
4187
+ structures: Array<StructureDetail>;
4188
+ /**
4189
+ * Created At
4190
+ */
4191
+ created_at: string;
4192
+ /**
4193
+ * Parquet Export Prefix
4194
+ * Prefix for parquet file exports
4195
+ */
4196
+ parquet_export_prefix: string;
4197
+ };
4198
+
3911
4199
  /**
3912
4200
  * SchemaExportResponse
3913
4201
  * Response model for schema export.
@@ -4240,6 +4528,28 @@ export type StorageSummary = {
4240
4528
  measurement_count: number;
4241
4529
  };
4242
4530
 
4531
+ /**
4532
+ * StructureDetail
4533
+ */
4534
+ export type StructureDetail = {
4535
+ /**
4536
+ * Structure Id
4537
+ */
4538
+ structure_id: string;
4539
+ /**
4540
+ * Structure Type
4541
+ */
4542
+ structure_type: string;
4543
+ /**
4544
+ * Name
4545
+ */
4546
+ name: string;
4547
+ /**
4548
+ * Element Count
4549
+ */
4550
+ element_count: number;
4551
+ };
4552
+
4243
4553
  /**
4244
4554
  * SubgraphQuotaResponse
4245
4555
  * Response model for subgraph quota information.
@@ -4491,37 +4801,6 @@ export type TableInfo = {
4491
4801
  s3_location?: string | null;
4492
4802
  };
4493
4803
 
4494
- /**
4495
- * TableIngestResult
4496
- */
4497
- export type TableIngestResult = {
4498
- /**
4499
- * Table Name
4500
- * Table name
4501
- */
4502
- table_name: string;
4503
- /**
4504
- * Status
4505
- * Ingestion status (success/failed/skipped)
4506
- */
4507
- status: string;
4508
- /**
4509
- * Rows Ingested
4510
- * Number of rows ingested
4511
- */
4512
- rows_ingested?: number;
4513
- /**
4514
- * Execution Time Ms
4515
- * Ingestion time in milliseconds
4516
- */
4517
- execution_time_ms?: number;
4518
- /**
4519
- * Error
4520
- * Error message if failed
4521
- */
4522
- error?: string | null;
4523
- };
4524
-
4525
4804
  /**
4526
4805
  * TableListResponse
4527
4806
  */
@@ -4779,42 +5058,158 @@ export type UserResponse = {
4779
5058
  * Id
4780
5059
  * Unique identifier for the user
4781
5060
  */
4782
- id: string;
5061
+ id: string;
5062
+ /**
5063
+ * Name
5064
+ * User's display name
5065
+ */
5066
+ name?: string | null;
5067
+ /**
5068
+ * Email
5069
+ * User's email address
5070
+ */
5071
+ email?: string | null;
5072
+ /**
5073
+ * Accounts
5074
+ * User's authentication accounts
5075
+ */
5076
+ accounts?: Array<AccountInfo>;
5077
+ };
5078
+
5079
+ /**
5080
+ * ValidationError
5081
+ */
5082
+ export type ValidationError = {
5083
+ /**
5084
+ * Location
5085
+ */
5086
+ loc: Array<string | number>;
5087
+ /**
5088
+ * Message
5089
+ */
5090
+ msg: string;
5091
+ /**
5092
+ * Error Type
5093
+ */
5094
+ type: string;
5095
+ };
5096
+
5097
+ /**
5098
+ * ViewAxisConfig
5099
+ */
5100
+ export type ViewAxisConfig = {
5101
+ /**
5102
+ * Type
5103
+ * Axis type: 'element', 'period', 'dimension', 'entity'
5104
+ */
5105
+ type: string;
5106
+ /**
5107
+ * Dimension Axis
5108
+ * Dimension axis name for dimension-type axes
5109
+ */
5110
+ dimension_axis?: string | null;
5111
+ /**
5112
+ * Include Null Dimension
5113
+ * Include facts where this dimension is NULL (default: false)
5114
+ */
5115
+ include_null_dimension?: boolean;
5116
+ /**
5117
+ * Selected Members
5118
+ * Specific members to include (e.g., ['2024-12-31', '2023-12-31'])
5119
+ */
5120
+ selected_members?: Array<string> | null;
5121
+ /**
5122
+ * Member Order
5123
+ * Explicit ordering of members (overrides default sort)
5124
+ */
5125
+ member_order?: Array<string> | null;
5126
+ /**
5127
+ * Member Labels
5128
+ * Custom labels for members (e.g., {'2024-12-31': 'Current Year'})
5129
+ */
5130
+ member_labels?: {
5131
+ [key: string]: string;
5132
+ } | null;
5133
+ /**
5134
+ * Element Order
5135
+ * Element ordering for hierarchy display (e.g., ['us-gaap:Assets', 'us-gaap:Cash', ...])
5136
+ */
5137
+ element_order?: Array<string> | null;
5138
+ /**
5139
+ * Element Labels
5140
+ * Custom labels for elements (e.g., {'us-gaap:Cash': 'Cash and Cash Equivalents'})
5141
+ */
5142
+ element_labels?: {
5143
+ [key: string]: string;
5144
+ } | null;
5145
+ };
5146
+
5147
+ /**
5148
+ * ViewConfig
5149
+ */
5150
+ export type ViewConfig = {
5151
+ /**
5152
+ * Rows
5153
+ * Row axis configuration
5154
+ */
5155
+ rows?: Array<ViewAxisConfig>;
5156
+ /**
5157
+ * Columns
5158
+ * Column axis configuration
5159
+ */
5160
+ columns?: Array<ViewAxisConfig>;
4783
5161
  /**
4784
- * Name
4785
- * User's display name
5162
+ * Values
5163
+ * Field to use for values (default: numeric_value)
4786
5164
  */
4787
- name?: string | null;
5165
+ values?: string;
4788
5166
  /**
4789
- * Email
4790
- * User's email address
5167
+ * Aggregation Function
5168
+ * Aggregation function: sum, average, count
4791
5169
  */
4792
- email?: string | null;
5170
+ aggregation_function?: string;
4793
5171
  /**
4794
- * Accounts
4795
- * User's authentication accounts
5172
+ * Fill Value
5173
+ * Value to use for missing data
4796
5174
  */
4797
- accounts?: Array<AccountInfo>;
5175
+ fill_value?: number;
4798
5176
  };
4799
5177
 
4800
5178
  /**
4801
- * ValidationError
5179
+ * ViewSource
4802
5180
  */
4803
- export type ValidationError = {
5181
+ export type ViewSource = {
4804
5182
  /**
4805
- * Location
5183
+ * Type of data source
4806
5184
  */
4807
- loc: Array<string | number>;
5185
+ type: ViewSourceType;
4808
5186
  /**
4809
- * Message
5187
+ * Period Start
5188
+ * Start date for transaction aggregation (YYYY-MM-DD)
4810
5189
  */
4811
- msg: string;
5190
+ period_start?: string | null;
4812
5191
  /**
4813
- * Error Type
5192
+ * Period End
5193
+ * End date for transaction aggregation (YYYY-MM-DD)
4814
5194
  */
4815
- type: string;
5195
+ period_end?: string | null;
5196
+ /**
5197
+ * Fact Set Id
5198
+ * FactSet ID for existing facts mode
5199
+ */
5200
+ fact_set_id?: string | null;
5201
+ /**
5202
+ * Entity Id
5203
+ * Filter by entity (optional)
5204
+ */
5205
+ entity_id?: string | null;
4816
5206
  };
4817
5207
 
5208
+ /**
5209
+ * ViewSourceType
5210
+ */
5211
+ export type ViewSourceType = 'transactions' | 'fact_set';
5212
+
4818
5213
  export type RegisterUserData = {
4819
5214
  body: RegisterRequest;
4820
5215
  path?: never;
@@ -7604,7 +7999,7 @@ export type CreateSubgraphResponses = {
7604
7999
  /**
7605
8000
  * Successful Response
7606
8001
  */
7607
- 201: SubgraphResponse;
8002
+ 200: SubgraphResponse;
7608
8003
  };
7609
8004
 
7610
8005
  export type CreateSubgraphResponse = CreateSubgraphResponses[keyof CreateSubgraphResponses];
@@ -7617,13 +8012,13 @@ export type DeleteSubgraphData = {
7617
8012
  */
7618
8013
  graph_id: string;
7619
8014
  /**
7620
- * Subgraph Id
7621
- * Subgraph identifier to delete
8015
+ * Subgraph Name
8016
+ * Subgraph name to delete (e.g., 'dev', 'staging')
7622
8017
  */
7623
- subgraph_id: string;
8018
+ subgraph_name: string;
7624
8019
  };
7625
8020
  query?: never;
7626
- url: '/v1/graphs/{graph_id}/subgraphs/{subgraph_id}';
8021
+ url: '/v1/graphs/{graph_id}/subgraphs/{subgraph_name}';
7627
8022
  };
7628
8023
 
7629
8024
  export type DeleteSubgraphErrors = {
@@ -7676,13 +8071,13 @@ export type GetSubgraphInfoData = {
7676
8071
  */
7677
8072
  graph_id: string;
7678
8073
  /**
7679
- * Subgraph Id
7680
- * Subgraph identifier
8074
+ * Subgraph Name
8075
+ * Subgraph name (e.g., 'dev', 'staging')
7681
8076
  */
7682
- subgraph_id: string;
8077
+ subgraph_name: string;
7683
8078
  };
7684
8079
  query?: never;
7685
- url: '/v1/graphs/{graph_id}/subgraphs/{subgraph_id}/info';
8080
+ url: '/v1/graphs/{graph_id}/subgraphs/{subgraph_name}/info';
7686
8081
  };
7687
8082
 
7688
8083
  export type GetSubgraphInfoErrors = {
@@ -7924,36 +8319,42 @@ export type ListTablesResponses = {
7924
8319
 
7925
8320
  export type ListTablesResponse = ListTablesResponses[keyof ListTablesResponses];
7926
8321
 
7927
- export type ListTableFilesData = {
7928
- body?: never;
8322
+ export type QueryTablesData = {
8323
+ /**
8324
+ * SQL query request
8325
+ */
8326
+ body: TableQueryRequest;
7929
8327
  path: {
7930
8328
  /**
7931
8329
  * Graph Id
7932
8330
  */
7933
8331
  graph_id: string;
7934
- /**
7935
- * Table Name
7936
- * Table name
7937
- */
7938
- table_name: string;
7939
8332
  };
7940
8333
  query?: never;
7941
- url: '/v1/graphs/{graph_id}/tables/{table_name}/files';
8334
+ url: '/v1/graphs/{graph_id}/tables/query';
7942
8335
  };
7943
8336
 
7944
- export type ListTableFilesErrors = {
8337
+ export type QueryTablesErrors = {
8338
+ /**
8339
+ * Invalid SQL query syntax or execution error
8340
+ */
8341
+ 400: ErrorResponse;
7945
8342
  /**
7946
8343
  * Not authenticated
7947
8344
  */
7948
8345
  401: unknown;
7949
8346
  /**
7950
- * Access denied - insufficient permissions for this graph
8347
+ * Access denied - shared repositories or insufficient permissions
7951
8348
  */
7952
8349
  403: ErrorResponse;
7953
8350
  /**
7954
- * Graph or table not found
8351
+ * Graph not found
7955
8352
  */
7956
8353
  404: ErrorResponse;
8354
+ /**
8355
+ * Query timeout exceeded
8356
+ */
8357
+ 408: unknown;
7957
8358
  /**
7958
8359
  * Validation Error
7959
8360
  */
@@ -7964,48 +8365,94 @@ export type ListTableFilesErrors = {
7964
8365
  500: unknown;
7965
8366
  };
7966
8367
 
7967
- export type ListTableFilesError = ListTableFilesErrors[keyof ListTableFilesErrors];
8368
+ export type QueryTablesError = QueryTablesErrors[keyof QueryTablesErrors];
7968
8369
 
7969
- export type ListTableFilesResponses = {
8370
+ export type QueryTablesResponses = {
7970
8371
  /**
7971
- * Files retrieved successfully with full metadata
8372
+ * Query executed successfully
7972
8373
  */
7973
- 200: ListTableFilesResponse;
8374
+ 200: TableQueryResponse;
7974
8375
  };
7975
8376
 
7976
- export type ListTableFilesResponse2 = ListTableFilesResponses[keyof ListTableFilesResponses];
8377
+ export type QueryTablesResponse = QueryTablesResponses[keyof QueryTablesResponses];
7977
8378
 
7978
- export type GetUploadUrlData = {
7979
- /**
7980
- * Upload request
7981
- */
7982
- body: FileUploadRequest;
8379
+ export type CreateViewData = {
8380
+ body: CreateViewRequest;
7983
8381
  path: {
7984
8382
  /**
7985
8383
  * Graph Id
7986
8384
  */
7987
8385
  graph_id: string;
8386
+ };
8387
+ query?: never;
8388
+ url: '/v1/graphs/{graph_id}/views';
8389
+ };
8390
+
8391
+ export type CreateViewErrors = {
8392
+ /**
8393
+ * Validation Error
8394
+ */
8395
+ 422: HttpValidationError;
8396
+ };
8397
+
8398
+ export type CreateViewError = CreateViewErrors[keyof CreateViewErrors];
8399
+
8400
+ export type CreateViewResponses = {
8401
+ /**
8402
+ * Successful Response
8403
+ */
8404
+ 200: unknown;
8405
+ };
8406
+
8407
+ export type SaveViewData = {
8408
+ body: SaveViewRequest;
8409
+ path: {
7988
8410
  /**
7989
- * Table Name
7990
- * Table name
8411
+ * Graph Id
7991
8412
  */
7992
- table_name: string;
8413
+ graph_id: string;
7993
8414
  };
7994
8415
  query?: never;
7995
- url: '/v1/graphs/{graph_id}/tables/{table_name}/files';
8416
+ url: '/v1/graphs/{graph_id}/views/save';
7996
8417
  };
7997
8418
 
7998
- export type GetUploadUrlErrors = {
8419
+ export type SaveViewErrors = {
7999
8420
  /**
8000
- * Invalid file format, name, or extension mismatch
8421
+ * Validation Error
8001
8422
  */
8002
- 400: ErrorResponse;
8423
+ 422: HttpValidationError;
8424
+ };
8425
+
8426
+ export type SaveViewError = SaveViewErrors[keyof SaveViewErrors];
8427
+
8428
+ export type SaveViewResponses = {
8429
+ /**
8430
+ * Successful Response
8431
+ */
8432
+ 200: SaveViewResponse;
8433
+ };
8434
+
8435
+ export type SaveViewResponse2 = SaveViewResponses[keyof SaveViewResponses];
8436
+
8437
+ export type GetMaterializationStatusData = {
8438
+ body?: never;
8439
+ path: {
8440
+ /**
8441
+ * Graph Id
8442
+ */
8443
+ graph_id: string;
8444
+ };
8445
+ query?: never;
8446
+ url: '/v1/graphs/{graph_id}/materialize/status';
8447
+ };
8448
+
8449
+ export type GetMaterializationStatusErrors = {
8003
8450
  /**
8004
8451
  * Not authenticated
8005
8452
  */
8006
8453
  401: unknown;
8007
8454
  /**
8008
- * Access denied - shared repositories or insufficient permissions
8455
+ * Access denied - insufficient permissions
8009
8456
  */
8010
8457
  403: ErrorResponse;
8011
8458
  /**
@@ -8016,41 +8463,36 @@ export type GetUploadUrlErrors = {
8016
8463
  * Validation Error
8017
8464
  */
8018
8465
  422: HttpValidationError;
8019
- /**
8020
- * Internal server error
8021
- */
8022
- 500: unknown;
8023
8466
  };
8024
8467
 
8025
- export type GetUploadUrlError = GetUploadUrlErrors[keyof GetUploadUrlErrors];
8468
+ export type GetMaterializationStatusError = GetMaterializationStatusErrors[keyof GetMaterializationStatusErrors];
8026
8469
 
8027
- export type GetUploadUrlResponses = {
8470
+ export type GetMaterializationStatusResponses = {
8028
8471
  /**
8029
- * Upload URL generated successfully
8472
+ * Materialization status retrieved successfully
8030
8473
  */
8031
- 200: FileUploadResponse;
8474
+ 200: MaterializeStatusResponse;
8032
8475
  };
8033
8476
 
8034
- export type GetUploadUrlResponse = GetUploadUrlResponses[keyof GetUploadUrlResponses];
8477
+ export type GetMaterializationStatusResponse = GetMaterializationStatusResponses[keyof GetMaterializationStatusResponses];
8035
8478
 
8036
- export type DeleteFileData = {
8037
- body?: never;
8479
+ export type MaterializeGraphData = {
8480
+ body: MaterializeRequest;
8038
8481
  path: {
8039
8482
  /**
8040
8483
  * Graph Id
8041
8484
  */
8042
8485
  graph_id: string;
8043
- /**
8044
- * File Id
8045
- * File ID
8046
- */
8047
- file_id: string;
8048
8486
  };
8049
8487
  query?: never;
8050
- url: '/v1/graphs/{graph_id}/tables/files/{file_id}';
8488
+ url: '/v1/graphs/{graph_id}/materialize';
8051
8489
  };
8052
8490
 
8053
- export type DeleteFileErrors = {
8491
+ export type MaterializeGraphErrors = {
8492
+ /**
8493
+ * Graph not stale and force=false
8494
+ */
8495
+ 400: ErrorResponse;
8054
8496
  /**
8055
8497
  * Not authenticated
8056
8498
  */
@@ -8060,9 +8502,13 @@ export type DeleteFileErrors = {
8060
8502
  */
8061
8503
  403: ErrorResponse;
8062
8504
  /**
8063
- * File not found in graph
8505
+ * Graph not found
8064
8506
  */
8065
8507
  404: ErrorResponse;
8508
+ /**
8509
+ * Conflict - another materialization is already in progress for this graph
8510
+ */
8511
+ 409: ErrorResponse;
8066
8512
  /**
8067
8513
  * Validation Error
8068
8514
  */
@@ -8073,45 +8519,51 @@ export type DeleteFileErrors = {
8073
8519
  500: unknown;
8074
8520
  };
8075
8521
 
8076
- export type DeleteFileError = DeleteFileErrors[keyof DeleteFileErrors];
8522
+ export type MaterializeGraphError = MaterializeGraphErrors[keyof MaterializeGraphErrors];
8077
8523
 
8078
- export type DeleteFileResponses = {
8524
+ export type MaterializeGraphResponses = {
8079
8525
  /**
8080
- * File deleted successfully
8526
+ * Graph materialized successfully
8081
8527
  */
8082
- 200: DeleteFileResponse;
8528
+ 200: MaterializeResponse;
8083
8529
  };
8084
8530
 
8085
- export type DeleteFileResponse2 = DeleteFileResponses[keyof DeleteFileResponses];
8531
+ export type MaterializeGraphResponse = MaterializeGraphResponses[keyof MaterializeGraphResponses];
8086
8532
 
8087
- export type GetFileInfoData = {
8533
+ export type ListFilesData = {
8088
8534
  body?: never;
8089
8535
  path: {
8090
8536
  /**
8091
8537
  * Graph Id
8092
8538
  */
8093
8539
  graph_id: string;
8540
+ };
8541
+ query?: {
8094
8542
  /**
8095
- * File Id
8096
- * File ID
8543
+ * Table Name
8544
+ * Filter by table name (optional)
8097
8545
  */
8098
- file_id: string;
8546
+ table_name?: string | null;
8547
+ /**
8548
+ * Status
8549
+ * Filter by upload status (optional)
8550
+ */
8551
+ status?: string | null;
8099
8552
  };
8100
- query?: never;
8101
- url: '/v1/graphs/{graph_id}/tables/files/{file_id}';
8553
+ url: '/v1/graphs/{graph_id}/files';
8102
8554
  };
8103
8555
 
8104
- export type GetFileInfoErrors = {
8556
+ export type ListFilesErrors = {
8105
8557
  /**
8106
8558
  * Not authenticated
8107
8559
  */
8108
8560
  401: unknown;
8109
8561
  /**
8110
- * Access denied - insufficient permissions for this graph
8562
+ * Access denied - insufficient permissions
8111
8563
  */
8112
8564
  403: ErrorResponse;
8113
8565
  /**
8114
- * File not found in graph
8566
+ * Graph not found
8115
8567
  */
8116
8568
  404: ErrorResponse;
8117
8569
  /**
@@ -8120,40 +8572,35 @@ export type GetFileInfoErrors = {
8120
8572
  422: HttpValidationError;
8121
8573
  };
8122
8574
 
8123
- export type GetFileInfoError = GetFileInfoErrors[keyof GetFileInfoErrors];
8575
+ export type ListFilesError = ListFilesErrors[keyof ListFilesErrors];
8124
8576
 
8125
- export type GetFileInfoResponses = {
8577
+ export type ListFilesResponses = {
8126
8578
  /**
8127
- * File information retrieved successfully
8579
+ * Files retrieved successfully
8128
8580
  */
8129
- 200: GetFileInfoResponse;
8581
+ 200: ListTableFilesResponse;
8130
8582
  };
8131
8583
 
8132
- export type GetFileInfoResponse2 = GetFileInfoResponses[keyof GetFileInfoResponses];
8584
+ export type ListFilesResponse = ListFilesResponses[keyof ListFilesResponses];
8133
8585
 
8134
- export type UpdateFileStatusData = {
8586
+ export type CreateFileUploadData = {
8135
8587
  /**
8136
- * Status update
8588
+ * Upload request with table_name
8137
8589
  */
8138
- body: FileStatusUpdate;
8590
+ body: FileUploadRequest;
8139
8591
  path: {
8140
8592
  /**
8141
8593
  * Graph Id
8142
8594
  */
8143
8595
  graph_id: string;
8144
- /**
8145
- * File Id
8146
- * File identifier
8147
- */
8148
- file_id: string;
8149
8596
  };
8150
8597
  query?: never;
8151
- url: '/v1/graphs/{graph_id}/tables/files/{file_id}';
8598
+ url: '/v1/graphs/{graph_id}/files';
8152
8599
  };
8153
8600
 
8154
- export type UpdateFileStatusErrors = {
8601
+ export type CreateFileUploadErrors = {
8155
8602
  /**
8156
- * Invalid status, file too large, or empty file
8603
+ * Invalid file format or parameters
8157
8604
  */
8158
8605
  400: ErrorResponse;
8159
8606
  /**
@@ -8165,108 +8612,149 @@ export type UpdateFileStatusErrors = {
8165
8612
  */
8166
8613
  403: ErrorResponse;
8167
8614
  /**
8168
- * Graph, file, or S3 object not found
8615
+ * Graph not found
8169
8616
  */
8170
8617
  404: ErrorResponse;
8171
- /**
8172
- * Storage limit exceeded for tier
8173
- */
8174
- 413: ErrorResponse;
8175
8618
  /**
8176
8619
  * Validation Error
8177
8620
  */
8178
8621
  422: HttpValidationError;
8622
+ };
8623
+
8624
+ export type CreateFileUploadError = CreateFileUploadErrors[keyof CreateFileUploadErrors];
8625
+
8626
+ export type CreateFileUploadResponses = {
8179
8627
  /**
8180
- * Internal server error
8628
+ * Upload URL generated successfully
8181
8629
  */
8182
- 500: unknown;
8630
+ 200: FileUploadResponse;
8183
8631
  };
8184
8632
 
8185
- export type UpdateFileStatusError = UpdateFileStatusErrors[keyof UpdateFileStatusErrors];
8633
+ export type CreateFileUploadResponse = CreateFileUploadResponses[keyof CreateFileUploadResponses];
8634
+
8635
+ export type DeleteFileData = {
8636
+ body?: never;
8637
+ path: {
8638
+ /**
8639
+ * Graph Id
8640
+ */
8641
+ graph_id: string;
8642
+ /**
8643
+ * File Id
8644
+ * File ID
8645
+ */
8646
+ file_id: string;
8647
+ };
8648
+ query?: {
8649
+ /**
8650
+ * Cascade
8651
+ * If true, delete from all layers including DuckDB and mark graph stale
8652
+ */
8653
+ cascade?: boolean;
8654
+ };
8655
+ url: '/v1/graphs/{graph_id}/files/{file_id}';
8656
+ };
8186
8657
 
8187
- export type UpdateFileStatusResponses = {
8658
+ export type DeleteFileErrors = {
8188
8659
  /**
8189
- * Response Updatefilestatus
8190
- * File status updated successfully
8660
+ * Not authenticated
8191
8661
  */
8192
- 200: {
8193
- [key: string]: unknown;
8194
- };
8662
+ 401: unknown;
8663
+ /**
8664
+ * Access denied - shared repositories or insufficient permissions
8665
+ */
8666
+ 403: ErrorResponse;
8667
+ /**
8668
+ * File not found
8669
+ */
8670
+ 404: ErrorResponse;
8671
+ /**
8672
+ * Validation Error
8673
+ */
8674
+ 422: HttpValidationError;
8195
8675
  };
8196
8676
 
8197
- export type UpdateFileStatusResponse = UpdateFileStatusResponses[keyof UpdateFileStatusResponses];
8677
+ export type DeleteFileError = DeleteFileErrors[keyof DeleteFileErrors];
8198
8678
 
8199
- export type IngestTablesData = {
8679
+ export type DeleteFileResponses = {
8200
8680
  /**
8201
- * Ingestion request
8681
+ * File deleted successfully
8202
8682
  */
8203
- body: BulkIngestRequest;
8683
+ 200: DeleteFileResponse;
8684
+ };
8685
+
8686
+ export type DeleteFileResponse2 = DeleteFileResponses[keyof DeleteFileResponses];
8687
+
8688
+ export type GetFileData = {
8689
+ body?: never;
8204
8690
  path: {
8205
8691
  /**
8206
8692
  * Graph Id
8207
8693
  */
8208
8694
  graph_id: string;
8695
+ /**
8696
+ * File Id
8697
+ * File ID
8698
+ */
8699
+ file_id: string;
8209
8700
  };
8210
8701
  query?: never;
8211
- url: '/v1/graphs/{graph_id}/tables/ingest';
8702
+ url: '/v1/graphs/{graph_id}/files/{file_id}';
8212
8703
  };
8213
8704
 
8214
- export type IngestTablesErrors = {
8705
+ export type GetFileErrors = {
8215
8706
  /**
8216
8707
  * Not authenticated
8217
8708
  */
8218
8709
  401: unknown;
8219
8710
  /**
8220
- * Access denied - shared repositories or insufficient permissions
8711
+ * Access denied - insufficient permissions
8221
8712
  */
8222
8713
  403: ErrorResponse;
8223
8714
  /**
8224
- * Graph not found
8715
+ * File not found
8225
8716
  */
8226
8717
  404: ErrorResponse;
8227
- /**
8228
- * Conflict - another ingestion is already in progress for this graph
8229
- */
8230
- 409: ErrorResponse;
8231
8718
  /**
8232
8719
  * Validation Error
8233
8720
  */
8234
8721
  422: HttpValidationError;
8235
- /**
8236
- * Ingestion failed - check per-table results for details
8237
- */
8238
- 500: ErrorResponse;
8239
8722
  };
8240
8723
 
8241
- export type IngestTablesError = IngestTablesErrors[keyof IngestTablesErrors];
8724
+ export type GetFileError = GetFileErrors[keyof GetFileErrors];
8242
8725
 
8243
- export type IngestTablesResponses = {
8726
+ export type GetFileResponses = {
8244
8727
  /**
8245
- * Ingestion completed with detailed per-table results
8728
+ * File information retrieved successfully
8246
8729
  */
8247
- 200: BulkIngestResponse;
8730
+ 200: GetFileInfoResponse;
8248
8731
  };
8249
8732
 
8250
- export type IngestTablesResponse = IngestTablesResponses[keyof IngestTablesResponses];
8733
+ export type GetFileResponse = GetFileResponses[keyof GetFileResponses];
8251
8734
 
8252
- export type QueryTablesData = {
8735
+ export type UpdateFileData = {
8253
8736
  /**
8254
- * SQL query request
8737
+ * Status update request
8255
8738
  */
8256
- body: TableQueryRequest;
8739
+ body: FileStatusUpdate;
8257
8740
  path: {
8258
8741
  /**
8259
8742
  * Graph Id
8260
8743
  */
8261
8744
  graph_id: string;
8745
+ /**
8746
+ * File Id
8747
+ * File ID
8748
+ */
8749
+ file_id: string;
8262
8750
  };
8263
8751
  query?: never;
8264
- url: '/v1/graphs/{graph_id}/tables/query';
8752
+ url: '/v1/graphs/{graph_id}/files/{file_id}';
8265
8753
  };
8266
8754
 
8267
- export type QueryTablesErrors = {
8755
+ export type UpdateFileErrors = {
8268
8756
  /**
8269
- * Invalid SQL query syntax or execution error
8757
+ * Invalid status or file not in S3
8270
8758
  */
8271
8759
  400: ErrorResponse;
8272
8760
  /**
@@ -8274,37 +8762,32 @@ export type QueryTablesErrors = {
8274
8762
  */
8275
8763
  401: unknown;
8276
8764
  /**
8277
- * Access denied - shared repositories or insufficient permissions
8765
+ * Access denied
8278
8766
  */
8279
8767
  403: ErrorResponse;
8280
8768
  /**
8281
- * Graph not found
8769
+ * File not found
8282
8770
  */
8283
8771
  404: ErrorResponse;
8284
- /**
8285
- * Query timeout exceeded
8286
- */
8287
- 408: unknown;
8288
8772
  /**
8289
8773
  * Validation Error
8290
8774
  */
8291
8775
  422: HttpValidationError;
8292
- /**
8293
- * Internal server error
8294
- */
8295
- 500: unknown;
8296
8776
  };
8297
8777
 
8298
- export type QueryTablesError = QueryTablesErrors[keyof QueryTablesErrors];
8778
+ export type UpdateFileError = UpdateFileErrors[keyof UpdateFileErrors];
8299
8779
 
8300
- export type QueryTablesResponses = {
8780
+ export type UpdateFileResponses = {
8301
8781
  /**
8302
- * Query executed successfully
8782
+ * Response Updatefile
8783
+ * File status updated successfully
8303
8784
  */
8304
- 200: TableQueryResponse;
8785
+ 200: {
8786
+ [key: string]: unknown;
8787
+ };
8305
8788
  };
8306
8789
 
8307
- export type QueryTablesResponse = QueryTablesResponses[keyof QueryTablesResponses];
8790
+ export type UpdateFileResponse = UpdateFileResponses[keyof UpdateFileResponses];
8308
8791
 
8309
8792
  export type GetGraphsData = {
8310
8793
  body?: never;