@robosystems/client 1.12.1 → 1.13.0

package/artifacts/hooks.js

@@ -45,6 +45,7 @@ function useQuery(graphId) {
             credentials: sdkConfig.credentials,
             headers: sdkConfig.headers,
             token,
+            tokenProvider: sdkConfig.tokenProvider,
         });
         return () => {
             clientRef.current?.close();
@@ -122,6 +123,7 @@ function useStreamingQuery(graphId) {
             credentials: sdkConfig.credentials,
             headers: sdkConfig.headers,
             token: sdkConfig.token,
+            tokenProvider: sdkConfig.tokenProvider,
         });
         return () => {
             clientRef.current?.close();
@@ -201,6 +203,7 @@ function useOperation(operationId) {
             baseUrl: sdkConfig.baseUrl || clientConfig.baseUrl || 'http://localhost:8000',
             credentials: sdkConfig.credentials,
             token,
+            tokenProvider: sdkConfig.tokenProvider,
             maxRetries: sdkConfig.maxRetries,
             retryDelay: sdkConfig.retryDelay,
         });
@@ -300,6 +303,7 @@ function useMultipleOperations() {
             baseUrl: sdkConfig.baseUrl || clientConfig.baseUrl || 'http://localhost:8000',
             credentials: sdkConfig.credentials,
             token,
+            tokenProvider: sdkConfig.tokenProvider,
             maxRetries: sdkConfig.maxRetries,
             retryDelay: sdkConfig.retryDelay,
         });
@@ -368,6 +372,7 @@ function useSDKClients() {
             credentials: sdkConfig.credentials,
             headers: sdkConfig.headers,
             token,
+            tokenProvider: sdkConfig.tokenProvider,
         };
         const queryClient = new QueryClient_1.QueryClient(baseConfig);
         const operationsClient = new OperationClient_1.OperationClient(baseConfig);

package/artifacts/hooks.ts

@@ -46,6 +46,7 @@ export function useQuery(graphId: string) {
       credentials: sdkConfig.credentials,
       headers: sdkConfig.headers,
       token,
+      tokenProvider: sdkConfig.tokenProvider,
     })
 
     return () => {
@@ -143,6 +144,7 @@ export function useStreamingQuery(graphId: string) {
       credentials: sdkConfig.credentials,
       headers: sdkConfig.headers,
       token: sdkConfig.token,
+      tokenProvider: sdkConfig.tokenProvider,
     })
 
     return () => {
@@ -240,6 +242,7 @@ export function useOperation<T = any>(operationId?: string) {
       baseUrl: sdkConfig.baseUrl || clientConfig.baseUrl || 'http://localhost:8000',
       credentials: sdkConfig.credentials,
       token,
+      tokenProvider: sdkConfig.tokenProvider,
       maxRetries: sdkConfig.maxRetries,
       retryDelay: sdkConfig.retryDelay,
     })
@@ -353,6 +356,7 @@ export function useMultipleOperations<T = any>() {
       baseUrl: sdkConfig.baseUrl || clientConfig.baseUrl || 'http://localhost:8000',
       credentials: sdkConfig.credentials,
       token,
+      tokenProvider: sdkConfig.tokenProvider,
       maxRetries: sdkConfig.maxRetries,
       retryDelay: sdkConfig.retryDelay,
     })
@@ -439,6 +443,7 @@ export function useSDKClients() {
       credentials: sdkConfig.credentials,
       headers: sdkConfig.headers,
       token,
+      tokenProvider: sdkConfig.tokenProvider,
     }
 
     const queryClient = new QueryClient(baseConfig)

package/artifacts/index.d.ts

