@pcircle/footprint 1.1.0 → 1.2.0

package/dist/{lib → src/lib}/storage/schema.js

@@ -10,6 +10,14 @@ const SCHEMA_VERSION = '1';
  */
 export function createSchema(db) {
     try {
+        // Enable WAL mode for better concurrency and crash safety
+        db.pragma('journal_mode = WAL');
+        // NORMAL synchronous is safe with WAL and much faster
+        db.pragma('synchronous = NORMAL');
+        // Wait 5 seconds before returning SQLITE_BUSY error
+        db.pragma('busy_timeout = 5000');
+        // Enable foreign key constraints
+        db.pragma('foreign_keys = ON');
         // Create evidences table
         db.exec(`
       CREATE TABLE IF NOT EXISTS evidences (
@@ -28,12 +36,20 @@ export function createSchema(db) {
         updatedAt TEXT NOT NULL DEFAULT (datetime('now'))
       );
     `);
-        // Create metadata table for schema versioning
+        // Create metadata table for schema versioning and configuration
         db.exec(`
       CREATE TABLE IF NOT EXISTS metadata (
         key TEXT PRIMARY KEY,
         value TEXT NOT NULL
       );
+    `);
+        // Create crypto_keys table for master salt storage
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS crypto_keys (
+        id INTEGER PRIMARY KEY CHECK (id = 1),
+        salt BLOB NOT NULL,
+        createdAt TEXT NOT NULL DEFAULT (datetime('now'))
+      );
     `);
         // Create indexes for common queries
         db.exec(`
@@ -77,6 +93,11 @@ export function verifySchema(db) {
         if (!metadataTableInfo || metadataTableInfo.length === 0) {
             return false;
         }
+        // Check if crypto_keys table exists
+        const cryptoKeysTableInfo = db.pragma('table_info(crypto_keys)');
+        if (!cryptoKeysTableInfo || cryptoKeysTableInfo.length === 0) {
+            return false;
+        }
         // Verify required columns exist in evidences table
         const evidencesColumns = evidencesTableInfo.map((col) => col.name);
         const requiredColumns = [

package/dist/src/lib/storage/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/lib/storage/schema.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,EAAqB;IAChD,IAAI,CAAC;QACH,0DAA0D;QAC1D,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAChC,sDAAsD;QACtD,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAClC,oDAAoD;QACpD,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACjC,iCAAiC;QACjC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAE/B,yBAAyB;QACzB,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;KAgBP,CAAC,CAAC;QAEH,gEAAgE;QAChE,EAAE,CAAC,IAAI,CAAC;;;;;KAKP,CAAC,CAAC;QAEH,mDAAmD;QACnD,EAAE,CAAC,IAAI,CAAC;;;;;;KAMP,CAAC,CAAC;QAEH,oCAAoC;QACpC,EAAE,CAAC,IAAI,CAAC;;KAEP,CAAC,CAAC;QAEH,EAAE,CAAC,IAAI,CAAC;;KAEP,CAAC,CAAC;QAEH,EAAE,CAAC,IAAI,CAAC;;KAEP,CAAC,CAAC;QAEH,kEAAkE;QAClE,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC;;;KAGvB,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,oEAAoE;QACpE,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,EAAqB;IAChD,IAAI,CAAC;QACH,kCAAkC;QAClC,MAAM,kBAAkB,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAA0C,CAAC;QACvG,IAAI,CAAC,kBAAkB,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3D,OAAO,KAAK,CAAC;QACf,CAAC;QAED,iCAAiC;QACjC,MAAM,iBAAiB,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAA0C,CAAC;QACrG,IAAI,CAAC,iBAAiB,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,oCAAoC;QACpC,MAAM,mBAAmB,GAAG,EAAE,CAAC,MAAM,CAAC,yBAAyB,CAA0C,CAAC;QAC1G,IAAI,CAAC,mBAAmB,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7D,OAAO,KAAK,CAAC;QACf,CAAC;QAED,mDAAmD;QACnD,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnE,MAAM,eAAe,GAAG;YACtB,IAAI;YACJ,WAAW;YACX,kBAAkB;YAClB,OAAO;YACP,aAAa;YACb,cAAc;YACd,WAAW;YACX,WAAW;SACZ,CAAC;QAEF,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAClC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpC,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/src/lib/storage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/storage/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,UAAU,CAAC;IAC7B,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/src/lib/storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/lib/storage/types.ts"],"names":[],"mappings":""}

package/dist/src/lib/tool-response.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Standardized tool response builder for MCP tools
+ * Provides consistent formatting across all tool handlers
+ */
+/**
+ * MCP tool response structure
+ * Includes index signature to match MCP SDK requirements
+ */
+export interface ToolResponse<T = unknown> {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    structuredContent?: T;
+    [key: string]: unknown;
+}
+/**
+ * Create a standardized tool response
+ *
+ * @param message - Human-readable message (can include newlines and formatting)
+ * @param structuredContent - Machine-readable structured data
+ * @returns Formatted tool response
+ *
+ * @example
+ * ```typescript
+ * return createToolResponse(
+ *   '✅ Evidence captured successfully\n- ID: abc123\n- Timestamp: 2024-01-01',
+ *   { id: 'abc123', timestamp: '2024-01-01', success: true }
+ * );
+ * ```
+ */
+export declare function createToolResponse<T>(message: string, structuredContent: T): ToolResponse<T>;
+/**
+ * Format a key-value object as a bulleted list
+ *
+ * @param items - Key-value pairs to format
+ * @param indent - Indentation string (default: '- ')
+ * @returns Formatted bullet list string
+ *
+ * @example
+ * ```typescript
+ * formatBulletList({ id: '123', count: 5, tag: null })
+ * // Returns: "- id: 123\n- count: 5"
+ * ```
+ */
+export declare function formatBulletList(items: Record<string, string | number | boolean | null | undefined>, indent?: string): string;
+/**
+ * Format a success response with standardized emoji and structure
+ *
+ * @param title - Success message title
+ * @param details - Key-value details to display
+ * @param structuredContent - Machine-readable data
+ * @returns Formatted success response
+ *
+ * @example
+ * ```typescript
+ * return formatSuccessResponse(
+ *   'Evidence captured successfully',
+ *   { id: 'abc123', timestamp: '2024-01-01' },
+ *   { id: 'abc123', success: true }
+ * );
+ * // Returns: "✅ Evidence captured successfully\n- id: abc123\n- timestamp: 2024-01-01"
+ * ```
+ */
+export declare function formatSuccessResponse<T>(title: string, details: Record<string, string | number | boolean | null | undefined>, structuredContent: T): ToolResponse<T>;
+/**
+ * Format an error response with standardized emoji
+ *
+ * @param title - Error message title
+ * @param reason - Error reason or details
+ * @param structuredContent - Machine-readable error data
+ * @returns Formatted error response
+ */
+export declare function formatErrorResponse<T>(title: string, reason: string, structuredContent: T): ToolResponse<T>;
+/**
+ * Format a warning response with standardized emoji
+ *
+ * @param title - Warning message title
+ * @param details - Warning details
+ * @param structuredContent - Machine-readable data
+ * @returns Formatted warning response
+ */
+export declare function formatWarningResponse<T>(title: string, details: string, structuredContent: T): ToolResponse<T>;
+//# sourceMappingURL=tool-response.d.ts.map

package/dist/src/lib/tool-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-response.d.ts","sourceRoot":"","sources":["../../../src/lib/tool-response.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,iBAAiB,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,CAAC,GACnB,YAAY,CAAC,CAAC,CAAC,CAKjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,EACnE,MAAM,SAAO,GACZ,MAAM,CAKR;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,EACrE,iBAAiB,EAAE,CAAC,GACnB,YAAY,CAAC,CAAC,CAAC,CAGjB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,CAAC,GACnB,YAAY,CAAC,CAAC,CAAC,CAGjB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,CAAC,GACnB,YAAY,CAAC,CAAC,CAAC,CAGjB"}

package/dist/src/lib/tool-response.js

@@ -0,0 +1,91 @@
+/**
+ * Standardized tool response builder for MCP tools
+ * Provides consistent formatting across all tool handlers
+ */
+/**
+ * Create a standardized tool response
+ *
+ * @param message - Human-readable message (can include newlines and formatting)
+ * @param structuredContent - Machine-readable structured data
+ * @returns Formatted tool response
+ *
+ * @example
+ * ```typescript
+ * return createToolResponse(
+ *   '✅ Evidence captured successfully\n- ID: abc123\n- Timestamp: 2024-01-01',
+ *   { id: 'abc123', timestamp: '2024-01-01', success: true }
+ * );
+ * ```
+ */
+export function createToolResponse(message, structuredContent) {
+    return {
+        content: [{ type: 'text', text: message }],
+        structuredContent
+    };
+}
+/**
+ * Format a key-value object as a bulleted list
+ *
+ * @param items - Key-value pairs to format
+ * @param indent - Indentation string (default: '- ')
+ * @returns Formatted bullet list string
+ *
+ * @example
+ * ```typescript
+ * formatBulletList({ id: '123', count: 5, tag: null })
+ * // Returns: "- id: 123\n- count: 5"
+ * ```
+ */
+export function formatBulletList(items, indent = '- ') {
+    return Object.entries(items)
+        .filter(([, value]) => value !== undefined && value !== null)
+        .map(([key, value]) => `${indent}${key}: ${value}`)
+        .join('\n');
+}
+/**
+ * Format a success response with standardized emoji and structure
+ *
+ * @param title - Success message title
+ * @param details - Key-value details to display
+ * @param structuredContent - Machine-readable data
+ * @returns Formatted success response
+ *
+ * @example
+ * ```typescript
+ * return formatSuccessResponse(
+ *   'Evidence captured successfully',
+ *   { id: 'abc123', timestamp: '2024-01-01' },
+ *   { id: 'abc123', success: true }
+ * );
+ * // Returns: "✅ Evidence captured successfully\n- id: abc123\n- timestamp: 2024-01-01"
+ * ```
+ */
+export function formatSuccessResponse(title, details, structuredContent) {
+    const message = `✅ ${title}\n${formatBulletList(details)}`;
+    return createToolResponse(message, structuredContent);
+}
+/**
+ * Format an error response with standardized emoji
+ *
+ * @param title - Error message title
+ * @param reason - Error reason or details
+ * @param structuredContent - Machine-readable error data
+ * @returns Formatted error response
+ */
+export function formatErrorResponse(title, reason, structuredContent) {
+    const message = `❌ ${title}\n${reason}`;
+    return createToolResponse(message, structuredContent);
+}
+/**
+ * Format a warning response with standardized emoji
+ *
+ * @param title - Warning message title
+ * @param details - Warning details
+ * @param structuredContent - Machine-readable data
+ * @returns Formatted warning response
+ */
+export function formatWarningResponse(title, details, structuredContent) {
+    const message = `⚠️ ${title}\n${details}`;
+    return createToolResponse(message, structuredContent);
+}
+//# sourceMappingURL=tool-response.js.map

package/dist/src/lib/tool-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-response.js","sourceRoot":"","sources":["../../../src/lib/tool-response.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,iBAAoB;IAEpB,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC1C,iBAAiB;KAClB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAmE,EACnE,MAAM,GAAG,IAAI;IAEb,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;SACzB,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;SAC5D,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,GAAG,KAAK,KAAK,EAAE,CAAC;SAClD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAa,EACb,OAAqE,EACrE,iBAAoB;IAEpB,MAAM,OAAO,GAAG,KAAK,KAAK,KAAK,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3D,OAAO,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,MAAc,EACd,iBAAoB;IAEpB,MAAM,OAAO,GAAG,KAAK,KAAK,KAAK,MAAM,EAAE,CAAC;IACxC,OAAO,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAa,EACb,OAAe,EACf,iBAAoB;IAEpB,MAAM,OAAO,GAAG,MAAM,KAAK,KAAK,OAAO,EAAE,CAAC;IAC1C,OAAO,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;AACxD,CAAC"}

package/dist/src/lib/tool-wrapper.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Tool handler error wrapper for consistent error handling
+ * Provides standardized error messages across all MCP tools
+ */
+/**
+ * Get error message from unknown error type
+ * Handles Error objects, strings, and other types safely
+ *
+ * @param error - Unknown error value
+ * @returns Error message string
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * Wrap a tool handler with standardized error handling
+ * Catches errors and formats them with tool name and suggested action
+ *
+ * @param toolName - Name of the tool (e.g., 'capture-footprint')
+ * @param suggestedAction - Action to suggest when error occurs
+ * @param handler - The actual tool handler function
+ * @returns Wrapped handler with error handling
+ *
+ * @example
+ * ```typescript
+ * const handler = wrapToolHandler(
+ *   'capture-footprint',
+ *   'Check content is not empty and messageCount is positive.',
+ *   async (params) => {
+ *     // Handler implementation
+ *     return { ... };
+ *   }
+ * );
+ * ```
+ */
+export declare function wrapToolHandler<TParams, TResult>(toolName: string, suggestedAction: string, handler: (params: TParams) => Promise<TResult>): (params: TParams) => Promise<TResult>;
+/**
+ * Wrap a synchronous tool handler with error handling
+ * Same as wrapToolHandler but for sync functions
+ *
+ * @param toolName - Name of the tool
+ * @param suggestedAction - Action to suggest when error occurs
+ * @param handler - The actual tool handler function (synchronous)
+ * @returns Wrapped handler with error handling
+ */
+export declare function wrapSyncToolHandler<TParams, TResult>(toolName: string, suggestedAction: string, handler: (params: TParams) => TResult): (params: TParams) => TResult;
+//# sourceMappingURL=tool-wrapper.d.ts.map

package/dist/src/lib/tool-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-wrapper.d.ts","sourceRoot":"","sources":["../../../src/lib/tool-wrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQtD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAC9C,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAC7C,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAWvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAClD,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GACpC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAW9B"}

package/dist/src/lib/tool-wrapper.js

@@ -0,0 +1,73 @@
+/**
+ * Tool handler error wrapper for consistent error handling
+ * Provides standardized error messages across all MCP tools
+ */
+/**
+ * Get error message from unknown error type
+ * Handles Error objects, strings, and other types safely
+ *
+ * @param error - Unknown error value
+ * @returns Error message string
+ */
+export function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    return 'Unknown error';
+}
+/**
+ * Wrap a tool handler with standardized error handling
+ * Catches errors and formats them with tool name and suggested action
+ *
+ * @param toolName - Name of the tool (e.g., 'capture-footprint')
+ * @param suggestedAction - Action to suggest when error occurs
+ * @param handler - The actual tool handler function
+ * @returns Wrapped handler with error handling
+ *
+ * @example
+ * ```typescript
+ * const handler = wrapToolHandler(
+ *   'capture-footprint',
+ *   'Check content is not empty and messageCount is positive.',
+ *   async (params) => {
+ *     // Handler implementation
+ *     return { ... };
+ *   }
+ * );
+ * ```
+ */
+export function wrapToolHandler(toolName, suggestedAction, handler) {
+    return async (params) => {
+        try {
+            return await handler(params);
+        }
+        catch (error) {
+            const errorMessage = getErrorMessage(error);
+            throw new Error(`[Tool: ${toolName}] ${errorMessage}. Suggested action: ${suggestedAction}`);
+        }
+    };
+}
+/**
+ * Wrap a synchronous tool handler with error handling
+ * Same as wrapToolHandler but for sync functions
+ *
+ * @param toolName - Name of the tool
+ * @param suggestedAction - Action to suggest when error occurs
+ * @param handler - The actual tool handler function (synchronous)
+ * @returns Wrapped handler with error handling
+ */
+export function wrapSyncToolHandler(toolName, suggestedAction, handler) {
+    return (params) => {
+        try {
+            return handler(params);
+        }
+        catch (error) {
+            const errorMessage = getErrorMessage(error);
+            throw new Error(`[Tool: ${toolName}] ${errorMessage}. Suggested action: ${suggestedAction}`);
+        }
+    };
+}
+//# sourceMappingURL=tool-wrapper.js.map

package/dist/src/lib/tool-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-wrapper.js","sourceRoot":"","sources":["../../../src/lib/tool-wrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,eAAuB,EACvB,OAA8C;IAE9C,OAAO,KAAK,EAAE,MAAe,EAAE,EAAE;QAC/B,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,UAAU,QAAQ,KAAK,YAAY,uBAAuB,eAAe,EAAE,CAC5E,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,eAAuB,EACvB,OAAqC;IAErC,OAAO,CAAC,MAAe,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,UAAU,QAAQ,KAAK,YAAY,uBAAuB,eAAe,EAAE,CAC5E,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/{test-helpers.d.ts → src/test-helpers.d.ts}

@@ -1,7 +1,7 @@
 /**
- * Test Helper Utilities for EvidenceMCP Server
+ * Test Helper Utilities for Footprint Server
  */
-import type { EvidenceMCPServer } from './index.js';
+import type { FootprintServer } from './index.js';
 export interface ToolInfo {
     name: string;
     description: string;
@@ -12,9 +12,9 @@ export interface ResourceInfo {
     description: string;
     mimeType: string;
 }
-export declare class EvidenceMCPTestHelpers {
+export declare class FootprintTestHelpers {
     private server;
-    constructor(server: EvidenceMCPServer);
+    constructor(server: FootprintServer);
     private getServerInternal;
     getTools(): Promise<ToolInfo[]>;
     getResources(): Promise<ResourceInfo[]>;

package/dist/src/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../src/test-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAuDD,qBAAa,oBAAoB;IACnB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAE3C,OAAO,CAAC,iBAAiB;IAInB,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAS/B,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAiBvC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IA0BxG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAmBhG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;QAAE,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAIvH"}

package/dist/{test-helpers.js → src/test-helpers.js}

@@ -1,5 +1,5 @@
 /**
- * Test Helper Utilities for EvidenceMCP Server
+ * Test Helper Utilities for Footprint Server
  */
 function getFromRegistry(registry, finder) {
     if (!registry)
@@ -41,7 +41,7 @@ function mapRegistry(registry, mapper) {
     }
     return [];
 }
-export class EvidenceMCPTestHelpers {
+export class FootprintTestHelpers {
     server;
     constructor(server) {
         this.server = server;

package/dist/src/test-helpers.js.map

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

package/dist/src/tools/capture-footprint.d.ts

@@ -0,0 +1,29 @@
+import * as z from "zod";
+import { type EvidenceDatabase } from "../lib/storage/index.js";
+import type { CaptureEvidenceParams } from "../types.js";
+export declare const captureFootprintSchema: {
+    inputSchema: {
+        conversationId: z.ZodString;
+        llmProvider: z.ZodString;
+        content: z.ZodString;
+        messageCount: z.ZodNumber;
+        tags: z.ZodOptional<z.ZodString>;
+    };
+    outputSchema: {
+        id: z.ZodString;
+        timestamp: z.ZodString;
+        gitCommitHash: z.ZodNullable<z.ZodString>;
+        success: z.ZodBoolean;
+    };
+};
+export declare const captureFootprintMetadata: {
+    title: string;
+    description: string;
+};
+export declare function createCaptureFootprintHandler(db: EvidenceDatabase, getDerivedKey: () => Promise<Uint8Array>): (params: CaptureEvidenceParams) => Promise<import("../lib/tool-response.js").ToolResponse<{
+    id: string;
+    timestamp: string;
+    gitCommitHash: string | null;
+    success: boolean;
+}>>;
+//# sourceMappingURL=capture-footprint.d.ts.map

package/dist/src/tools/capture-footprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-footprint.d.ts","sourceRoot":"","sources":["../../../src/tools/capture-footprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAKzB,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;CAkBlC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;CAGpC,CAAC;AAEF,wBAAgB,6BAA6B,CAC3C,EAAE,EAAE,gBAAgB,EACpB,aAAa,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC;;;;;IAmFzC"}

package/dist/src/tools/capture-footprint.js

@@ -0,0 +1,94 @@
+import * as z from "zod";
+import * as crypto from "crypto";
+import { wrapToolHandler } from "../lib/tool-wrapper.js";
+import { formatSuccessResponse } from "../lib/tool-response.js";
+import { encrypt } from "../lib/crypto/index.js";
+import { getCurrentCommit, } from "../lib/storage/index.js";
+export const captureFootprintSchema = {
+    inputSchema: {
+        conversationId: z.string().describe("Conversation ID"),
+        llmProvider: z
+            .string()
+            .describe("LLM provider name (e.g., Claude Sonnet 4.5)"),
+        content: z
+            .string()
+            .describe("Conversation content (messages, prompts, responses)"),
+        messageCount: z.number().int().positive().describe("Number of messages"),
+        tags: z.string().optional().describe("Optional tags (comma-separated)"),
+    },
+    outputSchema: {
+        id: z.string(),
+        timestamp: z.string(),
+        gitCommitHash: z.string().nullable(),
+        success: z.boolean(),
+    },
+};
+export const captureFootprintMetadata = {
+    title: "Capture Footprint",
+    description: "Capture and encrypt LLM conversation as footprint",
+};
+export function createCaptureFootprintHandler(db, getDerivedKey) {
+    return wrapToolHandler("capture-footprint", "Check content is not empty, messageCount is positive, and tags format is valid.", async (params) => {
+        // Validation
+        if (!params.content || params.content.trim().length === 0) {
+            throw new Error("Content cannot be empty");
+        }
+        if (params.messageCount <= 0) {
+            throw new Error("Message count must be positive");
+        }
+        // eslint-disable-next-line no-control-regex
+        if (/[\x00\n\r,]/.test(params.conversationId)) {
+            throw new Error("Conversation ID cannot contain null bytes, newlines, or commas");
+        }
+        // Validate and sanitize tags if provided
+        if (params.tags) {
+            const tags = params.tags
+                .split(",")
+                .map((t) => t.trim())
+                .filter((t) => t.length > 0);
+            if (tags.length === 0) {
+                throw new Error("All provided tags are empty or whitespace");
+            }
+            for (const tag of tags) {
+                // eslint-disable-next-line no-control-regex
+                if (/[\x00\n\r,]/.test(tag)) {
+                    throw new Error(`Invalid tag format: "${tag}". Tags cannot contain null bytes, newlines, or commas.`);
+                }
+            }
+            params.tags = tags.join(",");
+        }
+        // Encrypt and capture
+        const key = await getDerivedKey();
+        const encrypted = await encrypt(params.content, key);
+        const gitInfo = await getCurrentCommit();
+        const contentHash = crypto
+            .createHash("sha256")
+            .update(params.content)
+            .digest("hex");
+        const timestamp = new Date().toISOString();
+        const id = db.create({
+            timestamp,
+            conversationId: params.conversationId,
+            llmProvider: params.llmProvider,
+            encryptedContent: encrypted.ciphertext,
+            nonce: encrypted.nonce,
+            contentHash,
+            messageCount: params.messageCount,
+            gitCommitHash: gitInfo?.commitHash || null,
+            gitTimestamp: gitInfo?.timestamp || null,
+            tags: params.tags || null,
+        });
+        return formatSuccessResponse("Evidence captured successfully", {
+            ID: id,
+            Timestamp: timestamp,
+            "Git Commit": gitInfo?.commitHash || "N/A",
+            "Message Count": params.messageCount,
+        }, {
+            id,
+            timestamp,
+            gitCommitHash: gitInfo?.commitHash || null,
+            success: true,
+        });
+    });
+}
+//# sourceMappingURL=capture-footprint.js.map

package/dist/src/tools/capture-footprint.js.map

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

package/dist/src/tools/delete-footprints.d.ts

@@ -0,0 +1,22 @@
+import * as z from "zod";
+import type { EvidenceDatabase } from "../lib/storage/index.js";
+export declare const deleteFootprintsSchema: {
+    inputSchema: {
+        evidenceIds: z.ZodArray<z.ZodString, "many">;
+    };
+    outputSchema: {
+        deletedCount: z.ZodNumber;
+        success: z.ZodBoolean;
+    };
+};
+export declare const deleteFootprintsMetadata: {
+    title: string;
+    description: string;
+};
+export declare function createDeleteFootprintsHandler(db: EvidenceDatabase): (params: {
+    evidenceIds: string[];
+}) => Promise<import("../lib/tool-response.js").ToolResponse<{
+    deletedCount: number;
+    success: boolean;
+}>>;
+//# sourceMappingURL=delete-footprints.d.ts.map

package/dist/src/tools/delete-footprints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-footprints.d.ts","sourceRoot":"","sources":["../../../src/tools/delete-footprints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,sBAAsB;;;;;;;;CAWlC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;CAGpC,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,gBAAgB;iBAIhC,MAAM,EAAE;;;;IAezC"}

package/dist/src/tools/delete-footprints.js

@@ -0,0 +1,33 @@
+import * as z from "zod";
+import { wrapToolHandler } from "../lib/tool-wrapper.js";
+import { createToolResponse } from "../lib/tool-response.js";
+export const deleteFootprintsSchema = {
+    inputSchema: {
+        evidenceIds: z
+            .array(z.string())
+            .min(1)
+            .describe("Array of footprint IDs to delete"),
+    },
+    outputSchema: {
+        deletedCount: z.number(),
+        success: z.boolean(),
+    },
+};
+export const deleteFootprintsMetadata = {
+    title: "Delete Footprints",
+    description: "Permanently delete one or more footprint records",
+};
+export function createDeleteFootprintsHandler(db) {
+    return wrapToolHandler("delete-footprints", "Verify the footprint IDs exist.", async (params) => {
+        if (!params.evidenceIds || params.evidenceIds.length === 0) {
+            throw new Error("At least one evidence ID is required");
+        }
+        const deletedCount = db.deleteMany(params.evidenceIds);
+        const success = deletedCount > 0;
+        const resultText = success
+            ? `🗑️ Successfully deleted ${deletedCount} footprint record${deletedCount > 1 ? "s" : ""}`
+            : `⚠️ No footprint records found with the provided IDs`;
+        return createToolResponse(resultText, { deletedCount, success });
+    });
+}
+//# sourceMappingURL=delete-footprints.js.map

package/dist/src/tools/delete-footprints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-footprints.js","sourceRoot":"","sources":["../../../src/tools/delete-footprints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,WAAW,EAAE;QACX,WAAW,EAAE,CAAC;aACX,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,kCAAkC,CAAC;KAChD;IACD,YAAY,EAAE;QACZ,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;KACrB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EAAE,kDAAkD;CAChE,CAAC;AAEF,MAAM,UAAU,6BAA6B,CAAC,EAAoB;IAChE,OAAO,eAAe,CACpB,mBAAmB,EACnB,iCAAiC,EACjC,KAAK,EAAE,MAAiC,EAAE,EAAE;QAC1C,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,YAAY,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACvD,MAAM,OAAO,GAAG,YAAY,GAAG,CAAC,CAAC;QAEjC,MAAM,UAAU,GAAG,OAAO;YACxB,CAAC,CAAC,4BAA4B,YAAY,oBAAoB,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC3F,CAAC,CAAC,qDAAqD,CAAC;QAE1D,OAAO,kBAAkB,CAAC,UAAU,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC,CACF,CAAC;AACJ,CAAC"}