@robosystems/client 1.8.0 → 1.8.1

package/README.md

@@ -3,7 +3,7 @@
 [![npm version](https://badge.fury.io/js/@robosystems%2Fclient.svg)](https://www.npmjs.com/package/@robosystems/client)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Official TypeScript Client for the RoboSystems Financial Knowledge Graph API. Access comprehensive financial data including accounting transactions, financial reports, and advanced graph analytics through a type-safe, modern TypeScript interface.
+Official TypeScript client for the RoboSystems financial intelligence platform — accounting, financial reporting, and investment management over a knowledge graph API. Type-safe and modern, generated from the OpenAPI spec, with GraphQL reads and idempotent operation writes.
 
 ## Features
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@robosystems/client",
-  "version": "1.8.0",
-  "description": "TypeScript client library for RoboSystems Financial Knowledge Graph API",
+  "version": "1.8.1",
+  "description": "TypeScript client library for the RoboSystems financial intelligence platform",
   "main": "index.js",
   "types": "index.d.ts",
   "bin": {

package/sdk/sdk.gen.d.ts

@@ -272,7 +272,7 @@ export declare const listOperators: <ThrowOnError extends boolean = false>(optio
 /**
  * Auto-select Operator for Query
  *
- * Routes to the best operator for your query. Operators: `financial` (SEC, accounting), `research` (deep analysis), `rag` (knowledge base, free). Credit cost by mode: `quick` 5-10, `standard` 15-25, `extended` 30-75. Execution strategy (sync/SSE/async) auto-selected; override with `?mode=sync|async`.
+ * 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. Execution strategy (sync/SSE/async) auto-selected; override with `?mode=sync|async`.
  */
 export declare const autoSelectOperator: <ThrowOnError extends boolean = false>(options: Options<AutoSelectOperatorData, ThrowOnError>) => import("./client").RequestResult<AutoSelectOperatorResponses, AutoSelectOperatorErrors, ThrowOnError, "fields">;
 /**
@@ -282,7 +282,7 @@ export declare const getOperatorMetadata: <ThrowOnError extends boolean = false>
 /**
  * Execute Specific Operator
  *
- * Available: `financial` (SEC filings, accounting), `research` (deep analysis), `rag` (retrieval, no credits). Execution strategy auto-selected; override with `?mode=sync|async`.
+ * 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. Execution strategy auto-selected; override with `?mode=sync|async`.
  */
 export declare const executeSpecificOperator: <ThrowOnError extends boolean = false>(options: Options<ExecuteSpecificOperatorData, ThrowOnError>) => import("./client").RequestResult<ExecuteSpecificOperatorResponses, ExecuteSpecificOperatorErrors, ThrowOnError, "fields">;
 /**

package/sdk/sdk.gen.js

@@ -537,7 +537,7 @@ exports.listOperators = listOperators;
 /**
  * Auto-select Operator for Query
  *
- * Routes to the best operator for your query. Operators: `financial` (SEC, accounting), `research` (deep analysis), `rag` (knowledge base, free). Credit cost by mode: `quick` 5-10, `standard` 15-25, `extended` 30-75. Execution strategy (sync/SSE/async) auto-selected; override with `?mode=sync|async`.
+ * 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. Execution strategy (sync/SSE/async) auto-selected; override with `?mode=sync|async`.
  */
 const autoSelectOperator = (options) => (options.client ?? client_gen_1.client).post({
     security: [{ name: 'X-API-Key', type: 'apiKey' }, { scheme: 'bearer', type: 'http' }],
@@ -561,7 +561,7 @@ exports.getOperatorMetadata = getOperatorMetadata;
 /**
  * Execute Specific Operator
  *
- * Available: `financial` (SEC filings, accounting), `research` (deep analysis), `rag` (retrieval, no credits). Execution strategy auto-selected; override with `?mode=sync|async`.
+ * 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. Execution strategy auto-selected; override with `?mode=sync|async`.
  */
 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

@@ -549,7 +549,7 @@ export const listOperators = <ThrowOnError extends boolean = false>(options: Opt
 /**
  * Auto-select Operator for Query
  *
- * Routes to the best operator for your query. Operators: `financial` (SEC, accounting), `research` (deep analysis), `rag` (knowledge base, free). Credit cost by mode: `quick` 5-10, `standard` 15-25, `extended` 30-75. Execution strategy (sync/SSE/async) auto-selected; override with `?mode=sync|async`.
+ * 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. Execution strategy (sync/SSE/async) auto-selected; override with `?mode=sync|async`.
  */
 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' }],
@@ -573,7 +573,7 @@ export const getOperatorMetadata = <ThrowOnError extends boolean = false>(option
 /**
  * Execute Specific Operator
  *
- * Available: `financial` (SEC filings, accounting), `research` (deep analysis), `rag` (retrieval, no credits). Execution strategy auto-selected; override with `?mode=sync|async`.
+ * 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. Execution strategy auto-selected; override with `?mode=sync|async`.
  */
 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

@@ -1167,6 +1167,12 @@ export type BlockSourceGraphResult = {
      * Number of previously-shared reports deleted from this graph. Zero unless `purge` was set.
      */
     purged_report_count?: number;
+    /**
+     * Purged Report Ids
+     *
+     * Ids of the previously-shared reports deleted from this graph. Empty unless `purge` was set.
+     */
+    purged_report_ids?: Array<string>;
 };
 /**
  * BlockedSourceGraphResponse
@@ -8216,7 +8222,7 @@ export type LiveFinancialStatementRequest = {
     /**
      * Statement Type
      *
-     * income_statement | balance_sheet | equity_statement
+     * income_statement | balance_sheet | cash_flow_statement | equity_statement
      */
     statement_type: string;
     /**
@@ -13913,9 +13919,11 @@ export type SqlStatementRequest = {
     /**
      * Parameters
      *
-     * Query parameters for safe value substitution. ALWAYS use parameters instead of string concatenation.
+     * Query parameters for safe value substitution. ALWAYS use parameters instead of string concatenation. Pass a list for positional placeholders (`?` or `$1`) and an object for named ones (`$param_name`) — the two forms cannot be mixed in one statement.
      */
-    parameters?: Array<unknown> | null;
+    parameters?: Array<unknown> | {
+        [key: string]: unknown;
+    } | null;
 };
 /**
  * SqlStatementResponse

package/sdk/types.gen.ts

@@ -1200,6 +1200,12 @@ export type BlockSourceGraphResult = {
      * Number of previously-shared reports deleted from this graph. Zero unless `purge` was set.
      */
     purged_report_count?: number;
+    /**
+     * Purged Report Ids
+     *
+     * Ids of the previously-shared reports deleted from this graph. Empty unless `purge` was set.
+     */
+    purged_report_ids?: Array<string>;
 };
 
 /**
@@ -8412,7 +8418,7 @@ export type LiveFinancialStatementRequest = {
     /**
      * Statement Type
      *
-     * income_statement | balance_sheet | equity_statement
+     * income_statement | balance_sheet | cash_flow_statement | equity_statement
      */
     statement_type: string;
     /**
@@ -14259,9 +14265,11 @@ export type SqlStatementRequest = {
     /**
      * Parameters
      *
-     * Query parameters for safe value substitution. ALWAYS use parameters instead of string concatenation.
+     * Query parameters for safe value substitution. ALWAYS use parameters instead of string concatenation. Pass a list for positional placeholders (`?` or `$1`) and an object for named ones (`$param_name`) — the two forms cannot be mixed in one statement.
      */
-    parameters?: Array<unknown> | null;
+    parameters?: Array<unknown> | {
+        [key: string]: unknown;
+    } | null;
 };
 
 /**

package/sdk.gen.d.ts

@@ -272,7 +272,7 @@ export declare const listOperators: <ThrowOnError extends boolean = false>(optio
 /**
  * Auto-select Operator for Query
  *
- * Routes to the best operator for your query. Operators: `financial` (SEC, accounting), `research` (deep analysis), `rag` (knowledge base, free). Credit cost by mode: `quick` 5-10, `standard` 15-25, `extended` 30-75. Execution strategy (sync/SSE/async) auto-selected; override with `?mode=sync|async`.
+ * 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. Execution strategy (sync/SSE/async) auto-selected; override with `?mode=sync|async`.
  */
 export declare const autoSelectOperator: <ThrowOnError extends boolean = false>(options: Options<AutoSelectOperatorData, ThrowOnError>) => import("./client").RequestResult<AutoSelectOperatorResponses, AutoSelectOperatorErrors, ThrowOnError, "fields">;
 /**
@@ -282,7 +282,7 @@ export declare const getOperatorMetadata: <ThrowOnError extends boolean = false>
 /**
  * Execute Specific Operator
  *
- * Available: `financial` (SEC filings, accounting), `research` (deep analysis), `rag` (retrieval, no credits). Execution strategy auto-selected; override with `?mode=sync|async`.
+ * 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. Execution strategy auto-selected; override with `?mode=sync|async`.
  */
 export declare const executeSpecificOperator: <ThrowOnError extends boolean = false>(options: Options<ExecuteSpecificOperatorData, ThrowOnError>) => import("./client").RequestResult<ExecuteSpecificOperatorResponses, ExecuteSpecificOperatorErrors, ThrowOnError, "fields">;
 /**

package/sdk.gen.js

@@ -537,7 +537,7 @@ exports.listOperators = listOperators;
 /**
  * Auto-select Operator for Query
  *
- * Routes to the best operator for your query. Operators: `financial` (SEC, accounting), `research` (deep analysis), `rag` (knowledge base, free). Credit cost by mode: `quick` 5-10, `standard` 15-25, `extended` 30-75. Execution strategy (sync/SSE/async) auto-selected; override with `?mode=sync|async`.
+ * 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. Execution strategy (sync/SSE/async) auto-selected; override with `?mode=sync|async`.
  */
 const autoSelectOperator = (options) => (options.client ?? client_gen_1.client).post({
     security: [{ name: 'X-API-Key', type: 'apiKey' }, { scheme: 'bearer', type: 'http' }],
@@ -561,7 +561,7 @@ exports.getOperatorMetadata = getOperatorMetadata;
 /**
  * Execute Specific Operator
  *
- * Available: `financial` (SEC filings, accounting), `research` (deep analysis), `rag` (retrieval, no credits). Execution strategy auto-selected; override with `?mode=sync|async`.
+ * 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. Execution strategy auto-selected; override with `?mode=sync|async`.
  */
 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

@@ -549,7 +549,7 @@ export const listOperators = <ThrowOnError extends boolean = false>(options: Opt
 /**
  * Auto-select Operator for Query
  *
- * Routes to the best operator for your query. Operators: `financial` (SEC, accounting), `research` (deep analysis), `rag` (knowledge base, free). Credit cost by mode: `quick` 5-10, `standard` 15-25, `extended` 30-75. Execution strategy (sync/SSE/async) auto-selected; override with `?mode=sync|async`.
+ * 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. Execution strategy (sync/SSE/async) auto-selected; override with `?mode=sync|async`.
  */
 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' }],
@@ -573,7 +573,7 @@ export const getOperatorMetadata = <ThrowOnError extends boolean = false>(option
 /**
  * Execute Specific Operator
  *
- * Available: `financial` (SEC filings, accounting), `research` (deep analysis), `rag` (retrieval, no credits). Execution strategy auto-selected; override with `?mode=sync|async`.
+ * 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. Execution strategy auto-selected; override with `?mode=sync|async`.
  */
 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

@@ -1167,6 +1167,12 @@ export type BlockSourceGraphResult = {
      * Number of previously-shared reports deleted from this graph. Zero unless `purge` was set.
      */
     purged_report_count?: number;
+    /**
+     * Purged Report Ids
+     *
+     * Ids of the previously-shared reports deleted from this graph. Empty unless `purge` was set.
+     */
+    purged_report_ids?: Array<string>;
 };
 /**
  * BlockedSourceGraphResponse
@@ -8216,7 +8222,7 @@ export type LiveFinancialStatementRequest = {
     /**
      * Statement Type
      *
-     * income_statement | balance_sheet | equity_statement
+     * income_statement | balance_sheet | cash_flow_statement | equity_statement
      */
     statement_type: string;
     /**
@@ -13913,9 +13919,11 @@ export type SqlStatementRequest = {
     /**
      * Parameters
      *
-     * Query parameters for safe value substitution. ALWAYS use parameters instead of string concatenation.
+     * Query parameters for safe value substitution. ALWAYS use parameters instead of string concatenation. Pass a list for positional placeholders (`?` or `$1`) and an object for named ones (`$param_name`) — the two forms cannot be mixed in one statement.
      */
-    parameters?: Array<unknown> | null;
+    parameters?: Array<unknown> | {
+        [key: string]: unknown;
+    } | null;
 };
 /**
  * SqlStatementResponse

package/types.gen.ts

@@ -1200,6 +1200,12 @@ export type BlockSourceGraphResult = {
      * Number of previously-shared reports deleted from this graph. Zero unless `purge` was set.
      */
     purged_report_count?: number;
+    /**
+     * Purged Report Ids
+     *
+     * Ids of the previously-shared reports deleted from this graph. Empty unless `purge` was set.
+     */
+    purged_report_ids?: Array<string>;
 };
 
 /**
@@ -8412,7 +8418,7 @@ export type LiveFinancialStatementRequest = {
     /**
      * Statement Type
      *
-     * income_statement | balance_sheet | equity_statement
+     * income_statement | balance_sheet | cash_flow_statement | equity_statement
      */
     statement_type: string;
     /**
@@ -14259,9 +14265,11 @@ export type SqlStatementRequest = {
     /**
      * Parameters
      *
-     * Query parameters for safe value substitution. ALWAYS use parameters instead of string concatenation.
+     * Query parameters for safe value substitution. ALWAYS use parameters instead of string concatenation. Pass a list for positional placeholders (`?` or `$1`) and an object for named ones (`$param_name`) — the two forms cannot be mixed in one statement.
      */
-    parameters?: Array<unknown> | null;
+    parameters?: Array<unknown> | {
+        [key: string]: unknown;
+    } | null;
 };
 
 /**