@pcircle/footprint 1.1.1 → 1.2.1

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

@@ -0,0 +1,60 @@
+import * as z from "zod";
+import type { EvidenceDatabase } from "../lib/storage/index.js";
+export declare const searchFootprintsSchema: {
+    inputSchema: {
+        query: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        dateFrom: z.ZodOptional<z.ZodString>;
+        dateTo: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+    };
+    outputSchema: {
+        evidences: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            timestamp: z.ZodString;
+            conversationId: z.ZodString;
+            llmProvider: z.ZodString;
+            messageCount: z.ZodNumber;
+            tags: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            timestamp: string;
+            messageCount: number;
+            conversationId: string;
+            llmProvider: string;
+            tags: string | null;
+        }, {
+            id: string;
+            timestamp: string;
+            messageCount: number;
+            conversationId: string;
+            llmProvider: string;
+            tags: string | null;
+        }>, "many">;
+        total: z.ZodNumber;
+    };
+};
+export declare const searchFootprintsMetadata: {
+    title: string;
+    description: string;
+};
+export declare function createSearchFootprintsHandler(db: EvidenceDatabase): (params: {
+    query?: string;
+    tags?: string[];
+    dateFrom?: string;
+    dateTo?: string;
+    limit?: number;
+    offset?: number;
+}) => Promise<import("../lib/tool-response.js").ToolResponse<{
+    evidences: {
+        id: string;
+        timestamp: string;
+        conversationId: string | null;
+        llmProvider: string | null;
+        messageCount: number;
+        tags: string | null;
+    }[];
+    total: number;
+}>>;
+//# sourceMappingURL=search-footprints.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-footprints.d.ts","sourceRoot":"","sources":["../../../src/tools/search-footprints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyBlC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;CAGpC,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,gBAAgB;YAKpD,MAAM;WACP,MAAM,EAAE;eACJ,MAAM;aACR,MAAM;YACP,MAAM;aACL,MAAM;;;;;;;;;;;IAsDpB"}

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

@@ -0,0 +1,78 @@
+import * as z from "zod";
+import { wrapToolHandler } from "../lib/tool-wrapper.js";
+import { formatSuccessResponse } from "../lib/tool-response.js";
+export const searchFootprintsSchema = {
+    inputSchema: {
+        query: z
+            .string()
+            .optional()
+            .describe("Search text (matches conversationId, tags)"),
+        tags: z.array(z.string()).optional().describe("Filter by tags"),
+        dateFrom: z.string().optional().describe("Start date (ISO format)"),
+        dateTo: z.string().optional().describe("End date (ISO format)"),
+        limit: z.number().int().positive().optional().describe("Maximum results"),
+        offset: z.number().int().min(0).optional().describe("Pagination offset"),
+    },
+    outputSchema: {
+        evidences: z.array(z.object({
+            id: z.string(),
+            timestamp: z.string(),
+            conversationId: z.string(),
+            llmProvider: z.string(),
+            messageCount: z.number(),
+            tags: z.string().nullable(),
+        })),
+        total: z.number(),
+    },
+};
+export const searchFootprintsMetadata = {
+    title: "Search Footprints",
+    description: "Search and filter footprints by query, tags, or date range",
+};
+export function createSearchFootprintsHandler(db) {
+    return wrapToolHandler("search-footprints", "Check date format (ISO 8601), limit > 0, and offset >= 0.", async (params) => {
+        // Validate parameters
+        if (params.limit !== undefined && params.limit <= 0) {
+            throw new Error("Limit must be positive");
+        }
+        if (params.offset !== undefined && params.offset < 0) {
+            throw new Error("Offset cannot be negative");
+        }
+        // Validate date format if provided
+        if (params.dateFrom) {
+            const date = new Date(params.dateFrom);
+            if (isNaN(date.getTime())) {
+                throw new Error("dateFrom must be a valid ISO date string");
+            }
+        }
+        if (params.dateTo) {
+            const date = new Date(params.dateTo);
+            if (isNaN(date.getTime())) {
+                throw new Error("dateTo must be a valid ISO date string");
+            }
+        }
+        const evidences = db.search({
+            query: params.query,
+            tags: params.tags,
+            dateFrom: params.dateFrom,
+            dateTo: params.dateTo,
+            limit: params.limit,
+            offset: params.offset,
+        });
+        const mappedEvidences = evidences.map((e) => ({
+            id: e.id,
+            timestamp: e.timestamp,
+            conversationId: e.conversationId,
+            llmProvider: e.llmProvider,
+            messageCount: e.messageCount,
+            tags: e.tags,
+        }));
+        return formatSuccessResponse("Search completed successfully", {
+            Results: `${evidences.length} footprint(s) found`,
+            Query: params.query || "None",
+            Tags: params.tags?.join(", ") || "None",
+            "Date Range": `${params.dateFrom || "Start"} to ${params.dateTo || "End"}`,
+        }, { evidences: mappedEvidences, total: evidences.length });
+    });
+}
+//# sourceMappingURL=search-footprints.js.map

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

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

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

