@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.
@@ -2524,7 +2524,7 @@ export type ConnectionResponse = {
2524
2524
  /**
2525
2525
  * Entity Id
2526
2526
  *
2527
- * Entity identifier
2527
+ * 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.
2528
2528
  */
2529
2529
  entity_id?: string | null;
2530
2530
  /**
@@ -3100,7 +3100,7 @@ export type CreateConnectionRequest = {
3100
3100
  /**
3101
3101
  * Entity Id
3102
3102
  *
3103
- * Entity identifier. Required for QuickBooks.
3103
+ * 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.
3104
3104
  */
3105
3105
  entity_id?: string | null;
3106
3106
  quickbooks_config?: QuickBooksConnectionConfig | null;
@@ -4779,7 +4779,11 @@ export type DeleteForecastRequest = {
4779
4779
  *
4780
4780
  * - **Immediate** (default): subscription canceled now (`ends_at = now`) and
4781
4781
  * fast-path deprovisioning fires within ~10 minutes. Use when you want
4782
- * the data gone and the slot freed right away.
4782
+ * the data gone and the slot freed right away. The unused part of the
4783
+ * billed period is credited, not refunded: on a card-billed plan to the
4784
+ * organization's account balance, applied to its next invoice; on an
4785
+ * invoiced plan as a credit on that period's invoice, or a separate credit
4786
+ * invoice if it is already paid.
4783
4787
  * - **At period end** (`at_period_end=true`): subscription canceled but
4784
4788
  * `ends_at = current_period_end` so the graph stays usable through the
4785
4789
  * paid period. The existing suspend → deprovision sensor pipeline tears
@@ -14591,9 +14595,15 @@ export type OperatorRequest = {
14591
14595
  /**
14592
14596
  * History
14593
14597
  *
14594
- * Conversation history
14598
+ * Conversation history. Omit it on a threaded request and the run is seeded from the thread's own record instead
14595
14599
  */
14596
14600
  history?: Array<OperatorMessage>;
14601
+ /**
14602
+ * Thread Id
14603
+ *
14604
+ * 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`
14605
+ */
14606
+ thread_id?: string | null;
14597
14607
  /**
14598
14608
  * Context
14599
14609
  *
@@ -14718,6 +14728,334 @@ export type OperatorResponse = {
14718
14728
  */
14719
14729
  timestamp?: string;
14720
14730
  };
14731
+ /**
14732
+ * OperatorRunDetail
14733
+ *
14734
+ * A run with its full paper trail: the history it was given, every model
14735
+ * call, and the response envelope's metadata.
14736
+ */
14737
+ export type OperatorRunDetail = {
14738
+ /**
14739
+ * Operation Id
14740
+ *
14741
+ * The run's operation id; every mutation audit entry the run made carries it as `operation_id`
14742
+ */
14743
+ operation_id: string;
14744
+ /**
14745
+ * Thread Id
14746
+ *
14747
+ * The conversation the run belongs to, when the caller threaded it; null for a standalone API call
14748
+ */
14749
+ thread_id?: string | null;
14750
+ /**
14751
+ * User Id
14752
+ *
14753
+ * The user the run ran as
14754
+ */
14755
+ user_id: string;
14756
+ /**
14757
+ * Operator Type
14758
+ *
14759
+ * The operator that ran
14760
+ */
14761
+ operator_type: string;
14762
+ /**
14763
+ * Mode
14764
+ *
14765
+ * The execution mode the run used
14766
+ */
14767
+ mode: string;
14768
+ /**
14769
+ * Status
14770
+ *
14771
+ * How the run ended
14772
+ */
14773
+ status: 'completed' | 'failed' | 'cancelled';
14774
+ /**
14775
+ * Question
14776
+ *
14777
+ * The message the run was given
14778
+ */
14779
+ question: string;
14780
+ /**
14781
+ * Answer
14782
+ *
14783
+ * The operator's answer; null when the run did not reach one
14784
+ */
14785
+ answer?: string | null;
14786
+ /**
14787
+ * Error
14788
+ *
14789
+ * Why a failed run failed
14790
+ */
14791
+ error?: string | null;
14792
+ /**
14793
+ * Credits Consumed
14794
+ *
14795
+ * Credits the run's model calls cost
14796
+ */
14797
+ credits_consumed?: number;
14798
+ /**
14799
+ * Call Count
14800
+ *
14801
+ * Model calls the run made
14802
+ */
14803
+ call_count?: number;
14804
+ /**
14805
+ * Tools Called
14806
+ *
14807
+ * The tools the run called, each named once
14808
+ */
14809
+ tools_called?: Array<string>;
14810
+ /**
14811
+ * Write Count
14812
+ *
14813
+ * Writes the run made to the graph
14814
+ */
14815
+ write_count?: number;
14816
+ /**
14817
+ * Started At
14818
+ *
14819
+ * When the run started on the worker
14820
+ */
14821
+ started_at: string;
14822
+ /**
14823
+ * Finished At
14824
+ *
14825
+ * When the run ended
14826
+ */
14827
+ finished_at: string;
14828
+ /**
14829
+ * Duration Ms
14830
+ *
14831
+ * How long the run took
14832
+ */
14833
+ duration_ms: number;
14834
+ /**
14835
+ * History
14836
+ *
14837
+ * The prior turns the run was given, as role/content pairs
14838
+ */
14839
+ history?: Array<{
14840
+ [key: string]: unknown;
14841
+ }>;
14842
+ /**
14843
+ * Transcript
14844
+ *
14845
+ * 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
14846
+ */
14847
+ transcript?: Array<{
14848
+ [key: string]: unknown;
14849
+ }>;
14850
+ /**
14851
+ * Result
14852
+ *
14853
+ * The response envelope's metadata without its result rows: tokens, credits, the Cypher run, the writes made, confidence and loop flags
14854
+ */
14855
+ result?: {
14856
+ [key: string]: unknown;
14857
+ };
14858
+ };
14859
+ /**
14860
+ * OperatorRunListResponse
14861
+ *
14862
+ * A page of the graph's operator runs, newest first.
14863
+ */
14864
+ export type OperatorRunListResponse = {
14865
+ /**
14866
+ * Graph Id
14867
+ */
14868
+ graph_id: string;
14869
+ /**
14870
+ * Runs
14871
+ */
14872
+ runs: Array<OperatorRunSummary>;
14873
+ /**
14874
+ * Next Cursor
14875
+ *
14876
+ * Pass as `cursor` for the next, older page; null on the last page
14877
+ */
14878
+ next_cursor?: string | null;
14879
+ };
14880
+ /**
14881
+ * OperatorRunSummary
14882
+ *
14883
+ * One in-app AI operator run: what it was asked and what it answered.
14884
+ */
14885
+ export type OperatorRunSummary = {
14886
+ /**
14887
+ * Operation Id
14888
+ *
14889
+ * The run's operation id; every mutation audit entry the run made carries it as `operation_id`
14890
+ */
14891
+ operation_id: string;
14892
+ /**
14893
+ * Thread Id
14894
+ *
14895
+ * The conversation the run belongs to, when the caller threaded it; null for a standalone API call
14896
+ */
14897
+ thread_id?: string | null;
14898
+ /**
14899
+ * User Id
14900
+ *
14901
+ * The user the run ran as
14902
+ */
14903
+ user_id: string;
14904
+ /**
14905
+ * Operator Type
14906
+ *
14907
+ * The operator that ran
14908
+ */
14909
+ operator_type: string;
14910
+ /**
14911
+ * Mode
14912
+ *
14913
+ * The execution mode the run used
14914
+ */
14915
+ mode: string;
14916
+ /**
14917
+ * Status
14918
+ *
14919
+ * How the run ended
14920
+ */
14921
+ status: 'completed' | 'failed' | 'cancelled';
14922
+ /**
14923
+ * Question
14924
+ *
14925
+ * The message the run was given
14926
+ */
14927
+ question: string;
14928
+ /**
14929
+ * Answer
14930
+ *
14931
+ * The operator's answer; null when the run did not reach one
14932
+ */
14933
+ answer?: string | null;
14934
+ /**
14935
+ * Error
14936
+ *
14937
+ * Why a failed run failed
14938
+ */
14939
+ error?: string | null;
14940
+ /**
14941
+ * Credits Consumed
14942
+ *
14943
+ * Credits the run's model calls cost
14944
+ */
14945
+ credits_consumed?: number;
14946
+ /**
14947
+ * Call Count
14948
+ *
14949
+ * Model calls the run made
14950
+ */
14951
+ call_count?: number;
14952
+ /**
14953
+ * Tools Called
14954
+ *
14955
+ * The tools the run called, each named once
14956
+ */
14957
+ tools_called?: Array<string>;
14958
+ /**
14959
+ * Write Count
14960
+ *
14961
+ * Writes the run made to the graph
14962
+ */
14963
+ write_count?: number;
14964
+ /**
14965
+ * Started At
14966
+ *
14967
+ * When the run started on the worker
14968
+ */
14969
+ started_at: string;
14970
+ /**
14971
+ * Finished At
14972
+ *
14973
+ * When the run ended
14974
+ */
14975
+ finished_at: string;
14976
+ /**
14977
+ * Duration Ms
14978
+ *
14979
+ * How long the run took
14980
+ */
14981
+ duration_ms: number;
14982
+ };
14983
+ /**
14984
+ * OperatorThreadListResponse
14985
+ *
14986
+ * A page of the graph's operator threads, most recently active first.
14987
+ */
14988
+ export type OperatorThreadListResponse = {
14989
+ /**
14990
+ * Graph Id
14991
+ */
14992
+ graph_id: string;
14993
+ /**
14994
+ * Threads
14995
+ */
14996
+ threads: Array<OperatorThreadSummary>;
14997
+ /**
14998
+ * Next Cursor
14999
+ *
15000
+ * Pass as `cursor` for the next, older page; null on the last page
15001
+ */
15002
+ next_cursor?: string | null;
15003
+ };
15004
+ /**
15005
+ * OperatorThreadSummary
15006
+ *
15007
+ * One console conversation: the runs that share a thread id.
15008
+ */
15009
+ export type OperatorThreadSummary = {
15010
+ /**
15011
+ * Thread Id
15012
+ *
15013
+ * The thread id the runs were made under
15014
+ */
15015
+ thread_id: string;
15016
+ /**
15017
+ * User Id
15018
+ *
15019
+ * The user whose conversation it is
15020
+ */
15021
+ user_id: string;
15022
+ /**
15023
+ * Title
15024
+ *
15025
+ * The conversation's first question, clipped
15026
+ */
15027
+ title: string;
15028
+ /**
15029
+ * Run Count
15030
+ *
15031
+ * Runs in the thread
15032
+ */
15033
+ run_count: number;
15034
+ /**
15035
+ * First Run At
15036
+ *
15037
+ * When the first run started
15038
+ */
15039
+ first_run_at: string;
15040
+ /**
15041
+ * Last Run At
15042
+ *
15043
+ * When the latest run started
15044
+ */
15045
+ last_run_at: string;
15046
+ /**
15047
+ * Last Operator Type
15048
+ *
15049
+ * The operator the latest run used
15050
+ */
15051
+ last_operator_type: string;
15052
+ /**
15053
+ * Last Status
15054
+ *
15055
+ * How the latest run ended
15056
+ */
15057
+ last_status: 'completed' | 'failed' | 'cancelled';
15058
+ };
14721
15059
  /**
14722
15060
  * OrgDetailResponse
14723
15061
  *
@@ -18650,6 +18988,12 @@ export type SsoCompleteRequest = {
18650
18988
  * Temporary session ID from secure handoff
18651
18989
  */
18652
18990
  session_id: string;
18991
+ /**
18992
+ * Browser Nonce
18993
+ *
18994
+ * The nonce this browser minted when it started the bridge; its SHA-256 was passed through the exchange as browser_nonce_hash.
18995
+ */
18996
+ browser_nonce?: string | null;
18653
18997
  };
18654
18998
  /**
18655
18999
  * SSOExchangeRequest
@@ -18675,6 +19019,12 @@ export type SsoExchangeRequest = {
18675
19019
  * Optional return URL after authentication
18676
19020
  */
18677
19021
  return_url?: string | null;
19022
+ /**
19023
+ * Browser Nonce Hash
19024
+ *
19025
+ * 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.
19026
+ */
19027
+ browser_nonce_hash?: string | null;
18678
19028
  };
