@robosystems/client 0.2.13 → 0.2.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robosystems/client",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "description": "TypeScript client library for RoboSystems Financial Knowledge Graph API",
   "main": "index.js",
   "types": "index.d.ts",

package/sdk/sdk.gen.d.ts

@@ -457,6 +457,13 @@ export declare const listAgents: <ThrowOnError extends boolean = false>(options:
  * - Leverage conversation history for contextual understanding
  * - Enable RAG for knowledge base enrichment
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * Agents operate on the specified graph/subgraph's data independently. RAG enrichment
+ * and knowledge base search are scoped to the specific graph/subgraph.
+ *
  * See request/response examples in the "Examples" dropdown below.
  */
 export declare const autoSelectAgent: <ThrowOnError extends boolean = false>(options: Options<AutoSelectAgentData, ThrowOnError>) => import("./client").RequestResult<AutoSelectAgentResponses, AutoSelectAgentErrors, ThrowOnError, "fields">;
@@ -545,6 +552,13 @@ export declare const recommendAgent: <ThrowOnError extends boolean = false>(opti
  * - User permissions and subscription tier
  * - Backend capabilities (Kuzu, Neo4j, etc.)
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * The returned tool list is identical for parent graphs and subgraphs, as all
+ * MCP tools work uniformly across graph boundaries.
+ *
  * **Note:**
  * MCP tool listing is included - no credit consumption required.
  */
@@ -583,6 +597,13 @@ export declare const listMcpTools: <ThrowOnError extends boolean = false>(option
  * - `408 Request Timeout`: Tool execution exceeded timeout
  * - Clients should implement exponential backoff on errors
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * MCP tools operate on the specified graph/subgraph independently. Each subgraph
+ * has its own schema, data, and can be queried separately via MCP.
+ *
  * **Credit Model:**
  * MCP tool execution is included - no credit consumption required. Database
  * operations (queries, schema inspection, analytics) are completely free.
@@ -850,6 +871,12 @@ export declare const getGraphUsageAnalytics: <ThrowOnError extends boolean = fal
  * - `503 Service Unavailable`: Circuit breaker open or SSE disabled
  * - Clients should implement exponential backoff
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * Subgraphs share the same instance as their parent graph and have independent data.
+ *
  * **Note:**
  * Query operations are included - no credit consumption required.
  * Queue position is based on subscription tier for priority.
@@ -892,6 +919,14 @@ export declare const executeCypherQuery: <ThrowOnError extends boolean = false>(
  * Property discovery is limited to 10 properties per node type for performance.
  * For complete schema definitions, use `/schema/export`.
  *
+ * ## Subgraph Support
+ *
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * Each subgraph has independent schema and data. The returned schema reflects
+ * only the specified graph/subgraph's actual structure.
+ *
  * This operation is included - no credit consumption required.
  */
 export declare const getGraphSchema: <ThrowOnError extends boolean = false>(options: Options<GetGraphSchemaData, ThrowOnError>) => import("./client").RequestResult<GetGraphSchemaResponses, GetGraphSchemaErrors, ThrowOnError, "fields">;
@@ -969,6 +1004,13 @@ export declare const exportGraphSchema: <ThrowOnError extends boolean = false>(o
  * - Performance problems
  * - Naming conflicts
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * Schema validation is performed against the specified graph/subgraph's current
+ * schema and data structure.
+ *
  * This operation is included - no credit consumption required.
  */
 export declare const validateSchema: <ThrowOnError extends boolean = false>(options: Options<ValidateSchemaData, ThrowOnError>) => import("./client").RequestResult<ValidateSchemaResponses, ValidateSchemaErrors, ThrowOnError, "fields">;
@@ -1065,6 +1107,13 @@ export declare const checkStorageLimits: <ThrowOnError extends boolean = false>(
  * - **Resource Usage**: Memory and storage consumption
  * - **Alerts**: Active warnings or issues
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * Health metrics are specific to the requested graph/subgraph. Subgraphs share the
+ * same physical instance as their parent but have independent health indicators.
+ *
  * This endpoint provides essential monitoring data for operational visibility.
  */
 export declare const getDatabaseHealth: <ThrowOnError extends boolean = false>(options: Options<GetDatabaseHealthData, ThrowOnError>) => import("./client").RequestResult<GetDatabaseHealthResponses, GetDatabaseHealthErrors, ThrowOnError, "fields">;
@@ -1087,6 +1136,13 @@ export declare const getDatabaseHealth: <ThrowOnError extends boolean = false>(o
  * - **Backup Status**: Backup availability and recency
  * - **Timestamps**: Creation and modification dates
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * Returned metrics are specific to the requested graph/subgraph. Subgraphs have
+ * independent size, node/relationship counts, and backup status.
+ *
  * This endpoint provides essential database information for capacity planning and monitoring.
  */
 export declare const getDatabaseInfo: <ThrowOnError extends boolean = false>(options: Options<GetDatabaseInfoData, ThrowOnError>) => import("./client").RequestResult<GetDatabaseInfoResponses, GetDatabaseInfoErrors, ThrowOnError, "fields">;
@@ -1104,7 +1160,7 @@ export declare const getDatabaseInfo: <ThrowOnError extends boolean = false>(opt
  *
  * This unified endpoint provides all limits in one place for easier client integration.
  *
- * **Note**: Limits vary based on subscription tier (Standard, Enterprise, Premium).
+ * **Note**: Limits vary based on subscription tier (kuzu-standard, kuzu-large, kuzu-xlarge).
  */
 export declare const getGraphLimits: <ThrowOnError extends boolean = false>(options: Options<GetGraphLimitsData, ThrowOnError>) => import("./client").RequestResult<GetGraphLimitsResponses, GetGraphLimitsErrors, ThrowOnError, "fields">;
 /**
@@ -1135,6 +1191,12 @@ export declare const listSubgraphs: <ThrowOnError extends boolean = false>(optio
  *
  * **Returns:**
  * - Created subgraph details including its unique ID
+ * - Subgraph ID format: `{parent_id}_{subgraph_name}` (e.g., kg1234567890abcdef_dev)
+ *
+ * **Usage:**
+ * - Subgraphs share parent's credit pool
+ * - Subgraph ID can be used in all standard `/v1/graphs/{graph_id}*` endpoints
+ * - Permissions inherited from parent graph
  */
 export declare const createSubgraph: <ThrowOnError extends boolean = false>(options: Options<CreateSubgraphData, ThrowOnError>) => import("./client").RequestResult<CreateSubgraphResponses, CreateSubgraphErrors, ThrowOnError, "fields">;
 /**
@@ -1144,6 +1206,7 @@ export declare const createSubgraph: <ThrowOnError extends boolean = false>(opti
  * **Requirements:**
  * - Must be a valid subgraph (not parent graph)
  * - User must have admin access to parent graph
+ * - Subgraph name must be alphanumeric (1-20 characters)
  * - Optional backup before deletion
  *
  * **Deletion Options:**
@@ -1157,6 +1220,11 @@ export declare const createSubgraph: <ThrowOnError extends boolean = false>(opti
  * **Backup Location:**
  * If backup requested, stored in S3 Kuzu database bucket at:
  * `s3://{kuzu_s3_bucket}/{instance_id}/{database_name}_{timestamp}.backup`
+ *
+ * **Notes:**
+ * - Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID
+ * - Deletion does not affect parent graph's credit pool or permissions
+ * - Backup creation consumes credits from parent graph's allocation
  */
 export declare const deleteSubgraph: <ThrowOnError extends boolean = false>(options: Options<DeleteSubgraphData, ThrowOnError>) => import("./client").RequestResult<DeleteSubgraphResponses, DeleteSubgraphErrors, ThrowOnError, "fields">;
 /**
@@ -1165,6 +1233,7 @@ export declare const deleteSubgraph: <ThrowOnError extends boolean = false>(opti
  *
  * **Requirements:**
  * - User must have read access to parent graph
+ * - Subgraph name must be alphanumeric (1-20 characters)
  *
  * **Response includes:**
  * - Full subgraph metadata
@@ -1180,6 +1249,10 @@ export declare const deleteSubgraph: <ThrowOnError extends boolean = false>(opti
  * - Edge count
  * - Database size on disk
  * - Schema information
+ *
+ * **Note:**
+ * Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID.
+ * The full ID is returned in the response (e.g., 'kg0123456789abcdef_dev').
  */
 export declare const getSubgraphInfo: <ThrowOnError extends boolean = false>(options: Options<GetSubgraphInfoData, ThrowOnError>) => import("./client").RequestResult<GetSubgraphInfoResponses, GetSubgraphInfoErrors, ThrowOnError, "fields">;
 /**
@@ -1337,6 +1410,13 @@ export declare const listTableFiles: <ThrowOnError extends boolean = false>(opti
  * Tables are automatically created on first file upload with type inferred from name
  * (e.g., "Transaction" → relationship) and empty schema populated during ingestion.
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * Each subgraph has completely isolated S3 staging areas and tables. Files uploaded
+ * to one subgraph do not appear in other subgraphs.
+ *
  * **Important Notes:**
  * - Presigned URLs expire (default: 1 hour)
  * - Use appropriate Content-Type header when uploading to S3
@@ -1456,7 +1536,7 @@ export declare const updateFileStatus: <ThrowOnError extends boolean = false>(op
  * 2. Files are validated and marked as 'uploaded'
  * 3. Trigger ingestion: `POST /tables/ingest`
  * 4. DuckDB staging tables created from S3 patterns
- * 5. Data copied row-by-row from DuckDB to Kuzu
+ * 5. Data copied from DuckDB to Kuzu
  * 6. Per-table results and metrics returned
  *
  * **Rebuild Feature:**
@@ -1487,6 +1567,13 @@ export declare const updateFileStatus: <ThrowOnError extends boolean = false>(op
  * you'll receive a 409 Conflict error. The distributed lock automatically expires after
  * the configured TTL (default: 1 hour) to prevent deadlocks from failed ingestions.
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * Each subgraph has independent staging tables and graph data. Ingestion operates
+ * on the specified graph/subgraph only and does not affect other subgraphs.
+ *
  * **Important Notes:**
  * - Only files with 'uploaded' status are processed
  * - Tables with no uploaded files are skipped
@@ -1543,6 +1630,12 @@ export declare const ingestTables: <ThrowOnError extends boolean = false>(option
  * - Read-only: No INSERT, UPDATE, DELETE
  * - User's tables only: Cannot query other users' data
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * Each subgraph has its own independent staging tables.
+ *
  * **Shared Repositories:**
  * Shared repositories (SEC, etc.) do not allow direct SQL queries.
  * Use the graph query endpoint instead: `POST /v1/graphs/{graph_id}/query`

package/sdk/sdk.gen.js

@@ -1103,6 +1103,13 @@ exports.listAgents = listAgents;
  * - Leverage conversation history for contextual understanding
  * - Enable RAG for knowledge base enrichment
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * Agents operate on the specified graph/subgraph's data independently. RAG enrichment
+ * and knowledge base search are scoped to the specific graph/subgraph.
+ *
  * See request/response examples in the "Examples" dropdown below.
  */
 const autoSelectAgent = (options) => {
@@ -1287,6 +1294,13 @@ exports.recommendAgent = recommendAgent;
  * - User permissions and subscription tier
  * - Backend capabilities (Kuzu, Neo4j, etc.)
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * The returned tool list is identical for parent graphs and subgraphs, as all
+ * MCP tools work uniformly across graph boundaries.
+ *
  * **Note:**
  * MCP tool listing is included - no credit consumption required.
  */
@@ -1341,6 +1355,13 @@ exports.listMcpTools = listMcpTools;
  * - `408 Request Timeout`: Tool execution exceeded timeout
  * - Clients should implement exponential backoff on errors
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * MCP tools operate on the specified graph/subgraph independently. Each subgraph
+ * has its own schema, data, and can be queried separately via MCP.
+ *
  * **Credit Model:**
  * MCP tool execution is included - no credit consumption required. Database
  * operations (queries, schema inspection, analytics) are completely free.
@@ -1748,6 +1769,12 @@ exports.getGraphUsageAnalytics = getGraphUsageAnalytics;
  * - `503 Service Unavailable`: Circuit breaker open or SSE disabled
  * - Clients should implement exponential backoff
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * Subgraphs share the same instance as their parent graph and have independent data.
+ *
  * **Note:**
  * Query operations are included - no credit consumption required.
  * Queue position is based on subscription tier for priority.
@@ -1810,6 +1837,14 @@ exports.executeCypherQuery = executeCypherQuery;
  * Property discovery is limited to 10 properties per node type for performance.
  * For complete schema definitions, use `/schema/export`.
  *
+ * ## Subgraph Support
+ *
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * Each subgraph has independent schema and data. The returned schema reflects
+ * only the specified graph/subgraph's actual structure.
+ *
  * This operation is included - no credit consumption required.
  */
 const getGraphSchema = (options) => {
@@ -1919,6 +1954,13 @@ exports.exportGraphSchema = exportGraphSchema;
  * - Performance problems
  * - Naming conflicts
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * Schema validation is performed against the specified graph/subgraph's current
+ * schema and data structure.
+ *
  * This operation is included - no credit consumption required.
  */
 const validateSchema = (options) => {
@@ -2115,6 +2157,13 @@ exports.checkStorageLimits = checkStorageLimits;
  * - **Resource Usage**: Memory and storage consumption
  * - **Alerts**: Active warnings or issues
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * Health metrics are specific to the requested graph/subgraph. Subgraphs share the
+ * same physical instance as their parent but have independent health indicators.
+ *
  * This endpoint provides essential monitoring data for operational visibility.
  */
 const getDatabaseHealth = (options) => {
@@ -2153,6 +2202,13 @@ exports.getDatabaseHealth = getDatabaseHealth;
  * - **Backup Status**: Backup availability and recency
  * - **Timestamps**: Creation and modification dates
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * Returned metrics are specific to the requested graph/subgraph. Subgraphs have
+ * independent size, node/relationship counts, and backup status.
+ *
  * This endpoint provides essential database information for capacity planning and monitoring.
  */
 const getDatabaseInfo = (options) => {
@@ -2186,7 +2242,7 @@ exports.getDatabaseInfo = getDatabaseInfo;
  *
  * This unified endpoint provides all limits in one place for easier client integration.
  *
- * **Note**: Limits vary based on subscription tier (Standard, Enterprise, Premium).
+ * **Note**: Limits vary based on subscription tier (kuzu-standard, kuzu-large, kuzu-xlarge).
  */
 const getGraphLimits = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -2249,6 +2305,12 @@ exports.listSubgraphs = listSubgraphs;
  *
  * **Returns:**
  * - Created subgraph details including its unique ID
+ * - Subgraph ID format: `{parent_id}_{subgraph_name}` (e.g., kg1234567890abcdef_dev)
+ *
+ * **Usage:**
+ * - Subgraphs share parent's credit pool
+ * - Subgraph ID can be used in all standard `/v1/graphs/{graph_id}*` endpoints
+ * - Permissions inherited from parent graph
  */
 const createSubgraph = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -2278,6 +2340,7 @@ exports.createSubgraph = createSubgraph;
  * **Requirements:**
  * - Must be a valid subgraph (not parent graph)
  * - User must have admin access to parent graph
+ * - Subgraph name must be alphanumeric (1-20 characters)
  * - Optional backup before deletion
  *
  * **Deletion Options:**
@@ -2291,6 +2354,11 @@ exports.createSubgraph = createSubgraph;
  * **Backup Location:**
  * If backup requested, stored in S3 Kuzu database bucket at:
  * `s3://{kuzu_s3_bucket}/{instance_id}/{database_name}_{timestamp}.backup`
+ *
+ * **Notes:**
+ * - Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID
+ * - Deletion does not affect parent graph's credit pool or permissions
+ * - Backup creation consumes credits from parent graph's allocation
  */
 const deleteSubgraph = (options) => {
     return (options.client ?? client_gen_1.client).delete({
@@ -2304,7 +2372,7 @@ const deleteSubgraph = (options) => {
                 type: 'http'
             }
         ],
-        url: '/v1/graphs/{graph_id}/subgraphs/{subgraph_id}',
+        url: '/v1/graphs/{graph_id}/subgraphs/{subgraph_name}',
         ...options,
         headers: {
             'Content-Type': 'application/json',
@@ -2319,6 +2387,7 @@ exports.deleteSubgraph = deleteSubgraph;
  *
  * **Requirements:**
  * - User must have read access to parent graph
+ * - Subgraph name must be alphanumeric (1-20 characters)
  *
  * **Response includes:**
  * - Full subgraph metadata
@@ -2334,6 +2403,10 @@ exports.deleteSubgraph = deleteSubgraph;
  * - Edge count
  * - Database size on disk
  * - Schema information
+ *
+ * **Note:**
+ * Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID.
+ * The full ID is returned in the response (e.g., 'kg0123456789abcdef_dev').
  */
 const getSubgraphInfo = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -2347,7 +2420,7 @@ const getSubgraphInfo = (options) => {
                 type: 'http'
             }
         ],
-        url: '/v1/graphs/{graph_id}/subgraphs/{subgraph_id}/info',
+        url: '/v1/graphs/{graph_id}/subgraphs/{subgraph_name}/info',
         ...options
     });
 };
@@ -2611,6 +2684,13 @@ exports.listTableFiles = listTableFiles;
  * Tables are automatically created on first file upload with type inferred from name
  * (e.g., "Transaction" → relationship) and empty schema populated during ingestion.
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * Each subgraph has completely isolated S3 staging areas and tables. Files uploaded
+ * to one subgraph do not appear in other subgraphs.
+ *
  * **Important Notes:**
  * - Presigned URLs expire (default: 1 hour)
  * - Use appropriate Content-Type header when uploading to S3
@@ -2802,7 +2882,7 @@ exports.updateFileStatus = updateFileStatus;
  * 2. Files are validated and marked as 'uploaded'
  * 3. Trigger ingestion: `POST /tables/ingest`
  * 4. DuckDB staging tables created from S3 patterns
- * 5. Data copied row-by-row from DuckDB to Kuzu
+ * 5. Data copied from DuckDB to Kuzu
  * 6. Per-table results and metrics returned
  *
  * **Rebuild Feature:**
@@ -2833,6 +2913,13 @@ exports.updateFileStatus = updateFileStatus;
  * you'll receive a 409 Conflict error. The distributed lock automatically expires after
  * the configured TTL (default: 1 hour) to prevent deadlocks from failed ingestions.
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * Each subgraph has independent staging tables and graph data. Ingestion operates
+ * on the specified graph/subgraph only and does not affect other subgraphs.
+ *
  * **Important Notes:**
  * - Only files with 'uploaded' status are processed
  * - Tables with no uploaded files are skipped
@@ -2909,6 +2996,12 @@ exports.ingestTables = ingestTables;
  * - Read-only: No INSERT, UPDATE, DELETE
  * - User's tables only: Cannot query other users' data
  *
+ * **Subgraph Support:**
+ * This endpoint accepts both parent graph IDs and subgraph IDs.
+ * - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+ * - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+ * Each subgraph has its own independent staging tables.
+ *
  * **Shared Repositories:**
  * Shared repositories (SEC, etc.) do not allow direct SQL queries.
  * Use the graph query endpoint instead: `POST /v1/graphs/{graph_id}/query`