@@ -22,9 +22,12 @@ export interface RoboSystemsClientConfig {
      */
     token?: string;
     /**
-     * Dynamic credential callback invoked on every GraphQL request.
-     * When set, JWT refreshes are picked up automatically — no need
-     * to rebuild or clear cached clients after a refresh.
+     * Dynamic credential callback invoked on every GraphQL request and
+     * every SSE connect. When set, JWT refreshes are picked up
+     * automatically — no need to rebuild or clear cached clients after a
+     * refresh. Browser sessions need this: the backend revokes the previous
+     * JWT on each refresh, so a static `token` captured at construction
+     * stops opening progress streams the moment the session rotates.
      */
     tokenProvider?: TokenProvider;
     headers?: Record<string, string>;
@@ -90,4 +93,3 @@ export declare const monitorOperation: (operationId: string, onProgress?: (progr
 export declare const executeQuery: (graphId: string, query: string, parameters?: Record<string, any>) => Promise<import("./QueryClient").QueryResult>;
 export declare const streamQuery: (graphId: string, query: string, parameters?: Record<string, any>, chunkSize?: number) => AsyncIterableIterator<any>;
 export declare const operatorQuery: (graphId: string, message: string, context?: Record<string, any>) => Promise<import("./OperatorClient").OperatorResult>;
-export declare const analyzeFinancials: (graphId: string, message: string) => Promise<import("./OperatorClient").OperatorResult>;

package/artifacts/index.js

@@ -18,7 +18,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.analyzeFinancials = exports.operatorQuery = exports.streamQuery = exports.executeQuery = exports.monitorOperation = exports.clients = exports.useStreamingQuery = exports.useSDKClients = exports.useQuery = exports.useOperation = exports.useMultipleOperations = exports.SSEClient = exports.QueryClient = exports.OperatorClient = exports.OperationClient = exports.LibraryClient = exports.LedgerClient = exports.InvestorClient = exports.RoboSystemsClients = exports.GraphQLError = exports.DEFAULT_GRAPHQL_TIMEOUT_MS = void 0;
+exports.operatorQuery = exports.streamQuery = exports.executeQuery = exports.monitorOperation = exports.clients = exports.useStreamingQuery = exports.useSDKClients = exports.useQuery = exports.useOperation = exports.useMultipleOperations = exports.SSEClient = exports.QueryClient = exports.OperatorClient = exports.OperationClient = exports.LibraryClient = exports.LedgerClient = exports.InvestorClient = exports.RoboSystemsClients = exports.GraphQLError = exports.DEFAULT_GRAPHQL_TIMEOUT_MS = void 0;
 const client_gen_1 = require("../client.gen");
 const config_1 = require("./config");
 const InvestorClient_1 = require("./InvestorClient");
@@ -60,27 +60,33 @@ class RoboSystemsClients {
             retryDelay: config.retryDelay || 1000,
             timeout: config.timeout,
         };
+        // Every client that opens an SSE stream gets the tokenProvider too:
+        // the stream endpoint authenticates the JWT from the URL, and a
+        // captured static token is dead after the first session refresh.
         this.query = new QueryClient_1.QueryClient({
             baseUrl: this.config.baseUrl,
             credentials: this.config.credentials,
             token: this.config.token,
+            tokenProvider: this.config.tokenProvider,
             headers: this.config.headers,
         });
         this.operator = new OperatorClient_1.OperatorClient({
             baseUrl: this.config.baseUrl,
             credentials: this.config.credentials,
             token: this.config.token,
+            tokenProvider: this.config.tokenProvider,
             headers: this.config.headers,
         });
         this.operations = new OperationClient_1.OperationClient({
             baseUrl: this.config.baseUrl,
             credentials: this.config.credentials,
             token: this.config.token,
+            tokenProvider: this.config.tokenProvider,
             maxRetries: this.config.maxRetries,
             retryDelay: this.config.retryDelay,
         });
-        // LedgerClient / InvestorClient use GraphQL internally, so they
-        // get the tokenProvider — REST-only clients do not.
+        // LedgerClient / InvestorClient / LibraryClient use GraphQL internally
+        // and consult the tokenProvider on every request.
         this.ledger = new LedgerClient_1.LedgerClient({
             baseUrl: this.config.baseUrl,
             credentials: this.config.credentials,
@@ -125,6 +131,7 @@ class RoboSystemsClients {
             baseUrl: this.config.baseUrl,
             credentials: this.config.credentials,
             token: this.config.token,
+            tokenProvider: this.config.tokenProvider,
             headers: this.config.headers,
             maxRetries: this.config.maxRetries,
             retryDelay: this.config.retryDelay,
@@ -200,5 +207,3 @@ const streamQuery = (graphId, query, parameters, chunkSize) => getClients().quer
 exports.streamQuery = streamQuery;
 const operatorQuery = (graphId, message, context) => getClients().operator.query(graphId, message, context);
 exports.operatorQuery = operatorQuery;
-const analyzeFinancials = (graphId, message) => getClients().operator.analyzeFinancials(graphId, message);
-exports.analyzeFinancials = analyzeFinancials;

package/artifacts/index.ts

@@ -34,9 +34,12 @@ export interface RoboSystemsClientConfig {
    */
   token?: string
   /**
-   * Dynamic credential callback invoked on every GraphQL request.
-   * When set, JWT refreshes are picked up automatically — no need
-   * to rebuild or clear cached clients after a refresh.
+   * Dynamic credential callback invoked on every GraphQL request and
+   * every SSE connect. When set, JWT refreshes are picked up
+   * automatically — no need to rebuild or clear cached clients after a
+   * refresh. Browser sessions need this: the backend revokes the previous
+   * JWT on each refresh, so a static `token` captured at construction
+   * stops opening progress streams the moment the session rotates.
    */
   tokenProvider?: TokenProvider
   headers?: Record<string, string>
@@ -98,10 +101,14 @@ export class RoboSystemsClients {
       timeout: config.timeout,
     }
 
+    // Every client that opens an SSE stream gets the tokenProvider too:
+    // the stream endpoint authenticates the JWT from the URL, and a
+    // captured static token is dead after the first session refresh.
     this.query = new QueryClient({
       baseUrl: this.config.baseUrl,
       credentials: this.config.credentials,
       token: this.config.token,
+      tokenProvider: this.config.tokenProvider,
       headers: this.config.headers,
     })
 
@@ -109,6 +116,7 @@ export class RoboSystemsClients {
       baseUrl: this.config.baseUrl,
       credentials: this.config.credentials,
       token: this.config.token,
+      tokenProvider: this.config.tokenProvider,
       headers: this.config.headers,
     })
 
@@ -116,12 +124,13 @@ export class RoboSystemsClients {
       baseUrl: this.config.baseUrl,
       credentials: this.config.credentials,
       token: this.config.token,
+      tokenProvider: this.config.tokenProvider,
       maxRetries: this.config.maxRetries,
       retryDelay: this.config.retryDelay,
     })
 
-    // LedgerClient / InvestorClient use GraphQL internally, so they
-    // get the tokenProvider — REST-only clients do not.
+    // LedgerClient / InvestorClient / LibraryClient use GraphQL internally
+    // and consult the tokenProvider on every request.
     this.ledger = new LedgerClient({
       baseUrl: this.config.baseUrl,
       credentials: this.config.credentials,
@@ -171,6 +180,7 @@ export class RoboSystemsClients {
       baseUrl: this.config.baseUrl,
       credentials: this.config.credentials,
       token: this.config.token,
+      tokenProvider: this.config.tokenProvider,
       headers: this.config.headers,
       maxRetries: this.config.maxRetries,
       retryDelay: this.config.retryDelay,
@@ -271,6 +281,3 @@ export const streamQuery = (
 
 export const operatorQuery = (graphId: string, message: string, context?: Record<string, any>) =>
   getClients().operator.query(graphId, message, context)
-
-export const analyzeFinancials = (graphId: string, message: string) =>
-  getClients().operator.analyzeFinancials(graphId, message)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robosystems/client",
-  "version": "1.12.1",
+  "version": "1.13.0",
   "description": "TypeScript client library for the RoboSystems financial intelligence platform",
   "main": "index.js",
   "types": "index.d.ts",

package/sdk/sdk.gen.d.ts

@@ -358,7 +358,7 @@ export declare const listOperators: <ThrowOnError extends boolean = false>(optio
 /**
  * Auto-select Operator for Query
  *
- * Routes to the best operator for your query. Operators: `cypher` (answers natural-language questions by querying the graph; supports `quick`, `standard`, `extended`) and `mapping` (autonomous Chart of Accounts → rs-gaap mapping; roboledger graphs only, `extended` only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. Credits are consumed by actual token usage, not a fixed price per mode. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
+ * Routes to the best operator for your query. Operators: `analyst` (answers natural-language questions over the graph — curated financial reads, documents, memory, and read-only Cypher; supports `quick`, `standard`, `extended`; `cypher` is accepted as its former name) and `mapping` (autonomous Chart of Accounts → rs-gaap mapping; roboledger graphs only, `extended` only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. Credits are consumed by actual token usage, not a fixed price per mode. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
  */
 export declare const autoSelectOperator: <ThrowOnError extends boolean = false>(options: Options<AutoSelectOperatorData, ThrowOnError>) => import("./client").RequestResult<AutoSelectOperatorResponses, AutoSelectOperatorErrors, ThrowOnError, "fields">;
 /**
@@ -368,7 +368,7 @@ export declare const getOperatorMetadata: <ThrowOnError extends boolean = false>
 /**
  * Execute Specific Operator
  *
- * Available: `cypher` (natural-language questions answered by querying the graph; RAG retrieval is one of its capabilities, not a separate operator) and `mapping` (Chart of Accounts → rs-gaap mapping, roboledger graphs only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
+ * Available: `analyst` (natural-language questions over the graph — curated financial reads, documents, memory, and read-only Cypher; RAG retrieval is one of its capabilities, not a separate operator; `cypher` is accepted as its former name) and `mapping` (Chart of Accounts → rs-gaap mapping, roboledger graphs only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
  */
 export declare const executeSpecificOperator: <ThrowOnError extends boolean = false>(options: Options<ExecuteSpecificOperatorData, ThrowOnError>) => import("./client").RequestResult<ExecuteSpecificOperatorResponses, ExecuteSpecificOperatorErrors, ThrowOnError, "fields">;
 /**

package/sdk/sdk.gen.js

@@ -708,7 +708,7 @@ exports.listOperators = listOperators;
 /**
  * Auto-select Operator for Query
  *
- * Routes to the best operator for your query. Operators: `cypher` (answers natural-language questions by querying the graph; supports `quick`, `standard`, `extended`) and `mapping` (autonomous Chart of Accounts → rs-gaap mapping; roboledger graphs only, `extended` only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. Credits are consumed by actual token usage, not a fixed price per mode. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
+ * Routes to the best operator for your query. Operators: `analyst` (answers natural-language questions over the graph — curated financial reads, documents, memory, and read-only Cypher; supports `quick`, `standard`, `extended`; `cypher` is accepted as its former name) and `mapping` (autonomous Chart of Accounts → rs-gaap mapping; roboledger graphs only, `extended` only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. Credits are consumed by actual token usage, not a fixed price per mode. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
  */
 const autoSelectOperator = (options) => (options.client ?? client_gen_1.client).post({
     security: [{ name: 'X-API-Key', type: 'apiKey' }, { scheme: 'bearer', type: 'http' }],
@@ -732,7 +732,7 @@ exports.getOperatorMetadata = getOperatorMetadata;
 /**
  * Execute Specific Operator
  *
- * Available: `cypher` (natural-language questions answered by querying the graph; RAG retrieval is one of its capabilities, not a separate operator) and `mapping` (Chart of Accounts → rs-gaap mapping, roboledger graphs only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
+ * Available: `analyst` (natural-language questions over the graph — curated financial reads, documents, memory, and read-only Cypher; RAG retrieval is one of its capabilities, not a separate operator; `cypher` is accepted as its former name) and `mapping` (Chart of Accounts → rs-gaap mapping, roboledger graphs only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
  */
 const executeSpecificOperator = (options) => (options.client ?? client_gen_1.client).post({
     security: [{ name: 'X-API-Key', type: 'apiKey' }, { scheme: 'bearer', type: 'http' }],

package/sdk/sdk.gen.ts

@@ -720,7 +720,7 @@ export const listOperators = <ThrowOnError extends boolean = false>(options: Opt
 /**
  * Auto-select Operator for Query
  *
- * Routes to the best operator for your query. Operators: `cypher` (answers natural-language questions by querying the graph; supports `quick`, `standard`, `extended`) and `mapping` (autonomous Chart of Accounts → rs-gaap mapping; roboledger graphs only, `extended` only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. Credits are consumed by actual token usage, not a fixed price per mode. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
+ * Routes to the best operator for your query. Operators: `analyst` (answers natural-language questions over the graph — curated financial reads, documents, memory, and read-only Cypher; supports `quick`, `standard`, `extended`; `cypher` is accepted as its former name) and `mapping` (autonomous Chart of Accounts → rs-gaap mapping; roboledger graphs only, `extended` only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. Credits are consumed by actual token usage, not a fixed price per mode. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
  */
 export const autoSelectOperator = <ThrowOnError extends boolean = false>(options: Options<AutoSelectOperatorData, ThrowOnError>) => (options.client ?? client).post<AutoSelectOperatorResponses, AutoSelectOperatorErrors, ThrowOnError>({
     security: [{ name: 'X-API-Key', type: 'apiKey' }, { scheme: 'bearer', type: 'http' }],
@@ -744,7 +744,7 @@ export const getOperatorMetadata = <ThrowOnError extends boolean = false>(option
 /**
  * Execute Specific Operator
  *
- * Available: `cypher` (natural-language questions answered by querying the graph; RAG retrieval is one of its capabilities, not a separate operator) and `mapping` (Chart of Accounts → rs-gaap mapping, roboledger graphs only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
+ * Available: `analyst` (natural-language questions over the graph — curated financial reads, documents, memory, and read-only Cypher; RAG retrieval is one of its capabilities, not a separate operator; `cypher` is accepted as its former name) and `mapping` (Chart of Accounts → rs-gaap mapping, roboledger graphs only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
  */
 export const executeSpecificOperator = <ThrowOnError extends boolean = false>(options: Options<ExecuteSpecificOperatorData, ThrowOnError>) => (options.client ?? client).post<ExecuteSpecificOperatorResponses, ExecuteSpecificOperatorErrors, ThrowOnError>({
     security: [{ name: 'X-API-Key', type: 'apiKey' }, { scheme: 'bearer', type: 'http' }],

package/sdk/types.gen.d.ts

@@ -20531,7 +20531,7 @@ export type GetOperatorMetadataData = {
         /**
          * Operator Type
          *
-         * Operator type identifier (e.g., 'financial', 'research', 'rag')
+         * Operator type identifier (e.g., 'analyst', 'mapping')
          */
         operator_type: string;
     };

package/sdk/types.gen.ts

@@ -21301,7 +21301,7 @@ export type GetOperatorMetadataData = {
         /**
          * Operator Type
          *
-         * Operator type identifier (e.g., 'financial', 'research', 'rag')
+         * Operator type identifier (e.g., 'analyst', 'mapping')
          */
         operator_type: string;
     };

package/sdk.gen.d.ts

@@ -358,7 +358,7 @@ export declare const listOperators: <ThrowOnError extends boolean = false>(optio
 /**
  * Auto-select Operator for Query
  *
- * Routes to the best operator for your query. Operators: `cypher` (answers natural-language questions by querying the graph; supports `quick`, `standard`, `extended`) and `mapping` (autonomous Chart of Accounts → rs-gaap mapping; roboledger graphs only, `extended` only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. Credits are consumed by actual token usage, not a fixed price per mode. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
+ * Routes to the best operator for your query. Operators: `analyst` (answers natural-language questions over the graph — curated financial reads, documents, memory, and read-only Cypher; supports `quick`, `standard`, `extended`; `cypher` is accepted as its former name) and `mapping` (autonomous Chart of Accounts → rs-gaap mapping; roboledger graphs only, `extended` only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. Credits are consumed by actual token usage, not a fixed price per mode. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
  */
 export declare const autoSelectOperator: <ThrowOnError extends boolean = false>(options: Options<AutoSelectOperatorData, ThrowOnError>) => import("./client").RequestResult<AutoSelectOperatorResponses, AutoSelectOperatorErrors, ThrowOnError, "fields">;
 /**
@@ -368,7 +368,7 @@ export declare const getOperatorMetadata: <ThrowOnError extends boolean = false>
 /**
  * Execute Specific Operator
  *
- * Available: `cypher` (natural-language questions answered by querying the graph; RAG retrieval is one of its capabilities, not a separate operator) and `mapping` (Chart of Accounts → rs-gaap mapping, roboledger graphs only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
+ * Available: `analyst` (natural-language questions over the graph — curated financial reads, documents, memory, and read-only Cypher; RAG retrieval is one of its capabilities, not a separate operator; `cypher` is accepted as its former name) and `mapping` (Chart of Accounts → rs-gaap mapping, roboledger graphs only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
  */
 export declare const executeSpecificOperator: <ThrowOnError extends boolean = false>(options: Options<ExecuteSpecificOperatorData, ThrowOnError>) => import("./client").RequestResult<ExecuteSpecificOperatorResponses, ExecuteSpecificOperatorErrors, ThrowOnError, "fields">;
 /**

package/sdk.gen.js

@@ -708,7 +708,7 @@ exports.listOperators = listOperators;
 /**
  * Auto-select Operator for Query
  *
- * Routes to the best operator for your query. Operators: `cypher` (answers natural-language questions by querying the graph; supports `quick`, `standard`, `extended`) and `mapping` (autonomous Chart of Accounts → rs-gaap mapping; roboledger graphs only, `extended` only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. Credits are consumed by actual token usage, not a fixed price per mode. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
+ * Routes to the best operator for your query. Operators: `analyst` (answers natural-language questions over the graph — curated financial reads, documents, memory, and read-only Cypher; supports `quick`, `standard`, `extended`; `cypher` is accepted as its former name) and `mapping` (autonomous Chart of Accounts → rs-gaap mapping; roboledger graphs only, `extended` only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. Credits are consumed by actual token usage, not a fixed price per mode. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
  */
 const autoSelectOperator = (options) => (options.client ?? client_gen_1.client).post({
     security: [{ name: 'X-API-Key', type: 'apiKey' }, { scheme: 'bearer', type: 'http' }],
@@ -732,7 +732,7 @@ exports.getOperatorMetadata = getOperatorMetadata;
 /**
  * Execute Specific Operator
  *
- * Available: `cypher` (natural-language questions answered by querying the graph; RAG retrieval is one of its capabilities, not a separate operator) and `mapping` (Chart of Accounts → rs-gaap mapping, roboledger graphs only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
+ * Available: `analyst` (natural-language questions over the graph — curated financial reads, documents, memory, and read-only Cypher; RAG retrieval is one of its capabilities, not a separate operator; `cypher` is accepted as its former name) and `mapping` (Chart of Accounts → rs-gaap mapping, roboledger graphs only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
  */
 const executeSpecificOperator = (options) => (options.client ?? client_gen_1.client).post({
     security: [{ name: 'X-API-Key', type: 'apiKey' }, { scheme: 'bearer', type: 'http' }],

package/sdk.gen.ts

@@ -720,7 +720,7 @@ export const listOperators = <ThrowOnError extends boolean = false>(options: Opt
 /**
  * Auto-select Operator for Query
  *
- * Routes to the best operator for your query. Operators: `cypher` (answers natural-language questions by querying the graph; supports `quick`, `standard`, `extended`) and `mapping` (autonomous Chart of Accounts → rs-gaap mapping; roboledger graphs only, `extended` only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. Credits are consumed by actual token usage, not a fixed price per mode. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
+ * Routes to the best operator for your query. Operators: `analyst` (answers natural-language questions over the graph — curated financial reads, documents, memory, and read-only Cypher; supports `quick`, `standard`, `extended`; `cypher` is accepted as its former name) and `mapping` (autonomous Chart of Accounts → rs-gaap mapping; roboledger graphs only, `extended` only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. Credits are consumed by actual token usage, not a fixed price per mode. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
  */
 export const autoSelectOperator = <ThrowOnError extends boolean = false>(options: Options<AutoSelectOperatorData, ThrowOnError>) => (options.client ?? client).post<AutoSelectOperatorResponses, AutoSelectOperatorErrors, ThrowOnError>({
     security: [{ name: 'X-API-Key', type: 'apiKey' }, { scheme: 'bearer', type: 'http' }],
@@ -744,7 +744,7 @@ export const getOperatorMetadata = <ThrowOnError extends boolean = false>(option
 /**
  * Execute Specific Operator
  *
- * Available: `cypher` (natural-language questions answered by querying the graph; RAG retrieval is one of its capabilities, not a separate operator) and `mapping` (Chart of Accounts → rs-gaap mapping, roboledger graphs only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
+ * Available: `analyst` (natural-language questions over the graph — curated financial reads, documents, memory, and read-only Cypher; RAG retrieval is one of its capabilities, not a separate operator; `cypher` is accepted as its former name) and `mapping` (Chart of Accounts → rs-gaap mapping, roboledger graphs only). `GET /v1/graphs/{graph_id}/operator` lists what is registered. The run executes on the background worker: the default answer is 202 with the operation's `_links` (stream, status, cancel); `?mode=sync` waits up to 50s and answers 200 with the result.
  */
 export const executeSpecificOperator = <ThrowOnError extends boolean = false>(options: Options<ExecuteSpecificOperatorData, ThrowOnError>) => (options.client ?? client).post<ExecuteSpecificOperatorResponses, ExecuteSpecificOperatorErrors, ThrowOnError>({
     security: [{ name: 'X-API-Key', type: 'apiKey' }, { scheme: 'bearer', type: 'http' }],

package/types.gen.d.ts

@@ -20531,7 +20531,7 @@ export type GetOperatorMetadataData = {
         /**
          * Operator Type
          *
-         * Operator type identifier (e.g., 'financial', 'research', 'rag')
+         * Operator type identifier (e.g., 'analyst', 'mapping')
          */
         operator_type: string;
     };

package/types.gen.ts

@@ -21301,7 +21301,7 @@ export type GetOperatorMetadataData = {
         /**
          * Operator Type
          *
-         * Operator type identifier (e.g., 'financial', 'research', 'rag')
+         * Operator type identifier (e.g., 'analyst', 'mapping')
          */
         operator_type: string;
     };