18679
19029
  /**
18680
19030
  * SSOExchangeResponse
@@ -21998,9 +22348,15 @@ export type UpdateEventHandlerRequest = {
21998
22348
  /**
21999
22349
  * Approve
22000
22350
  *
22001
- * Approval shortcut: True stamps approved_by/approved_at to the current user; False clears both.
22351
+ * 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`.
22002
22352
  */
22003
22353
  approve?: boolean | null;
22354
+ /**
22355
+ * Expected Updated At
22356
+ *
22357
+ * 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.
22358
+ */
22359
+ expected_updated_at?: string | null;
22004
22360
  /**
22005
22361
  * Metadata Patch
22006
22362
  *
@@ -25438,7 +25794,7 @@ export type ListConnectionsData = {
25438
25794
  /**
25439
25795
  * Entity Id
25440
25796
  *
25441
- * Filter by entity ID
25797
+ * Only the connections that keep this entity's books
25442
25798
  */
25443
25799
  entity_id?: string | null;
25444
25800
  /**
@@ -27269,6 +27625,233 @@ export type ListGraphMutationsResponses = {
27269
27625
  200: MutationAuditListResponse;
27270
27626
  };
27271
27627
  export type ListGraphMutationsResponse = ListGraphMutationsResponses[keyof ListGraphMutationsResponses];
27628
+ export type ListOperatorThreadsData = {
27629
+ body?: never;
27630
+ path: {
27631
+ /**
27632
+ * Graph Id
27633
+ *
27634
+ * Graph identifier
27635
+ */
27636
+ graph_id: string;
27637
+ };
27638
+ query?: {
27639
+ /**
27640
+ * User Id
27641
+ *
27642
+ * Only this user's threads (admins; members see their own)
27643
+ */
27644
+ user_id?: string | null;
27645
+ /**
27646
+ * Cursor
27647
+ *
27648
+ * The `next_cursor` of the previous page
27649
+ */
27650
+ cursor?: string | null;
27651
+ /**
27652
+ * Limit
27653
+ *
27654
+ * Threads per page
27655
+ */
27656
+ limit?: number;
27657
+ };
27658
+ url: '/v1/graphs/{graph_id}/audit/threads';
27659
+ };
27660
+ export type ListOperatorThreadsErrors = {
27661
+ /**
27662
+ * Invalid request
27663
+ */
27664
+ 400: ErrorResponse;
27665
+ /**
27666
+ * Authentication required
27667
+ */
27668
+ 401: ErrorResponse;
27669
+ /**
27670
+ * Access denied
27671
+ */
27672
+ 403: ErrorResponse;
27673
+ /**
27674
+ * Resource not found
27675
+ */
27676
+ 404: ErrorResponse;
27677
+ /**
27678
+ * Validation Error
27679
+ */
27680
+ 422: HttpValidationError;
27681
+ /**
27682
+ * Rate limit exceeded
27683
+ */
27684
+ 429: ErrorResponse;
27685
+ /**
27686
+ * Internal server error
27687
+ */
27688
+ 500: ErrorResponse;
27689
+ };
27690
+ export type ListOperatorThreadsError = ListOperatorThreadsErrors[keyof ListOperatorThreadsErrors];
27691
+ export type ListOperatorThreadsResponses = {
27692
+ /**
27693
+ * Successful Response
27694
+ */
27695
+ 200: OperatorThreadListResponse;
27696
+ };
27697
+ export type ListOperatorThreadsResponse = ListOperatorThreadsResponses[keyof ListOperatorThreadsResponses];
27698
+ export type ListOperatorRunsData = {
27699
+ body?: never;
27700
+ path: {
27701
+ /**
27702
+ * Graph Id
27703
+ *
27704
+ * Graph identifier
27705
+ */
27706
+ graph_id: string;
27707
+ };
27708
+ query?: {
27709
+ /**
27710
+ * Thread Id
27711
+ *
27712
+ * Only the runs of this thread
27713
+ */
27714
+ thread_id?: string | null;
27715
+ /**
27716
+ * User Id
27717
+ *
27718
+ * Only runs made as this user (admins; members see their own)
27719
+ */
27720
+ user_id?: string | null;
27721
+ /**
27722
+ * Operator Type
27723
+ *
27724
+ * Only runs of this operator
27725
+ */
27726
+ operator_type?: string | null;
27727
+ /**
27728
+ * Status
27729
+ *
27730
+ * Only runs that ended this way
27731
+ */
27732
+ status?: 'completed' | 'failed' | 'cancelled' | null;
27733
+ /**
27734
+ * Since
27735
+ *
27736
+ * Only runs started at or after this time
27737
+ */
27738
+ since?: string | null;
27739
+ /**
27740
+ * Until
27741
+ *
27742
+ * Only runs started before this time
27743
+ */
27744
+ until?: string | null;
27745
+ /**
27746
+ * Cursor
27747
+ *
27748
+ * The `next_cursor` of the previous page
27749
+ */
27750
+ cursor?: string | null;
27751
+ /**
27752
+ * Limit
27753
+ *
27754
+ * Runs per page
27755
+ */
27756
+ limit?: number;
27757
+ };
27758
+ url: '/v1/graphs/{graph_id}/audit/runs';
27759
+ };
27760
+ export type ListOperatorRunsErrors = {
27761
+ /**
27762
+ * Invalid request
27763
+ */
27764
+ 400: ErrorResponse;
27765
+ /**
27766
+ * Authentication required
27767
+ */
27768
+ 401: ErrorResponse;
27769
+ /**
27770
+ * Access denied
27771
+ */
27772
+ 403: ErrorResponse;
27773
+ /**
27774
+ * Resource not found
27775
+ */
27776
+ 404: ErrorResponse;
27777
+ /**
27778
+ * Validation Error
27779
+ */
27780
+ 422: HttpValidationError;
27781
+ /**
27782
+ * Rate limit exceeded
27783
+ */
27784
+ 429: ErrorResponse;
27785
+ /**
27786
+ * Internal server error
27787
+ */
27788
+ 500: ErrorResponse;
27789
+ };
27790
+ export type ListOperatorRunsError = ListOperatorRunsErrors[keyof ListOperatorRunsErrors];
27791
+ export type ListOperatorRunsResponses = {
27792
+ /**
27793
+ * Successful Response
27794
+ */
27795
+ 200: OperatorRunListResponse;
27796
+ };
27797
+ export type ListOperatorRunsResponse = ListOperatorRunsResponses[keyof ListOperatorRunsResponses];
27798
+ export type GetOperatorRunData = {
27799
+ body?: never;
27800
+ path: {
27801
+ /**
27802
+ * Graph Id
27803
+ *
27804
+ * Graph identifier
27805
+ */
27806
+ graph_id: string;
27807
+ /**
27808
+ * Operation Id
27809
+ *
27810
+ * The run's operation id
27811
+ */
27812
+ operation_id: string;
27813
+ };
27814
+ query?: never;
27815
+ url: '/v1/graphs/{graph_id}/audit/runs/{operation_id}';
27816
+ };
27817
+ export type GetOperatorRunErrors = {
27818
+ /**
27819
+ * Invalid request
27820
+ */
27821
+ 400: ErrorResponse;
27822
+ /**
27823
+ * Authentication required
27824
+ */
27825
+ 401: ErrorResponse;
27826
+ /**
27827
+ * Access denied
27828
+ */
27829
+ 403: ErrorResponse;
27830
+ /**
27831
+ * Resource not found
27832
+ */
27833
+ 404: ErrorResponse;
27834
+ /**
27835
+ * Validation Error
27836
+ */
27837
+ 422: HttpValidationError;
27838
+ /**
27839
+ * Rate limit exceeded
27840
+ */
27841
+ 429: ErrorResponse;
27842
+ /**
27843
+ * Internal server error
27844
+ */
27845
+ 500: ErrorResponse;
27846
+ };
27847
+ export type GetOperatorRunError = GetOperatorRunErrors[keyof GetOperatorRunErrors];
27848
+ export type GetOperatorRunResponses = {
27849
+ /**
27850
+ * Successful Response
27851
+ */
27852
+ 200: OperatorRunDetail;
27853
+ };
27854
+ export type GetOperatorRunResponse = GetOperatorRunResponses[keyof GetOperatorRunResponses];
27272
27855
  export type ListSubgraphsData = {
27273
27856
  body?: never;
27274
27857
  path: {