@robosystems/client 2.33.3 → 2.34.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.ts CHANGED
@@ -2588,7 +2588,7 @@ export type ConnectionResponse = {
2588
2588
  /**
2589
2589
  * Entity Id
2590
2590
  *
2591
- * Entity identifier
2591
+ * The entity whose books the connection keeps: the group parent for QuickBooks, the entity a bank feed was connected for (each of its accounts can move to another entity later), none for an external source, whose events name their own.
2592
2592
  */
2593
2593
  entity_id?: string | null;
2594
2594
  /**
@@ -3177,7 +3177,7 @@ export type CreateConnectionRequest = {
3177
3177
  /**
3178
3178
  * Entity Id
3179
3179
  *
3180
- * Entity identifier. Required for QuickBooks.
3180
+ * QuickBooks: the entity whose books it keeps, which can only be the group parent; omit it. A bank feed names its entity on its own config.
3181
3181
  */
3182
3182
  entity_id?: string | null;
3183
3183
  quickbooks_config?: QuickBooksConnectionConfig | null;
@@ -4888,7 +4888,11 @@ export type DeleteForecastRequest = {
4888
4888
  *
4889
4889
  * - **Immediate** (default): subscription canceled now (`ends_at = now`) and
4890
4890
  * fast-path deprovisioning fires within ~10 minutes. Use when you want
4891
- * the data gone and the slot freed right away.
4891
+ * the data gone and the slot freed right away. The unused part of the
4892
+ * billed period is credited, not refunded: on a card-billed plan to the
4893
+ * organization's account balance, applied to its next invoice; on an
4894
+ * invoiced plan as a credit on that period's invoice, or a separate credit
4895
+ * invoice if it is already paid.
4892
4896
  * - **At period end** (`at_period_end=true`): subscription canceled but
4893
4897
  * `ends_at = current_period_end` so the graph stays usable through the
4894
4898
  * paid period. The existing suspend → deprovision sensor pipeline tears
@@ -14923,9 +14927,15 @@ export type OperatorRequest = {
14923
14927
  /**
14924
14928
  * History
14925
14929
  *
14926
- * Conversation history
14930
+ * Conversation history. Omit it on a threaded request and the run is seeded from the thread's own record instead
14927
14931
  */
14928
14932
  history?: Array<OperatorMessage>;
14933
+ /**
14934
+ * Thread Id
14935
+ *
14936
+ * Groups this run with the earlier runs of one conversation. A caller mints the id (any ULID or UUID) on the first question and sends it with each follow-up; the run is recorded under it, and with no `history` given, the thread's last exchanges are the history. Runs list by thread at `GET /v1/graphs/{graph_id}/audit/runs`
14937
+ */
14938
+ thread_id?: string | null;
14929
14939
  /**
14930
14940
  * Context
14931
14941
  *
@@ -15052,6 +15062,339 @@ export type OperatorResponse = {
15052
15062
  timestamp?: string;
15053
15063
  };
15054
15064
 
15065
+ /**
15066
+ * OperatorRunDetail
15067
+ *
15068
+ * A run with its full paper trail: the history it was given, every model
15069
+ * call, and the response envelope's metadata.
15070
+ */
15071
+ export type OperatorRunDetail = {
15072
+ /**
15073
+ * Operation Id
15074
+ *
15075
+ * The run's operation id; every mutation audit entry the run made carries it as `operation_id`
15076
+ */
15077
+ operation_id: string;
15078
+ /**
15079
+ * Thread Id
15080
+ *
15081
+ * The conversation the run belongs to, when the caller threaded it; null for a standalone API call
15082
+ */
15083
+ thread_id?: string | null;
15084
+ /**
15085
+ * User Id
15086
+ *
15087
+ * The user the run ran as
15088
+ */
15089
+ user_id: string;
15090
+ /**
15091
+ * Operator Type
15092
+ *
15093
+ * The operator that ran
15094
+ */
15095
+ operator_type: string;
15096
+ /**
15097
+ * Mode
15098
+ *
15099
+ * The execution mode the run used
15100
+ */
15101
+ mode: string;
15102
+ /**
15103
+ * Status
15104
+ *
15105
+ * How the run ended
15106
+ */
15107
+ status: 'completed' | 'failed' | 'cancelled';
15108
+ /**
15109
+ * Question
15110
+ *
15111
+ * The message the run was given
15112
+ */
15113
+ question: string;
15114
+ /**
15115
+ * Answer
15116
+ *
15117
+ * The operator's answer; null when the run did not reach one
15118
+ */
15119
+ answer?: string | null;
15120
+ /**
15121
+ * Error
15122
+ *
15123
+ * Why a failed run failed
15124
+ */
15125
+ error?: string | null;
15126
+ /**
15127
+ * Credits Consumed
15128
+ *
15129
+ * Credits the run's model calls cost
15130
+ */
15131
+ credits_consumed?: number;
15132
+ /**
15133
+ * Call Count
15134
+ *
15135
+ * Model calls the run made
15136
+ */
15137
+ call_count?: number;
15138
+ /**
15139
+ * Tools Called
15140
+ *
15141
+ * The tools the run called, each named once
15142
+ */
15143
+ tools_called?: Array<string>;
15144
+ /**
15145
+ * Write Count
15146
+ *
15147
+ * Writes the run made to the graph
15148
+ */
15149
+ write_count?: number;
15150
+ /**
15151
+ * Started At
15152
+ *
15153
+ * When the run started on the worker
15154
+ */
15155
+ started_at: string;
15156
+ /**
15157
+ * Finished At
15158
+ *
15159
+ * When the run ended
15160
+ */
15161
+ finished_at: string;
15162
+ /**
15163
+ * Duration Ms
15164
+ *
15165
+ * How long the run took
15166
+ */
15167
+ duration_ms: number;
15168
+ /**
15169
+ * History
15170
+ *
15171
+ * The prior turns the run was given, as role/content pairs
15172
+ */
15173
+ history?: Array<{
15174
+ [key: string]: unknown;
15175
+ }>;
15176
+ /**
15177
+ * Transcript
15178
+ *
15179
+ * One entry per model call, in order: the input added since the previous call (the question, then each turn's tool results), the model's output blocks (text and tool calls), stop reason, token usage and credits. The first entry also carries the system prompt's SHA-256 and size and the tool names offered; later entries repeat them only when they change
15180
+ */
15181
+ transcript?: Array<{
15182
+ [key: string]: unknown;
15183
+ }>;
15184
+ /**
15185
+ * Result
15186
+ *
15187
+ * The response envelope's metadata without its result rows: tokens, credits, the Cypher run, the writes made, confidence and loop flags
15188
+ */
15189
+ result?: {
15190
+ [key: string]: unknown;
15191
+ };
15192
+ };
15193
+
15194
+ /**
15195
+ * OperatorRunListResponse
15196
+ *
15197
+ * A page of the graph's operator runs, newest first.
15198
+ */
15199
+ export type OperatorRunListResponse = {
15200
+ /**
15201
+ * Graph Id
15202
+ */
15203
+ graph_id: string;
15204
+ /**
15205
+ * Runs
15206
+ */
15207
+ runs: Array<OperatorRunSummary>;
15208
+ /**
15209
+ * Next Cursor
15210
+ *
15211
+ * Pass as `cursor` for the next, older page; null on the last page
15212
+ */
15213
+ next_cursor?: string | null;
15214
+ };
15215
+
15216
+ /**
15217
+ * OperatorRunSummary
15218
+ *
15219
+ * One in-app AI operator run: what it was asked and what it answered.
15220
+ */
15221
+ export type OperatorRunSummary = {
15222
+ /**
15223
+ * Operation Id
15224
+ *
15225
+ * The run's operation id; every mutation audit entry the run made carries it as `operation_id`
15226
+ */
15227
+ operation_id: string;
15228
+ /**
15229
+ * Thread Id
15230
+ *
15231
+ * The conversation the run belongs to, when the caller threaded it; null for a standalone API call
15232
+ */
15233
+ thread_id?: string | null;
15234
+ /**
15235
+ * User Id
15236
+ *
15237
+ * The user the run ran as
15238
+ */
15239
+ user_id: string;
15240
+ /**
15241
+ * Operator Type
15242
+ *
15243
+ * The operator that ran
15244
+ */
15245
+ operator_type: string;
15246
+ /**
15247
+ * Mode
15248
+ *
15249
+ * The execution mode the run used
15250
+ */
15251
+ mode: string;
15252
+ /**
15253
+ * Status
15254
+ *
15255
+ * How the run ended
15256
+ */
15257
+ status: 'completed' | 'failed' | 'cancelled';
15258
+ /**
15259
+ * Question
15260
+ *
15261
+ * The message the run was given
15262
+ */
15263
+ question: string;
15264
+ /**
15265
+ * Answer
15266
+ *
15267
+ * The operator's answer; null when the run did not reach one
15268
+ */
15269
+ answer?: string | null;
15270
+ /**
15271
+ * Error
15272
+ *
15273
+ * Why a failed run failed
15274
+ */
15275
+ error?: string | null;
15276
+ /**
15277
+ * Credits Consumed
15278
+ *
15279
+ * Credits the run's model calls cost
15280
+ */
15281
+ credits_consumed?: number;
15282
+ /**
15283
+ * Call Count
15284
+ *
15285
+ * Model calls the run made
15286
+ */
15287
+ call_count?: number;
15288
+ /**
15289
+ * Tools Called
15290
+ *
15291
+ * The tools the run called, each named once
15292
+ */
15293
+ tools_called?: Array<string>;
15294
+ /**
15295
+ * Write Count
15296
+ *
15297
+ * Writes the run made to the graph
15298
+ */
15299
+ write_count?: number;
15300
+ /**
15301
+ * Started At
15302
+ *
15303
+ * When the run started on the worker
15304
+ */
15305
+ started_at: string;
15306
+ /**
15307
+ * Finished At
15308
+ *
15309
+ * When the run ended
15310
+ */
15311
+ finished_at: string;
15312
+ /**
15313
+ * Duration Ms
15314
+ *
15315
+ * How long the run took
15316
+ */
15317
+ duration_ms: number;
15318
+ };
15319
+
15320
+ /**
15321
+ * OperatorThreadListResponse
15322
+ *
15323
+ * A page of the graph's operator threads, most recently active first.
15324
+ */
15325
+ export type OperatorThreadListResponse = {
15326
+ /**
15327
+ * Graph Id
15328
+ */
15329
+ graph_id: string;
15330
+ /**
15331
+ * Threads
15332
+ */
15333
+ threads: Array<OperatorThreadSummary>;
15334
+ /**
15335
+ * Next Cursor
15336
+ *
15337
+ * Pass as `cursor` for the next, older page; null on the last page
15338
+ */
15339
+ next_cursor?: string | null;
15340
+ };
15341
+
15342
+ /**
15343
+ * OperatorThreadSummary
15344
+ *
15345
+ * One console conversation: the runs that share a thread id.
15346
+ */
15347
+ export type OperatorThreadSummary = {
15348
+ /**
15349
+ * Thread Id
15350
+ *
15351
+ * The thread id the runs were made under
15352
+ */
15353
+ thread_id: string;
15354
+ /**
15355
+ * User Id
15356
+ *
15357
+ * The user whose conversation it is
15358
+ */
15359
+ user_id: string;
15360
+ /**
15361
+ * Title
15362
+ *
15363
+ * The conversation's first question, clipped
15364
+ */
15365
+ title: string;
15366
+ /**
15367
+ * Run Count
15368
+ *
15369
+ * Runs in the thread
15370
+ */
15371
+ run_count: number;
15372
+ /**
15373
+ * First Run At
15374
+ *
15375
+ * When the first run started
15376
+ */
15377
+ first_run_at: string;
15378
+ /**
15379
+ * Last Run At
15380
+ *
15381
+ * When the latest run started
15382
+ */
15383
+ last_run_at: string;
15384
+ /**
15385
+ * Last Operator Type
15386
+ *
15387
+ * The operator the latest run used
15388
+ */
15389
+ last_operator_type: string;
15390
+ /**
15391
+ * Last Status
15392
+ *
15393
+ * How the latest run ended
15394
+ */
15395
+ last_status: 'completed' | 'failed' | 'cancelled';
15396
+ };
15397
+
15055
15398
  /**
15056
15399
  * OrgDetailResponse
15057
15400
  *
@@ -19083,6 +19426,12 @@ export type SsoCompleteRequest = {
19083
19426
  * Temporary session ID from secure handoff
19084
19427
  */
19085
19428
  session_id: string;
19429
+ /**
19430
+ * Browser Nonce
19431
+ *
19432
+ * The nonce this browser minted when it started the bridge; its SHA-256 was passed through the exchange as browser_nonce_hash.
19433
+ */
19434
+ browser_nonce?: string | null;
19086
19435
  };
19087
19436
 
19088
19437
  /**
@@ -19109,6 +19458,12 @@ export type SsoExchangeRequest = {
19109
19458
  * Optional return URL after authentication
19110
19459
  */
19111
19460
  return_url?: string | null;
19461
+ /**
19462
+ * Browser Nonce Hash
19463
+ *
19464
+ * SHA-256 (hex) of a nonce the target app minted in the browser that is signing in. Completion must present the nonce, so the handoff cannot be redeemed by any other browser.
19465
+ */
19466
+ browser_nonce_hash?: string | null;
19112
19467
  };
19113
19468
 
19114
19469
  /**
@@ -22513,9 +22868,15 @@ export type UpdateEventHandlerRequest = {
22513
22868
  /**
22514
22869
  * Approve
22515
22870
  *
22516
- * Approval shortcut: True stamps approved_by/approved_at to the current user; False clears both.
22871
+ * Approval shortcut: True stamps approved_by/approved_at to the current user; False clears both. Approving an AI-suggested handler also needs `expected_updated_at`.
22517
22872
  */
22518
22873
  approve?: boolean | null;
22874
+ /**
22875
+ * Expected Updated At
22876
+ *
22877
+ * The handler's `updated_at` as shown when it was reviewed. Required with `approve=true` on an AI-suggested handler, so the approval covers exactly that version; a mismatch is refused with 409.
22878
+ */
22879
+ expected_updated_at?: string | null;
22519
22880
  /**
22520
22881
  * Metadata Patch
22521
22882
  *
@@ -26262,7 +26623,7 @@ export type ListConnectionsData = {
26262
26623
  /**
26263
26624
  * Entity Id
26264
26625
  *
26265
- * Filter by entity ID
26626
+ * Only the connections that keep this entity's books
26266
26627
  */
26267
26628
  entity_id?: string | null;
26268
26629
  /**
@@ -28247,6 +28608,248 @@ export type ListGraphMutationsResponses = {
28247
28608
 
28248
28609
  export type ListGraphMutationsResponse = ListGraphMutationsResponses[keyof ListGraphMutationsResponses];
28249
28610
 
28611
+ export type ListOperatorThreadsData = {
28612
+ body?: never;
28613
+ path: {
28614
+ /**
28615
+ * Graph Id
28616
+ *
28617
+ * Graph identifier
28618
+ */
28619
+ graph_id: string;
28620
+ };
28621
+ query?: {
28622
+ /**
28623
+ * User Id
28624
+ *
28625
+ * Only this user's threads (admins; members see their own)
28626
+ */
28627
+ user_id?: string | null;
28628
+ /**
28629
+ * Cursor
28630
+ *
28631
+ * The `next_cursor` of the previous page
28632
+ */
28633
+ cursor?: string | null;
28634
+ /**
28635
+ * Limit
28636
+ *
28637
+ * Threads per page
28638
+ */
28639
+ limit?: number;
28640
+ };
28641
+ url: '/v1/graphs/{graph_id}/audit/threads';
28642
+ };
28643
+
28644
+ export type ListOperatorThreadsErrors = {
28645
+ /**
28646
+ * Invalid request
28647
+ */
28648
+ 400: ErrorResponse;
28649
+ /**
28650
+ * Authentication required
28651
+ */
28652
+ 401: ErrorResponse;
28653
+ /**
28654
+ * Access denied
28655
+ */
28656
+ 403: ErrorResponse;
28657
+ /**
28658
+ * Resource not found
28659
+ */
28660
+ 404: ErrorResponse;
28661
+ /**
28662
+ * Validation Error
28663
+ */
28664
+ 422: HttpValidationError;
28665
+ /**
28666
+ * Rate limit exceeded
28667
+ */
28668
+ 429: ErrorResponse;
28669
+ /**
28670
+ * Internal server error
28671
+ */
28672
+ 500: ErrorResponse;
28673
+ };
28674
+
28675
+ export type ListOperatorThreadsError = ListOperatorThreadsErrors[keyof ListOperatorThreadsErrors];
28676
+
28677
+ export type ListOperatorThreadsResponses = {
28678
+ /**
28679
+ * Successful Response
28680
+ */
28681
+ 200: OperatorThreadListResponse;
28682
+ };
28683
+
28684
+ export type ListOperatorThreadsResponse = ListOperatorThreadsResponses[keyof ListOperatorThreadsResponses];
28685
+
28686
+ export type ListOperatorRunsData = {
28687
+ body?: never;
28688
+ path: {
28689
+ /**
28690
+ * Graph Id
28691
+ *
28692
+ * Graph identifier
28693
+ */
28694
+ graph_id: string;
28695
+ };
28696
+ query?: {
28697
+ /**
28698
+ * Thread Id
28699
+ *
28700
+ * Only the runs of this thread
28701
+ */
28702
+ thread_id?: string | null;
28703
+ /**
28704
+ * User Id
28705
+ *
28706
+ * Only runs made as this user (admins; members see their own)
28707
+ */
28708
+ user_id?: string | null;
28709
+ /**
28710
+ * Operator Type
28711
+ *
28712
+ * Only runs of this operator
28713
+ */
28714
+ operator_type?: string | null;
28715
+ /**
28716
+ * Status
28717
+ *
28718
+ * Only runs that ended this way
28719
+ */
28720
+ status?: 'completed' | 'failed' | 'cancelled' | null;
28721
+ /**
28722
+ * Since
28723
+ *
28724
+ * Only runs started at or after this time
28725
+ */
28726
+ since?: string | null;
28727
+ /**
28728
+ * Until
28729
+ *
28730
+ * Only runs started before this time
28731
+ */
28732
+ until?: string | null;
28733
+ /**
28734
+ * Cursor
28735
+ *
28736
+ * The `next_cursor` of the previous page
28737
+ */
28738
+ cursor?: string | null;
28739
+ /**
28740
+ * Limit
28741
+ *
28742
+ * Runs per page
28743
+ */
28744
+ limit?: number;
28745
+ };
28746
+ url: '/v1/graphs/{graph_id}/audit/runs';
28747
+ };
28748
+
28749
+ export type ListOperatorRunsErrors = {
28750
+ /**
28751
+ * Invalid request
28752
+ */
28753
+ 400: ErrorResponse;
28754
+ /**
28755
+ * Authentication required
28756
+ */
28757
+ 401: ErrorResponse;
28758
+ /**
28759
+ * Access denied
28760
+ */
28761
+ 403: ErrorResponse;
28762
+ /**
28763
+ * Resource not found
28764
+ */
28765
+ 404: ErrorResponse;
28766
+ /**
28767
+ * Validation Error
28768
+ */
28769
+ 422: HttpValidationError;
28770
+ /**
28771
+ * Rate limit exceeded
28772
+ */
28773
+ 429: ErrorResponse;
28774
+ /**
28775
+ * Internal server error
28776
+ */
28777
+ 500: ErrorResponse;
28778
+ };
28779
+
28780
+ export type ListOperatorRunsError = ListOperatorRunsErrors[keyof ListOperatorRunsErrors];
28781
+
28782
+ export type ListOperatorRunsResponses = {
28783
+ /**
28784
+ * Successful Response
28785
+ */
28786
+ 200: OperatorRunListResponse;
28787
+ };
28788
+
28789
+ export type ListOperatorRunsResponse = ListOperatorRunsResponses[keyof ListOperatorRunsResponses];
28790
+
28791
+ export type GetOperatorRunData = {
28792
+ body?: never;
28793
+ path: {
28794
+ /**
28795
+ * Graph Id
28796
+ *
28797
+ * Graph identifier
28798
+ */
28799
+ graph_id: string;
28800
+ /**
28801
+ * Operation Id
28802
+ *
28803
+ * The run's operation id
28804
+ */
28805
+ operation_id: string;
28806
+ };
28807
+ query?: never;
28808
+ url: '/v1/graphs/{graph_id}/audit/runs/{operation_id}';
28809
+ };
28810
+
28811
+ export type GetOperatorRunErrors = {
28812
+ /**
28813
+ * Invalid request
28814
+ */
28815
+ 400: ErrorResponse;
28816
+ /**
28817
+ * Authentication required
28818
+ */
28819
+ 401: ErrorResponse;
28820
+ /**
28821
+ * Access denied
28822
+ */
28823
+ 403: ErrorResponse;
28824
+ /**
28825
+ * Resource not found
28826
+ */
28827
+ 404: ErrorResponse;
28828
+ /**
28829
+ * Validation Error
28830
+ */
28831
+ 422: HttpValidationError;
28832
+ /**
28833
+ * Rate limit exceeded
28834
+ */
28835
+ 429: ErrorResponse;
28836
+ /**
28837
+ * Internal server error
28838
+ */
28839
+ 500: ErrorResponse;
28840
+ };
28841
+
28842
+ export type GetOperatorRunError = GetOperatorRunErrors[keyof GetOperatorRunErrors];
28843
+
28844
+ export type GetOperatorRunResponses = {
28845
+ /**
28846
+ * Successful Response
28847
+ */
28848
+ 200: OperatorRunDetail;
28849
+ };
28850
+
28851
+ export type GetOperatorRunResponse = GetOperatorRunResponses[keyof GetOperatorRunResponses];
28852
+
28250
28853
  export type ListSubgraphsData = {
28251
28854
  body?: never;
28252
28855
  path: {