@pcircle/footprint 1.2.2 → 1.5.0

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",
@@ -32,34 +34,36 @@ export const getFootprintMetadata = {
     },
 };
 export function createGetFootprintHandler(db, getDerivedKey) {
-    return wrapToolHandler("get-footprint", "Verify the footprint ID exists and password is correct.", async (params) => {
-        const fp = db.findById(params.id);
-        if (!fp) {
-            throw new Error(`Footprint not found: ${params.id}`);
+    return wrapToolHandler("get-footprint", "Verify the evidence ID exists and password is correct.", async (params) => {
+        const evidence = db.findById(params.id);
+        if (!evidence) {
+            throw new Error(`Evidence not found: ${params.id}`);
         }
         const key = await getDerivedKey();
-        const decrypted = decrypt(fp.encryptedContent, fp.nonce, key);
-        const gitInfo = fp.gitCommitHash && fp.gitTimestamp
+        const decrypted = decrypt(evidence.encryptedContent, evidence.nonce, key);
+        const gitInfo = evidence.gitCommitHash && evidence.gitTimestamp
             ? {
-                commitHash: fp.gitCommitHash,
-                timestamp: fp.gitTimestamp,
+                commitHash: evidence.gitCommitHash,
+                timestamp: evidence.gitTimestamp,
             }
             : null;
-        return formatSuccessResponse("Footprint retrieved successfully", {
-            ID: fp.id,
-            Timestamp: fp.timestamp,
-            Provider: fp.llmProvider,
-            "Message Count": fp.messageCount,
-            "Content Preview": `${decrypted.substring(0, 100)}...`,
+        return formatSuccessResponse("Evidence retrieved successfully", {
+            ID: evidence.id,
+            Timestamp: evidence.timestamp,
+            Provider: evidence.llmProvider,
+            "Message Count": evidence.messageCount,
+            "Content Preview": decrypted.length > 100
+                ? `${decrypted.substring(0, 100)}...`
+                : decrypted,
         }, {
-            id: fp.id,
-            timestamp: fp.timestamp,
-            conversationId: fp.conversationId,
-            llmProvider: fp.llmProvider,
+            id: evidence.id,
+            timestamp: evidence.timestamp,
+            conversationId: evidence.conversationId,
+            llmProvider: evidence.llmProvider,
             content: decrypted,
-            messageCount: fp.messageCount,
+            messageCount: evidence.messageCount,
             gitInfo,
-            tags: fp.tags,
+            tags: evidence.tags,
         });
     });
 }

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,yDAAyD,EACzD,KAAK,EAAE,MAAsB,EAAE,EAAE;QAC/B,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,aAAa,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,OAAO,CAAC,EAAE,CAAC,gBAAgB,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAE9D,MAAM,OAAO,GACX,EAAE,CAAC,aAAa,IAAI,EAAE,CAAC,YAAY;YACjC,CAAC,CAAC;gBACE,UAAU,EAAE,EAAE,CAAC,aAAa;gBAC5B,SAAS,EAAE,EAAE,CAAC,YAAY;aAC3B;YACH,CAAC,CAAC,IAAI,CAAC;QAEX,OAAO,qBAAqB,CAC1B,kCAAkC,EAClC;YACE,EAAE,EAAE,EAAE,CAAC,EAAE;YACT,SAAS,EAAE,EAAE,CAAC,SAAS;YACvB,QAAQ,EAAE,EAAE,CAAC,WAAW;YACxB,eAAe,EAAE,EAAE,CAAC,YAAY;YAChC,iBAAiB,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK;SACvD,EACD;YACE,EAAE,EAAE,EAAE,CAAC,EAAE;YACT,SAAS,EAAE,EAAE,CAAC,SAAS;YACvB,cAAc,EAAE,EAAE,CAAC,cAAc;YACjC,WAAW,EAAE,EAAE,CAAC,WAAW;YAC3B,OAAO,EAAE,SAAS;YAClB,YAAY,EAAE,EAAE,CAAC,YAAY;YAC7B,OAAO;YACP,IAAI,EAAE,EAAE,CAAC,IAAI;SACd,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

@@ -6,28 +6,14 @@ export declare const listFootprintsSchema: {
         offset: z.ZodOptional<z.ZodNumber>;
     };
     outputSchema: {
-        footprints: z.ZodArray<z.ZodObject<{
+        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">;
+        }, z.core.$strip>>;
         total: z.ZodNumber;
     };
 };
@@ -44,7 +30,7 @@ export declare function createListFootprintsHandler(db: EvidenceDatabase): (para
     limit?: number;
     offset?: number;
 }) => Promise<import("../lib/tool-response.js").ToolResponse<{
-    footprints: {
+    evidences: {
         id: string;
         timestamp: string;
         conversationId: string | null;

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,11 +3,21 @@ 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: {
-        footprints: z.array(z.object({
+        evidences: z.array(z.object({
             id: z.string(),
             timestamp: z.string(),
             conversationId: z.string(),
@@ -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",
@@ -35,23 +45,24 @@ export function createListFootprintsHandler(db) {
         if (params.offset !== undefined && params.offset < 0) {
             throw new Error("Offset cannot be negative");
         }
-        const footprints = db.list({
+        const evidences = db.list({
             limit: params.limit,
             offset: params.offset,
         });
-        const mappedFootprints = footprints.map((fp) => ({
-            id: fp.id,
-            timestamp: fp.timestamp,
-            conversationId: fp.conversationId,
-            llmProvider: fp.llmProvider,
-            messageCount: fp.messageCount,
-            tags: fp.tags,
+        const mappedEvidences = evidences.map((e) => ({
+            id: e.id,
+            timestamp: e.timestamp,
+            conversationId: e.conversationId,
+            llmProvider: e.llmProvider,
+            messageCount: e.messageCount,
+            tags: e.tags,
         }));
+        const total = db.getTotalCount();
         return formatSuccessResponse("Footprint list retrieved successfully", {
-            Count: `${footprints.length} footprint(s)`,
-            Limit: params.limit || "No limit",
-            Offset: params.offset || 0,
-        }, { footprints: mappedFootprints, total: footprints.length });
+            Count: `${evidences.length} footprint(s)`,
+            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,UAAU,EAAE,CAAC,CAAC,KAAK,CACjB,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,UAAU,GAAG,EAAE,CAAC,IAAI,CAAC;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC;QACH,MAAM,gBAAgB,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC/C,EAAE,EAAE,EAAE,CAAC,EAAE;YACT,SAAS,EAAE,EAAE,CAAC,SAAS;YACvB,cAAc,EAAE,EAAE,CAAC,cAAc;YACjC,WAAW,EAAE,EAAE,CAAC,WAAW;YAC3B,YAAY,EAAE,EAAE,CAAC,YAAY;YAC7B,IAAI,EAAE,EAAE,CAAC,IAAI;SACd,CAAC,CAAC,CAAC;QAEJ,OAAO,qBAAqB,CAC1B,uCAAuC,EACvC;YACE,KAAK,EAAE,GAAG,UAAU,CAAC,MAAM,eAAe;YAC1C,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,UAAU;YACjC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC;SAC3B,EACD,EAAE,UAAU,EAAE,gBAAgB,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,CAC3D,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":"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"}

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

@@ -3,35 +3,21 @@ 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">>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         dateFrom: z.ZodOptional<z.ZodString>;
         dateTo: z.ZodOptional<z.ZodString>;
         limit: z.ZodOptional<z.ZodNumber>;
         offset: z.ZodOptional<z.ZodNumber>;
     };
     outputSchema: {
-        footprints: z.ZodArray<z.ZodObject<{
+        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">;
+        }, z.core.$strip>>;
         total: z.ZodNumber;
     };
 };
@@ -47,7 +33,7 @@ export declare function createSearchFootprintsHandler(db: EvidenceDatabase): (pa
     limit?: number;
     offset?: number;
 }) => Promise<import("../lib/tool-response.js").ToolResponse<{
-    footprints: {
+    evidences: {
         id: string;
         timestamp: string;
         conversationId: string | null;

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;;CA0ClC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;CAIpC,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,gBAAgB;YAKpD,MAAM;WACP,MAAM,EAAE;eACJ,MAAM;aACR,MAAM;YACP,MAAM;aACL,MAAM;;;;;;;;;;;IA8DpB"}

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

@@ -6,15 +6,24 @@ export const searchFootprintsSchema = {
         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)"),
+            .describe("Search text (matches conversationId and tags via LIKE). Combine with tags for precise filtering."),
+        tags: z
+            .array(z.string())
+            .optional()
+            .describe("Filter by tags (AND logic — all specified tags must be present)"),
+        dateFrom: z
+            .string()
+            .optional()
+            .describe("Start date filter (ISO 8601 format, e.g., 2026-01-01T00:00:00Z)"),
+        dateTo: z
+            .string()
+            .optional()
+            .describe("End date filter (ISO 8601 format, e.g., 2026-12-31T23:59:59Z)"),
         limit: z.number().int().positive().optional().describe("Maximum results"),
         offset: z.number().int().min(0).optional().describe("Pagination offset"),
     },
     outputSchema: {
-        footprints: z.array(z.object({
+        evidences: z.array(z.object({
             id: z.string(),
             timestamp: z.string(),
             conversationId: z.string(),
@@ -27,7 +36,7 @@ export const searchFootprintsSchema = {
 };
 export const searchFootprintsMetadata = {
     title: "Search Footprints",
-    description: "Search and filter footprints by query, tags, or date range",
+    description: "Search and filter footprints by query, tags, or date range. Query matches conversationId and tags (LIKE). Tags filter uses AND logic — all specified tags must be present. Query + tags combined with AND. Returns paginated results with total matching count.",
 };
 export function createSearchFootprintsHandler(db) {
     return wrapToolHandler("search-footprints", "Check date format (ISO 8601), limit > 0, and offset >= 0.", async (params) => {
@@ -51,7 +60,14 @@ export function createSearchFootprintsHandler(db) {
                 throw new Error("dateTo must be a valid ISO date string");
             }
         }
-        const footprints = db.search({
+        // Cross-validate date range using parsed dates (handles timezone offsets correctly)
+        if (params.dateFrom && params.dateTo) {
+            if (new Date(params.dateFrom) > new Date(params.dateTo)) {
+                throw new Error("dateFrom must be before dateTo");
+            }
+        }
+        // Single combined query for results + count (avoids duplicate WHERE clause)
+        const { evidences, total } = db.searchWithCount({
             query: params.query,
             tags: params.tags,
             dateFrom: params.dateFrom,
@@ -59,20 +75,20 @@ export function createSearchFootprintsHandler(db) {
             limit: params.limit,
             offset: params.offset,
         });
-        const mappedFootprints = footprints.map((fp) => ({
-            id: fp.id,
-            timestamp: fp.timestamp,
-            conversationId: fp.conversationId,
-            llmProvider: fp.llmProvider,
-            messageCount: fp.messageCount,
-            tags: fp.tags,
+        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: `${footprints.length} footprint(s) found`,
+            Results: `${evidences.length} footprint(s) found`,
             Query: params.query || "None",
             Tags: params.tags?.join(", ") || "None",
             "Date Range": `${params.dateFrom || "Start"} to ${params.dateTo || "End"}`,
-        }, { footprints: mappedFootprints, total: footprints.length });
+        }, { evidences: mappedEvidences, total });
     });
 }
 //# sourceMappingURL=search-footprints.js.map

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

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

@@ -6,7 +6,7 @@ export declare const suggestCaptureSchema: {
     outputSchema: {
         shouldCapture: z.ZodBoolean;
         reason: z.ZodString;
-        suggestedTags: z.ZodArray<z.ZodString, "many">;
+        suggestedTags: z.ZodArray<z.ZodString>;
         suggestedConversationId: z.ZodString;
         confidence: z.ZodNumber;
     };

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

@@ -1 +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"}
+{"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;;;;;;;;;;;CAgBhC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;CAIlC,CAAC;AAEF,wBAAgB,2BAA2B;aAIb,MAAM;yHAmBnC"}

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

@@ -6,7 +6,8 @@ export const suggestCaptureSchema = {
     inputSchema: {
         summary: z
             .string()
-            .describe("Conversation summary or key content to analyze"),
+            .max(1_000_000, "Summary too long (max ~1MB)")
+            .describe("Brief conversation summary or key content to analyze for capture-worthy signals (IP, legal, business decisions, research, compliance)."),
     },
     outputSchema: {
         shouldCapture: z.boolean(),
@@ -18,13 +19,16 @@ export const suggestCaptureSchema = {
 };
 export const suggestCaptureMetadata = {
     title: "Suggest Capture",
-    description: "Analyze conversation content and suggest whether to capture it as a footprint",
+    description: "Lightweight keyword-based pre-filter that analyzes conversation content and suggests whether to capture it as evidence. For deeper semantic analysis, use the 'footprint-should-capture' prompt instead.",
 };
 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");
         }
+        if (params.summary.length > 1_000_000) {
+            throw new Error("Summary too long (max ~1MB)");
+        }
         // Analyze content using content analyzer
         const analysis = analyzeContent(params.summary);
         // Format result text