ocr-provenance-mcp 1.0.0

package/dist/tools/tags.js.map

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

package/dist/tools/timeline.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Temporal Analytics MCP Tools
+ *
+ * NOTE: ocr_timeline_analytics merged into ocr_trends (reports.ts) in V7 MERGE-C.
+ * This module is kept because index.ts imports timelineTools.
+ *
+ * @module tools/timeline
+ */
+import type { ToolDefinition } from './shared.js';
+/**
+ * Timeline tools collection for MCP server registration.
+ * Empty after V7 MERGE-C: ocr_timeline_analytics → ocr_trends in reports.ts.
+ */
+export declare const timelineTools: Record<string, ToolDefinition>;
+//# sourceMappingURL=timeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../src/tools/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAM,CAAC"}

package/dist/tools/timeline.js

@@ -0,0 +1,14 @@
+/**
+ * Temporal Analytics MCP Tools
+ *
+ * NOTE: ocr_timeline_analytics merged into ocr_trends (reports.ts) in V7 MERGE-C.
+ * This module is kept because index.ts imports timelineTools.
+ *
+ * @module tools/timeline
+ */
+/**
+ * Timeline tools collection for MCP server registration.
+ * Empty after V7 MERGE-C: ocr_timeline_analytics → ocr_trends in reports.ts.
+ */
+export const timelineTools = {};
+//# sourceMappingURL=timeline.js.map

package/dist/tools/timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../../src/tools/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAmC,EAAE,CAAC"}

package/dist/tools/users.d.ts

@@ -0,0 +1,14 @@
+/**
+ * User Identity and Audit Log Tools
+ *
+ * Provides 2 MCP tools for user management and audit trail querying:
+ * - ocr_user_info: Get/set current user identity
+ * - ocr_audit_query: Query the audit log with filters
+ *
+ * CRITICAL: NEVER use console.log() - stdout is reserved for JSON-RPC protocol.
+ *
+ * @module tools/users
+ */
+import { type ToolDefinition } from './shared.js';
+export declare const userTools: Record<string, ToolDefinition>;
+//# sourceMappingURL=users.d.ts.map

package/dist/tools/users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/tools/users.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAkD,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAkOlG,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAiEpD,CAAC"}

package/dist/tools/users.js

