@hiveforge/hivemind-mcp 3.3.1 → 3.5.0

package/dist/mcp/timeline-tools.js

@@ -0,0 +1,317 @@
+/**
+ * Timeline MCP tools - date field discovery and validation.
+ *
+ * Provides date field discovery from template registry and Zod validation
+ * schemas for timeline query tools.
+ */
+import { z } from 'zod';
+import { templateRegistry } from '../templates/registry.js';
+/**
+ * Discovers entity types that have date-typed fields.
+ *
+ * Scans the active template's entity types and returns information about
+ * which types have date fields available for timeline queries.
+ *
+ * @returns Array of temporal type information, or empty array if no active template
+ */
+export function discoverTemporalTypes() {
+    const activeTemplate = templateRegistry.getActive();
+    if (!activeTemplate) {
+        return [];
+    }
+    const temporalTypes = [];
+    for (const entityType of activeTemplate.entityTypes) {
+        const dateFields = entityType.fields
+            .filter((field) => field.type === 'date')
+            .map((field) => ({
+            name: field.name,
+            required: field.required ?? false,
+            description: field.description,
+        }));
+        if (dateFields.length > 0) {
+            temporalTypes.push({
+                entityType: entityType.name,
+                dateFields,
+            });
+        }
+    }
+    return temporalTypes;
+}
+/**
+ * Validates that a field exists on an entity type and is a date type.
+ *
+ * @param entityType - Entity type name to check
+ * @param dateField - Field name to validate
+ * @returns True if the field exists and is a date type, false otherwise
+ */
+export function validateDateField(entityType, dateField) {
+    const activeTemplate = templateRegistry.getActive();
+    if (!activeTemplate) {
+        return false;
+    }
+    const entityConfig = activeTemplate.entityTypeMap.get(entityType);
+    if (!entityConfig) {
+        return false;
+    }
+    const field = entityConfig.fields.find((f) => f.name === dateField);
+    if (!field) {
+        return false;
+    }
+    return field.type === 'date';
+}
+/**
+ * ISO8601 date string regex (YYYY-MM-DD format only).
+ *
+ * Validates format but not calendar correctness - SQLite handles string
+ * comparison correctly even with invalid dates like 2024-13-45.
+ */
+const ISO8601DateRegex = /^\d{4}-\d{2}-\d{2}$/;
+/**
+ * Validation schema for query_timeline_range arguments.
+ *
+ * Finds entities with date fields in a specified range.
+ */
+export const QueryTimelineRangeArgsSchema = z.object({
+    startDate: z
+        .string()
+        .regex(ISO8601DateRegex, 'Date must be in YYYY-MM-DD format'),
+    endDate: z
+        .string()
+        .regex(ISO8601DateRegex, 'Date must be in YYYY-MM-DD format'),
+    dateField: z.string().describe('Name of the date field to query'),
+    entityType: z
+        .string()
+        .optional()
+        .describe('Optional entity type filter'),
+    sortOrder: z
+        .enum(['asc', 'desc'])
+        .optional()
+        .default('asc')
+        .describe('Sort order for results'),
+    limit: z
+        .number()
+        .min(1)
+        .max(1000)
+        .optional()
+        .default(100)
+        .describe('Maximum number of results to return'),
+});
+/**
+ * Validation schema for query_timeline_before arguments.
+ *
+ * Finds entities with date fields before a specified date.
+ */
+export const QueryTimelineBeforeArgsSchema = z.object({
+    date: z
+        .string()
+        .regex(ISO8601DateRegex, 'Date must be in YYYY-MM-DD format'),
+    dateField: z.string().describe('Name of the date field to query'),
+    entityType: z
+        .string()
+        .optional()
+        .describe('Optional entity type filter'),
+    sortOrder: z
+        .enum(['asc', 'desc'])
+        .optional()
+        .default('desc')
+        .describe('Sort order for results'),
+    limit: z
+        .number()
+        .min(1)
+        .max(1000)
+        .optional()
+        .default(100)
+        .describe('Maximum number of results to return'),
+});
+/**
+ * Validation schema for query_timeline_after arguments.
+ *
+ * Finds entities with date fields after a specified date.
+ */
+export const QueryTimelineAfterArgsSchema = z.object({
+    date: z
+        .string()
+        .regex(ISO8601DateRegex, 'Date must be in YYYY-MM-DD format'),
+    dateField: z.string().describe('Name of the date field to query'),
+    entityType: z
+        .string()
+        .optional()
+        .describe('Optional entity type filter'),
+    sortOrder: z
+        .enum(['asc', 'desc'])
+        .optional()
+        .default('asc')
+        .describe('Sort order for results'),
+    limit: z
+        .number()
+        .min(1)
+        .max(1000)
+        .optional()
+        .default(100)
+        .describe('Maximum number of results to return'),
+});
+/**
+ * Validation schema for query_timeline_exact arguments.
+ *
+ * Finds entities with date fields matching an exact date.
+ */
+export const QueryTimelineExactArgsSchema = z.object({
+    date: z
+        .string()
+        .regex(ISO8601DateRegex, 'Date must be in YYYY-MM-DD format'),
+    dateField: z.string().describe('Name of the date field to query'),
+    entityType: z
+        .string()
+        .optional()
+        .describe('Optional entity type filter'),
+    sortOrder: z
+        .enum(['asc', 'desc'])
+        .optional()
+        .default('asc')
+        .describe('Sort order for results'),
+    limit: z
+        .number()
+        .min(1)
+        .max(1000)
+        .optional()
+        .default(100)
+        .describe('Maximum number of results to return'),
+});
+/**
+ * Generates MCP tool definitions for timeline queries.
+ *
+ * Creates four tools: query_timeline_range, query_timeline_before,
+ * query_timeline_after, and query_timeline_exact.
+ *
+ * Tool descriptions dynamically include available date fields per entity type.
+ *
+ * @param temporalTypes - Entity types with date fields
+ * @returns Array of tool definitions for MCP registration
+ */
+export function generateTimelineTools(temporalTypes) {
+    // Build description of available date fields
+    const dateFieldsDescription = buildDateFieldsDescription(temporalTypes);
+    // Common properties shared by all timeline tools
+    const commonProperties = {
+        dateField: {
+            type: 'string',
+            description: 'Name of the date field to query',
+        },
+        entityType: {
+            type: 'string',
+            description: 'Optional: filter to specific entity type',
+        },
+        sortOrder: {
+            type: 'string',
+            enum: ['asc', 'desc'],
+            description: 'Sort order for results',
+        },
+        limit: {
+            type: 'number',
+            description: 'Maximum number of results to return (1-1000, default: 100)',
+            minimum: 1,
+            maximum: 1000,
+            default: 100,
+        },
+    };
+    const tools = [
+        {
+            name: 'query_timeline_range',
+            description: `Query entities with dates in a specified range. Returns entities where the date field falls between startDate and endDate (inclusive).${dateFieldsDescription}`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    startDate: {
+                        type: 'string',
+                        description: 'Start date in YYYY-MM-DD format (inclusive)',
+                    },
+                    endDate: {
+                        type: 'string',
+                        description: 'End date in YYYY-MM-DD format (inclusive)',
+                    },
+                    ...commonProperties,
+                },
+                required: ['startDate', 'endDate', 'dateField'],
+            },
+        },
+        {
+            name: 'query_timeline_before',
+            description: `Query entities with dates before a specified date. Returns entities where the date field is earlier than the given date.${dateFieldsDescription}`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    date: {
+                        type: 'string',
+                        description: 'Date in YYYY-MM-DD format (exclusive upper bound)',
+                    },
+                    ...commonProperties,
+                    sortOrder: {
+                        ...commonProperties.sortOrder,
+                        default: 'desc',
+                        description: 'Sort order for results (default: desc)',
+                    },
+                },
+                required: ['date', 'dateField'],
+            },
+        },
+        {
+            name: 'query_timeline_after',
+            description: `Query entities with dates after a specified date. Returns entities where the date field is later than the given date.${dateFieldsDescription}`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    date: {
+                        type: 'string',
+                        description: 'Date in YYYY-MM-DD format (exclusive lower bound)',
+                    },
+                    ...commonProperties,
+                    sortOrder: {
+                        ...commonProperties.sortOrder,
+                        default: 'asc',
+                        description: 'Sort order for results (default: asc)',
+                    },
+                },
+                required: ['date', 'dateField'],
+            },
+        },
+        {
+            name: 'query_timeline_exact',
+            description: `Query entities with dates matching an exact date. Returns entities where the date field exactly matches the given date.${dateFieldsDescription}`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    date: {
+                        type: 'string',
+                        description: 'Date in YYYY-MM-DD format (exact match)',
+                    },
+                    ...commonProperties,
+                    sortOrder: {
+                        ...commonProperties.sortOrder,
+                        default: 'asc',
+                        description: 'Sort order for results (default: asc)',
+                    },
+                },
+                required: ['date', 'dateField'],
+            },
+        },
+    ];
+    return tools;
+}
+/**
+ * Builds the date fields description section for tool descriptions.
+ *
+ * @param temporalTypes - Entity types with date fields
+ * @returns Formatted description of available date fields
+ */
+function buildDateFieldsDescription(temporalTypes) {
+    if (temporalTypes.length === 0) {
+        return '';
+    }
+    let description = '\n\nAvailable date fields:\n';
+    for (const typeInfo of temporalTypes) {
+        const fieldNames = typeInfo.dateFields.map((f) => f.name).join(', ');
+        description += `- ${typeInfo.entityType}: ${fieldNames}\n`;
+    }
+    return description;
+}
+//# sourceMappingURL=timeline-tools.js.map

