@pcircle/footprint 1.3.0 → 1.5.0

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;CA+BlC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;CAIpC,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,gBAAgB;iBAIhC,MAAM,EAAE;oBAAkB,OAAO;;;;;;;;;;;;;IA2DlE"}

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

@@ -6,28 +6,76 @@ export const deleteFootprintsSchema = {
         evidenceIds: z
             .array(z.string())
             .min(1)
-            .describe("Array of footprint IDs to delete"),
+            .max(100, "Maximum 100 IDs per delete operation")
+            .describe("Array of footprint IDs to delete. Always verify IDs first with search-footprints or list-footprints."),
+        confirmDelete: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Set to true to confirm deletion. Without this, returns a preview of records to be deleted without actually deleting them. Two-step pattern: first call without confirmDelete to preview, then call with confirmDelete: true to execute."),
     },
     outputSchema: {
         deletedCount: z.number(),
+        previewed: z
+            .array(z.object({
+            id: z.string(),
+            conversationId: z.string(),
+            timestamp: z.string(),
+        }))
+            .optional(),
+        notFoundIds: z.array(z.string()).optional(),
         success: z.boolean(),
     },
 };
 export const deleteFootprintsMetadata = {
     title: "Delete Footprints",
-    description: "Permanently delete one or more footprint records",
+    description: "Permanently delete one or more footprint records. WARNING: Irreversible operation. Uses two-step confirmation: first call previews records, second call with confirmDelete: true performs deletion.",
 };
 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);
+        if (params.evidenceIds.length > 100) {
+            throw new Error(`Too many IDs (${params.evidenceIds.length}). Maximum 100 per delete operation.`);
+        }
+        // Preview mode: show what would be deleted without actually deleting
+        if (!params.confirmDelete) {
+            const previewed = params.evidenceIds
+                .map((id) => db.findById(id))
+                .filter((e) => e !== null)
+                .map((e) => ({
+                id: e.id,
+                conversationId: e.conversationId,
+                timestamp: e.timestamp,
+            }));
+            const resultText = previewed.length > 0
+                ? `⚠️ Preview: ${previewed.length} record(s) would be deleted:\n${previewed.map((p) => `  - ${p.id} (${p.conversationId})`).join("\n")}\n\nTo confirm, call again with confirmDelete: true`
+                : `⚠️ No records found with the provided IDs`;
+            return createToolResponse(resultText, {
+                deletedCount: 0,
+                previewed,
+                success: false,
+            });
+        }
+        // Check which IDs exist before deletion (Set for O(1) lookup)
+        const existingIds = params.evidenceIds.filter((id) => db.findById(id));
+        const existingSet = new Set(existingIds);
+        const notFoundIds = params.evidenceIds.filter((id) => !existingSet.has(id));
+        // Actual deletion
+        const deletedCount = db.deleteMany(existingIds);
         const success = deletedCount > 0;
-        const resultText = success
+        let resultText = success
             ? `🗑️ Successfully deleted ${deletedCount} footprint record${deletedCount > 1 ? "s" : ""}`
             : `⚠️ No footprint records found with the provided IDs`;
-        return createToolResponse(resultText, { deletedCount, success });
+        if (notFoundIds.length > 0) {
+            resultText += `\n⚠️ IDs not found: ${notFoundIds.join(", ")}`;
+        }
+        return createToolResponse(resultText, {
+            deletedCount,
+            notFoundIds,
+            success,
+        });
     });
 }
 //# sourceMappingURL=delete-footprints.js.map

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

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

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

