@elqnt/kg 3.0.0 → 3.0.2

package/dist/api/index.d.mts

@@ -1,7 +1,8 @@
 import { ApiClientOptions, ApiResponse } from '@elqnt/api-client';
 import { ResponseMetadata } from '@elqnt/types';
-import { ListGraphsResult, GetGraphResult, CreateGraphRequest, CreateGraphResult, Graph, UpdateGraphResult, DeleteGraphResult, KGQuery, KGQueryResult, KGLabelInfo, KGNode, KGNodeIngestRequest, KGSyncIngestResponse, DeleteDocumentResponse } from '../models/kg.mjs';
-import { GraphNodeResponse, GraphNodeDefinition, GraphEdgeResponse, GraphEdgeDefinition } from '../models/kg-designer.mjs';
+import { CreateGraphRequest, CreateGraphResult, DeleteGraphResult, DeleteDocumentResponse, GetGraphResult, KGLabelInfo, KGNode, KGNodeIngestRequest, KGSyncIngestResponse, ListGraphsResult, KGQuery, KGQueryResult, Graph, UpdateGraphResult } from '../models/kg.mjs';
+import { GraphEdgeDefinition, GraphEdgeResponse, GraphNodeDefinition, GraphNodeResponse } from '../models/kg-designer.mjs';
+import { FullIngestCancelResult, QuickIngestCancelResult, FullIngestJob, FullIngestNodesRequest, FullIngestNodesResult, FullIngestJobsListResponse, FullIngestExtractionRequest, FullIngestExtractionResult, QuickIngestStartRequest } from '../models/index.mjs';
 
 /**
  * Knowledge Graph Browser API
@@ -206,10 +207,11 @@ declare function ingestDocumentApi(document: {
  * Delete a document from the knowledge graph
  *
  * @param documentId - The document ID to delete
- * @param options - API options including optional graphId
+ * @param options - API options including optional graphId and cascade
+ * @param cascade - If true, also delete all connected nodes (articles, etc.). Default: false
  * @returns Deletion result with counts
  */
-declare function deleteKGDocumentApi(documentId: string, options: KGApiOptions): Promise<ApiResponse<DeleteDocumentResponse>>;
+declare function deleteKGDocumentApi(documentId: string, options: KGApiOptions, cascade?: boolean): Promise<ApiResponse<DeleteDocumentResponse>>;
 /**
  * Optimize the knowledge graph
  *
@@ -353,5 +355,92 @@ declare function cancelCrawlJobApi(jobId: string, options: KGApiOptions): Promis
  * @returns List of crawled pages
  */
 declare function getCrawledPagesApi(jobId: string, options: KGApiOptions): Promise<ApiResponse<CrawledPagesResponse>>;
+/**
+ * Quick ingest SSE event types
+ */
+interface QuickIngestEvent {
+    type: "started" | "item_start" | "item_progress" | "item_complete" | "item_error" | "job_complete" | "error" | "cancelled";
+    itemId?: string;
+    message?: string;
+    progress?: number;
+    text?: string;
+    error?: string;
+    articles?: number;
+    topics?: number;
+    nodesCreated?: number;
+    nodesByLabel?: Record<string, number>;
+    timestamp: number;
+}
+/**
+ * Start a quick ingestion job with SSE streaming response
+ *
+ * @param request - Quick ingestion start request
+ * @param options - API options including optional graphId
+ * @param onEvent - Callback for each SSE event
+ * @returns Promise that resolves when streaming completes
+ *
+ * @example
+ * ```ts
+ * await startQuickIngestApi(
+ *   { items: [...], options: {...}, graphId: "default" },
+ *   { baseUrl, orgId },
+ *   (event) => {
+ *     if (event.type === "item_complete") {
+ *       console.log(`Completed: ${event.itemId}`);
+ *     }
+ *   }
+ * );
+ * ```
+ */
+declare function startQuickIngestApi(request: QuickIngestStartRequest, options: KGApiOptions, onEvent: (event: QuickIngestEvent) => void): Promise<void>;
+/**
+ * Cancel a quick ingestion job
+ *
+ * @param jobId - The job ID to cancel
+ * @param options - API options including optional graphId
+ * @returns Cancel result with status
+ */
+declare function cancelQuickIngestApi(jobId: string, options: KGApiOptions): Promise<ApiResponse<QuickIngestCancelResult>>;
+/**
+ * Start full ingestion extraction
+ *
+ * @param request - Extraction request with source and labels
+ * @param options - API options including optional graphId
+ * @returns Extraction job result
+ */
+declare function startFullIngestExtractionApi(request: FullIngestExtractionRequest, options: KGApiOptions): Promise<ApiResponse<FullIngestExtractionResult>>;
+/**
+ * Cancel full ingestion extraction
+ *
+ * @param jobId - The job ID to cancel
+ * @param options - API options including optional graphId
+ * @returns Cancel result with status
+ */
+declare function cancelFullIngestExtractionApi(jobId: string, options: KGApiOptions): Promise<ApiResponse<FullIngestCancelResult>>;
+/**
+ * Ingest extracted nodes into the knowledge graph
+ *
+ * @param request - Nodes to ingest
+ * @param options - API options including optional graphId
+ * @returns Ingest result with counts
+ */
+declare function ingestFullIngestNodesApi(request: FullIngestNodesRequest, options: KGApiOptions): Promise<ApiResponse<FullIngestNodesResult>>;
+/**
+ * List full ingestion jobs for the organization
+ *
+ * @param options - API options including optional limit
+ * @returns List of job summaries
+ */
+declare function listFullIngestJobsApi(options: KGApiOptions & {
+    limit?: number;
+}): Promise<ApiResponse<FullIngestJobsListResponse>>;
+/**
+ * Get a specific full ingestion job by ID
+ *
+ * @param jobId - The job ID
+ * @param options - API options
+ * @returns The job details including nodes, edges, and events
+ */
+declare function getFullIngestJobApi(jobId: string, options: KGApiOptions): Promise<ApiResponse<FullIngestJob>>;
 
-export { type CrawlJob, type CrawlJobStartResponse, type CrawlJobStatusResponse, type CrawlJobsListResponse, type CrawledPagesResponse, type KGApiOptions, cancelCrawlJobApi, createDesignerEdgeApi, createDesignerNodeApi, createGraphApi, deleteDesignerEdgeApi, deleteDesignerNodeApi, deleteGraphApi, deleteKGDocumentApi, getCrawlJobStatusApi, getCrawledPagesApi, getDesignerEdgeApi, getDesignerNodeApi, getGraphApi, getGraphLabelsApi, getKGNodeApi, getNodeConnectionStatsApi, ingestDocumentApi, ingestKGNodeApi, listCrawlJobsApi, listDesignerEdgesApi, listDesignerNodesApi, listGraphsApi, optimizeGraphApi, queryGraphApi, startCrawlJobApi, updateDesignerEdgeApi, updateDesignerNodeApi, updateGraphApi, updateKGNodeApi };
+export { type CrawlJob, type CrawlJobStartResponse, type CrawlJobStatusResponse, type CrawlJobsListResponse, type CrawledPagesResponse, type KGApiOptions, type QuickIngestEvent, cancelCrawlJobApi, cancelFullIngestExtractionApi, cancelQuickIngestApi, createDesignerEdgeApi, createDesignerNodeApi, createGraphApi, deleteDesignerEdgeApi, deleteDesignerNodeApi, deleteGraphApi, deleteKGDocumentApi, getCrawlJobStatusApi, getCrawledPagesApi, getDesignerEdgeApi, getDesignerNodeApi, getFullIngestJobApi, getGraphApi, getGraphLabelsApi, getKGNodeApi, getNodeConnectionStatsApi, ingestDocumentApi, ingestFullIngestNodesApi, ingestKGNodeApi, listCrawlJobsApi, listDesignerEdgesApi, listDesignerNodesApi, listFullIngestJobsApi, listGraphsApi, optimizeGraphApi, queryGraphApi, startCrawlJobApi, startFullIngestExtractionApi, startQuickIngestApi, updateDesignerEdgeApi, updateDesignerNodeApi, updateGraphApi, updateKGNodeApi };