@@ -0,0 +1,257 @@
+/**
+ * User Identity and Audit Log Tools
+ *
+ * Provides 2 MCP tools for user management and audit trail querying:
+ * - ocr_user_info: Get/set current user identity
+ * - ocr_audit_query: Query the audit log with filters
+ *
+ * CRITICAL: NEVER use console.log() - stdout is reserved for JSON-RPC protocol.
+ *
+ * @module tools/users
+ */
+import { z } from 'zod';
+import { formatResponse, handleError } from './shared.js';
+import { successResult } from '../server/types.js';
+import { requireDatabase } from '../server/state.js';
+import { validateInput } from '../utils/validation.js';
+import { createUser, getUser, getUserByExternalId, updateUserActivity, listUsers, queryAuditLog, } from '../services/storage/database/user-operations.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// SCHEMAS
+// ═══════════════════════════════════════════════════════════════════════════════
+const UserRoleSchema = z.enum(['viewer', 'reviewer', 'editor', 'admin']);
+const UserInfoInputSchema = z.object({
+    user_id: z.string().min(1).optional().describe('Internal user ID to look up'),
+    external_id: z.string().min(1).optional().describe('External user ID (e.g., SSO sub claim)'),
+    display_name: z
+        .string()
+        .min(1)
+        .max(200)
+        .optional()
+        .describe('Display name for the user (required when creating a new user)'),
+    email: z.string().email().optional().describe('User email address'),
+    role: UserRoleSchema.optional().describe('User role: viewer, reviewer, editor, or admin'),
+});
+const AuditQueryInputSchema = z.object({
+    user_id: z.string().min(1).optional().describe('Filter by user ID'),
+    action: z.string().min(1).optional().describe('Filter by action (e.g., "ingest", "delete", "search")'),
+    entity_type: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Filter by entity type (e.g., "document", "chunk", "user")'),
+    entity_id: z.string().min(1).optional().describe('Filter by entity ID'),
+    date_from: z
+        .string()
+        .optional()
+        .describe('Filter entries from this ISO 8601 datetime'),
+    date_to: z
+        .string()
+        .optional()
+        .describe('Filter entries up to this ISO 8601 datetime'),
+    limit: z.number().int().min(1).max(500).default(50).describe('Max entries to return (1-500)'),
+    offset: z.number().int().min(0).default(0).describe('Offset for pagination'),
+});
+// ═══════════════════════════════════════════════════════════════════════════════
+// TOOL 1: ocr_user_info
+// ═══════════════════════════════════════════════════════════════════════════════
+async function handleUserInfo(params) {
+    try {
+        const input = validateInput(UserInfoInputSchema, params);
+        const { db } = requireDatabase();
+        const conn = db.getConnection();
+        // Case 1: Look up by internal user_id
+        if (input.user_id) {
+            const user = getUser(conn, input.user_id);
+            if (!user) {
+                throw new Error(`User not found: ${input.user_id}`);
+            }
+            updateUserActivity(conn, user.id);
+            return formatResponse(successResult({
+                user,
+                next_steps: [
+                    { tool: 'ocr_audit_query', description: 'View this user\'s activity log' },
+                ],
+            }));
+        }
+        // Case 2: Look up by external_id (or create if display_name provided)
+        if (input.external_id) {
+            const existing = getUserByExternalId(conn, input.external_id);
+            if (existing) {
+                updateUserActivity(conn, existing.id);
+                return formatResponse(successResult({
+                    user: existing,
+                    created: false,
+                    next_steps: [
+                        { tool: 'ocr_audit_query', description: 'View this user\'s activity log' },
+                    ],
+                }));
+            }
+            // external_id not found - create user if display_name provided
+            if (input.display_name) {
+                const newUser = createUser(conn, {
+                    display_name: input.display_name,
+                    external_id: input.external_id,
+                    email: input.email,
+                    role: input.role ?? 'viewer',
+                });
+                return formatResponse(successResult({
+                    user: newUser,
+                    created: true,
+                    next_steps: [
+                        { tool: 'ocr_audit_query', description: 'View audit log entries' },
+                        { tool: 'ocr_document_list', description: 'Browse documents' },
+                    ],
+                }));
+            }
+            throw new Error(`User with external_id "${input.external_id}" not found. Provide display_name to create.`);
+        }
+        // Case 3: Create user with display_name only (no external_id)
+        if (input.display_name) {
+            const newUser = createUser(conn, {
+                display_name: input.display_name,
+                email: input.email,
+                role: input.role ?? 'viewer',
+            });
+            return formatResponse(successResult({
+                user: newUser,
+                created: true,
+                next_steps: [
+                    { tool: 'ocr_audit_query', description: 'View audit log entries' },
+                    { tool: 'ocr_document_list', description: 'Browse documents' },
+                ],
+            }));
+        }
+        // Case 4: No user_id, no external_id, no display_name - list all users
+        const users = listUsers(conn);
+        return formatResponse(successResult({
+            users,
+            total: users.length,
+            next_steps: users.length === 0
+                ? [
+                    {
+                        tool: 'ocr_user_info',
+                        description: 'Create a user by providing display_name (and optionally external_id, email, role)',
+                    },
+                ]
+                : [
+                    { tool: 'ocr_audit_query', description: 'View audit log for a specific user' },
+                    {
+                        tool: 'ocr_user_info',
+                        description: 'Get details for a specific user by user_id',
+                    },
+                ],
+        }));
+    }
+    catch (error) {
+        return handleError(error);
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// TOOL 2: ocr_audit_query
+// ═══════════════════════════════════════════════════════════════════════════════
+async function handleAuditQuery(params) {
+    try {
+        const input = validateInput(AuditQueryInputSchema, params);
+        const { db } = requireDatabase();
+        const conn = db.getConnection();
+        const limit = input.limit ?? 50;
+        const offset = input.offset ?? 0;
+        const { entries, total } = queryAuditLog(conn, {
+            user_id: input.user_id,
+            action: input.action,
+            entity_type: input.entity_type,
+            entity_id: input.entity_id,
+            date_from: input.date_from,
+            date_to: input.date_to,
+            limit,
+            offset,
+        });
+        const hasMore = offset + entries.length < total;
+        return formatResponse(successResult({
+            entries,
+            total,
+            offset,
+            limit,
+            has_more: hasMore,
+            next_steps: hasMore
+                ? [
+                    {
+                        tool: 'ocr_audit_query',
+                        description: `Get next page with offset=${offset + limit}`,
+                    },
+                ]
+                : [
+                    { tool: 'ocr_user_info', description: 'Look up a user referenced in the audit log' },
+                    { tool: 'ocr_document_get', description: 'Get details for a referenced entity' },
+                ],
+        }));
+    }
+    catch (error) {
+        return handleError(error);
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// TOOL DEFINITIONS EXPORT
+// ═══════════════════════════════════════════════════════════════════════════════
+export const userTools = {
+    ocr_user_info: {
+        description: '[MANAGE] Use to get, create, or list users. If user_id is provided, returns that user. If external_id is provided, looks up or creates (when display_name is also given). If only display_name is provided, creates a new user. If no params, lists all users.',
+        inputSchema: {
+            user_id: z.string().min(1).optional().describe('Internal user ID to look up'),
+            external_id: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('External user ID (e.g., SSO sub claim)'),
+            display_name: z
+                .string()
+                .min(1)
+                .max(200)
+                .optional()
+                .describe('Display name for the user (required when creating a new user)'),
+            email: z.string().email().optional().describe('User email address'),
+            role: UserRoleSchema.optional().describe('User role: viewer, reviewer, editor, or admin'),
+        },
+        handler: handleUserInfo,
+    },
+    ocr_audit_query: {
+        description: '[STATUS] Use to query the audit log. Filter by user_id, action, entity_type, entity_id, and date range. Returns paginated entries ordered by newest first.',
+        inputSchema: {
+            user_id: z.string().min(1).optional().describe('Filter by user ID'),
+            action: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Filter by action (e.g., "ingest", "delete", "search")'),
+            entity_type: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Filter by entity type (e.g., "document", "chunk", "user")'),
+            entity_id: z.string().min(1).optional().describe('Filter by entity ID'),
+            date_from: z
+                .string()
+                .optional()
+                .describe('Filter entries from this ISO 8601 datetime'),
+            date_to: z
+                .string()
+                .optional()
+                .describe('Filter entries up to this ISO 8601 datetime'),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(500)
+                .default(50)
+                .describe('Max entries to return (1-500)'),
+            offset: z
+                .number()
+                .int()
+                .min(0)
+                .default(0)
+                .describe('Offset for pagination'),
+        },
+        handler: handleAuditQuery,
+    },
+};
+//# sourceMappingURL=users.js.map

package/dist/tools/users.js.map

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

package/dist/tools/vlm.d.ts

@@ -0,0 +1,40 @@
+/**
+ * VLM (Vision Language Model) MCP Tools
+ *
+ * Tools for Gemini 3 multimodal image analysis of legal and medical documents.
+ * Uses the VLMService for analysis and VLMPipeline for batch processing.
+ *
+ * CRITICAL: NEVER use console.log() - stdout is reserved for JSON-RPC protocol.
+ * Use console.error() for all logging.
+ *
+ * @module tools/vlm
+ */
+import { type ToolResponse, type ToolDefinition } from './shared.js';
+/**
+ * Handle ocr_vlm_describe - Generate detailed description of an image using Gemini 3
+ *
+ * If the image is a database-tracked image (matched by extracted_path), this tool
+ * will also generate an embedding with full provenance chain for searchability.
+ * For arbitrary images not in the database, only the description is returned.
+ */
+export declare function handleVLMDescribe(params: Record<string, unknown>): Promise<ToolResponse>;
+/**
+ * Handle ocr_vlm_process - Process VLM on a single document or all pending images
+ *
+ * If document_id is provided, processes all images in that document.
+ * If document_id is omitted, processes all pending images across all documents.
+ */
+export declare function handleVLMProcess(params: Record<string, unknown>): Promise<ToolResponse>;
+/**
+ * Handle ocr_vlm_analyze_pdf - Analyze a PDF document directly with Gemini 3
+ */
+export declare function handleVLMAnalyzePDF(params: Record<string, unknown>): Promise<ToolResponse>;
+/**
+ * Handle ocr_vlm_status - Get VLM service status and statistics
+ */
+export declare function handleVLMStatus(params: Record<string, unknown>): Promise<ToolResponse>;
+/**
+ * VLM tools collection for MCP server registration
+ */
+export declare const vlmTools: Record<string, ToolDefinition>;
+//# sourceMappingURL=vlm.d.ts.map

package/dist/tools/vlm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vlm.d.ts","sourceRoot":"","sources":["../../src/tools/vlm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAiCrB;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAwO9F;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,YAAY,CAAC,CA2FvB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAmDhG;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAiC5F;AAMD;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CA2CnD,CAAC"}