@weavelogic/knowledge-graph-agent 0.3.0 → 0.6.0

package/dist/graphql/resolvers/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/graphql/resolvers/queries.ts"],"names":[],"mappings":"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"}

package/dist/graphql/resolvers/subscriptions.d.ts

@@ -0,0 +1,399 @@
+/**
+ * GraphQL Subscription Resolvers
+ *
+ * Implements subscription resolvers for real-time updates in the
+ * knowledge graph agent system. Uses AsyncIterator pattern for
+ * streaming events to clients.
+ *
+ * @module graphql/resolvers/subscriptions
+ */
+import { type DeletedNode, type AgentStatusPayload, type WorkflowProgressPayload, type AnalysisProgressPayload, type HealthStatusPayload } from '../pubsub.js';
+import type { KnowledgeNode, GraphEdge } from '../../core/types.js';
+import type { WorkflowExecution, WorkflowEvent } from '../../workflows/types.js';
+import type { SystemHealth } from '../../health/types.js';
+import type { AgentResult } from '../../agents/types.js';
+/**
+ * GraphQL resolver context with connection tracking.
+ */
+export interface SubscriptionContext {
+    /** Unique connection ID for cleanup tracking */
+    connectionId?: string;
+    /** Active subscriptions for this connection */
+    activeSubscriptions?: Set<string>;
+    /** Cleanup function called on disconnect */
+    onDisconnect?: (cleanup: () => void) => void;
+}
+/**
+ * Result type for nodeDeleted subscription matching schema.
+ */
+export interface NodeDeletedResult {
+    id: string;
+}
+/**
+ * GraphQL Subscription resolvers.
+ *
+ * Each resolver returns an AsyncIterator that yields events from the
+ * PubSub system. Subscriptions are automatically cleaned up when
+ * the client disconnects.
+ */
+export declare const subscriptionResolvers: {
+    Subscription: {
+        /**
+         * Subscribe to node creation events.
+         *
+         * Emits KnowledgeNode objects when new nodes are created.
+         */
+        nodeCreated: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<KnowledgeNode>;
+            resolve: (payload: KnowledgeNode) => KnowledgeNode;
+        };
+        /**
+         * Subscribe to node update events.
+         *
+         * Emits KnowledgeNode objects when existing nodes are modified.
+         */
+        nodeUpdated: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<KnowledgeNode>;
+            resolve: (payload: KnowledgeNode) => KnowledgeNode;
+        };
+        /**
+         * Subscribe to node deletion events.
+         *
+         * Emits the ID of deleted nodes.
+         */
+        nodeDeleted: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<DeletedNode>;
+            resolve: (payload: DeletedNode) => string;
+        };
+        /**
+         * Subscribe to edge creation events.
+         *
+         * Emits GraphEdge objects when new edges are created.
+         */
+        edgeCreated: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<GraphEdge>;
+            resolve: (payload: GraphEdge) => GraphEdge;
+        };
+        /**
+         * Subscribe to edge deletion events.
+         *
+         * Emits the ID of deleted edges.
+         */
+        edgeDeleted: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<string>;
+            resolve: (payload: string) => string;
+        };
+        /**
+         * Subscribe to workflow status changes for a specific execution.
+         *
+         * @param args.id - Workflow execution ID to monitor
+         */
+        workflowStatus: {
+            subscribe: (_parent: unknown, args: {
+                id: string;
+            }, ctx: SubscriptionContext) => AsyncIterableIterator<WorkflowExecution>;
+            resolve: (payload: WorkflowExecution) => WorkflowExecution;
+        };
+        /**
+         * Subscribe to all workflow events, optionally filtered by workflow ID.
+         *
+         * @param args.workflowId - Optional workflow ID to filter events
+         */
+        workflowEvents: {
+            subscribe: (_parent: unknown, args: {
+                workflowId?: string;
+            }, ctx: SubscriptionContext) => AsyncIterableIterator<WorkflowEvent>;
+            resolve: (payload: WorkflowEvent) => WorkflowEvent;
+        };
+        /**
+         * Subscribe to agent status changes for a specific agent.
+         *
+         * @param args.id - Agent ID to monitor
+         */
+        agentStatus: {
+            subscribe: (_parent: unknown, args: {
+                id: string;
+            }, ctx: SubscriptionContext) => AsyncIterableIterator<AgentStatusPayload>;
+            resolve: (payload: AgentStatusPayload) => unknown;
+        };
+        /**
+         * Subscribe to task completion events.
+         *
+         * @param args.agentId - Optional agent ID to filter events
+         */
+        taskCompleted: {
+            subscribe: (_parent: unknown, args: {
+                agentId?: string;
+            }, ctx: SubscriptionContext) => AsyncIterableIterator<unknown>;
+            resolve: (payload: unknown) => AgentResult;
+        };
+        /**
+         * Subscribe to reasoning chain updates for a specific chain.
+         *
+         * @param args.id - Reasoning chain ID to monitor
+         */
+        reasoningChainUpdated: {
+            subscribe: (_parent: unknown, args: {
+                id: string;
+            }, ctx: SubscriptionContext) => AsyncIterableIterator<unknown>;
+            resolve: (payload: unknown) => unknown;
+        };
+        /**
+         * Subscribe to new decision events.
+         */
+        decisionMade: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<unknown>;
+            resolve: (payload: unknown) => unknown;
+        };
+        /**
+         * Subscribe to graph sync completion events.
+         */
+        graphSynced: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<unknown>;
+            resolve: (payload: unknown) => unknown;
+        };
+        /**
+         * Subscribe to system health status changes.
+         */
+        healthChanged: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<SystemHealth>;
+            resolve: (payload: SystemHealth) => unknown;
+        };
+    };
+};
+/**
+ * Additional subscription resolvers beyond the base schema.
+ * These can be used for extended functionality.
+ */
+export declare const extendedSubscriptionResolvers: {
+    Subscription: {
+        /**
+         * Subscribe to relation/edge creation events.
+         * Maps to the 'relationCreated' subscription type in the schema.
+         */
+        relationCreated: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<GraphEdge>;
+            resolve: (payload: GraphEdge) => GraphEdge;
+        };
+        /**
+         * Subscribe to workflow progress updates for a specific workflow.
+         *
+         * @param args.id - Workflow execution ID to monitor
+         */
+        workflowProgress: {
+            subscribe: (_parent: unknown, args: {
+                id: string;
+            }, ctx: SubscriptionContext) => AsyncIterableIterator<WorkflowProgressPayload>;
+            resolve: (payload: WorkflowProgressPayload) => unknown;
+        };
+        /**
+         * Subscribe to agent status change events (all agents).
+         */
+        agentStatusChanged: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<AgentStatusPayload>;
+            resolve: (payload: AgentStatusPayload) => unknown;
+        };
+        /**
+         * Subscribe to health status updates.
+         */
+        healthUpdated: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<HealthStatusPayload>;
+            resolve: (payload: HealthStatusPayload) => unknown;
+        };
+        /**
+         * Subscribe to analysis progress updates for a specific task.
+         *
+         * @param args.taskId - Analysis task ID to monitor
+         */
+        analysisProgress: {
+            subscribe: (_parent: unknown, args: {
+                taskId: string;
+            }, ctx: SubscriptionContext) => AsyncIterableIterator<AnalysisProgressPayload>;
+            resolve: (payload: AnalysisProgressPayload) => unknown;
+        };
+    };
+};
+/**
+ * Merged subscription resolvers combining base and extended resolvers.
+ */
+export declare const mergedSubscriptionResolvers: {
+    Subscription: {
+        /**
+         * Subscribe to relation/edge creation events.
+         * Maps to the 'relationCreated' subscription type in the schema.
+         */
+        relationCreated: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<GraphEdge>;
+            resolve: (payload: GraphEdge) => GraphEdge;
+        };
+        /**
+         * Subscribe to workflow progress updates for a specific workflow.
+         *
+         * @param args.id - Workflow execution ID to monitor
+         */
+        workflowProgress: {
+            subscribe: (_parent: unknown, args: {
+                id: string;
+            }, ctx: SubscriptionContext) => AsyncIterableIterator<WorkflowProgressPayload>;
+            resolve: (payload: WorkflowProgressPayload) => unknown;
+        };
+        /**
+         * Subscribe to agent status change events (all agents).
+         */
+        agentStatusChanged: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<AgentStatusPayload>;
+            resolve: (payload: AgentStatusPayload) => unknown;
+        };
+        /**
+         * Subscribe to health status updates.
+         */
+        healthUpdated: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<HealthStatusPayload>;
+            resolve: (payload: HealthStatusPayload) => unknown;
+        };
+        /**
+         * Subscribe to analysis progress updates for a specific task.
+         *
+         * @param args.taskId - Analysis task ID to monitor
+         */
+        analysisProgress: {
+            subscribe: (_parent: unknown, args: {
+                taskId: string;
+            }, ctx: SubscriptionContext) => AsyncIterableIterator<AnalysisProgressPayload>;
+            resolve: (payload: AnalysisProgressPayload) => unknown;
+        };
+        /**
+         * Subscribe to node creation events.
+         *
+         * Emits KnowledgeNode objects when new nodes are created.
+         */
+        nodeCreated: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<KnowledgeNode>;
+            resolve: (payload: KnowledgeNode) => KnowledgeNode;
+        };
+        /**
+         * Subscribe to node update events.
+         *
+         * Emits KnowledgeNode objects when existing nodes are modified.
+         */
+        nodeUpdated: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<KnowledgeNode>;
+            resolve: (payload: KnowledgeNode) => KnowledgeNode;
+        };
+        /**
+         * Subscribe to node deletion events.
+         *
+         * Emits the ID of deleted nodes.
+         */
+        nodeDeleted: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<DeletedNode>;
+            resolve: (payload: DeletedNode) => string;
+        };
+        /**
+         * Subscribe to edge creation events.
+         *
+         * Emits GraphEdge objects when new edges are created.
+         */
+        edgeCreated: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<GraphEdge>;
+            resolve: (payload: GraphEdge) => GraphEdge;
+        };
+        /**
+         * Subscribe to edge deletion events.
+         *
+         * Emits the ID of deleted edges.
+         */
+        edgeDeleted: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<string>;
+            resolve: (payload: string) => string;
+        };
+        /**
+         * Subscribe to workflow status changes for a specific execution.
+         *
+         * @param args.id - Workflow execution ID to monitor
+         */
+        workflowStatus: {
+            subscribe: (_parent: unknown, args: {
+                id: string;
+            }, ctx: SubscriptionContext) => AsyncIterableIterator<WorkflowExecution>;
+            resolve: (payload: WorkflowExecution) => WorkflowExecution;
+        };
+        /**
+         * Subscribe to all workflow events, optionally filtered by workflow ID.
+         *
+         * @param args.workflowId - Optional workflow ID to filter events
+         */
+        workflowEvents: {
+            subscribe: (_parent: unknown, args: {
+                workflowId?: string;
+            }, ctx: SubscriptionContext) => AsyncIterableIterator<WorkflowEvent>;
+            resolve: (payload: WorkflowEvent) => WorkflowEvent;
+        };
+        /**
+         * Subscribe to agent status changes for a specific agent.
+         *
+         * @param args.id - Agent ID to monitor
+         */
+        agentStatus: {
+            subscribe: (_parent: unknown, args: {
+                id: string;
+            }, ctx: SubscriptionContext) => AsyncIterableIterator<AgentStatusPayload>;
+            resolve: (payload: AgentStatusPayload) => unknown;
+        };
+        /**
+         * Subscribe to task completion events.
+         *
+         * @param args.agentId - Optional agent ID to filter events
+         */
+        taskCompleted: {
+            subscribe: (_parent: unknown, args: {
+                agentId?: string;
+            }, ctx: SubscriptionContext) => AsyncIterableIterator<unknown>;
+            resolve: (payload: unknown) => AgentResult;
+        };
+        /**
+         * Subscribe to reasoning chain updates for a specific chain.
+         *
+         * @param args.id - Reasoning chain ID to monitor
+         */
+        reasoningChainUpdated: {
+            subscribe: (_parent: unknown, args: {
+                id: string;
+            }, ctx: SubscriptionContext) => AsyncIterableIterator<unknown>;
+            resolve: (payload: unknown) => unknown;
+        };
+        /**
+         * Subscribe to new decision events.
+         */
+        decisionMade: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<unknown>;
+            resolve: (payload: unknown) => unknown;
+        };
+        /**
+         * Subscribe to graph sync completion events.
+         */
+        graphSynced: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<unknown>;
+            resolve: (payload: unknown) => unknown;
+        };
+        /**
+         * Subscribe to system health status changes.
+         */
+        healthChanged: {
+            subscribe: (_parent: unknown, _args: unknown, ctx: SubscriptionContext) => AsyncIterableIterator<SystemHealth>;
+            resolve: (payload: SystemHealth) => unknown;
+        };
+    };
+};
+/**
+ * Create a subscription cleanup handler for WebSocket connections.
+ *
+ * @param connectionId - Unique connection identifier
+ * @returns Object with cleanup tracking methods
+ */
+export declare function createSubscriptionCleanup(connectionId: string): {
+    context: SubscriptionContext;
+    cleanup: () => void;
+};
+export default mergedSubscriptionResolvers;
+//# sourceMappingURL=subscriptions.d.ts.map