package/dist/api/index.d.ts

@@ -1,7 +1,8 @@
 import { ApiClientOptions, ApiResponse } from '@elqnt/api-client';
 import { ResponseMetadata } from '@elqnt/types';
-import { ListGraphsResult, GetGraphResult, CreateGraphRequest, CreateGraphResult, Graph, UpdateGraphResult, DeleteGraphResult, KGQuery, KGQueryResult, KGLabelInfo, KGNode, KGNodeIngestRequest, KGSyncIngestResponse, DeleteDocumentResponse } from '../models/kg.js';
-import { GraphNodeResponse, GraphNodeDefinition, GraphEdgeResponse, GraphEdgeDefinition } from '../models/kg-designer.js';
+import { CreateGraphRequest, CreateGraphResult, DeleteGraphResult, DeleteDocumentResponse, GetGraphResult, KGLabelInfo, KGNode, KGNodeIngestRequest, KGSyncIngestResponse, ListGraphsResult, KGQuery, KGQueryResult, Graph, UpdateGraphResult } from '../models/kg.js';
+import { GraphEdgeDefinition, GraphEdgeResponse, GraphNodeDefinition, GraphNodeResponse } from '../models/kg-designer.js';
+import { FullIngestCancelResult, QuickIngestCancelResult, FullIngestJob, FullIngestNodesRequest, FullIngestNodesResult, FullIngestJobsListResponse, FullIngestExtractionRequest, FullIngestExtractionResult, QuickIngestStartRequest } from '../models/index.js';
 
 /**
  * Knowledge Graph Browser API
@@ -206,10 +207,11 @@ declare function ingestDocumentApi(document: {
  * Delete a document from the knowledge graph
  *
  * @param documentId - The document ID to delete
- * @param options - API options including optional graphId
+ * @param options - API options including optional graphId and cascade
+ * @param cascade - If true, also delete all connected nodes (articles, etc.). Default: false
  * @returns Deletion result with counts
  */
-declare function deleteKGDocumentApi(documentId: string, options: KGApiOptions): Promise<ApiResponse<DeleteDocumentResponse>>;
+declare function deleteKGDocumentApi(documentId: string, options: KGApiOptions, cascade?: boolean): Promise<ApiResponse<DeleteDocumentResponse>>;
 /**
  * Optimize the knowledge graph
  *
@@ -353,5 +355,92 @@ declare function cancelCrawlJobApi(jobId: string, options: KGApiOptions): Promis
  * @returns List of crawled pages
  */
 declare function getCrawledPagesApi(jobId: string, options: KGApiOptions): Promise<ApiResponse<CrawledPagesResponse>>;
+/**
+ * Quick ingest SSE event types
+ */
+interface QuickIngestEvent {
+    type: "started" | "item_start" | "item_progress" | "item_complete" | "item_error" | "job_complete" | "error" | "cancelled";
+    itemId?: string;
+    message?: string;
+    progress?: number;
+    text?: string;
+    error?: string;
+    articles?: number;
+    topics?: number;
+    nodesCreated?: number;
+    nodesByLabel?: Record<string, number>;
+    timestamp: number;
+}
+/**
+ * Start a quick ingestion job with SSE streaming response
+ *
+ * @param request - Quick ingestion start request
+ * @param options - API options including optional graphId
+ * @param onEvent - Callback for each SSE event
+ * @returns Promise that resolves when streaming completes
+ *
+ * @example
+ * ```ts
+ * await startQuickIngestApi(
+ *   { items: [...], options: {...}, graphId: "default" },
+ *   { baseUrl, orgId },
+ *   (event) => {
+ *     if (event.type === "item_complete") {
+ *       console.log(`Completed: ${event.itemId}`);
+ *     }
+ *   }
+ * );
+ * ```
+ */
+declare function startQuickIngestApi(request: QuickIngestStartRequest, options: KGApiOptions, onEvent: (event: QuickIngestEvent) => void): Promise<void>;
+/**
+ * Cancel a quick ingestion job
+ *
+ * @param jobId - The job ID to cancel
+ * @param options - API options including optional graphId
+ * @returns Cancel result with status
+ */
+declare function cancelQuickIngestApi(jobId: string, options: KGApiOptions): Promise<ApiResponse<QuickIngestCancelResult>>;
+/**
+ * Start full ingestion extraction
+ *
+ * @param request - Extraction request with source and labels
+ * @param options - API options including optional graphId
+ * @returns Extraction job result
+ */
+declare function startFullIngestExtractionApi(request: FullIngestExtractionRequest, options: KGApiOptions): Promise<ApiResponse<FullIngestExtractionResult>>;
+/**
+ * Cancel full ingestion extraction
+ *
+ * @param jobId - The job ID to cancel
+ * @param options - API options including optional graphId
+ * @returns Cancel result with status
+ */
+declare function cancelFullIngestExtractionApi(jobId: string, options: KGApiOptions): Promise<ApiResponse<FullIngestCancelResult>>;
+/**
+ * Ingest extracted nodes into the knowledge graph
+ *
+ * @param request - Nodes to ingest
+ * @param options - API options including optional graphId
+ * @returns Ingest result with counts
+ */
+declare function ingestFullIngestNodesApi(request: FullIngestNodesRequest, options: KGApiOptions): Promise<ApiResponse<FullIngestNodesResult>>;
+/**
+ * List full ingestion jobs for the organization
+ *
+ * @param options - API options including optional limit
+ * @returns List of job summaries
+ */
+declare function listFullIngestJobsApi(options: KGApiOptions & {
+    limit?: number;
+}): Promise<ApiResponse<FullIngestJobsListResponse>>;
+/**
+ * Get a specific full ingestion job by ID
+ *
+ * @param jobId - The job ID
+ * @param options - API options
+ * @returns The job details including nodes, edges, and events
+ */
+declare function getFullIngestJobApi(jobId: string, options: KGApiOptions): Promise<ApiResponse<FullIngestJob>>;
 