package/dist/mcp/timeline-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-tools.js","sourceRoot":"","sources":["../../src/mcp/timeline-tools.ts"],"names":[],"mappings":"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"}

package/dist/search/engine.d.ts

@@ -53,5 +53,191 @@ export declare class SearchEngine {
             [k: string]: number;
         };
     };
+    /**
+     * Query nodes by date range with full context
+     *
+     * @param startDate - Start date (inclusive) in ISO format (YYYY-MM-DD)
+     * @param endDate - End date (inclusive) in ISO format (YYYY-MM-DD)
+     * @param dateField - Name of the date field to query
+     * @param options - Query options (entityType, sortOrder, limit)
+     * @returns Results grouped by entity type with relationships and metadata
+     */
+    queryTimelineRange(startDate: string, endDate: string, dateField: string, options?: {
+        entityType?: string;
+        sortOrder?: 'asc' | 'desc';
+        limit?: number;
+    }): Promise<{
+        nodes: GraphNode[];
+        relationships: GraphEdge[];
+        metadata: {
+            source: 'timeline';
+            executionTime: number;
+            totalResults: number;
+            dateField: string;
+            queryType: 'range';
+        };
+    }>;
+    /**
+     * Query nodes before a specific date with full context
+     *
+     * @param date - Date threshold in ISO format (YYYY-MM-DD)
+     * @param dateField - Name of the date field to query
+     * @param options - Query options (entityType, sortOrder, limit)
+     * @returns Results grouped by entity type with relationships and metadata
+     */
+    queryTimelineBefore(date: string, dateField: string, options?: {
+        entityType?: string;
+        sortOrder?: 'asc' | 'desc';
+        limit?: number;
+    }): Promise<{
+        nodes: GraphNode[];
+        relationships: GraphEdge[];
+        metadata: {
+            source: 'timeline';
+            executionTime: number;
+            totalResults: number;
+            dateField: string;
+            queryType: 'before';
+        };
+    }>;
+    /**
+     * Query nodes after a specific date with full context
+     *
+     * @param date - Date threshold in ISO format (YYYY-MM-DD)
+     * @param dateField - Name of the date field to query
+     * @param options - Query options (entityType, sortOrder, limit)
+     * @returns Results grouped by entity type with relationships and metadata
+     */
+    queryTimelineAfter(date: string, dateField: string, options?: {
+        entityType?: string;
+        sortOrder?: 'asc' | 'desc';
+        limit?: number;
+    }): Promise<{
+        nodes: GraphNode[];
+        relationships: GraphEdge[];
+        metadata: {
+            source: 'timeline';
+            executionTime: number;
+            totalResults: number;
+            dateField: string;
+            queryType: 'after';
+        };
+    }>;
+    /**
+     * Query nodes by exact date match with full context
+     *
+     * @param date - Date to match in ISO format (YYYY-MM-DD)
+     * @param dateField - Name of the date field to query
+     * @param options - Query options (entityType, sortOrder, limit)
+     * @returns Results grouped by entity type with relationships and metadata
+     */
+    queryTimelineExact(date: string, dateField: string, options?: {
+        entityType?: string;
+        sortOrder?: 'asc' | 'desc';
+        limit?: number;
+    }): Promise<{
+        nodes: GraphNode[];
+        relationships: GraphEdge[];
+        metadata: {
+            source: 'timeline';
+            executionTime: number;
+            totalResults: number;
+            dateField: string;
+            queryType: 'exact';
+        };
+    }>;
+    /**
+     * Query immediate neighbors (1-hop) of an entity with full node details
+     *
+     * @param entityId - Entity ID to query
+     * @param options - Query options (direction, filters, limits)
+     * @returns Results with full node details, relationships, and metadata
+     */
+    queryGraphNeighbors(entityId: string, options?: {
+        direction?: 'outgoing' | 'incoming' | 'both';
+        includeRelationships?: string[];
+        excludeRelationships?: string[];
+        includeEntityTypes?: string[];
+        limit?: number;
+    }): Promise<{
+        neighbors: Array<{
+            node: GraphNode;
+            relationship: {
+                type: string;
+                direction: 'outgoing' | 'incoming';
+            };
+        }>;
+        metadata: {
+            source: 'graph';
+            executionTime: number;
+            totalResults: number;
+        };
+    }>;
+    /**
+     * Query subgraph (N-hop neighborhood) of an entity with full node details
+     *
+     * @param entityId - Entity ID to query
+     * @param depth - Number of hops (1-5)
+     * @param options - Query options (direction, filters, limits)
+     * @returns Results with full node details and metadata
+     */
+    queryGraphSubgraph(entityId: string, depth: number, options?: {
+        direction?: 'outgoing' | 'incoming' | 'both';
+        includeRelationships?: string[];
+        excludeRelationships?: string[];
+        includeEntityTypes?: string[];
+        includeIntermediateNodes?: boolean;
+        limit?: number;
+    }): Promise<{
+        nodes: GraphNode[];
+        metadata: {
+            source: 'graph';
+            executionTime: number;
+            totalResults: number;
+            depth: number;
+        };
+    }>;
+    /**
+     * Find shortest path between two entities with full node details
+     *
+     * @param fromEntityId - Starting entity ID
+     * @param toEntityId - Target entity ID
+     * @param options - Query options (relationship filter, max depth)
+     * @returns Path with full node details or not found
+     */
+    queryGraphPath(fromEntityId: string, toEntityId: string, options?: {
+        includeRelationships?: string[];
+        maxDepth?: number;
+    }): Promise<{
+        found: boolean;
+        path: GraphNode[];
+        edges: Array<{
+            from: string;
+            to: string;
+            type: string;
+        }>;
+        metadata: {
+            source: 'graph';
+            executionTime: number;
+            pathLength?: number;
+        };
+    }>;
+    /**
+     * List all relationship types available in the vault
+     *
+     * @returns List of relationship types with metadata
+     */
+    listRelationshipTypes(): Promise<{
+        types: Array<{
+            id: string;
+            label?: string;
+            description?: string;
+        }>;
+        metadata: {
+            source: 'template';
+            executionTime: number;
+            totalResults: number;
+        };
+    }>;
 }
 //# sourceMappingURL=engine.d.ts.map

package/dist/search/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/search/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,SAAS,EAAE,CAAC;IAC5B,QAAQ,EAAE;QACR,MAAM,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;QACnC,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAmB;gBAEjB,EAAE,EAAE,gBAAgB;IAIhC;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QACpC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,OAAO,CAAC,EAAE;YACR,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;YAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;SACnB,CAAC;QACF,oFAAoF;QACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,WAAW,CAAC;IAoFxB;;;;;;OAMG;IACG,wBAAwB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC;QACV,IAAI,EAAE,SAAS,CAAC;QAChB,aAAa,EAAE,SAAS,EAAE,CAAC;QAC3B,YAAY,EAAE,SAAS,EAAE,CAAC;KAC3B,GAAG,IAAI,CAAC;IA6BT;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAIxD;;OAEG;IACH,QAAQ;;;;;;;CAGT"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/search/engine.ts"],"names":[],"mappings":"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"}