@@ -0,0 +1,21 @@
+import * as z from "zod";
+export declare const suggestCaptureSchema: {
+    inputSchema: {
+        summary: z.ZodString;
+    };
+    outputSchema: {
+        shouldCapture: z.ZodBoolean;
+        reason: z.ZodString;
+        suggestedTags: z.ZodArray<z.ZodString, "many">;
+        suggestedConversationId: z.ZodString;
+        confidence: z.ZodNumber;
+    };
+};
+export declare const suggestCaptureMetadata: {
+    title: string;
+    description: string;
+};
+export declare function createSuggestCaptureHandler(): (params: {
+    summary: string;
+}) => Promise<import("../lib/tool-response.js").ToolResponse<import("../analyzers/content-analyzer.js").AnalysisResult>>;
+//# sourceMappingURL=suggest-capture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-capture.d.ts","sourceRoot":"","sources":["../../../src/tools/suggest-capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAKzB,eAAO,MAAM,oBAAoB;;;;;;;;;;;CAahC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;CAIlC,CAAC;AAEF,wBAAgB,2BAA2B;aAIb,MAAM;yHAgBnC"}

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

@@ -0,0 +1,37 @@
+import * as z from "zod";
+import { wrapToolHandler } from "../lib/tool-wrapper.js";
+import { createToolResponse } from "../lib/tool-response.js";
+import { analyzeContent } from "../analyzers/content-analyzer.js";
+export const suggestCaptureSchema = {
+    inputSchema: {
+        summary: z
+            .string()
+            .describe("Conversation summary or key content to analyze"),
+    },
+    outputSchema: {
+        shouldCapture: z.boolean(),
+        reason: z.string(),
+        suggestedTags: z.array(z.string()),
+        suggestedConversationId: z.string(),
+        confidence: z.number(),
+    },
+};
+export const suggestCaptureMetadata = {
+    title: "Suggest Capture",
+    description: "Analyze conversation content and suggest whether to capture it as evidence",
+};
+export function createSuggestCaptureHandler() {
+    return wrapToolHandler("suggest-capture", "Ensure summary is not empty.", async (params) => {
+        if (!params.summary || params.summary.trim().length === 0) {
+            throw new Error("Summary cannot be empty");
+        }
+        // Analyze content using content analyzer
+        const analysis = analyzeContent(params.summary);
+        // Format result text
+        const resultText = analysis.shouldCapture
+            ? `💡 Capture suggested (${Math.round(analysis.confidence * 100)}% confidence)\n🔍 Reason: ${analysis.reason}\n🏷️  Tags: ${analysis.suggestedTags.join(", ")}\n📝 ID: ${analysis.suggestedConversationId}`
+            : `🤷 Capture not recommended (${Math.round(analysis.confidence * 100)}% confidence)\n💬 ${analysis.reason}`;
+        return createToolResponse(resultText, analysis);
+    });
+}
+//# sourceMappingURL=suggest-capture.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-capture.js","sourceRoot":"","sources":["../../../src/tools/suggest-capture.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;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAElE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,WAAW,EAAE;QACX,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,CAAC,gDAAgD,CAAC;KAC9D;IACD,YAAY,EAAE;QACZ,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;QAC1B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAClC,uBAAuB,EAAE,CAAC,CAAC,MAAM,EAAE;QACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;KACvB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,4EAA4E;CAC/E,CAAC;AAEF,MAAM,UAAU,2BAA2B;IACzC,OAAO,eAAe,CACpB,iBAAiB,EACjB,8BAA8B,EAC9B,KAAK,EAAE,MAA2B,EAAE,EAAE;QACpC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,yCAAyC;QACzC,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEhD,qBAAqB;QACrB,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa;YACvC,CAAC,CAAC,yBAAyB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC,6BAA6B,QAAQ,CAAC,MAAM,gBAAgB,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,QAAQ,CAAC,uBAAuB,EAAE;YAC3M,CAAC,CAAC,+BAA+B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC,qBAAqB,QAAQ,CAAC,MAAM,EAAE,CAAC;QAE/G,OAAO,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,104 @@
+import * as z from "zod";
+import type { EvidenceDatabase } from "../lib/storage/index.js";
+export declare const verifyFootprintSchema: {
+    inputSchema: {
+        id: z.ZodString;
+    };
+    outputSchema: {
+        id: z.ZodString;
+        verified: z.ZodBoolean;
+        checks: z.ZodObject<{
+            contentIntegrity: z.ZodObject<{
+                passed: z.ZodBoolean;
+                hash: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                passed: boolean;
+                hash: string;
+            }, {
+                passed: boolean;
+                hash: string;
+            }>;
+            gitTimestamp: z.ZodObject<{
+                passed: z.ZodBoolean;
+                commitHash: z.ZodNullable<z.ZodString>;
+                timestamp: z.ZodNullable<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                timestamp: string | null;
+                commitHash: string | null;
+                passed: boolean;
+            }, {
+                timestamp: string | null;
+                commitHash: string | null;
+                passed: boolean;
+            }>;
+            encryptionStatus: z.ZodObject<{
+                passed: z.ZodBoolean;
+                algorithm: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                passed: boolean;
+                algorithm: string;
+            }, {
+                passed: boolean;
+                algorithm: string;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            gitTimestamp: {
+                timestamp: string | null;
+                commitHash: string | null;
+                passed: boolean;
+            };
+            contentIntegrity: {
+                passed: boolean;
+                hash: string;
+            };
+            encryptionStatus: {
+                passed: boolean;
+                algorithm: string;
+            };
+        }, {
+            gitTimestamp: {
+                timestamp: string | null;
+                commitHash: string | null;
+                passed: boolean;
+            };
+            contentIntegrity: {
+                passed: boolean;
+                hash: string;
+            };
+            encryptionStatus: {
+                passed: boolean;
+                algorithm: string;
+            };
+        }>;
+        legalReadiness: z.ZodBoolean;
+        verifiedAt: z.ZodString;
+    };
+};
+export declare const verifyFootprintMetadata: {
+    title: string;
+    description: string;
+};
+export declare function createVerifyFootprintHandler(db: EvidenceDatabase, getDerivedKey: () => Promise<Uint8Array>): (params: {
+    id: string;
+}) => Promise<import("../lib/tool-response.js").ToolResponse<{
+    id: string;
+    verified: boolean;
+    checks: {
+        contentIntegrity: {
+            passed: boolean;
+            hash: string;
+        };
+        gitTimestamp: {
+            passed: boolean;
+            commitHash: string | null;
+            timestamp: string | null;
+        };
+        encryptionStatus: {
+            passed: boolean;
+            algorithm: string;
+        };
+    };
+    legalReadiness: boolean;
+    verifiedAt: string;
+}>>;
+//# sourceMappingURL=verify-footprint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify-footprint.d.ts","sourceRoot":"","sources":["../../../src/tools/verify-footprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAKzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyBjC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;CAGnC,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,gBAAgB,EACpB,aAAa,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC;QAKjB,MAAM;;;;;;;;;;;wBAcD,MAAM,GAAG,IAAI;uBACd,MAAM,GAAG,IAAI;;;;;;;;;IAkEzC"}

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

@@ -0,0 +1,102 @@
+import * as z from "zod";
+import * as crypto from "crypto";
+import { wrapToolHandler } from "../lib/tool-wrapper.js";
+import { createToolResponse } from "../lib/tool-response.js";
+import { decrypt } from "../lib/crypto/index.js";
+export const verifyFootprintSchema = {
+    inputSchema: {
+        id: z.string().describe("Footprint ID to verify"),
+    },
+    outputSchema: {
+        id: z.string(),
+        verified: z.boolean(),
+        checks: z.object({
+            contentIntegrity: z.object({
+                passed: z.boolean(),
+                hash: z.string(),
+            }),
+            gitTimestamp: z.object({
+                passed: z.boolean(),
+                commitHash: z.string().nullable(),
+                timestamp: z.string().nullable(),
+            }),
+            encryptionStatus: z.object({
+                passed: z.boolean(),
+                algorithm: z.string(),
+            }),
+        }),
+        legalReadiness: z.boolean(),
+        verifiedAt: z.string(),
+    },
+};
+export const verifyFootprintMetadata = {
+    title: "Verify Footprint",
+    description: "Verify the integrity and authenticity of captured footprint",
+};
+export function createVerifyFootprintHandler(db, getDerivedKey) {
+    return wrapToolHandler("verify-footprint", "Verify the evidence ID exists and encryption password is correct.", async (params) => {
+        // Find the footprint record
+        const evidence = db.findById(params.id);
+        if (!evidence) {
+            throw new Error(`Evidence with ID ${params.id} not found`);
+        }
+        const key = await getDerivedKey();
+        // Perform verifications
+        const checks = {
+            contentIntegrity: { passed: false, hash: "" },
+            gitTimestamp: {
+                passed: false,
+                commitHash: null,
+                timestamp: null,
+            },
+            encryptionStatus: {
+                passed: false,
+                algorithm: "XChaCha20-Poly1305",
+            },
+        };
+        // Single decryption for both content integrity and encryption status checks
+        // This fixes the redundant decryption issue identified in Simplifier Round 1
+        try {
+            const decryptedContent = decrypt(evidence.encryptedContent, evidence.nonce, key);
+            const computedHash = crypto
+                .createHash("sha256")
+                .update(decryptedContent)
+                .digest("hex");
+            // Content integrity check
+            checks.contentIntegrity.passed = computedHash === evidence.contentHash;
+            checks.contentIntegrity.hash = computedHash;
+            // Encryption status check (decryption succeeded)
+            checks.encryptionStatus.passed = true;
+        }
+        catch (error) {
+            // Both checks fail if decryption fails
+            checks.contentIntegrity.passed = false;
+            checks.contentIntegrity.hash = "";
+            checks.encryptionStatus.passed = false;
+        }
+        // Git Timestamp: Check if gitCommitHash exists and gitTimestamp is valid
+        checks.gitTimestamp.commitHash = evidence.gitCommitHash;
+        checks.gitTimestamp.timestamp = evidence.gitTimestamp;
+        checks.gitTimestamp.passed = !!(evidence.gitCommitHash && evidence.gitTimestamp);
+        const verified = checks.contentIntegrity.passed &&
+            checks.gitTimestamp.passed &&
+            checks.encryptionStatus.passed;
+        const legalReadiness = verified;
+        const statusSymbols = {
+            content: checks.contentIntegrity.passed ? "✓" : "✗",
+            git: checks.gitTimestamp.passed ? "✓" : "✗",
+            encryption: checks.encryptionStatus.passed ? "✓" : "✗",
+        };
+        const statusText = verified
+            ? `✅ Evidence ${params.id} verified successfully\n- Content: ${statusSymbols.content} Integrity preserved\n- Git: ${statusSymbols.git} Timestamp verified\n- Encryption: ${statusSymbols.encryption} XChaCha20-Poly1305`
+            : `❌ Evidence ${params.id} verification failed\n- Content: ${statusSymbols.content} Integrity check\n- Git: ${statusSymbols.git} Timestamp check\n- Encryption: ${statusSymbols.encryption} Decryption check`;
+        return createToolResponse(statusText, {
+            id: params.id,
+            verified,
+            checks,
+            legalReadiness,
+            verifiedAt: new Date().toISOString(),
+        });
+    });
+}
+//# sourceMappingURL=verify-footprint.js.map

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

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

package/dist/{types.d.ts → src/types.d.ts}

@@ -1,5 +1,5 @@
 /**
- * Configuration for EvidenceMCP Server
+ * Configuration for Footprint Server
  */
 export interface ServerConfig {
     /** Path to encrypted evidence database */

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IAEf,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IAEjB,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,cAAc,EAAE,MAAM,CAAC;IAEvB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IAEpB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAEhB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IAErB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/{lib/storage → src}/types.js.map

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

package/dist/src/ui/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/ui/register.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqEzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS;;;;EA2CpD"}

package/dist/src/ui/register.js

@@ -0,0 +1,94 @@
+import { registerAppResource, RESOURCE_MIME_TYPE } from "@modelcontextprotocol/ext-apps/server";
+import fs from "node:fs/promises";
+import path from "node:path";
+const DIST_DIR = path.join(import.meta.dirname, "../../dist/ui");
+/**
+ * Create a resource handler for a UI file
+ */
+function createUIResourceHandler(config) {
+    return async () => {
+        try {
+            const htmlPath = path.join(DIST_DIR, config.filename);
+            const html = await fs.readFile(htmlPath, "utf-8");
+            return {
+                contents: [{
+                        uri: config.uri,
+                        mimeType: RESOURCE_MIME_TYPE,
+                        text: html,
+                    }],
+            };
+        }
+        catch (error) {
+            console.error(`Failed to load ${config.filename}:`, error);
+            return {
+                contents: [{
+                        uri: config.uri,
+                        mimeType: RESOURCE_MIME_TYPE,
+                        text: createFallbackHTML(config),
+                    }],
+            };
+        }
+    };
+}
+/**
+ * Generate fallback HTML for when UI files are not built
+ */
+function createFallbackHTML(config) {
+    return `
+    <!DOCTYPE html>
+    <html lang="en">
+    <head>
+      <meta charset="UTF-8">
+      <meta name="viewport" content="width=device-width, initial-scale=1.0">
+      <title>${config.title}</title>
+      <style>
+        body { font-family: system-ui; padding: 2rem; text-align: center; }
+        .error { color: #ef4444; background: #fef2f2; padding: 1rem; border-radius: 8px; }
+      </style>
+    </head>
+    <body>
+      <h1>${config.emoji} ${config.description}</h1>
+      <div class="error">
+        <p>${config.description} not available. Please build the UI first:</p>
+        <code>pnpm build:ui</code>
+      </div>
+    </body>
+    </html>
+  `;
+}
+export function registerUIResources(server) {
+    const resources = [
+        {
+            uri: "ui://footprint/dashboard.html",
+            filename: "dashboard.html",
+            title: "Footprint Dashboard",
+            emoji: "🔐",
+            description: "Dashboard"
+        },
+        {
+            uri: "ui://footprint/detail.html",
+            filename: "detail.html",
+            title: "Evidence Detail - Footprint",
+            emoji: "🔍",
+            description: "Detail view"
+        },
+        {
+            uri: "ui://footprint/export.html",
+            filename: "export.html",
+            title: "Export Evidence - Footprint",
+            emoji: "📦",
+            description: "Export view"
+        }
+    ];
+    // Register all UI resources using data-driven approach
+    resources.forEach(config => {
+        registerAppResource(server, config.uri, config.uri, { mimeType: RESOURCE_MIME_TYPE }, createUIResourceHandler(config));
+    });
+    console.log("✅ Registered UI resources:", resources.map(r => r.uri).join(", "));
+    return {
+        dashboardUri: resources[0].uri,
+        detailUri: resources[1].uri,
+        exportUri: resources[2].uri,
+    };
+}
+//# sourceMappingURL=register.js.map

package/dist/src/ui/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/ui/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChG,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;AAUjE;;GAEG;AACH,SAAS,uBAAuB,CAAC,MAAwB;IACvD,OAAO,KAAK,IAAI,EAAE;QAChB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAElD,OAAO;gBACL,QAAQ,EAAE,CAAC;wBACT,GAAG,EAAE,MAAM,CAAC,GAAG;wBACf,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI;qBACX,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;YAE3D,OAAO;gBACL,QAAQ,EAAE,CAAC;wBACT,GAAG,EAAE,MAAM,CAAC,GAAG;wBACf,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC;qBACjC,CAAC;aACH,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,MAAwB;IAClD,OAAO;;;;;;eAMM,MAAM,CAAC,KAAK;;;;;;;YAOf,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,WAAW;;aAEjC,MAAM,CAAC,WAAW;;;;;GAK5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,SAAS,GAAuB;QACpC;YACE,GAAG,EAAE,+BAA+B;YACpC,QAAQ,EAAE,gBAAgB;YAC1B,KAAK,EAAE,qBAAqB;YAC5B,KAAK,EAAE,IAAI;YACX,WAAW,EAAE,WAAW;SACzB;QACD;YACE,GAAG,EAAE,4BAA4B;YACjC,QAAQ,EAAE,aAAa;YACvB,KAAK,EAAE,6BAA6B;YACpC,KAAK,EAAE,IAAI;YACX,WAAW,EAAE,aAAa;SAC3B;QACD;YACE,GAAG,EAAE,4BAA4B;YACjC,QAAQ,EAAE,aAAa;YACvB,KAAK,EAAE,6BAA6B;YACpC,KAAK,EAAE,IAAI;YACX,WAAW,EAAE,aAAa;SAC3B;KACF,CAAC;IAEF,uDAAuD;IACvD,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;QACzB,mBAAmB,CACjB,MAAM,EACN,MAAM,CAAC,GAAG,EACV,MAAM,CAAC,GAAG,EACV,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EAChC,uBAAuB,CAAC,MAAM,CAAC,CAChC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhF,OAAO;QACL,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG;QAC9B,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG;QAC3B,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG;KAC5B,CAAC;AACJ,CAAC"}

package/dist/tests/error-handling.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=error-handling.test.d.ts.map

package/dist/tests/error-handling.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handling.test.d.ts","sourceRoot":"","sources":["../../tests/error-handling.test.ts"],"names":[],"mappings":""}