-export { type CrawlJob, type CrawlJobStartResponse, type CrawlJobStatusResponse, type CrawlJobsListResponse, type CrawledPagesResponse, type KGApiOptions, cancelCrawlJobApi, createDesignerEdgeApi, createDesignerNodeApi, createGraphApi, deleteDesignerEdgeApi, deleteDesignerNodeApi, deleteGraphApi, deleteKGDocumentApi, getCrawlJobStatusApi, getCrawledPagesApi, getDesignerEdgeApi, getDesignerNodeApi, getGraphApi, getGraphLabelsApi, getKGNodeApi, getNodeConnectionStatsApi, ingestDocumentApi, ingestKGNodeApi, listCrawlJobsApi, listDesignerEdgesApi, listDesignerNodesApi, listGraphsApi, optimizeGraphApi, queryGraphApi, startCrawlJobApi, updateDesignerEdgeApi, updateDesignerNodeApi, updateGraphApi, updateKGNodeApi };
+export { type CrawlJob, type CrawlJobStartResponse, type CrawlJobStatusResponse, type CrawlJobsListResponse, type CrawledPagesResponse, type KGApiOptions, type QuickIngestEvent, cancelCrawlJobApi, cancelFullIngestExtractionApi, cancelQuickIngestApi, createDesignerEdgeApi, createDesignerNodeApi, createGraphApi, deleteDesignerEdgeApi, deleteDesignerNodeApi, deleteGraphApi, deleteKGDocumentApi, getCrawlJobStatusApi, getCrawledPagesApi, getDesignerEdgeApi, getDesignerNodeApi, getFullIngestJobApi, getGraphApi, getGraphLabelsApi, getKGNodeApi, getNodeConnectionStatsApi, ingestDocumentApi, ingestFullIngestNodesApi, ingestKGNodeApi, listCrawlJobsApi, listDesignerEdgesApi, listDesignerNodesApi, listFullIngestJobsApi, listGraphsApi, optimizeGraphApi, queryGraphApi, startCrawlJobApi, startFullIngestExtractionApi, startQuickIngestApi, updateDesignerEdgeApi, updateDesignerNodeApi, updateGraphApi, updateKGNodeApi };

package/dist/api/index.js

@@ -29,7 +29,6 @@
 
 
 
-var _chunk2TJCYLTPjs = require('../chunk-2TJCYLTP.js');
 
 
 
@@ -37,6 +36,7 @@ var _chunk2TJCYLTPjs = require('../chunk-2TJCYLTP.js');
 
 
 
+var _chunkCNWOI7LXjs = require('../chunk-CNWOI7LX.js');
 
 
 
@@ -60,5 +60,19 @@ var _chunk2TJCYLTPjs = require('../chunk-2TJCYLTP.js');
 
 
 
-exports.cancelCrawlJobApi = _chunk2TJCYLTPjs.cancelCrawlJobApi; exports.createDesignerEdgeApi = _chunk2TJCYLTPjs.createDesignerEdgeApi; exports.createDesignerNodeApi = _chunk2TJCYLTPjs.createDesignerNodeApi; exports.createGraphApi = _chunk2TJCYLTPjs.createGraphApi; exports.deleteDesignerEdgeApi = _chunk2TJCYLTPjs.deleteDesignerEdgeApi; exports.deleteDesignerNodeApi = _chunk2TJCYLTPjs.deleteDesignerNodeApi; exports.deleteGraphApi = _chunk2TJCYLTPjs.deleteGraphApi; exports.deleteKGDocumentApi = _chunk2TJCYLTPjs.deleteKGDocumentApi; exports.getCrawlJobStatusApi = _chunk2TJCYLTPjs.getCrawlJobStatusApi; exports.getCrawledPagesApi = _chunk2TJCYLTPjs.getCrawledPagesApi; exports.getDesignerEdgeApi = _chunk2TJCYLTPjs.getDesignerEdgeApi; exports.getDesignerNodeApi = _chunk2TJCYLTPjs.getDesignerNodeApi; exports.getGraphApi = _chunk2TJCYLTPjs.getGraphApi; exports.getGraphLabelsApi = _chunk2TJCYLTPjs.getGraphLabelsApi; exports.getKGNodeApi = _chunk2TJCYLTPjs.getKGNodeApi; exports.getNodeConnectionStatsApi = _chunk2TJCYLTPjs.getNodeConnectionStatsApi; exports.ingestDocumentApi = _chunk2TJCYLTPjs.ingestDocumentApi; exports.ingestKGNodeApi = _chunk2TJCYLTPjs.ingestKGNodeApi; exports.listCrawlJobsApi = _chunk2TJCYLTPjs.listCrawlJobsApi; exports.listDesignerEdgesApi = _chunk2TJCYLTPjs.listDesignerEdgesApi; exports.listDesignerNodesApi = _chunk2TJCYLTPjs.listDesignerNodesApi; exports.listGraphsApi = _chunk2TJCYLTPjs.listGraphsApi; exports.optimizeGraphApi = _chunk2TJCYLTPjs.optimizeGraphApi; exports.queryGraphApi = _chunk2TJCYLTPjs.queryGraphApi; exports.startCrawlJobApi = _chunk2TJCYLTPjs.startCrawlJobApi; exports.updateDesignerEdgeApi = _chunk2TJCYLTPjs.updateDesignerEdgeApi; exports.updateDesignerNodeApi = _chunk2TJCYLTPjs.updateDesignerNodeApi; exports.updateGraphApi = _chunk2TJCYLTPjs.updateGraphApi; exports.updateKGNodeApi = _chunk2TJCYLTPjs.updateKGNodeApi;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.cancelCrawlJobApi = _chunkCNWOI7LXjs.cancelCrawlJobApi; exports.cancelFullIngestExtractionApi = _chunkCNWOI7LXjs.cancelFullIngestExtractionApi; exports.cancelQuickIngestApi = _chunkCNWOI7LXjs.cancelQuickIngestApi; exports.createDesignerEdgeApi = _chunkCNWOI7LXjs.createDesignerEdgeApi; exports.createDesignerNodeApi = _chunkCNWOI7LXjs.createDesignerNodeApi; exports.createGraphApi = _chunkCNWOI7LXjs.createGraphApi; exports.deleteDesignerEdgeApi = _chunkCNWOI7LXjs.deleteDesignerEdgeApi; exports.deleteDesignerNodeApi = _chunkCNWOI7LXjs.deleteDesignerNodeApi; exports.deleteGraphApi = _chunkCNWOI7LXjs.deleteGraphApi; exports.deleteKGDocumentApi = _chunkCNWOI7LXjs.deleteKGDocumentApi; exports.getCrawlJobStatusApi = _chunkCNWOI7LXjs.getCrawlJobStatusApi; exports.getCrawledPagesApi = _chunkCNWOI7LXjs.getCrawledPagesApi; exports.getDesignerEdgeApi = _chunkCNWOI7LXjs.getDesignerEdgeApi; exports.getDesignerNodeApi = _chunkCNWOI7LXjs.getDesignerNodeApi; exports.getFullIngestJobApi = _chunkCNWOI7LXjs.getFullIngestJobApi; exports.getGraphApi = _chunkCNWOI7LXjs.getGraphApi; exports.getGraphLabelsApi = _chunkCNWOI7LXjs.getGraphLabelsApi; exports.getKGNodeApi = _chunkCNWOI7LXjs.getKGNodeApi; exports.getNodeConnectionStatsApi = _chunkCNWOI7LXjs.getNodeConnectionStatsApi; exports.ingestDocumentApi = _chunkCNWOI7LXjs.ingestDocumentApi; exports.ingestFullIngestNodesApi = _chunkCNWOI7LXjs.ingestFullIngestNodesApi; exports.ingestKGNodeApi = _chunkCNWOI7LXjs.ingestKGNodeApi; exports.listCrawlJobsApi = _chunkCNWOI7LXjs.listCrawlJobsApi; exports.listDesignerEdgesApi = _chunkCNWOI7LXjs.listDesignerEdgesApi; exports.listDesignerNodesApi = _chunkCNWOI7LXjs.listDesignerNodesApi; exports.listFullIngestJobsApi = _chunkCNWOI7LXjs.listFullIngestJobsApi; exports.listGraphsApi = _chunkCNWOI7LXjs.listGraphsApi; exports.optimizeGraphApi = _chunkCNWOI7LXjs.optimizeGraphApi; exports.queryGraphApi = _chunkCNWOI7LXjs.queryGraphApi; exports.startCrawlJobApi = _chunkCNWOI7LXjs.startCrawlJobApi; exports.startFullIngestExtractionApi = _chunkCNWOI7LXjs.startFullIngestExtractionApi; exports.startQuickIngestApi = _chunkCNWOI7LXjs.startQuickIngestApi; exports.updateDesignerEdgeApi = _chunkCNWOI7LXjs.updateDesignerEdgeApi; exports.updateDesignerNodeApi = _chunkCNWOI7LXjs.updateDesignerNodeApi; exports.updateGraphApi = _chunkCNWOI7LXjs.updateGraphApi; exports.updateKGNodeApi = _chunkCNWOI7LXjs.updateKGNodeApi;
 //# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/eloquent-packages/eloquent-packages/packages/kg/dist/api/index.js"],"names":[],"mappings":"AAAA,qFAAY;AACZ;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,uDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,q1DAAC","file":"/home/runner/work/eloquent-packages/eloquent-packages/packages/kg/dist/api/index.js"}
