@hiveforge/hivemind-mcp 3.4.0 → 3.5.0

package/dist/mcp/graph-tools.js

@@ -0,0 +1,284 @@
+/**
+ * Graph MCP tools - relationship traversal and path finding.
+ *
+ * Provides graph traversal tools for querying entity relationships,
+ * finding shortest paths, and discovering available relationship types.
+ */
+import { z } from 'zod';
+import { templateRegistry } from '../templates/registry.js';
+/**
+ * Validation schema for query_graph_neighbors arguments.
+ *
+ * Finds immediate neighbors (1-hop connections) of an entity.
+ */
+export const QueryGraphNeighborsArgsSchema = z.object({
+    entityId: z
+        .string()
+        .describe('Entity identifier (ID, name, or Type:name format)'),
+    direction: z
+        .enum(['outgoing', 'incoming', 'both'])
+        .optional()
+        .default('both')
+        .describe('Traversal direction (default: both)'),
+    includeRelationships: z
+        .array(z.string())
+        .optional()
+        .describe('Only include these relationship types'),
+    excludeRelationships: z
+        .array(z.string())
+        .optional()
+        .describe('Exclude these relationship types'),
+    includeEntityTypes: z
+        .array(z.string())
+        .optional()
+        .describe('Only return neighbors of these entity types'),
+    limit: z
+        .number()
+        .min(1)
+        .max(100)
+        .optional()
+        .default(50)
+        .describe('Maximum neighbors to return'),
+});
+/**
+ * Validation schema for query_graph_subgraph arguments.
+ *
+ * Finds entities within N hops of a starting entity.
+ */
+export const QueryGraphSubgraphArgsSchema = z.object({
+    entityId: z
+        .string()
+        .describe('Starting entity identifier'),
+    depth: z
+        .number()
+        .min(1)
+        .max(5)
+        .optional()
+        .default(2)
+        .describe('Number of hops to traverse (max: 5)'),
+    direction: z
+        .enum(['outgoing', 'incoming', 'both'])
+        .optional()
+        .default('both')
+        .describe('Traversal direction (default: both)'),
+    includeRelationships: z
+        .array(z.string())
+        .optional()
+        .describe('Only include these relationship types'),
+    excludeRelationships: z
+        .array(z.string())
+        .optional()
+        .describe('Exclude these relationship types'),
+    includeEntityTypes: z
+        .array(z.string())
+        .optional()
+        .describe('Only return entities of these types'),
+    includeIntermediateNodes: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Include nodes at intermediate depths'),
+    limit: z
+        .number()
+        .min(1)
+        .max(200)
+        .optional()
+        .default(100)
+        .describe('Maximum entities to return'),
+});
+/**
+ * Validation schema for query_graph_path arguments.
+ *
+ * Finds the shortest path between two entities.
+ */
+export const QueryGraphPathArgsSchema = z.object({
+    fromEntityId: z
+        .string()
+        .describe('Starting entity identifier'),
+    toEntityId: z
+        .string()
+        .describe('Target entity identifier'),
+    includeRelationships: z
+        .array(z.string())
+        .optional()
+        .describe('Only traverse these relationship types'),
+    maxDepth: z
+        .number()
+        .min(1)
+        .max(10)
+        .optional()
+        .default(6)
+        .describe('Maximum path length to search'),
+});
+/**
+ * Validation schema for list_relationship_types arguments.
+ *
+ * Lists all relationship types available in the vault.
+ */
+export const ListRelationshipTypesArgsSchema = z.object({
+// No required parameters
+});
+/**
+ * Generates MCP tool definitions for graph queries.
+ *
+ * Creates four tools: query_graph_neighbors, query_graph_subgraph,
+ * query_graph_path, and list_relationship_types.
+ *
+ * Tool descriptions dynamically include available relationship types
+ * when an active template is present.
+ *
+ * @returns Array of tool definitions for MCP registration
+ */
+export function generateGraphTools() {
+    // Get available relationship types for tool descriptions
+    let relationshipTypesDescription = '';
+    try {
+        const relTypes = templateRegistry.getRelationshipTypes();
+        if (relTypes.length > 0) {
+            relationshipTypesDescription =
+                '\n\nAvailable relationship types: ' +
+                    relTypes.map((r) => r.id).join(', ');
+        }
+    }
+    catch {
+        // No active template - tools still available but without relationship type hints
+    }
+    return [
+        {
+            name: 'query_graph_neighbors',
+            description: `Get immediate neighbors (1-hop connections) of an entity. Returns neighbor entities with their relationship types and directions.${relationshipTypesDescription}`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    entityId: {
+                        type: 'string',
+                        description: 'Entity identifier (ID, name, or Type:name format like "Character:john")',
+                    },
+                    direction: {
+                        type: 'string',
+                        enum: ['outgoing', 'incoming', 'both'],
+                        default: 'both',
+                        description: 'Traversal direction (default: both)',
+                    },
+                    includeRelationships: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Only include these relationship types',
+                    },
+                    excludeRelationships: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Exclude these relationship types',
+                    },
+                    includeEntityTypes: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Only return neighbors of these entity types',
+                    },
+                    limit: {
+                        type: 'number',
+                        minimum: 1,
+                        maximum: 100,
+                        default: 50,
+                        description: 'Maximum neighbors to return',
+                    },
+                },
+                required: ['entityId'],
+            },
+        },
+        {
+            name: 'query_graph_subgraph',
+            description: `Get entities within N hops of a starting entity. Useful for exploring the neighborhood around an entity.${relationshipTypesDescription}`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    entityId: {
+                        type: 'string',
+                        description: 'Starting entity identifier',
+                    },
+                    depth: {
+                        type: 'number',
+                        minimum: 1,
+                        maximum: 5,
+                        default: 2,
+                        description: 'Number of hops to traverse (1-5, default: 2)',
+                    },
+                    direction: {
+                        type: 'string',
+                        enum: ['outgoing', 'incoming', 'both'],
+                        default: 'both',
+                        description: 'Traversal direction (default: both)',
+                    },
+                    includeRelationships: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Only include these relationship types',
+                    },
+                    excludeRelationships: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Exclude these relationship types',
+                    },
+                    includeEntityTypes: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Only return entities of these types',
+                    },
+                    includeIntermediateNodes: {
+                        type: 'boolean',
+                        default: false,
+                        description: 'Include nodes at intermediate depths (default: only final depth)',
+                    },
+                    limit: {
+                        type: 'number',
+                        minimum: 1,
+                        maximum: 200,
+                        default: 100,
+                        description: 'Maximum entities to return',
+                    },
+                },
+                required: ['entityId'],
+            },
+        },
+        {
+            name: 'query_graph_path',
+            description: `Find shortest path between two entities. Returns both the node sequence and edge list.${relationshipTypesDescription}`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    fromEntityId: {
+                        type: 'string',
+                        description: 'Starting entity identifier',
+                    },
+                    toEntityId: {
+                        type: 'string',
+                        description: 'Target entity identifier',
+                    },
+                    includeRelationships: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Only traverse these relationship types',
+                    },
+                    maxDepth: {
+                        type: 'number',
+                        minimum: 1,
+                        maximum: 10,
+                        default: 6,
+                        description: 'Maximum path length to search',
+                    },
+                },
+                required: ['fromEntityId', 'toEntityId'],
+            },
+        },
+        {
+            name: 'list_relationship_types',
+            description: 'List all relationship types available in the vault. Use this to discover valid filter values for graph queries.',
+            inputSchema: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+        },
+    ];
+}
+//# sourceMappingURL=graph-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-tools.js","sourceRoot":"","sources":["../../src/mcp/graph-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG5D;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,mDAAmD,CAAC;IAChE,SAAS,EAAE,CAAC;SACT,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;SACtC,QAAQ,EAAE;SACV,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,qCAAqC,CAAC;IAClD,oBAAoB,EAAE,CAAC;SACpB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,uCAAuC,CAAC;IACpD,oBAAoB,EAAE,CAAC;SACpB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,kCAAkC,CAAC;IAC/C,kBAAkB,EAAE,CAAC;SAClB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,6CAA6C,CAAC;IAC1D,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,6BAA6B,CAAC;CAC3C,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,4BAA4B,CAAC;IACzC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,qCAAqC,CAAC;IAClD,SAAS,EAAE,CAAC;SACT,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;SACtC,QAAQ,EAAE;SACV,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,qCAAqC,CAAC;IAClD,oBAAoB,EAAE,CAAC;SACpB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,uCAAuC,CAAC;IACpD,oBAAoB,EAAE,CAAC;SACpB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,kCAAkC,CAAC;IAC/C,kBAAkB,EAAE,CAAC;SAClB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,qCAAqC,CAAC;IAClD,wBAAwB,EAAE,CAAC;SACxB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,sCAAsC,CAAC;IACnD,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,GAAG,CAAC;SACZ,QAAQ,CAAC,4BAA4B,CAAC;CAC1C,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,CAAC,4BAA4B,CAAC;IACzC,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,CAAC,0BAA0B,CAAC;IACvC,oBAAoB,EAAE,CAAC;SACpB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,wCAAwC,CAAC;IACrD,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,+BAA+B,CAAC;CAC7C,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;AACtD,yBAAyB;CAC1B,CAAC,CAAC;AAIH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB;IAChC,yDAAyD;IACzD,IAAI,4BAA4B,GAAG,EAAE,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,gBAAgB,CAAC,oBAAoB,EAAE,CAAC;QACzD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,4BAA4B;gBAC1B,oCAAoC;oBACpC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iFAAiF;IACnF,CAAC;IAED,OAAO;QACL;YACE,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EAAE,oIAAoI,4BAA4B,EAAE;YAC/K,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,yEAAyE;qBAC5E;oBACD,SAAS,EAAE;wBACT,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC;wBACtC,OAAO,EAAE,MAAM;wBACf,WAAW,EAAE,qCAAqC;qBACnD;oBACD,oBAAoB,EAAE;wBACpB,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,WAAW,EAAE,uCAAuC;qBACrD;oBACD,oBAAoB,EAAE;wBACpB,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,WAAW,EAAE,kCAAkC;qBAChD;oBACD,kBAAkB,EAAE;wBAClB,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,WAAW,EAAE,6CAA6C;qBAC3D;oBACD,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,GAAG;wBACZ,OAAO,EAAE,EAAE;wBACX,WAAW,EAAE,6BAA6B;qBAC3C;iBACF;gBACD,QAAQ,EAAE,CAAC,UAAU,CAAC;aACvB;SACF;QACD;YACE,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,2GAA2G,4BAA4B,EAAE;YACtJ,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,4BAA4B;qBAC1C;oBACD,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,CAAC;wBACV,WAAW,EAAE,8CAA8C;qBAC5D;oBACD,SAAS,EAAE;wBACT,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC;wBACtC,OAAO,EAAE,MAAM;wBACf,WAAW,EAAE,qCAAqC;qBACnD;oBACD,oBAAoB,EAAE;wBACpB,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,WAAW,EAAE,uCAAuC;qBACrD;oBACD,oBAAoB,EAAE;wBACpB,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,WAAW,EAAE,kCAAkC;qBAChD;oBACD,kBAAkB,EAAE;wBAClB,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,WAAW,EAAE,qCAAqC;qBACnD;oBACD,wBAAwB,EAAE;wBACxB,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,KAAK;wBACd,WAAW,EACT,kEAAkE;qBACrE;oBACD,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,GAAG;wBACZ,OAAO,EAAE,GAAG;wBACZ,WAAW,EAAE,4BAA4B;qBAC1C;iBACF;gBACD,QAAQ,EAAE,CAAC,UAAU,CAAC;aACvB;SACF;QACD;YACE,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,yFAAyF,4BAA4B,EAAE;YACpI,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,YAAY,EAAE;wBACZ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,4BAA4B;qBAC1C;oBACD,UAAU,EAAE;wBACV,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,0BAA0B;qBACxC;oBACD,oBAAoB,EAAE;wBACpB,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,WAAW,EAAE,wCAAwC;qBACtD;oBACD,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,EAAE;wBACX,OAAO,EAAE,CAAC;wBACV,WAAW,EAAE,+BAA+B;qBAC7C;iBACF;gBACD,QAAQ,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC;aACzC;SACF;QACD;YACE,IAAI,EAAE,yBAAyB;YAC/B,WAAW,EACT,iHAAiH;YACnH,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE;gBACd,QAAQ,EAAE,EAAE;aACb;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/mcp/timeline-tools.d.ts