@@ -2,11 +2,17 @@ import * as z from "zod";
 import type { EvidenceDatabase } from "../lib/storage/index.js";
 export declare const exportFootprintsSchema: {
     inputSchema: {
-        evidenceIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        evidenceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
         includeGitInfo: z.ZodOptional<z.ZodBoolean>;
+        outputMode: z.ZodDefault<z.ZodEnum<{
+            base64: "base64";
+            file: "file";
+            both: "both";
+        }>>;
     };
     outputSchema: {
-        filename: z.ZodString;
+        filename: z.ZodOptional<z.ZodString>;
+        base64Data: z.ZodOptional<z.ZodString>;
         checksum: z.ZodString;
         evidenceCount: z.ZodNumber;
         success: z.ZodBoolean;
@@ -24,10 +30,12 @@ export declare const exportFootprintsMetadata: {
 export declare function createExportFootprintsHandler(db: EvidenceDatabase): (params: {
     evidenceIds?: string[];
     includeGitInfo?: boolean;
+    outputMode?: "file" | "base64" | "both";
 }) => Promise<import("../lib/tool-response.js").ToolResponse<{
-    filename: string;
     checksum: string;
     evidenceCount: number;
     success: boolean;
+    base64Data?: string | undefined;
+    filename?: string | undefined;
 }>>;
 //# sourceMappingURL=export-footprints.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"export-footprints.d.ts","sourceRoot":"","sources":["../../../src/tools/export-footprints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,sBAAsB;;;;;;;;;;;CAclC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;CAQpC,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,gBAAgB;kBAI/B,MAAM,EAAE;qBAAmB,OAAO;;;;;;IA4BpE"}
+{"version":3,"file":"export-footprints.d.ts","sourceRoot":"","sources":["../../../src/tools/export-footprints.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;CA0BlC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;CASpC,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,gBAAgB;kBAK9C,MAAM,EAAE;qBACL,OAAO;iBACX,MAAM,GAAG,QAAQ,GAAG,MAAM;;;;;;;IAmE5C"}

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

@@ -1,3 +1,4 @@
+/* global Buffer, process */
 import * as z from "zod";
 import { wrapToolHandler } from "../lib/tool-wrapper.js";
 import { formatSuccessResponse } from "../lib/tool-response.js";
@@ -6,11 +7,19 @@ export const exportFootprintsSchema = {
         evidenceIds: z
             .array(z.string())
             .optional()
-            .describe("Specific IDs (empty = all)"),
-        includeGitInfo: z.boolean().optional().describe("Include Git timestamps"),
+            .describe("Specific evidence IDs to export. If omitted, exports all evidence."),
+        includeGitInfo: z
+            .boolean()
+            .optional()
+            .describe("Include Git commit hash and timestamp in export metadata"),
+        outputMode: z
+            .enum(["file", "base64", "both"])
+            .default("both")
+            .describe("Output mode: 'file' writes ZIP to disk, 'base64' returns ZIP as base64 string (for Claude Desktop/MCP clients), 'both' does both (default, backward compatible)."),
     },
     outputSchema: {
-        filename: z.string(),
+        filename: z.string().optional(),
+        base64Data: z.string().optional(),
         checksum: z.string(),
         evidenceCount: z.number(),
         success: z.boolean(),
@@ -18,7 +27,7 @@ export const exportFootprintsSchema = {
 };
 export const exportFootprintsMetadata = {
     title: "Export Footprints",
-    description: "Export footprints to encrypted ZIP archive",
+    description: "Export footprints to encrypted ZIP archive. Supports file output (write to disk), base64 output (for MCP clients like Claude Desktop), or both. Default is 'both' for backward compatibility.",
     _meta: {
         ui: {
             resourceUri: "ui://footprint/export.html",
@@ -29,18 +38,48 @@ export function createExportFootprintsHandler(db) {
     return wrapToolHandler("export-footprints", "Check evidenceIds exist and filesystem has write permissions.", async (params) => {
         const { exportEvidences } = await import("../lib/storage/index.js");
         const fs = await import("fs");
+        const outputMode = params.outputMode || "both";
         const result = await exportEvidences(db, {
             evidenceIds: params.evidenceIds,
             includeGitInfo: params.includeGitInfo ?? false,
         });
-        fs.writeFileSync(result.filename, result.zipData);
-        return formatSuccessResponse("Export completed successfully", {
+        // Enforce size limit for base64 mode (base64 adds ~33% overhead)
+        const MAX_BASE64_SIZE = 75 * 1024 * 1024; // 75MB
+        if ((outputMode === "base64" || outputMode === "both") &&
+            result.zipData.length > MAX_BASE64_SIZE) {
+            throw new Error(`Export too large for base64 mode (${(result.zipData.length / (1024 * 1024)).toFixed(1)}MB). ` +
+                `Use outputMode="file" or export fewer records.`);
+        }
+        let filename;
+        let base64Data;
+        // Write to disk if file or both mode
+        if (outputMode === "file" || outputMode === "both") {
+            const os = await import("os");
+            const path = await import("path");
+            const outputDir = process.env.FOOTPRINT_DATA_DIR ||
+                process.env.FOOTPRINT_EXPORT_DIR ||
+                os.tmpdir();
+            const outputPath = path.join(outputDir, result.filename);
+            fs.writeFileSync(outputPath, result.zipData);
+            filename = outputPath;
+        }
+        // Generate base64 if base64 or both mode
+        if (outputMode === "base64" || outputMode === "both") {
+            base64Data = Buffer.from(result.zipData).toString("base64");
+        }
+        const details = {
             "Footprint Count": result.evidenceCount,
-            Filename: result.filename,
             Checksum: result.checksum,
             "Git Info": params.includeGitInfo ? "Included" : "Excluded",
-        }, {
-            filename: result.filename,
+            "Output Mode": outputMode,
+        };
+        if (filename)
+            details.Filename = filename;
+        if (base64Data)
+            details["Base64 Size"] = `${Math.round(base64Data.length / 1024)}KB`;
+        return formatSuccessResponse("Export completed successfully", details, {
+            ...(filename && { filename }),
+            ...(base64Data && { base64Data }),
             checksum: result.checksum,
             evidenceCount: result.evidenceCount,
             success: true,

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

@@ -1 +1 @@
-{"version":3,"file":"export-footprints.js","sourceRoot":"","sources":["../../../src/tools/export-footprints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,WAAW,EAAE;QACX,WAAW,EAAE,CAAC;aACX,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,EAAE;aACV,QAAQ,CAAC,4BAA4B,CAAC;QACzC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;KAC1E;IACD,YAAY,EAAE;QACZ,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;QACzB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;KACrB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EAAE,4CAA4C;IACzD,KAAK,EAAE;QACL,EAAE,EAAE;YACF,WAAW,EAAE,4BAA4B;SAC1C;KACF;CACF,CAAC;AAEF,MAAM,UAAU,6BAA6B,CAAC,EAAoB;IAChE,OAAO,eAAe,CACpB,mBAAmB,EACnB,+DAA+D,EAC/D,KAAK,EAAE,MAA4D,EAAE,EAAE;QACrE,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;QACpE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE;YACvC,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,KAAK;SAC/C,CAAC,CAAC;QAEH,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAElD,OAAO,qBAAqB,CAC1B,+BAA+B,EAC/B;YACE,iBAAiB,EAAE,MAAM,CAAC,aAAa;YACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU;SAC5D,EACD;YACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,OAAO,EAAE,IAAI;SACd,CACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"export-footprints.js","sourceRoot":"","sources":["../../../src/tools/export-footprints.ts"],"names":[],"mappings":"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"}

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

@@ -14,13 +14,7 @@ export declare const getFootprintSchema: {
         gitInfo: z.ZodNullable<z.ZodObject<{
             commitHash: z.ZodString;
             timestamp: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            timestamp: string;
-            commitHash: string;
-        }, {
-            timestamp: string;
-            commitHash: string;
-        }>>;
+        }, z.core.$strip>>;
         tags: z.ZodNullable<z.ZodString>;
     };
 };

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

@@ -1 +1 @@
-{"version":3,"file":"get-footprint.d.ts","sourceRoot":"","sources":["../../../src/tools/get-footprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;CAmB9B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;CAQhC,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,gBAAgB,EACpB,aAAa,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC;QAKjB,MAAM;;;;;;;;;;;;;IAuC9B"}
+{"version":3,"file":"get-footprint.d.ts","sourceRoot":"","sources":["../../../src/tools/get-footprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;CAuB9B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;CAShC,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,gBAAgB,EACpB,aAAa,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC;QAKjB,MAAM;;;;;;;;;;;;;IA0C9B"}

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

@@ -4,7 +4,9 @@ import { formatSuccessResponse } from "../lib/tool-response.js";
 import { decrypt } from "../lib/crypto/index.js";
 export const getFootprintSchema = {
     inputSchema: {
-        id: z.string().describe("Footprint ID"),
+        id: z
+            .string()
+            .describe("UUID of the footprint to retrieve. Use list-footprints or search-footprints to find IDs."),
     },
     outputSchema: {
         id: z.string(),
@@ -24,7 +26,7 @@ export const getFootprintSchema = {
 };
 export const getFootprintMetadata = {
     title: "Get Footprint",
-    description: "Retrieve and decrypt specific footprint by ID",
+    description: "Retrieve and decrypt a specific footprint by ID. Returns full conversation content (decrypted), metadata, and Git timestamp info. Requires the correct encryption password (set via FOOTPRINT_PASSPHRASE env var).",
     _meta: {
         ui: {
             resourceUri: "ui://footprint/detail.html",
@@ -50,7 +52,9 @@ export function createGetFootprintHandler(db, getDerivedKey) {
             Timestamp: evidence.timestamp,
             Provider: evidence.llmProvider,
             "Message Count": evidence.messageCount,
-            "Content Preview": `${decrypted.substring(0, 100)}...`,
+            "Content Preview": decrypted.length > 100
+                ? `${decrypted.substring(0, 100)}...`
+                : decrypted,
         }, {
             id: evidence.id,
             timestamp: evidence.timestamp,

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

@@ -1 +1 @@
-{"version":3,"file":"get-footprint.js","sourceRoot":"","sources":["../../../src/tools/get-footprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGjD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,WAAW,EAAE;QACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;KACxC;IACD,YAAY,EAAE;QACZ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,CAAC;aACP,MAAM,CAAC;YACN,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;YACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;SACtB,CAAC;aACD,QAAQ,EAAE;QACb,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC5B;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,KAAK,EAAE,eAAe;IACtB,WAAW,EAAE,+CAA+C;IAC5D,KAAK,EAAE;QACL,EAAE,EAAE;YACF,WAAW,EAAE,4BAA4B;SAC1C;KACF;CACF,CAAC;AAEF,MAAM,UAAU,yBAAyB,CACvC,EAAoB,EACpB,aAAwC;IAExC,OAAO,eAAe,CACpB,eAAe,EACf,wDAAwD,EACxD,KAAK,EAAE,MAAsB,EAAE,EAAE;QAC/B,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,aAAa,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAE1E,MAAM,OAAO,GACX,QAAQ,CAAC,aAAa,IAAI,QAAQ,CAAC,YAAY;YAC7C,CAAC,CAAC;gBACE,UAAU,EAAE,QAAQ,CAAC,aAAa;gBAClC,SAAS,EAAE,QAAQ,CAAC,YAAY;aACjC;YACH,CAAC,CAAC,IAAI,CAAC;QAEX,OAAO,qBAAqB,CAC1B,iCAAiC,EACjC;YACE,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,QAAQ,EAAE,QAAQ,CAAC,WAAW;YAC9B,eAAe,EAAE,QAAQ,CAAC,YAAY;YACtC,iBAAiB,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK;SACvD,EACD;YACE,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,cAAc,EAAE,QAAQ,CAAC,cAAc;YACvC,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,OAAO,EAAE,SAAS;YAClB,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,OAAO;YACP,IAAI,EAAE,QAAQ,CAAC,IAAI;SACpB,CACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get-footprint.js","sourceRoot":"","sources":["../../../src/tools/get-footprint.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/index.d.ts

@@ -10,7 +10,5 @@ export { searchFootprintsSchema, searchFootprintsMetadata, createSearchFootprint
 export { verifyFootprintSchema, verifyFootprintMetadata, createVerifyFootprintHandler, } from "./verify-footprint.js";
 export { suggestCaptureSchema, suggestCaptureMetadata, createSuggestCaptureHandler, } from "./suggest-capture.js";
 export { deleteFootprintsSchema, deleteFootprintsMetadata, createDeleteFootprintsHandler, } from "./delete-footprints.js";
-export { renameTagSchema, renameTagMetadata, createRenameTagHandler, } from "./rename-tag.js";
-export { removeTagSchema, removeTagMetadata, createRemoveTagHandler, } from "./remove-tag.js";
-export { getTagStatsSchema, getTagStatsMetadata, createGetTagStatsHandler, } from "./get-tag-stats.js";
+export { manageTagsSchema, manageTagsMetadata, createManageTagsHandler, } from "./manage-tags.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC"}

package/dist/src/tools/index.js

@@ -10,7 +10,5 @@ export { searchFootprintsSchema, searchFootprintsMetadata, createSearchFootprint
 export { verifyFootprintSchema, verifyFootprintMetadata, createVerifyFootprintHandler, } from "./verify-footprint.js";
 export { suggestCaptureSchema, suggestCaptureMetadata, createSuggestCaptureHandler, } from "./suggest-capture.js";
 export { deleteFootprintsSchema, deleteFootprintsMetadata, createDeleteFootprintsHandler, } from "./delete-footprints.js";
-export { renameTagSchema, renameTagMetadata, createRenameTagHandler, } from "./rename-tag.js";
-export { removeTagSchema, removeTagMetadata, createRemoveTagHandler, } from "./remove-tag.js";
-export { getTagStatsSchema, getTagStatsMetadata, createGetTagStatsHandler, } from "./get-tag-stats.js";
+export { manageTagsSchema, manageTagsMetadata, createManageTagsHandler, } from "./manage-tags.js";
 //# sourceMappingURL=index.js.map

package/dist/src/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC"}

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

@@ -13,21 +13,7 @@ export declare const listFootprintsSchema: {
             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">;
+        }, z.core.$strip>>;
         total: z.ZodNumber;
     };
 };

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

@@ -1 +1 @@
-{"version":3,"file":"list-footprints.d.ts","sourceRoot":"","sources":["../../../src/tools/list-footprints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBhC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;CAQlC,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,gBAAgB;YAInC,MAAM;aAAW,MAAM;;;;;;;;;;;IAgCnD"}
+{"version":3,"file":"list-footprints.d.ts","sourceRoot":"","sources":["../../../src/tools/list-footprints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;CA4BhC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;CASlC,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,gBAAgB;YAInC,MAAM;aAAW,MAAM;;;;;;;;;;;IAkCnD"}

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

@@ -3,8 +3,18 @@ import { wrapToolHandler } from "../lib/tool-wrapper.js";
 import { formatSuccessResponse } from "../lib/tool-response.js";
 export const listFootprintsSchema = {
     inputSchema: {
-        limit: z.number().int().positive().optional().describe("Maximum results"),
-        offset: z.number().int().min(0).optional().describe("Pagination offset"),
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Maximum number of results to return per page"),
+        offset: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe("Number of results to skip for pagination (0-based)"),
     },
     outputSchema: {
         evidences: z.array(z.object({
@@ -20,7 +30,7 @@ export const listFootprintsSchema = {
 };
 export const listFootprintsMetadata = {
     title: "List Footprints",
-    description: "List all captured footprint with pagination",
+    description: "List all captured footprints with pagination. Returns metadata only (IDs, timestamps, tags, message counts) — use get-footprint to retrieve full decrypted content. Use search-footprints for filtered queries.",
     _meta: {
         ui: {
             resourceUri: "ui://footprint/dashboard.html",
@@ -47,11 +57,12 @@ export function createListFootprintsHandler(db) {
             messageCount: e.messageCount,
             tags: e.tags,
         }));
+        const total = db.getTotalCount();
         return formatSuccessResponse("Footprint list retrieved successfully", {
             Count: `${evidences.length} footprint(s)`,
-            Limit: params.limit || "No limit",
-            Offset: params.offset || 0,
-        }, { evidences: mappedEvidences, total: evidences.length });
+            Limit: params.limit ?? "No limit",
+            Offset: params.offset ?? 0,
+        }, { evidences: mappedEvidences, total });
     });
 }
 //# sourceMappingURL=list-footprints.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"list-footprints.js","sourceRoot":"","sources":["../../../src/tools/list-footprints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,WAAW,EAAE;QACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QACzE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;KACzE;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,CAAC,CAAC,KAAK,CAChB,CAAC,CAAC,MAAM,CAAC;YACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;YACd,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;YAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;YACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;YACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC5B,CAAC,CACH;QACD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;KAClB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,iBAAiB;IACxB,WAAW,EAAE,6CAA6C;IAC1D,KAAK,EAAE;QACL,EAAE,EAAE;YACF,WAAW,EAAE,+BAA+B;SAC7C;KACF;CACF,CAAC;AAEF,MAAM,UAAU,2BAA2B,CAAC,EAAoB;IAC9D,OAAO,eAAe,CACpB,iBAAiB,EACjB,sDAAsD,EACtD,KAAK,EAAE,MAA2C,EAAE,EAAE;QACpD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,SAAS,GAAG,EAAE,CAAC,IAAI,CAAC;YACxB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC;QACH,MAAM,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5C,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,IAAI,EAAE,CAAC,CAAC,IAAI;SACb,CAAC,CAAC,CAAC;QAEJ,OAAO,qBAAqB,CAC1B,uCAAuC,EACvC;YACE,KAAK,EAAE,GAAG,SAAS,CAAC,MAAM,eAAe;YACzC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,UAAU;YACjC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC;SAC3B,EACD,EAAE,SAAS,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,CACxD,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"list-footprints.js","sourceRoot":"","sources":["../../../src/tools/list-footprints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,WAAW,EAAE;QACX,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,8CAA8C,CAAC;QAC3D,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,EAAE;aACV,QAAQ,CAAC,oDAAoD,CAAC;KAClE;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,CAAC,CAAC,KAAK,CAChB,CAAC,CAAC,MAAM,CAAC;YACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;YACd,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;YAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;YACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;YACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC5B,CAAC,CACH;QACD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;KAClB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,iNAAiN;IACnN,KAAK,EAAE;QACL,EAAE,EAAE;YACF,WAAW,EAAE,+BAA+B;SAC7C;KACF;CACF,CAAC;AAEF,MAAM,UAAU,2BAA2B,CAAC,EAAoB;IAC9D,OAAO,eAAe,CACpB,iBAAiB,EACjB,sDAAsD,EACtD,KAAK,EAAE,MAA2C,EAAE,EAAE;QACpD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,SAAS,GAAG,EAAE,CAAC,IAAI,CAAC;YACxB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC;QACH,MAAM,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5C,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,IAAI,EAAE,CAAC,CAAC,IAAI;SACb,CAAC,CAAC,CAAC;QAEJ,MAAM,KAAK,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC;QAEjC,OAAO,qBAAqB,CAC1B,uCAAuC,EACvC;YACE,KAAK,EAAE,GAAG,SAAS,CAAC,MAAM,eAAe;YACzC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,UAAU;YACjC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC;SAC3B,EACD,EAAE,SAAS,EAAE,eAAe,EAAE,KAAK,EAAE,CACtC,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/src/tools/manage-tags.d.ts

@@ -0,0 +1,47 @@
+import * as z from "zod";
+import type { EvidenceDatabase } from "../lib/storage/index.js";
+export declare const manageTagsSchema: {
+    inputSchema: {
+        action: z.ZodEnum<{
+            stats: "stats";
+            rename: "rename";
+            remove: "remove";
+        }>;
+        tag: z.ZodOptional<z.ZodString>;
+        oldTag: z.ZodOptional<z.ZodString>;
+        newTag: z.ZodOptional<z.ZodString>;
+    };
+    outputSchema: {
+        action: z.ZodString;
+        tags: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            tag: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$strip>>>;
+        totalTags: z.ZodOptional<z.ZodNumber>;
+        updatedCount: z.ZodOptional<z.ZodNumber>;
+        success: z.ZodBoolean;
+    };
+};
+export declare const manageTagsMetadata: {
+    title: string;
+    description: string;
+};
+export declare function createManageTagsHandler(db: EvidenceDatabase): (params: {
+    action: "stats" | "rename" | "remove";
+    tag?: string;
+    oldTag?: string;
+    newTag?: string;
+}) => Promise<import("../lib/tool-response.js").ToolResponse<{
+    action: string;
+    tags: {
+        tag: string;
+        count: number;
+    }[];
+    totalTags: number;
+    success: boolean;
+}> | import("../lib/tool-response.js").ToolResponse<{
+    action: string;
+    updatedCount: number;
+    success: boolean;
+}>>;
+//# sourceMappingURL=manage-tags.d.ts.map

package/dist/src/tools/manage-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-tags.d.ts","sourceRoot":"","sources":["../../../src/tools/manage-tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;CAqC5B,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;CAI9B,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,gBAAgB;YAK9C,OAAO,GAAG,QAAQ,GAAG,QAAQ;UAC/B,MAAM;aACH,MAAM;aACN,MAAM;;;;;;;;;;;;;IA2FpB"}

package/dist/src/tools/manage-tags.js

@@ -0,0 +1,109 @@
+import * as z from "zod";
+import { wrapToolHandler } from "../lib/tool-wrapper.js";
+import { createToolResponse } from "../lib/tool-response.js";
+export const manageTagsSchema = {
+    inputSchema: {
+        action: z
+            .enum(["stats", "rename", "remove"])
+            .describe("Tag operation to perform: 'stats' returns all tags with usage counts, 'rename' renames a tag across all records, 'remove' deletes a tag from all records."),
+        tag: z
+            .string()
+            .min(1)
+            .optional()
+            .describe("Tag name to remove (required when action='remove')"),
+        oldTag: z
+            .string()
+            .min(1)
+            .optional()
+            .describe("Current tag name to rename (required when action='rename')"),
+        newTag: z
+            .string()
+            .min(1)
+            .optional()
+            .describe("New tag name (required when action='rename')"),
+    },
+    outputSchema: {
+        action: z.string(),
+        tags: z
+            .array(z.object({
+            tag: z.string(),
+            count: z.number(),
+        }))
+            .optional(),
+        totalTags: z.number().optional(),
+        updatedCount: z.number().optional(),
+        success: z.boolean(),
+    },
+};
+export const manageTagsMetadata = {
+    title: "Manage Tags",
+    description: "Unified tag management: get tag statistics, rename tags across all records, or remove tags. Replaces individual tag tools for lower cognitive load. All rename/remove operations are atomic (transactional).",
+};
+export function createManageTagsHandler(db) {
+    return wrapToolHandler("manage-tags", "Ensure action is valid, and required parameters are provided for the chosen action.", async (params) => {
+        // Runtime validation for direct callers (Zod enum only applies through MCP SDK)
+        if (!["stats", "rename", "remove"].includes(params.action)) {
+            throw new Error(`Unknown action: ${params.action}. Valid actions: stats, rename, remove`);
+        }
+        switch (params.action) {
+            case "stats": {
+                const tagCounts = db.getTagCounts();
+                const tags = Array.from(tagCounts.entries())
+                    .map(([tag, count]) => ({ tag, count }))
+                    .sort((a, b) => b.count - a.count);
+                const resultText = tags.length > 0
+                    ? `📊 Tag Statistics:\n${tags.map((t) => `  • ${t.tag}: ${t.count}`).join("\n")}`
+                    : `📊 No tags found in any footprint records`;
+                return createToolResponse(resultText, {
+                    action: "stats",
+                    tags,
+                    totalTags: tags.length,
+                    success: true,
+                });
+            }
+            case "rename": {
+                if (!params.oldTag || !params.newTag) {
+                    throw new Error("Both oldTag and newTag are required for rename action");
+                }
+                if (params.oldTag.trim() === params.newTag.trim()) {
+                    throw new Error("New tag must be different from old tag");
+                }
+                // eslint-disable-next-line no-control-regex
+                if (/[\x00\n\r,]/.test(params.newTag)) {
+                    throw new Error(`Invalid tag format: "${params.newTag}". Tags cannot contain null bytes, newlines, or commas.`);
+                }
+                if (params.newTag.trim().length > 100) {
+                    throw new Error("Tag too long (max 100 characters)");
+                }
+                const updatedCount = db.renameTag(params.oldTag.trim(), params.newTag.trim());
+                const success = updatedCount > 0;
+                const resultText = success
+                    ? `🏷️ Renamed tag "${params.oldTag}" to "${params.newTag}" in ${updatedCount} record${updatedCount > 1 ? "s" : ""}`
+                    : `⚠️ No records found with tag "${params.oldTag}"`;
+                return createToolResponse(resultText, {
+                    action: "rename",
+                    updatedCount,
+                    success,
+                });
+            }
+            case "remove": {
+                if (!params.tag) {
+                    throw new Error("tag is required for remove action");
+                }
+                const updatedCount = db.removeTag(params.tag.trim());
+                const success = updatedCount > 0;
+                const resultText = success
+                    ? `🗑️ Removed tag "${params.tag}" from ${updatedCount} record${updatedCount > 1 ? "s" : ""}`
+                    : `⚠️ No records found with tag "${params.tag}"`;
+                return createToolResponse(resultText, {
+                    action: "remove",
+                    updatedCount,
+                    success,
+                });
+            }
+            default:
+                throw new Error(`Unknown action: ${params.action}. Valid actions: stats, rename, remove`);
+        }
+    });
+}
+//# sourceMappingURL=manage-tags.js.map

package/dist/src/tools/manage-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-tags.js","sourceRoot":"","sources":["../../../src/tools/manage-tags.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,gBAAgB,GAAG;IAC9B,WAAW,EAAE;QACX,MAAM,EAAE,CAAC;aACN,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;aACnC,QAAQ,CACP,2JAA2J,CAC5J;QACH,GAAG,EAAE,CAAC;aACH,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,EAAE;aACV,QAAQ,CAAC,oDAAoD,CAAC;QACjE,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,EAAE;aACV,QAAQ,CAAC,4DAA4D,CAAC;QACzE,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,EAAE;aACV,QAAQ,CAAC,8CAA8C,CAAC;KAC5D;IACD,YAAY,EAAE;QACZ,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,IAAI,EAAE,CAAC;aACJ,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;YACP,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;YACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SAClB,CAAC,CACH;aACA,QAAQ,EAAE;QACb,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACnC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;KACrB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,aAAa;IACpB,WAAW,EACT,8MAA8M;CACjN,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,EAAoB;IAC1D,OAAO,eAAe,CACpB,aAAa,EACb,qFAAqF,EACrF,KAAK,EAAE,MAKN,EAAE,EAAE;QACH,gFAAgF;QAChF,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CACb,mBAAmB,MAAM,CAAC,MAAgB,wCAAwC,CACnF,CAAC;QACJ,CAAC;QAED,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;YACtB,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,SAAS,GAAG,EAAE,CAAC,YAAY,EAAE,CAAC;gBACpC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;qBACzC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;qBACvC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;gBAErC,MAAM,UAAU,GACd,IAAI,CAAC,MAAM,GAAG,CAAC;oBACb,CAAC,CAAC,uBAAuB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBACjF,CAAC,CAAC,2CAA2C,CAAC;gBAElD,OAAO,kBAAkB,CAAC,UAAU,EAAE;oBACpC,MAAM,EAAE,OAAO;oBACf,IAAI;oBACJ,SAAS,EAAE,IAAI,CAAC,MAAM;oBACtB,OAAO,EAAE,IAAI;iBACd,CAAC,CAAC;YACL,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;oBACrC,MAAM,IAAI,KAAK,CACb,uDAAuD,CACxD,CAAC;gBACJ,CAAC;gBACD,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;oBAClD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;gBAC5D,CAAC;gBACD,4CAA4C;gBAC5C,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;oBACtC,MAAM,IAAI,KAAK,CACb,wBAAwB,MAAM,CAAC,MAAM,yDAAyD,CAC/F,CAAC;gBACJ,CAAC;gBACD,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;oBACtC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;gBACvD,CAAC;gBAED,MAAM,YAAY,GAAG,EAAE,CAAC,SAAS,CAC/B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EACpB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CACrB,CAAC;gBACF,MAAM,OAAO,GAAG,YAAY,GAAG,CAAC,CAAC;gBAEjC,MAAM,UAAU,GAAG,OAAO;oBACxB,CAAC,CAAC,oBAAoB,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,QAAQ,YAAY,UAAU,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBACpH,CAAC,CAAC,iCAAiC,MAAM,CAAC,MAAM,GAAG,CAAC;gBAEtD,OAAO,kBAAkB,CAAC,UAAU,EAAE;oBACpC,MAAM,EAAE,QAAQ;oBAChB,YAAY;oBACZ,OAAO;iBACR,CAAC,CAAC;YACL,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;oBAChB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;gBACvD,CAAC;gBAED,MAAM,YAAY,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrD,MAAM,OAAO,GAAG,YAAY,GAAG,CAAC,CAAC;gBAEjC,MAAM,UAAU,GAAG,OAAO;oBACxB,CAAC,CAAC,oBAAoB,MAAM,CAAC,GAAG,UAAU,YAAY,UAAU,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBAC7F,CAAC,CAAC,iCAAiC,MAAM,CAAC,GAAG,GAAG,CAAC;gBAEnD,OAAO,kBAAkB,CAAC,UAAU,EAAE;oBACpC,MAAM,EAAE,QAAQ;oBAChB,YAAY;oBACZ,OAAO;iBACR,CAAC,CAAC;YACL,CAAC;YAED;gBACE,MAAM,IAAI,KAAK,CACb,mBAAmB,MAAM,CAAC,MAAM,wCAAwC,CACzE,CAAC;QACN,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}