package/dist/graphql/resolvers/subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../../../src/graphql/resolvers/subscriptions.ts"],"names":[],"mappings":"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"}

package/dist/graphql/scalars.d.ts

@@ -0,0 +1,89 @@
+/**
+ * GraphQL Custom Scalars
+ *
+ * Provides custom scalar type definitions for DateTime, JSON, and UUID types.
+ * These scalars enable proper serialization/deserialization of complex data types
+ * in the GraphQL schema.
+ *
+ * @module graphql/scalars
+ */
+import { GraphQLScalarType } from 'graphql';
+/**
+ * DateTime scalar for ISO 8601 date-time values
+ *
+ * Serializes Date objects to ISO strings and parses ISO strings to Date objects.
+ *
+ * @example
+ * ```graphql
+ * scalar DateTime
+ *
+ * type Node {
+ *   createdAt: DateTime!
+ *   updatedAt: DateTime
+ * }
+ * ```
+ */
+export declare const DateTimeScalar: GraphQLScalarType<Date | null, string | null>;
+/**
+ * JSON scalar for arbitrary JSON data
+ *
+ * Serializes and parses arbitrary JSON values including objects, arrays,
+ * strings, numbers, booleans, and null.
+ *
+ * @example
+ * ```graphql
+ * scalar JSON
+ *
+ * type Node {
+ *   metadata: JSON
+ *   config: JSON
+ * }
+ * ```
+ */
+export declare const JSONScalar: GraphQLScalarType<unknown, unknown>;
+/**
+ * UUID scalar for unique identifiers
+ *
+ * Validates and serializes UUID v4 strings.
+ *
+ * @example
+ * ```graphql
+ * scalar UUID
+ *
+ * type Node {
+ *   id: UUID!
+ *   parentId: UUID
+ * }
+ * ```
+ */
+export declare const UUIDScalar: GraphQLScalarType<string | null, string | null>;
+/**
+ * FilePath scalar for file system paths
+ *
+ * Validates and normalizes file paths, preventing path traversal attacks.
+ *
+ * @example
+ * ```graphql
+ * scalar FilePath
+ *
+ * type Node {
+ *   path: FilePath!
+ * }
+ * ```
+ */
+export declare const FilePathScalar: GraphQLScalarType<string | null, string | null>;
+/**
+ * All custom scalars bundled for resolver integration
+ */
+export declare const customScalars: {
+    DateTime: GraphQLScalarType<Date | null, string | null>;
+    JSON: GraphQLScalarType<unknown, unknown>;
+    UUID: GraphQLScalarType<string | null, string | null>;
+    FilePath: GraphQLScalarType<string | null, string | null>;
+};
+/**
+ * Type definitions string for custom scalars
+ * (Useful if not loading from .graphql file)
+ */
+export declare const scalarTypeDefs = "\n  \"\"\"\n  ISO 8601 date-time string (e.g., 2024-01-15T10:30:00.000Z)\n  \"\"\"\n  scalar DateTime\n\n  \"\"\"\n  Arbitrary JSON value (object, array, string, number, boolean, or null)\n  \"\"\"\n  scalar JSON\n\n  \"\"\"\n  UUID v4 string (e.g., 550e8400-e29b-41d4-a716-446655440000)\n  \"\"\"\n  scalar UUID\n\n  \"\"\"\n  File system path (relative to docs root)\n  \"\"\"\n  scalar FilePath\n";
+//# sourceMappingURL=scalars.d.ts.map

package/dist/graphql/scalars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalars.d.ts","sourceRoot":"","sources":["../../src/graphql/scalars.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAmB,MAAM,SAAS,CAAC;AAE7D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,+CA0FzB,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU,qCAerB,CAAC;AAmDH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,UAAU,iDAmDrB,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,iDAuCzB,CAAC;AAgCH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;CAKzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,oZAoB1B,CAAC"}