@@ -0,0 +1,116 @@
+/**
+ * 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 type { ToolDefinition } from './tool-generator.js';
+/**
+ * Information about an entity type's date fields.
+ */
+export interface TemporalTypeInfo {
+    /** Entity type name */
+    entityType: string;
+    /** Date fields available on this entity type */
+    dateFields: Array<{
+        name: string;
+        required: boolean;
+        description?: string;
+    }>;
+}
+/**
+ * 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 declare function discoverTemporalTypes(): TemporalTypeInfo[];
+/**
+ * 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 declare function validateDateField(entityType: string, dateField: string): boolean;
+/**
+ * Validation schema for query_timeline_range arguments.
+ *
+ * Finds entities with date fields in a specified range.
+ */
+export declare const QueryTimelineRangeArgsSchema: z.ZodObject<{
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+    dateField: z.ZodString;
+    entityType: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+export type QueryTimelineRangeArgs = z.infer<typeof QueryTimelineRangeArgsSchema>;
+/**
+ * Validation schema for query_timeline_before arguments.
+ *
+ * Finds entities with date fields before a specified date.
+ */
+export declare const QueryTimelineBeforeArgsSchema: z.ZodObject<{
+    date: z.ZodString;
+    dateField: z.ZodString;
+    entityType: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+export type QueryTimelineBeforeArgs = z.infer<typeof QueryTimelineBeforeArgsSchema>;
+/**
+ * Validation schema for query_timeline_after arguments.
+ *
+ * Finds entities with date fields after a specified date.
+ */
+export declare const QueryTimelineAfterArgsSchema: z.ZodObject<{
+    date: z.ZodString;
+    dateField: z.ZodString;
+    entityType: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+export type QueryTimelineAfterArgs = z.infer<typeof QueryTimelineAfterArgsSchema>;
+/**
+ * Validation schema for query_timeline_exact arguments.
+ *
+ * Finds entities with date fields matching an exact date.
+ */
+export declare const QueryTimelineExactArgsSchema: z.ZodObject<{
+    date: z.ZodString;
+    dateField: z.ZodString;
+    entityType: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+export type QueryTimelineExactArgs = z.infer<typeof QueryTimelineExactArgsSchema>;
+/**
+ * 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 declare function generateTimelineTools(temporalTypes: TemporalTypeInfo[]): ToolDefinition[];
+//# sourceMappingURL=timeline-tools.d.ts.map

package/dist/mcp/timeline-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/timeline-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,gBAAgB,EAAE,CA0B1D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAiBhF;AAUD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;iBAwBvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;iBAqBxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;iBAqBvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;iBAqBvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,gBAAgB,EAAE,GAAG,cAAc,EAAE,CA+GzF"}