+{"version":3,"sources":["/home/runner/work/eloquent/eloquent/packages/@elqnt/kg/dist/api/index.js"],"names":[],"mappings":"AAAA,qFAAY;AACZ;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,uDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,u2EAAC","file":"/home/runner/work/eloquent/eloquent/packages/@elqnt/kg/dist/api/index.js"}

package/dist/api/index.mjs

@@ -1,6 +1,8 @@
 "use client";
 import {
   cancelCrawlJobApi,
+  cancelFullIngestExtractionApi,
+  cancelQuickIngestApi,
   createDesignerEdgeApi,
   createDesignerNodeApi,
   createGraphApi,
@@ -12,26 +14,33 @@ import {
   getCrawledPagesApi,
   getDesignerEdgeApi,
   getDesignerNodeApi,
+  getFullIngestJobApi,
   getGraphApi,
   getGraphLabelsApi,
   getKGNodeApi,
   getNodeConnectionStatsApi,
   ingestDocumentApi,
+  ingestFullIngestNodesApi,
   ingestKGNodeApi,
   listCrawlJobsApi,
   listDesignerEdgesApi,
   listDesignerNodesApi,
+  listFullIngestJobsApi,
   listGraphsApi,
   optimizeGraphApi,
   queryGraphApi,
   startCrawlJobApi,
+  startFullIngestExtractionApi,
+  startQuickIngestApi,
   updateDesignerEdgeApi,
   updateDesignerNodeApi,
   updateGraphApi,
   updateKGNodeApi
-} from "../chunk-HCDFJCQL.mjs";
+} from "../chunk-5D7RJC7D.mjs";
 export {
   cancelCrawlJobApi,
+  cancelFullIngestExtractionApi,
+  cancelQuickIngestApi,
   createDesignerEdgeApi,
   createDesignerNodeApi,
   createGraphApi,
@@ -43,19 +52,24 @@ export {
   getCrawledPagesApi,
   getDesignerEdgeApi,
   getDesignerNodeApi,
+  getFullIngestJobApi,
   getGraphApi,
   getGraphLabelsApi,
   getKGNodeApi,
   getNodeConnectionStatsApi,
   ingestDocumentApi,
+  ingestFullIngestNodesApi,
   ingestKGNodeApi,
   listCrawlJobsApi,
   listDesignerEdgesApi,
   listDesignerNodesApi,
+  listFullIngestJobsApi,
   listGraphsApi,
   optimizeGraphApi,
   queryGraphApi,
   startCrawlJobApi,
+  startFullIngestExtractionApi,
+  startQuickIngestApi,
   updateDesignerEdgeApi,
   updateDesignerNodeApi,
   updateGraphApi,

package/dist/api/server.d.mts

@@ -1,8 +1,9 @@
 import { ApiResponse } from '@elqnt/api-client';
 import { ResponseMetadata } from '@elqnt/types';
-import { ListGraphsResult, GetGraphResult, CreateGraphRequest, CreateGraphResult, Graph, UpdateGraphResult, DeleteGraphResult, KGQuery, KGQueryResult, KGLabelInfo, KGNode, KGNodeIngestRequest, KGSyncIngestResponse, DeleteDocumentResponse } from '../models/kg.mjs';
-import { GraphNodeResponse, GraphNodeDefinition, GraphEdgeResponse, GraphEdgeDefinition } from '../models/kg-designer.mjs';
-import { CrawlJobsListResponse, CrawlJobStartResponse, CrawlJobStatusResponse, CrawledPagesResponse } from './index.mjs';
+import { CreateGraphRequest, CreateGraphResult, DeleteGraphResult, DeleteDocumentResponse, KGLabelInfo, GetGraphResult, KGNode, KGNodeIngestRequest, KGSyncIngestResponse, ListGraphsResult, KGQuery, KGQueryResult, Graph, UpdateGraphResult } from '../models/kg.mjs';
+import { GraphEdgeDefinition, GraphEdgeResponse, GraphNodeDefinition, GraphNodeResponse } from '../models/kg-designer.mjs';
+import { CrawlJobStatusResponse, CrawledPagesResponse, CrawlJobsListResponse, CrawlJobStartResponse } from './index.mjs';
+import '../models/index.mjs';
 
 /**
  * Knowledge Graph Server API

package/dist/api/server.d.ts

@@ -1,8 +1,9 @@
 import { ApiResponse } from '@elqnt/api-client';
 import { ResponseMetadata } from '@elqnt/types';
-import { ListGraphsResult, GetGraphResult, CreateGraphRequest, CreateGraphResult, Graph, UpdateGraphResult, DeleteGraphResult, KGQuery, KGQueryResult, KGLabelInfo, KGNode, KGNodeIngestRequest, KGSyncIngestResponse, DeleteDocumentResponse } from '../models/kg.js';
-import { GraphNodeResponse, GraphNodeDefinition, GraphEdgeResponse, GraphEdgeDefinition } from '../models/kg-designer.js';
-import { CrawlJobsListResponse, CrawlJobStartResponse, CrawlJobStatusResponse, CrawledPagesResponse } from './index.js';
+import { CreateGraphRequest, CreateGraphResult, DeleteGraphResult, DeleteDocumentResponse, KGLabelInfo, GetGraphResult, KGNode, KGNodeIngestRequest, KGSyncIngestResponse, ListGraphsResult, KGQuery, KGQueryResult, Graph, UpdateGraphResult } from '../models/kg.js';
+import { GraphEdgeDefinition, GraphEdgeResponse, GraphNodeDefinition, GraphNodeResponse } from '../models/kg-designer.js';
+import { CrawlJobStatusResponse, CrawledPagesResponse, CrawlJobsListResponse, CrawlJobStartResponse } from './index.js';
+import '../models/index.js';
 
 /**
  * Knowledge Graph Server API

package/dist/api/server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/eloquent-packages/eloquent-packages/packages/kg/dist/api/server.js","../../api/server.ts"],"names":[],"mappings":"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CJ,IAAA;AACC,IAAA;AACG,IAAA;AACF,IAAA;AACF,IAAA;AAChB,EAAA;AACH;AAME;AAGwB,EAAA;AACd,IAAA;AACF,IAAA;AACc,IAAA;AACD,IAAA;AACJ,IAAA;AACC,IAAA;AACG,IAAA;AACW,IAAA;AACb,IAAA;AACF,IAAA;AAChB,EAAA;AACH;AAME;AAGqC,EAAA;AACb,EAAA;AACd,IAAA;AACY,IAAA;AACD,IAAA;AACJ,IAAA;AACC,IAAA;AACG,IAAA;AACF,IAAA;AACF,IAAA;AAChB,EAAA;AACH;AAME;AAGwB,EAAA;AACd,IAAA;AACD,IAAA;AACa,IAAA;AACD,IAAA;AACJ,IAAA;AACC,IAAA;AACG,IAAA;AACW,IAAA;AACb,IAAA;AACF,IAAA;AAChB,EAAA;AACH;AAME;AAGqC,EAAA;AACb,EAAA;AACd,IAAA;AACY,IAAA;AACD,IAAA;AACJ,IAAA;AACC,IAAA;AACG,IAAA;AACF,IAAA;AACF,IAAA;AAChB,EAAA;AACH;AD1UuC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/home/runner/work/eloquent-packages/eloquent-packages/packages/kg/dist/api/server.js","sourcesContent":[null,"/**\n * Knowledge Graph Server API\n *\n * Server-side API client for KG operations in server actions and SSR.\n * Uses @elqnt/api-client/server for HTTP requests with JWT token generation.\n *\n * @example\n * ```ts\n * // In a server action\n * import { listGraphsServer } from \"@elqnt/kg/api/server\";\n *\n * const graphs = await listGraphsServer({\n *   gatewayUrl: process.env.API_GATEWAY_URL!,\n *   jwtSecret: process.env.JWT_SECRET!,\n *   orgId: orgId,\n * });\n * ```\n *\n * @packageDocumentation\n */\n\nimport { serverApiRequest } from \"@elqnt/api-client/server\";\nimport type { ApiResponse } from \"@elqnt/api-client\";\nimport type { ResponseMetadata } from \"@elqnt/types\";\nimport type {\n  Graph,\n  ListGraphsResult,\n  GetGraphResult,\n  CreateGraphResult,\n  CreateGraphRequest,\n  UpdateGraphResult,\n  DeleteGraphResult,\n  KGNode,\n  KGQuery,\n  KGQueryResult,\n  KGLabelInfo,\n  KGNodeIngestRequest,\n  KGSyncIngestResponse,\n  DeleteDocumentResponse,\n  GraphNodeDefinition,\n  GraphNodeResponse,\n  GraphEdgeDefinition,\n  GraphEdgeResponse,\n} from \"../models\";\nimport type {\n  CrawlJob,\n  CrawlJobsListResponse,\n  CrawlJobStatusResponse,\n  CrawlJobStartResponse,\n  CrawledPagesResponse,\n} from \"./index\";\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\n/**\n * Options for server-side KG API calls\n */\nexport interface ServerApiOptions {\n  /** API Gateway URL */\n  gatewayUrl: string;\n  /** JWT secret for token generation */\n  jwtSecret: string;\n  /** Organization ID */\n  orgId: string;\n  /** Optional user ID (defaults to \"system\") */\n  userId?: string;\n  /** Optional user email */\n  userEmail?: string;\n  /** Optional graph ID for graph-scoped operations */\n  graphId?: string;\n  /** Request timeout in ms */\n  timeout?: number;\n  /** Request cache mode */\n  cache?: RequestCache;\n}\n\n/**\n * Build query string from parameters, filtering out undefined values\n */\nfunction buildQueryString(params: Record<string, string | undefined>): string {\n  const searchParams = new URLSearchParams();\n  for (const [key, value] of Object.entries(params)) {\n    if (value !== undefined) {\n      searchParams.set(key, value);\n    }\n  }\n  const queryString = searchParams.toString();\n  return queryString ? `?${queryString}` : \"\";\n}\n\n/**\n * Build headers including X-Graph-ID if provided\n */\nfunction buildHeaders(graphId?: string): Record<string, string> | undefined {\n  return graphId ? { \"X-Graph-ID\": graphId } : undefined;\n}\n\n// =============================================================================\n// GRAPHS\n// =============================================================================\n\n/**\n * List all knowledge graphs for the organization\n *\n * @example\n * ```ts\n * const response = await listGraphsServer({\n *   gatewayUrl: \"http://api-gateway:80\",\n *   jwtSecret: process.env.JWT_SECRET!,\n *   orgId: \"org-123\",\n * });\n * if (response.data?.graphs) {\n *   console.log(\"Graphs:\", response.data.graphs);\n * }\n * ```\n */\nexport async function listGraphsServer(\n  options: ServerApiOptions\n): Promise<ApiResponse<ListGraphsResult>> {\n  return serverApiRequest(\"/api/v1/kg/graphs\", {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Get a specific knowledge graph by ID\n */\nexport async function getGraphServer(\n  graphId: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<GetGraphResult>> {\n  return serverApiRequest(`/api/v1/kg/graphs/${graphId}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Create a new knowledge graph\n */\nexport async function createGraphServer(\n  graph: CreateGraphRequest,\n  options: ServerApiOptions\n): Promise<ApiResponse<CreateGraphResult>> {\n  return serverApiRequest(\"/api/v1/kg/graphs\", {\n    method: \"POST\",\n    body: graph,\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Update an existing knowledge graph\n */\nexport async function updateGraphServer(\n  graphId: string,\n  updates: Partial<Graph>,\n  options: ServerApiOptions\n): Promise<ApiResponse<UpdateGraphResult>> {\n  return serverApiRequest(`/api/v1/kg/graphs/${graphId}`, {\n    method: \"PUT\",\n    body: updates,\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Delete a knowledge graph\n */\nexport async function deleteGraphServer(\n  graphId: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<DeleteGraphResult>> {\n  return serverApiRequest(`/api/v1/kg/graphs/${graphId}`, {\n    method: \"DELETE\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n// =============================================================================\n// QUERY & LABELS\n// =============================================================================\n\n/**\n * Query knowledge graph nodes\n *\n * @example\n * ```ts\n * const response = await queryGraphServer(\n *   { label: \"Person\", fields: [], limit: 10, depth: 1, sortBy: \"\", sortOrder: \"\" },\n *   { gatewayUrl, jwtSecret, orgId, graphId }\n * );\n * ```\n */\nexport async function queryGraphServer(\n  query: KGQuery,\n  options: ServerApiOptions\n): Promise<ApiResponse<KGQueryResult>> {\n  return serverApiRequest(\"/api/v1/kg/query\", {\n    method: \"POST\",\n    body: query,\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout ?? 30000,\n    cache: options.cache,\n  });\n}\n\n/**\n * Get all node labels in the knowledge graph\n */\nexport async function getGraphLabelsServer(\n  options: ServerApiOptions\n): Promise<ApiResponse<{ labels: KGLabelInfo[] }>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/labels${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n// =============================================================================\n// NODES\n// =============================================================================\n\n/**\n * Get a specific KG node by ID\n */\nexport async function getKGNodeServer(\n  nodeId: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<{ node: KGNode }>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/nodes/${nodeId}${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Ingest a new node into the knowledge graph\n */\nexport async function ingestKGNodeServer(\n  node: KGNodeIngestRequest,\n  options: ServerApiOptions\n): Promise<ApiResponse<KGSyncIngestResponse>> {\n  return serverApiRequest(\"/api/v1/kg/nodes\", {\n    method: \"POST\",\n    body: node,\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Update an existing KG node\n */\nexport async function updateKGNodeServer(\n  nodeId: string,\n  updates: Partial<KGNode>,\n  options: ServerApiOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  return serverApiRequest(`/api/v1/kg/nodes/${nodeId}`, {\n    method: \"PUT\",\n    body: updates,\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Get connection statistics for a node\n */\nexport async function getNodeConnectionStatsServer(\n  nodeId: string,\n  edgeLabel: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<Record<string, number>>> {\n  const queryString = buildQueryString({\n    edgeLabel,\n    graphId: options.graphId,\n  });\n  return serverApiRequest(`/api/v1/kg/nodes/${nodeId}/connections${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n// =============================================================================\n// DOCUMENTS\n// =============================================================================\n\n/**\n * Ingest a document into the knowledge graph\n */\nexport async function ingestDocumentServer(\n  document: { id: string; title: string; content: string; docUrl?: string; lang?: string },\n  options: ServerApiOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  return serverApiRequest(\"/api/v1/kg/ingest\", {\n    method: \"POST\",\n    body: document,\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout ?? 120000,\n    cache: options.cache,\n  });\n}\n\n/**\n * Delete a document from the knowledge graph\n */\nexport async function deleteKGDocumentServer(\n  documentId: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<DeleteDocumentResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/documents/${documentId}${queryString}`, {\n    method: \"DELETE\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Optimize the knowledge graph\n */\nexport async function optimizeGraphServer(\n  options: ServerApiOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  return serverApiRequest(\"/api/v1/kg/graph/optimize\", {\n    method: \"POST\",\n    body: {},\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n// =============================================================================\n// DESIGNER - NODES\n// =============================================================================\n\n/**\n * List all node definitions in the graph designer\n */\nexport async function listDesignerNodesServer(\n  options: ServerApiOptions\n): Promise<ApiResponse<GraphNodeResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/designer/nodes${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Get a specific node definition by label\n */\nexport async function getDesignerNodeServer(\n  label: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<GraphNodeResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/designer/nodes/${label}${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Create a new node definition\n */\nexport async function createDesignerNodeServer(\n  node: Omit<GraphNodeDefinition, \"createdAt\" | \"updatedAt\">,\n  options: ServerApiOptions\n): Promise<ApiResponse<GraphNodeResponse>> {\n  return serverApiRequest(\"/api/v1/kg/designer/nodes\", {\n    method: \"POST\",\n    body: { node },\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Update an existing node definition\n */\nexport async function updateDesignerNodeServer(\n  label: string,\n  node: Partial<GraphNodeDefinition>,\n  options: ServerApiOptions\n): Promise<ApiResponse<GraphNodeResponse>> {\n  return serverApiRequest(`/api/v1/kg/designer/nodes/${label}`, {\n    method: \"PUT\",\n    body: { node },\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Delete a node definition\n */\nexport async function deleteDesignerNodeServer(\n  label: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/designer/nodes/${label}${queryString}`, {\n    method: \"DELETE\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n// =============================================================================\n// DESIGNER - EDGES\n// =============================================================================\n\n/**\n * List all edge definitions in the graph designer\n */\nexport async function listDesignerEdgesServer(\n  options: ServerApiOptions\n): Promise<ApiResponse<GraphEdgeResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/designer/edges${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Get a specific edge definition by label\n */\nexport async function getDesignerEdgeServer(\n  label: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<GraphEdgeResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/designer/edges/${label}${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Create a new edge definition\n */\nexport async function createDesignerEdgeServer(\n  edge: Omit<GraphEdgeDefinition, \"createdAt\" | \"updatedAt\">,\n  options: ServerApiOptions\n): Promise<ApiResponse<GraphEdgeResponse>> {\n  return serverApiRequest(\"/api/v1/kg/designer/edges\", {\n    method: \"POST\",\n    body: { edge },\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Update an existing edge definition\n */\nexport async function updateDesignerEdgeServer(\n  label: string,\n  edge: Partial<GraphEdgeDefinition>,\n  options: ServerApiOptions\n): Promise<ApiResponse<GraphEdgeResponse>> {\n  return serverApiRequest(`/api/v1/kg/designer/edges/${label}`, {\n    method: \"PUT\",\n    body: { edge },\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Delete an edge definition\n */\nexport async function deleteDesignerEdgeServer(\n  label: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/designer/edges/${label}${queryString}`, {\n    method: \"DELETE\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n// =============================================================================\n// CRAWL JOBS\n// =============================================================================\n\n/**\n * List crawl jobs\n */\nexport async function listCrawlJobsServer(\n  options: ServerApiOptions & { limit?: number; offset?: number; status?: string }\n): Promise<ApiResponse<CrawlJobsListResponse>> {\n  const queryString = buildQueryString({\n    graphId: options.graphId,\n    limit: options.limit?.toString(),\n    offset: options.offset?.toString(),\n    status: options.status,\n  });\n  return serverApiRequest(`/api/v1/kg/crawl/jobs${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Start a new crawl job\n */\nexport async function startCrawlJobServer(\n  params: { baseUrl: string; depth: number; maxPages: number },\n  options: ServerApiOptions\n): Promise<ApiResponse<CrawlJobStartResponse>> {\n  return serverApiRequest(\"/api/v1/kg/crawl/jobs\", {\n    method: \"POST\",\n    body: params,\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Get crawl job status\n */\nexport async function getCrawlJobStatusServer(\n  jobId: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<CrawlJobStatusResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/crawl/jobs/${jobId}${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Cancel a crawl job\n */\nexport async function cancelCrawlJobServer(\n  jobId: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<CrawlJobStatusResponse>> {\n  return serverApiRequest(`/api/v1/kg/crawl/jobs/${jobId}/cancel`, {\n    method: \"POST\",\n    body: {},\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Get pages crawled by a job\n */\nexport async function getCrawledPagesServer(\n  jobId: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<CrawledPagesResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/crawl/jobs/${jobId}/pages${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n"]}
+{"version":3,"sources":["/home/runner/work/eloquent/eloquent/packages/@elqnt/kg/dist/api/server.js","../../api/server.ts"],"names":[],"mappings":"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CJ,IAAA;AACC,IAAA;AACG,IAAA;AACF,IAAA;AACF,IAAA;AAChB,EAAA;AACH;AAME;AAGwB,EAAA;AACd,IAAA;AACF,IAAA;AACc,IAAA;AACD,IAAA;AACJ,IAAA;AACC,IAAA;AACG,IAAA;AACW,IAAA;AACb,IAAA;AACF,IAAA;AAChB,EAAA;AACH;AAME;AAGqC,EAAA;AACb,EAAA;AACd,IAAA;AACY,IAAA;AACD,IAAA;AACJ,IAAA;AACC,IAAA;AACG,IAAA;AACF,IAAA;AACF,IAAA;AAChB,EAAA;AACH;AAME;AAGwB,EAAA;AACd,IAAA;AACD,IAAA;AACa,IAAA;AACD,IAAA;AACJ,IAAA;AACC,IAAA;AACG,IAAA;AACW,IAAA;AACb,IAAA;AACF,IAAA;AAChB,EAAA;AACH;AAME;AAGqC,EAAA;AACb,EAAA;AACd,IAAA;AACY,IAAA;AACD,IAAA;AACJ,IAAA;AACC,IAAA;AACG,IAAA;AACF,IAAA;AACF,IAAA;AAChB,EAAA;AACH;AD1UuC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/home/runner/work/eloquent/eloquent/packages/@elqnt/kg/dist/api/server.js","sourcesContent":[null,"/**\n * Knowledge Graph Server API\n *\n * Server-side API client for KG operations in server actions and SSR.\n * Uses @elqnt/api-client/server for HTTP requests with JWT token generation.\n *\n * @example\n * ```ts\n * // In a server action\n * import { listGraphsServer } from \"@elqnt/kg/api/server\";\n *\n * const graphs = await listGraphsServer({\n *   gatewayUrl: process.env.API_GATEWAY_URL!,\n *   jwtSecret: process.env.JWT_SECRET!,\n *   orgId: orgId,\n * });\n * ```\n *\n * @packageDocumentation\n */\n\nimport { serverApiRequest } from \"@elqnt/api-client/server\";\nimport type { ApiResponse } from \"@elqnt/api-client\";\nimport type { ResponseMetadata } from \"@elqnt/types\";\nimport type {\n  Graph,\n  ListGraphsResult,\n  GetGraphResult,\n  CreateGraphResult,\n  CreateGraphRequest,\n  UpdateGraphResult,\n  DeleteGraphResult,\n  KGNode,\n  KGQuery,\n  KGQueryResult,\n  KGLabelInfo,\n  KGNodeIngestRequest,\n  KGSyncIngestResponse,\n  DeleteDocumentResponse,\n  GraphNodeDefinition,\n  GraphNodeResponse,\n  GraphEdgeDefinition,\n  GraphEdgeResponse,\n} from \"../models\";\nimport type {\n  CrawlJob,\n  CrawlJobsListResponse,\n  CrawlJobStatusResponse,\n  CrawlJobStartResponse,\n  CrawledPagesResponse,\n} from \"./index\";\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\n/**\n * Options for server-side KG API calls\n */\nexport interface ServerApiOptions {\n  /** API Gateway URL */\n  gatewayUrl: string;\n  /** JWT secret for token generation */\n  jwtSecret: string;\n  /** Organization ID */\n  orgId: string;\n  /** Optional user ID (defaults to \"system\") */\n  userId?: string;\n  /** Optional user email */\n  userEmail?: string;\n  /** Optional graph ID for graph-scoped operations */\n  graphId?: string;\n  /** Request timeout in ms */\n  timeout?: number;\n  /** Request cache mode */\n  cache?: RequestCache;\n}\n\n/**\n * Build query string from parameters, filtering out undefined values\n */\nfunction buildQueryString(params: Record<string, string | undefined>): string {\n  const searchParams = new URLSearchParams();\n  for (const [key, value] of Object.entries(params)) {\n    if (value !== undefined) {\n      searchParams.set(key, value);\n    }\n  }\n  const queryString = searchParams.toString();\n  return queryString ? `?${queryString}` : \"\";\n}\n\n/**\n * Build headers including X-Graph-ID if provided\n */\nfunction buildHeaders(graphId?: string): Record<string, string> | undefined {\n  return graphId ? { \"X-Graph-ID\": graphId } : undefined;\n}\n\n// =============================================================================\n// GRAPHS\n// =============================================================================\n\n/**\n * List all knowledge graphs for the organization\n *\n * @example\n * ```ts\n * const response = await listGraphsServer({\n *   gatewayUrl: \"http://api-gateway:80\",\n *   jwtSecret: process.env.JWT_SECRET!,\n *   orgId: \"org-123\",\n * });\n * if (response.data?.graphs) {\n *   console.log(\"Graphs:\", response.data.graphs);\n * }\n * ```\n */\nexport async function listGraphsServer(\n  options: ServerApiOptions\n): Promise<ApiResponse<ListGraphsResult>> {\n  return serverApiRequest(\"/api/v1/kg/graphs\", {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Get a specific knowledge graph by ID\n */\nexport async function getGraphServer(\n  graphId: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<GetGraphResult>> {\n  return serverApiRequest(`/api/v1/kg/graphs/${graphId}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Create a new knowledge graph\n */\nexport async function createGraphServer(\n  graph: CreateGraphRequest,\n  options: ServerApiOptions\n): Promise<ApiResponse<CreateGraphResult>> {\n  return serverApiRequest(\"/api/v1/kg/graphs\", {\n    method: \"POST\",\n    body: graph,\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Update an existing knowledge graph\n */\nexport async function updateGraphServer(\n  graphId: string,\n  updates: Partial<Graph>,\n  options: ServerApiOptions\n): Promise<ApiResponse<UpdateGraphResult>> {\n  return serverApiRequest(`/api/v1/kg/graphs/${graphId}`, {\n    method: \"PUT\",\n    body: updates,\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Delete a knowledge graph\n */\nexport async function deleteGraphServer(\n  graphId: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<DeleteGraphResult>> {\n  return serverApiRequest(`/api/v1/kg/graphs/${graphId}`, {\n    method: \"DELETE\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n// =============================================================================\n// QUERY & LABELS\n// =============================================================================\n\n/**\n * Query knowledge graph nodes\n *\n * @example\n * ```ts\n * const response = await queryGraphServer(\n *   { label: \"Person\", fields: [], limit: 10, depth: 1, sortBy: \"\", sortOrder: \"\" },\n *   { gatewayUrl, jwtSecret, orgId, graphId }\n * );\n * ```\n */\nexport async function queryGraphServer(\n  query: KGQuery,\n  options: ServerApiOptions\n): Promise<ApiResponse<KGQueryResult>> {\n  return serverApiRequest(\"/api/v1/kg/query\", {\n    method: \"POST\",\n    body: query,\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout ?? 30000,\n    cache: options.cache,\n  });\n}\n\n/**\n * Get all node labels in the knowledge graph\n */\nexport async function getGraphLabelsServer(\n  options: ServerApiOptions\n): Promise<ApiResponse<{ labels: KGLabelInfo[] }>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/labels${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n// =============================================================================\n// NODES\n// =============================================================================\n\n/**\n * Get a specific KG node by ID\n */\nexport async function getKGNodeServer(\n  nodeId: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<{ node: KGNode }>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/nodes/${nodeId}${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Ingest a new node into the knowledge graph\n */\nexport async function ingestKGNodeServer(\n  node: KGNodeIngestRequest,\n  options: ServerApiOptions\n): Promise<ApiResponse<KGSyncIngestResponse>> {\n  return serverApiRequest(\"/api/v1/kg/nodes\", {\n    method: \"POST\",\n    body: node,\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Update an existing KG node\n */\nexport async function updateKGNodeServer(\n  nodeId: string,\n  updates: Partial<KGNode>,\n  options: ServerApiOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  return serverApiRequest(`/api/v1/kg/nodes/${nodeId}`, {\n    method: \"PUT\",\n    body: updates,\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Get connection statistics for a node\n */\nexport async function getNodeConnectionStatsServer(\n  nodeId: string,\n  edgeLabel: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<Record<string, number>>> {\n  const queryString = buildQueryString({\n    edgeLabel,\n    graphId: options.graphId,\n  });\n  return serverApiRequest(`/api/v1/kg/nodes/${nodeId}/connections${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n// =============================================================================\n// DOCUMENTS\n// =============================================================================\n\n/**\n * Ingest a document into the knowledge graph\n */\nexport async function ingestDocumentServer(\n  document: { id: string; title: string; content: string; docUrl?: string; lang?: string },\n  options: ServerApiOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  return serverApiRequest(\"/api/v1/kg/ingest\", {\n    method: \"POST\",\n    body: document,\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout ?? 120000,\n    cache: options.cache,\n  });\n}\n\n/**\n * Delete a document from the knowledge graph\n */\nexport async function deleteKGDocumentServer(\n  documentId: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<DeleteDocumentResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/documents/${documentId}${queryString}`, {\n    method: \"DELETE\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Optimize the knowledge graph\n */\nexport async function optimizeGraphServer(\n  options: ServerApiOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  return serverApiRequest(\"/api/v1/kg/graph/optimize\", {\n    method: \"POST\",\n    body: {},\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n// =============================================================================\n// DESIGNER - NODES\n// =============================================================================\n\n/**\n * List all node definitions in the graph designer\n */\nexport async function listDesignerNodesServer(\n  options: ServerApiOptions\n): Promise<ApiResponse<GraphNodeResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/designer/nodes${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Get a specific node definition by label\n */\nexport async function getDesignerNodeServer(\n  label: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<GraphNodeResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/designer/nodes/${label}${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Create a new node definition\n */\nexport async function createDesignerNodeServer(\n  node: Omit<GraphNodeDefinition, \"createdAt\" | \"updatedAt\">,\n  options: ServerApiOptions\n): Promise<ApiResponse<GraphNodeResponse>> {\n  return serverApiRequest(\"/api/v1/kg/designer/nodes\", {\n    method: \"POST\",\n    body: { node },\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Update an existing node definition\n */\nexport async function updateDesignerNodeServer(\n  label: string,\n  node: Partial<GraphNodeDefinition>,\n  options: ServerApiOptions\n): Promise<ApiResponse<GraphNodeResponse>> {\n  return serverApiRequest(`/api/v1/kg/designer/nodes/${label}`, {\n    method: \"PUT\",\n    body: { node },\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Delete a node definition\n */\nexport async function deleteDesignerNodeServer(\n  label: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/designer/nodes/${label}${queryString}`, {\n    method: \"DELETE\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n// =============================================================================\n// DESIGNER - EDGES\n// =============================================================================\n\n/**\n * List all edge definitions in the graph designer\n */\nexport async function listDesignerEdgesServer(\n  options: ServerApiOptions\n): Promise<ApiResponse<GraphEdgeResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/designer/edges${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Get a specific edge definition by label\n */\nexport async function getDesignerEdgeServer(\n  label: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<GraphEdgeResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/designer/edges/${label}${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Create a new edge definition\n */\nexport async function createDesignerEdgeServer(\n  edge: Omit<GraphEdgeDefinition, \"createdAt\" | \"updatedAt\">,\n  options: ServerApiOptions\n): Promise<ApiResponse<GraphEdgeResponse>> {\n  return serverApiRequest(\"/api/v1/kg/designer/edges\", {\n    method: \"POST\",\n    body: { edge },\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Update an existing edge definition\n */\nexport async function updateDesignerEdgeServer(\n  label: string,\n  edge: Partial<GraphEdgeDefinition>,\n  options: ServerApiOptions\n): Promise<ApiResponse<GraphEdgeResponse>> {\n  return serverApiRequest(`/api/v1/kg/designer/edges/${label}`, {\n    method: \"PUT\",\n    body: { edge },\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Delete an edge definition\n */\nexport async function deleteDesignerEdgeServer(\n  label: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/designer/edges/${label}${queryString}`, {\n    method: \"DELETE\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n// =============================================================================\n// CRAWL JOBS\n// =============================================================================\n\n/**\n * List crawl jobs\n */\nexport async function listCrawlJobsServer(\n  options: ServerApiOptions & { limit?: number; offset?: number; status?: string }\n): Promise<ApiResponse<CrawlJobsListResponse>> {\n  const queryString = buildQueryString({\n    graphId: options.graphId,\n    limit: options.limit?.toString(),\n    offset: options.offset?.toString(),\n    status: options.status,\n  });\n  return serverApiRequest(`/api/v1/kg/crawl/jobs${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Start a new crawl job\n */\nexport async function startCrawlJobServer(\n  params: { baseUrl: string; depth: number; maxPages: number },\n  options: ServerApiOptions\n): Promise<ApiResponse<CrawlJobStartResponse>> {\n  return serverApiRequest(\"/api/v1/kg/crawl/jobs\", {\n    method: \"POST\",\n    body: params,\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Get crawl job status\n */\nexport async function getCrawlJobStatusServer(\n  jobId: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<CrawlJobStatusResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/crawl/jobs/${jobId}${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Cancel a crawl job\n */\nexport async function cancelCrawlJobServer(\n  jobId: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<CrawlJobStatusResponse>> {\n  return serverApiRequest(`/api/v1/kg/crawl/jobs/${jobId}/cancel`, {\n    method: \"POST\",\n    body: {},\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    headers: buildHeaders(options.graphId),\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n\n/**\n * Get pages crawled by a job\n */\nexport async function getCrawledPagesServer(\n  jobId: string,\n  options: ServerApiOptions\n): Promise<ApiResponse<CrawledPagesResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return serverApiRequest(`/api/v1/kg/crawl/jobs/${jobId}/pages${queryString}`, {\n    method: \"GET\",\n    gatewayUrl: options.gatewayUrl,\n    jwtSecret: options.jwtSecret,\n    orgId: options.orgId,\n    userId: options.userId,\n    userEmail: options.userEmail,\n    timeout: options.timeout,\n    cache: options.cache,\n  });\n}\n"]}