@pcircle/footprint 1.1.1 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (207) hide show
  1. package/README.md +165 -12
  2. package/SKILL.md +72 -15
  3. package/dist/src/analyzers/content-analyzer.d.ts +20 -0
  4. package/dist/src/analyzers/content-analyzer.d.ts.map +1 -0
  5. package/dist/src/analyzers/content-analyzer.js +169 -0
  6. package/dist/src/analyzers/content-analyzer.js.map +1 -0
  7. package/dist/src/index.d.ts +38 -0
  8. package/dist/src/index.d.ts.map +1 -0
  9. package/dist/src/index.js +243 -0
  10. package/dist/src/index.js.map +1 -0
  11. package/dist/src/lib/crypto/decrypt.d.ts.map +1 -0
  12. package/dist/{lib → src/lib}/crypto/decrypt.js +4 -0
  13. package/dist/src/lib/crypto/decrypt.js.map +1 -0
  14. package/dist/src/lib/crypto/encrypt.d.ts.map +1 -0
  15. package/dist/src/lib/crypto/encrypt.js.map +1 -0
  16. package/dist/{lib → src/lib}/crypto/index.d.ts +1 -1
  17. package/dist/src/lib/crypto/index.d.ts.map +1 -0
  18. package/dist/{lib → src/lib}/crypto/index.js +1 -1
  19. package/dist/src/lib/crypto/index.js.map +1 -0
  20. package/dist/{lib → src/lib}/crypto/key-derivation.d.ts +17 -3
  21. package/dist/src/lib/crypto/key-derivation.d.ts.map +1 -0
  22. package/dist/{lib → src/lib}/crypto/key-derivation.js +44 -3
  23. package/dist/src/lib/crypto/key-derivation.js.map +1 -0
  24. package/dist/src/lib/crypto/types.d.ts.map +1 -0
  25. package/dist/src/lib/crypto/types.js.map +1 -0
  26. package/dist/src/lib/errors/base-error.d.ts +15 -0
  27. package/dist/src/lib/errors/base-error.d.ts.map +1 -0
  28. package/dist/src/lib/errors/base-error.js +34 -0
  29. package/dist/src/lib/errors/base-error.js.map +1 -0
  30. package/dist/src/lib/errors/crypto-error.d.ts +29 -0
  31. package/dist/src/lib/errors/crypto-error.d.ts.map +1 -0
  32. package/dist/src/lib/errors/crypto-error.js +43 -0
  33. package/dist/src/lib/errors/crypto-error.js.map +1 -0
  34. package/dist/src/lib/errors/index.d.ts +26 -0
  35. package/dist/src/lib/errors/index.d.ts.map +1 -0
  36. package/dist/src/lib/errors/index.js +26 -0
  37. package/dist/src/lib/errors/index.js.map +1 -0
  38. package/dist/src/lib/errors/storage-error.d.ts +25 -0
  39. package/dist/src/lib/errors/storage-error.d.ts.map +1 -0
  40. package/dist/src/lib/errors/storage-error.js +38 -0
  41. package/dist/src/lib/errors/storage-error.js.map +1 -0
  42. package/dist/src/lib/errors/validation-error.d.ts +21 -0
  43. package/dist/src/lib/errors/validation-error.d.ts.map +1 -0
  44. package/dist/src/lib/errors/validation-error.js +29 -0
  45. package/dist/src/lib/errors/validation-error.js.map +1 -0
  46. package/dist/{lib → src/lib}/storage/database.d.ts +14 -2
  47. package/dist/src/lib/storage/database.d.ts.map +1 -0
  48. package/dist/{lib → src/lib}/storage/database.js +65 -29
  49. package/dist/src/lib/storage/database.js.map +1 -0
  50. package/dist/src/lib/storage/export.d.ts.map +1 -0
  51. package/dist/{lib → src/lib}/storage/export.js +16 -1
  52. package/dist/src/lib/storage/export.js.map +1 -0
  53. package/dist/{lib → src/lib}/storage/git.d.ts +1 -1
  54. package/dist/src/lib/storage/git.d.ts.map +1 -0
  55. package/dist/{lib → src/lib}/storage/git.js +5 -2
  56. package/dist/src/lib/storage/git.js.map +1 -0
  57. package/dist/{lib → src/lib}/storage/index.d.ts +1 -0
  58. package/dist/src/lib/storage/index.d.ts.map +1 -0
  59. package/dist/{lib → src/lib}/storage/index.js +1 -0
  60. package/dist/src/lib/storage/index.js.map +1 -0
  61. package/dist/src/lib/storage/salt-storage.d.ts +25 -0
  62. package/dist/src/lib/storage/salt-storage.d.ts.map +1 -0
  63. package/dist/src/lib/storage/salt-storage.js +66 -0
  64. package/dist/src/lib/storage/salt-storage.js.map +1 -0
  65. package/dist/src/lib/storage/schema.d.ts.map +1 -0
  66. package/dist/{lib → src/lib}/storage/schema.js +22 -1
  67. package/dist/src/lib/storage/schema.js.map +1 -0
  68. package/dist/src/lib/storage/types.d.ts.map +1 -0
  69. package/dist/src/lib/storage/types.js.map +1 -0
  70. package/dist/src/lib/tool-response.d.ts +84 -0
  71. package/dist/src/lib/tool-response.d.ts.map +1 -0
  72. package/dist/src/lib/tool-response.js +91 -0
  73. package/dist/src/lib/tool-response.js.map +1 -0
  74. package/dist/src/lib/tool-wrapper.d.ts +45 -0
  75. package/dist/src/lib/tool-wrapper.d.ts.map +1 -0
  76. package/dist/src/lib/tool-wrapper.js +73 -0
  77. package/dist/src/lib/tool-wrapper.js.map +1 -0
  78. package/dist/{test-helpers.d.ts → src/test-helpers.d.ts} +4 -4
  79. package/dist/src/test-helpers.d.ts.map +1 -0
  80. package/dist/{test-helpers.js → src/test-helpers.js} +2 -2
  81. package/dist/src/test-helpers.js.map +1 -0
  82. package/dist/src/tools/capture-footprint.d.ts +29 -0
  83. package/dist/src/tools/capture-footprint.d.ts.map +1 -0
  84. package/dist/src/tools/capture-footprint.js +94 -0
  85. package/dist/src/tools/capture-footprint.js.map +1 -0
  86. package/dist/src/tools/delete-footprints.d.ts +22 -0
  87. package/dist/src/tools/delete-footprints.d.ts.map +1 -0
  88. package/dist/src/tools/delete-footprints.js +33 -0
  89. package/dist/src/tools/delete-footprints.js.map +1 -0
  90. package/dist/src/tools/export-footprints.d.ts +33 -0
  91. package/dist/src/tools/export-footprints.d.ts.map +1 -0
  92. package/dist/src/tools/export-footprints.js +50 -0
  93. package/dist/src/tools/export-footprints.js.map +1 -0
  94. package/dist/src/tools/get-footprint.d.ts +51 -0
  95. package/dist/src/tools/get-footprint.d.ts.map +1 -0
  96. package/dist/src/tools/get-footprint.js +66 -0
  97. package/dist/src/tools/get-footprint.js.map +1 -0
  98. package/dist/src/tools/get-tag-stats.d.ts +30 -0
  99. package/dist/src/tools/get-tag-stats.d.ts.map +1 -0
  100. package/dist/src/tools/get-tag-stats.js +33 -0
  101. package/dist/src/tools/get-tag-stats.js.map +1 -0
  102. package/dist/src/tools/index.d.ts +16 -0
  103. package/dist/src/tools/index.d.ts.map +1 -0
  104. package/dist/src/tools/index.js +16 -0
  105. package/dist/src/tools/index.js.map +1 -0
  106. package/dist/src/tools/list-footprints.d.ts +57 -0
  107. package/dist/src/tools/list-footprints.d.ts.map +1 -0
  108. package/dist/src/tools/list-footprints.js +57 -0
  109. package/dist/src/tools/list-footprints.js.map +1 -0
  110. package/dist/src/tools/remove-tag.d.ts +22 -0
  111. package/dist/src/tools/remove-tag.d.ts.map +1 -0
  112. package/dist/src/tools/remove-tag.js +30 -0
  113. package/dist/src/tools/remove-tag.js.map +1 -0
  114. package/dist/src/tools/rename-tag.d.ts +24 -0
  115. package/dist/src/tools/rename-tag.d.ts.map +1 -0
  116. package/dist/src/tools/rename-tag.js +34 -0
  117. package/dist/src/tools/rename-tag.js.map +1 -0
  118. package/dist/src/tools/search-footprints.d.ts +60 -0
  119. package/dist/src/tools/search-footprints.d.ts.map +1 -0
  120. package/dist/src/tools/search-footprints.js +78 -0
  121. package/dist/src/tools/search-footprints.js.map +1 -0
  122. package/dist/src/tools/suggest-capture.d.ts +21 -0
  123. package/dist/src/tools/suggest-capture.d.ts.map +1 -0
  124. package/dist/src/tools/suggest-capture.js +37 -0
  125. package/dist/src/tools/suggest-capture.js.map +1 -0
  126. package/dist/src/tools/verify-footprint.d.ts +104 -0
  127. package/dist/src/tools/verify-footprint.d.ts.map +1 -0
  128. package/dist/src/tools/verify-footprint.js +102 -0
  129. package/dist/src/tools/verify-footprint.js.map +1 -0
  130. package/dist/{types.d.ts → src/types.d.ts} +1 -1
  131. package/dist/src/types.d.ts.map +1 -0
  132. package/dist/{lib/storage → src}/types.js.map +1 -1
  133. package/dist/src/ui/register.d.ts.map +1 -0
  134. package/dist/src/ui/register.js +94 -0
  135. package/dist/src/ui/register.js.map +1 -0
  136. package/dist/tests/error-handling.test.d.ts +2 -0
  137. package/dist/tests/error-handling.test.d.ts.map +1 -0
  138. package/dist/tests/error-handling.test.js +114 -0
  139. package/dist/tests/error-handling.test.js.map +1 -0
  140. package/dist/tests/fixtures.d.ts +87 -0
  141. package/dist/tests/fixtures.d.ts.map +1 -0
  142. package/dist/tests/fixtures.js +130 -0
  143. package/dist/tests/fixtures.js.map +1 -0
  144. package/dist/tests/integration.test.d.ts +2 -0
  145. package/dist/tests/integration.test.d.ts.map +1 -0
  146. package/dist/tests/integration.test.js +115 -0
  147. package/dist/tests/integration.test.js.map +1 -0
  148. package/dist/tests/resources.test.d.ts +2 -0
  149. package/dist/tests/resources.test.d.ts.map +1 -0
  150. package/dist/tests/resources.test.js +73 -0
  151. package/dist/tests/resources.test.js.map +1 -0
  152. package/dist/tests/setup.d.ts +8 -0
  153. package/dist/tests/setup.d.ts.map +1 -0
  154. package/dist/tests/setup.js +8 -0
  155. package/dist/tests/setup.js.map +1 -0
  156. package/dist/tests/tools.test.d.ts +2 -0
  157. package/dist/tests/tools.test.d.ts.map +1 -0
  158. package/dist/tests/tools.test.js +224 -0
  159. package/dist/tests/tools.test.js.map +1 -0
  160. package/dist/ui/dashboard.html +1 -1
  161. package/dist/ui/detail.html +1 -1
  162. package/dist/ui/export.html +1 -1
  163. package/dist/ui-tmp/ui/export.html +1 -1
  164. package/package.json +8 -8
  165. package/dist/index.d.ts +0 -19
  166. package/dist/index.d.ts.map +0 -1
  167. package/dist/index.js +0 -694
  168. package/dist/index.js.map +0 -1
  169. package/dist/lib/crypto/decrypt.d.ts.map +0 -1
  170. package/dist/lib/crypto/decrypt.js.map +0 -1
  171. package/dist/lib/crypto/encrypt.d.ts.map +0 -1
  172. package/dist/lib/crypto/encrypt.js.map +0 -1
  173. package/dist/lib/crypto/index.d.ts.map +0 -1
  174. package/dist/lib/crypto/index.js.map +0 -1
  175. package/dist/lib/crypto/key-derivation.d.ts.map +0 -1
  176. package/dist/lib/crypto/key-derivation.js.map +0 -1
  177. package/dist/lib/crypto/types.d.ts.map +0 -1
  178. package/dist/lib/crypto/types.js.map +0 -1
  179. package/dist/lib/storage/database.d.ts.map +0 -1
  180. package/dist/lib/storage/database.js.map +0 -1
  181. package/dist/lib/storage/export.d.ts.map +0 -1
  182. package/dist/lib/storage/export.js.map +0 -1
  183. package/dist/lib/storage/git.d.ts.map +0 -1
  184. package/dist/lib/storage/git.js.map +0 -1
  185. package/dist/lib/storage/index.d.ts.map +0 -1
  186. package/dist/lib/storage/index.js.map +0 -1
  187. package/dist/lib/storage/schema.d.ts.map +0 -1
  188. package/dist/lib/storage/schema.js.map +0 -1
  189. package/dist/lib/storage/types.d.ts.map +0 -1
  190. package/dist/test-helpers.d.ts.map +0 -1
  191. package/dist/test-helpers.js.map +0 -1
  192. package/dist/types.d.ts.map +0 -1
  193. package/dist/types.js.map +0 -1
  194. package/dist/ui/register.d.ts.map +0 -1
  195. package/dist/ui/register.js +0 -154
  196. package/dist/ui/register.js.map +0 -1
  197. /package/dist/{lib → src/lib}/crypto/decrypt.d.ts +0 -0
  198. /package/dist/{lib → src/lib}/crypto/encrypt.d.ts +0 -0
  199. /package/dist/{lib → src/lib}/crypto/encrypt.js +0 -0
  200. /package/dist/{lib → src/lib}/crypto/types.d.ts +0 -0
  201. /package/dist/{lib → src/lib}/crypto/types.js +0 -0
  202. /package/dist/{lib → src/lib}/storage/export.d.ts +0 -0
  203. /package/dist/{lib → src/lib}/storage/schema.d.ts +0 -0
  204. /package/dist/{lib → src/lib}/storage/types.d.ts +0 -0
  205. /package/dist/{lib → src/lib}/storage/types.js +0 -0
  206. /package/dist/{types.js → src/types.js} +0 -0
  207. /package/dist/{ui → src/ui}/register.d.ts +0 -0
@@ -0,0 +1,33 @@
1
+ import * as z from "zod";
2
+ import type { EvidenceDatabase } from "../lib/storage/index.js";
3
+ export declare const exportFootprintsSchema: {
4
+ inputSchema: {
5
+ evidenceIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6
+ includeGitInfo: z.ZodOptional<z.ZodBoolean>;
7
+ };
8
+ outputSchema: {
9
+ filename: z.ZodString;
10
+ checksum: z.ZodString;
11
+ evidenceCount: z.ZodNumber;
12
+ success: z.ZodBoolean;
13
+ };
14
+ };
15
+ export declare const exportFootprintsMetadata: {
16
+ title: string;
17
+ description: string;
18
+ _meta: {
19
+ ui: {
20
+ resourceUri: string;
21
+ };
22
+ };
23
+ };
24
+ export declare function createExportFootprintsHandler(db: EvidenceDatabase): (params: {
25
+ evidenceIds?: string[];
26
+ includeGitInfo?: boolean;
27
+ }) => Promise<import("../lib/tool-response.js").ToolResponse<{
28
+ filename: string;
29
+ checksum: string;
30
+ evidenceCount: number;
31
+ success: boolean;
32
+ }>>;
33
+ //# sourceMappingURL=export-footprints.d.ts.map
@@ -0,0 +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"}
@@ -0,0 +1,50 @@
1
+ import * as z from "zod";
2
+ import { wrapToolHandler } from "../lib/tool-wrapper.js";
3
+ import { formatSuccessResponse } from "../lib/tool-response.js";
4
+ export const exportFootprintsSchema = {
5
+ inputSchema: {
6
+ evidenceIds: z
7
+ .array(z.string())
8
+ .optional()
9
+ .describe("Specific IDs (empty = all)"),
10
+ includeGitInfo: z.boolean().optional().describe("Include Git timestamps"),
11
+ },
12
+ outputSchema: {
13
+ filename: z.string(),
14
+ checksum: z.string(),
15
+ evidenceCount: z.number(),
16
+ success: z.boolean(),
17
+ },
18
+ };
19
+ export const exportFootprintsMetadata = {
20
+ title: "Export Footprints",
21
+ description: "Export footprints to encrypted ZIP archive",
22
+ _meta: {
23
+ ui: {
24
+ resourceUri: "ui://footprint/export.html",
25
+ },
26
+ },
27
+ };
28
+ export function createExportFootprintsHandler(db) {
29
+ return wrapToolHandler("export-footprints", "Check evidenceIds exist and filesystem has write permissions.", async (params) => {
30
+ const { exportEvidences } = await import("../lib/storage/index.js");
31
+ const fs = await import("fs");
32
+ const result = await exportEvidences(db, {
33
+ evidenceIds: params.evidenceIds,
34
+ includeGitInfo: params.includeGitInfo ?? false,
35
+ });
36
+ fs.writeFileSync(result.filename, result.zipData);
37
+ return formatSuccessResponse("Export completed successfully", {
38
+ "Footprint Count": result.evidenceCount,
39
+ Filename: result.filename,
40
+ Checksum: result.checksum,
41
+ "Git Info": params.includeGitInfo ? "Included" : "Excluded",
42
+ }, {
43
+ filename: result.filename,
44
+ checksum: result.checksum,
45
+ evidenceCount: result.evidenceCount,
46
+ success: true,
47
+ });
48
+ });
49
+ }
50
+ //# sourceMappingURL=export-footprints.js.map
@@ -0,0 +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"}
@@ -0,0 +1,51 @@
1
+ import * as z from "zod";
2
+ import type { EvidenceDatabase } from "../lib/storage/index.js";
3
+ export declare const getFootprintSchema: {
4
+ inputSchema: {
5
+ id: z.ZodString;
6
+ };
7
+ outputSchema: {
8
+ id: z.ZodString;
9
+ timestamp: z.ZodString;
10
+ conversationId: z.ZodString;
11
+ llmProvider: z.ZodString;
12
+ content: z.ZodString;
13
+ messageCount: z.ZodNumber;
14
+ gitInfo: z.ZodNullable<z.ZodObject<{
15
+ commitHash: z.ZodString;
16
+ timestamp: z.ZodString;
17
+ }, "strip", z.ZodTypeAny, {
18
+ timestamp: string;
19
+ commitHash: string;
20
+ }, {
21
+ timestamp: string;
22
+ commitHash: string;
23
+ }>>;
24
+ tags: z.ZodNullable<z.ZodString>;
25
+ };
26
+ };
27
+ export declare const getFootprintMetadata: {
28
+ title: string;
29
+ description: string;
30
+ _meta: {
31
+ ui: {
32
+ resourceUri: string;
33
+ };
34
+ };
35
+ };
36
+ export declare function createGetFootprintHandler(db: EvidenceDatabase, getDerivedKey: () => Promise<Uint8Array>): (params: {
37
+ id: string;
38
+ }) => Promise<import("../lib/tool-response.js").ToolResponse<{
39
+ id: string;
40
+ timestamp: string;
41
+ conversationId: string | null;
42
+ llmProvider: string | null;
43
+ content: string;
44
+ messageCount: number;
45
+ gitInfo: {
46
+ commitHash: string;
47
+ timestamp: string;
48
+ } | null;
49
+ tags: string | null;
50
+ }>>;
51
+ //# sourceMappingURL=get-footprint.d.ts.map
@@ -0,0 +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"}
@@ -0,0 +1,66 @@
1
+ import * as z from "zod";
2
+ import { wrapToolHandler } from "../lib/tool-wrapper.js";
3
+ import { formatSuccessResponse } from "../lib/tool-response.js";
4
+ import { decrypt } from "../lib/crypto/index.js";
5
+ export const getFootprintSchema = {
6
+ inputSchema: {
7
+ id: z.string().describe("Footprint ID"),
8
+ },
9
+ outputSchema: {
10
+ id: z.string(),
11
+ timestamp: z.string(),
12
+ conversationId: z.string(),
13
+ llmProvider: z.string(),
14
+ content: z.string(),
15
+ messageCount: z.number(),
16
+ gitInfo: z
17
+ .object({
18
+ commitHash: z.string(),
19
+ timestamp: z.string(),
20
+ })
21
+ .nullable(),
22
+ tags: z.string().nullable(),
23
+ },
24
+ };
25
+ export const getFootprintMetadata = {
26
+ title: "Get Footprint",
27
+ description: "Retrieve and decrypt specific footprint by ID",
28
+ _meta: {
29
+ ui: {
30
+ resourceUri: "ui://footprint/detail.html",
31
+ },
32
+ },
33
+ };
34
+ export function createGetFootprintHandler(db, getDerivedKey) {
35
+ return wrapToolHandler("get-footprint", "Verify the evidence ID exists and password is correct.", async (params) => {
36
+ const evidence = db.findById(params.id);
37
+ if (!evidence) {
38
+ throw new Error(`Evidence not found: ${params.id}`);
39
+ }
40
+ const key = await getDerivedKey();
41
+ const decrypted = decrypt(evidence.encryptedContent, evidence.nonce, key);
42
+ const gitInfo = evidence.gitCommitHash && evidence.gitTimestamp
43
+ ? {
44
+ commitHash: evidence.gitCommitHash,
45
+ timestamp: evidence.gitTimestamp,
46
+ }
47
+ : null;
48
+ return formatSuccessResponse("Evidence retrieved successfully", {
49
+ ID: evidence.id,
50
+ Timestamp: evidence.timestamp,
51
+ Provider: evidence.llmProvider,
52
+ "Message Count": evidence.messageCount,
53
+ "Content Preview": `${decrypted.substring(0, 100)}...`,
54
+ }, {
55
+ id: evidence.id,
56
+ timestamp: evidence.timestamp,
57
+ conversationId: evidence.conversationId,
58
+ llmProvider: evidence.llmProvider,
59
+ content: decrypted,
60
+ messageCount: evidence.messageCount,
61
+ gitInfo,
62
+ tags: evidence.tags,
63
+ });
64
+ });
65
+ }
66
+ //# sourceMappingURL=get-footprint.js.map
@@ -0,0 +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"}
@@ -0,0 +1,30 @@
1
+ import * as z from "zod";
2
+ import type { EvidenceDatabase } from "../lib/storage/index.js";
3
+ export declare const getTagStatsSchema: {
4
+ inputSchema: {};
5
+ outputSchema: {
6
+ tags: z.ZodArray<z.ZodObject<{
7
+ tag: z.ZodString;
8
+ count: z.ZodNumber;
9
+ }, "strip", z.ZodTypeAny, {
10
+ tag: string;
11
+ count: number;
12
+ }, {
13
+ tag: string;
14
+ count: number;
15
+ }>, "many">;
16
+ totalTags: z.ZodNumber;
17
+ };
18
+ };
19
+ export declare const getTagStatsMetadata: {
20
+ title: string;
21
+ description: string;
22
+ };
23
+ export declare function createGetTagStatsHandler(db: EvidenceDatabase): (params: unknown) => Promise<import("../lib/tool-response.js").ToolResponse<{
24
+ tags: {
25
+ tag: string;
26
+ count: number;
27
+ }[];
28
+ totalTags: number;
29
+ }>>;
30
+ //# sourceMappingURL=get-tag-stats.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-tag-stats.d.ts","sourceRoot":"","sources":["../../../src/tools/get-tag-stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;CAW7B,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;CAG/B,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,gBAAgB;;;;;;IAqB5D"}
@@ -0,0 +1,33 @@
1
+ import * as z from "zod";
2
+ import { wrapToolHandler } from "../lib/tool-wrapper.js";
3
+ import { createToolResponse } from "../lib/tool-response.js";
4
+ export const getTagStatsSchema = {
5
+ inputSchema: {},
6
+ outputSchema: {
7
+ tags: z.array(z.object({
8
+ tag: z.string(),
9
+ count: z.number(),
10
+ })),
11
+ totalTags: z.number(),
12
+ },
13
+ };
14
+ export const getTagStatsMetadata = {
15
+ title: "Get Tag Statistics",
16
+ description: "Get all unique tags with their usage counts",
17
+ };
18
+ export function createGetTagStatsHandler(db) {
19
+ return wrapToolHandler("get-tag-stats", "Check database connectivity.", async () => {
20
+ const tagCounts = db.getTagCounts();
21
+ const tags = Array.from(tagCounts.entries())
22
+ .map(([tag, count]) => ({ tag, count }))
23
+ .sort((a, b) => b.count - a.count);
24
+ const resultText = tags.length > 0
25
+ ? `📊 Tag Statistics:\n${tags.map((t) => ` • ${t.tag}: ${t.count}`).join("\n")}`
26
+ : `📊 No tags found in any footprint records`;
27
+ return createToolResponse(resultText, {
28
+ tags,
29
+ totalTags: tags.length,
30
+ });
31
+ });
32
+ }
33
+ //# sourceMappingURL=get-tag-stats.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-tag-stats.js","sourceRoot":"","sources":["../../../src/tools/get-tag-stats.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,iBAAiB,GAAG;IAC/B,WAAW,EAAE,EAAE;IACf,YAAY,EAAE;QACZ,IAAI,EAAE,CAAC,CAAC,KAAK,CACX,CAAC,CAAC,MAAM,CAAC;YACP,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;YACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SAClB,CAAC,CACH;QACD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EAAE,6CAA6C;CAC3D,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,EAAoB;IAC3D,OAAO,eAAe,CACpB,eAAe,EACf,8BAA8B,EAC9B,KAAK,IAAI,EAAE;QACT,MAAM,SAAS,GAAG,EAAE,CAAC,YAAY,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;aACzC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;aACvC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAErC,MAAM,UAAU,GACd,IAAI,CAAC,MAAM,GAAG,CAAC;YACb,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;YACjF,CAAC,CAAC,2CAA2C,CAAC;QAElD,OAAO,kBAAkB,CAAC,UAAU,EAAE;YACpC,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Tool handlers for Footprint MCP Server
3
+ * Each tool is extracted to its own module for better maintainability
4
+ */
5
+ export { captureFootprintSchema, captureFootprintMetadata, createCaptureFootprintHandler, } from "./capture-footprint.js";
6
+ export { listFootprintsSchema, listFootprintsMetadata, createListFootprintsHandler, } from "./list-footprints.js";
7
+ export { exportFootprintsSchema, exportFootprintsMetadata, createExportFootprintsHandler, } from "./export-footprints.js";
8
+ export { getFootprintSchema, getFootprintMetadata, createGetFootprintHandler, } from "./get-footprint.js";
9
+ export { searchFootprintsSchema, searchFootprintsMetadata, createSearchFootprintsHandler, } from "./search-footprints.js";
10
+ export { verifyFootprintSchema, verifyFootprintMetadata, createVerifyFootprintHandler, } from "./verify-footprint.js";
11
+ export { suggestCaptureSchema, suggestCaptureMetadata, createSuggestCaptureHandler, } from "./suggest-capture.js";
12
+ export { deleteFootprintsSchema, deleteFootprintsMetadata, createDeleteFootprintsHandler, } from "./delete-footprints.js";
13
+ export { renameTagSchema, renameTagMetadata, createRenameTagHandler, } from "./rename-tag.js";
14
+ export { removeTagSchema, removeTagMetadata, createRemoveTagHandler, } from "./remove-tag.js";
15
+ export { getTagStatsSchema, getTagStatsMetadata, createGetTagStatsHandler, } from "./get-tag-stats.js";
16
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +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"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Tool handlers for Footprint MCP Server
3
+ * Each tool is extracted to its own module for better maintainability
4
+ */
5
+ export { captureFootprintSchema, captureFootprintMetadata, createCaptureFootprintHandler, } from "./capture-footprint.js";
6
+ export { listFootprintsSchema, listFootprintsMetadata, createListFootprintsHandler, } from "./list-footprints.js";
7
+ export { exportFootprintsSchema, exportFootprintsMetadata, createExportFootprintsHandler, } from "./export-footprints.js";
8
+ export { getFootprintSchema, getFootprintMetadata, createGetFootprintHandler, } from "./get-footprint.js";
9
+ export { searchFootprintsSchema, searchFootprintsMetadata, createSearchFootprintsHandler, } from "./search-footprints.js";
10
+ export { verifyFootprintSchema, verifyFootprintMetadata, createVerifyFootprintHandler, } from "./verify-footprint.js";
11
+ export { suggestCaptureSchema, suggestCaptureMetadata, createSuggestCaptureHandler, } from "./suggest-capture.js";
12
+ export { deleteFootprintsSchema, deleteFootprintsMetadata, createDeleteFootprintsHandler, } from "./delete-footprints.js";
13
+ export { renameTagSchema, renameTagMetadata, createRenameTagHandler, } from "./rename-tag.js";
14
+ export { removeTagSchema, removeTagMetadata, createRemoveTagHandler, } from "./remove-tag.js";
15
+ export { getTagStatsSchema, getTagStatsMetadata, createGetTagStatsHandler, } from "./get-tag-stats.js";
16
+ //# sourceMappingURL=index.js.map
@@ -0,0 +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"}
@@ -0,0 +1,57 @@
1
+ import * as z from "zod";
2
+ import type { EvidenceDatabase } from "../lib/storage/index.js";
3
+ export declare const listFootprintsSchema: {
4
+ inputSchema: {
5
+ limit: z.ZodOptional<z.ZodNumber>;
6
+ offset: z.ZodOptional<z.ZodNumber>;
7
+ };
8
+ outputSchema: {
9
+ evidences: z.ZodArray<z.ZodObject<{
10
+ id: z.ZodString;
11
+ timestamp: z.ZodString;
12
+ conversationId: z.ZodString;
13
+ llmProvider: z.ZodString;
14
+ messageCount: z.ZodNumber;
15
+ tags: z.ZodNullable<z.ZodString>;
16
+ }, "strip", z.ZodTypeAny, {
17
+ id: string;
18
+ timestamp: string;
19
+ messageCount: number;
20
+ conversationId: string;
21
+ llmProvider: string;
22
+ tags: string | null;
23
+ }, {
24
+ id: string;
25
+ timestamp: string;
26
+ messageCount: number;
27
+ conversationId: string;
28
+ llmProvider: string;
29
+ tags: string | null;
30
+ }>, "many">;
31
+ total: z.ZodNumber;
32
+ };
33
+ };
34
+ export declare const listFootprintsMetadata: {
35
+ title: string;
36
+ description: string;
37
+ _meta: {
38
+ ui: {
39
+ resourceUri: string;
40
+ };
41
+ };
42
+ };
43
+ export declare function createListFootprintsHandler(db: EvidenceDatabase): (params: {
44
+ limit?: number;
45
+ offset?: number;
46
+ }) => Promise<import("../lib/tool-response.js").ToolResponse<{
47
+ evidences: {
48
+ id: string;
49
+ timestamp: string;
50
+ conversationId: string | null;
51
+ llmProvider: string | null;
52
+ messageCount: number;
53
+ tags: string | null;
54
+ }[];
55
+ total: number;
56
+ }>>;
57
+ //# sourceMappingURL=list-footprints.d.ts.map
@@ -0,0 +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"}
@@ -0,0 +1,57 @@
1
+ import * as z from "zod";
2
+ import { wrapToolHandler } from "../lib/tool-wrapper.js";
3
+ import { formatSuccessResponse } from "../lib/tool-response.js";
4
+ export const listFootprintsSchema = {
5
+ inputSchema: {
6
+ limit: z.number().int().positive().optional().describe("Maximum results"),
7
+ offset: z.number().int().min(0).optional().describe("Pagination offset"),
8
+ },
9
+ outputSchema: {
10
+ evidences: z.array(z.object({
11
+ id: z.string(),
12
+ timestamp: z.string(),
13
+ conversationId: z.string(),
14
+ llmProvider: z.string(),
15
+ messageCount: z.number(),
16
+ tags: z.string().nullable(),
17
+ })),
18
+ total: z.number(),
19
+ },
20
+ };
21
+ export const listFootprintsMetadata = {
22
+ title: "List Footprints",
23
+ description: "List all captured footprint with pagination",
24
+ _meta: {
25
+ ui: {
26
+ resourceUri: "ui://footprint/dashboard.html",
27
+ },
28
+ },
29
+ };
30
+ export function createListFootprintsHandler(db) {
31
+ return wrapToolHandler("list-footprints", "Ensure limit is positive and offset is non-negative.", async (params) => {
32
+ if (params.limit !== undefined && params.limit <= 0) {
33
+ throw new Error("Limit must be positive");
34
+ }
35
+ if (params.offset !== undefined && params.offset < 0) {
36
+ throw new Error("Offset cannot be negative");
37
+ }
38
+ const evidences = db.list({
39
+ limit: params.limit,
40
+ offset: params.offset,
41
+ });
42
+ const mappedEvidences = evidences.map((e) => ({
43
+ id: e.id,
44
+ timestamp: e.timestamp,
45
+ conversationId: e.conversationId,
46
+ llmProvider: e.llmProvider,
47
+ messageCount: e.messageCount,
48
+ tags: e.tags,
49
+ }));
50
+ return formatSuccessResponse("Footprint list retrieved successfully", {
51
+ Count: `${evidences.length} footprint(s)`,
52
+ Limit: params.limit || "No limit",
53
+ Offset: params.offset || 0,
54
+ }, { evidences: mappedEvidences, total: evidences.length });
55
+ });
56
+ }
57
+ //# sourceMappingURL=list-footprints.js.map
@@ -0,0 +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"}
@@ -0,0 +1,22 @@
1
+ import * as z from "zod";
2
+ import type { EvidenceDatabase } from "../lib/storage/index.js";
3
+ export declare const removeTagSchema: {
4
+ inputSchema: {
5
+ tag: z.ZodString;
6
+ };
7
+ outputSchema: {
8
+ updatedCount: z.ZodNumber;
9
+ success: z.ZodBoolean;
10
+ };
11
+ };
12
+ export declare const removeTagMetadata: {
13
+ title: string;
14
+ description: string;
15
+ };
16
+ export declare function createRemoveTagHandler(db: EvidenceDatabase): (params: {
17
+ tag: string;
18
+ }) => Promise<import("../lib/tool-response.js").ToolResponse<{
19
+ updatedCount: number;
20
+ success: boolean;
21
+ }>>;
22
+ //# sourceMappingURL=remove-tag.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"remove-tag.d.ts","sourceRoot":"","sources":["../../../src/tools/remove-tag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,eAAe;;;;;;;;CAQ3B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;CAG7B,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,gBAAgB;SAIjC,MAAM;;;;IAe/B"}
@@ -0,0 +1,30 @@
1
+ import * as z from "zod";
2
+ import { wrapToolHandler } from "../lib/tool-wrapper.js";
3
+ import { createToolResponse } from "../lib/tool-response.js";
4
+ export const removeTagSchema = {
5
+ inputSchema: {
6
+ tag: z.string().min(1).describe("Tag name to remove"),
7
+ },
8
+ outputSchema: {
9
+ updatedCount: z.number(),
10
+ success: z.boolean(),
11
+ },
12
+ };
13
+ export const removeTagMetadata = {
14
+ title: "Remove Tag",
15
+ description: "Remove a tag from all footprint records",
16
+ };
17
+ export function createRemoveTagHandler(db) {
18
+ return wrapToolHandler("remove-tag", "Ensure tag name is valid.", async (params) => {
19
+ if (!params.tag) {
20
+ throw new Error("Tag name is required");
21
+ }
22
+ const updatedCount = db.removeTag(params.tag.trim());
23
+ const success = updatedCount > 0;
24
+ const resultText = success
25
+ ? `🗑️ Removed tag "${params.tag}" from ${updatedCount} footprint record${updatedCount > 1 ? "s" : ""}`
26
+ : `⚠️ No footprint records found with tag "${params.tag}"`;
27
+ return createToolResponse(resultText, { updatedCount, success });
28
+ });
29
+ }
30
+ //# sourceMappingURL=remove-tag.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"remove-tag.js","sourceRoot":"","sources":["../../../src/tools/remove-tag.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,eAAe,GAAG;IAC7B,WAAW,EAAE;QACX,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;KACtD;IACD,YAAY,EAAE;QACZ,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;KACrB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAE,YAAY;IACnB,WAAW,EAAE,yCAAyC;CACvD,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,EAAoB;IACzD,OAAO,eAAe,CACpB,YAAY,EACZ,2BAA2B,EAC3B,KAAK,EAAE,MAAuB,EAAE,EAAE;QAChC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,YAAY,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,YAAY,GAAG,CAAC,CAAC;QAEjC,MAAM,UAAU,GAAG,OAAO;YACxB,CAAC,CAAC,oBAAoB,MAAM,CAAC,GAAG,UAAU,YAAY,oBAAoB,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACvG,CAAC,CAAC,2CAA2C,MAAM,CAAC,GAAG,GAAG,CAAC;QAE7D,OAAO,kBAAkB,CAAC,UAAU,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,24 @@
1
+ import * as z from "zod";
2
+ import type { EvidenceDatabase } from "../lib/storage/index.js";
3
+ export declare const renameTagSchema: {
4
+ inputSchema: {
5
+ oldTag: z.ZodString;
6
+ newTag: z.ZodString;
7
+ };
8
+ outputSchema: {
9
+ updatedCount: z.ZodNumber;
10
+ success: z.ZodBoolean;
11
+ };
12
+ };
13
+ export declare const renameTagMetadata: {
14
+ title: string;
15
+ description: string;
16
+ };
17
+ export declare function createRenameTagHandler(db: EvidenceDatabase): (params: {
18
+ oldTag: string;
19
+ newTag: string;
20
+ }) => Promise<import("../lib/tool-response.js").ToolResponse<{
21
+ updatedCount: number;
22
+ success: boolean;
23
+ }>>;
24
+ //# sourceMappingURL=rename-tag.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rename-tag.d.ts","sourceRoot":"","sources":["../../../src/tools/rename-tag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,eAAe;;;;;;;;;CAS3B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;CAG7B,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,gBAAgB;YAI9B,MAAM;YAAU,MAAM;;;;IAsBlD"}
@@ -0,0 +1,34 @@
1
+ import * as z from "zod";
2
+ import { wrapToolHandler } from "../lib/tool-wrapper.js";
3
+ import { createToolResponse } from "../lib/tool-response.js";
4
+ export const renameTagSchema = {
5
+ inputSchema: {
6
+ oldTag: z.string().min(1).describe("Current tag name to rename"),
7
+ newTag: z.string().min(1).describe("New tag name"),
8
+ },
9
+ outputSchema: {
10
+ updatedCount: z.number(),
11
+ success: z.boolean(),
12
+ },
13
+ };
14
+ export const renameTagMetadata = {
15
+ title: "Rename Tag",
16
+ description: "Rename a tag across all footprint records",
17
+ };
18
+ export function createRenameTagHandler(db) {
19
+ return wrapToolHandler("rename-tag", "Ensure tag names are valid and different.", async (params) => {
20
+ if (!params.oldTag || !params.newTag) {
21
+ throw new Error("Both old and new tag names are required");
22
+ }
23
+ if (params.oldTag.trim() === params.newTag.trim()) {
24
+ throw new Error("New tag must be different from old tag");
25
+ }
26
+ const updatedCount = db.renameTag(params.oldTag.trim(), params.newTag.trim());
27
+ const success = updatedCount > 0;
28
+ const resultText = success
29
+ ? `🏷️ Renamed tag "${params.oldTag}" to "${params.newTag}" in ${updatedCount} footprint record${updatedCount > 1 ? "s" : ""}`
30
+ : `⚠️ No footprint records found with tag "${params.oldTag}"`;
31
+ return createToolResponse(resultText, { updatedCount, success });
32
+ });
33
+ }
34
+ //# sourceMappingURL=rename-tag.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rename-tag.js","sourceRoot":"","sources":["../../../src/tools/rename-tag.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,eAAe,GAAG;IAC7B,WAAW,EAAE;QACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QAChE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;KACnD;IACD,YAAY,EAAE;QACZ,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;KACrB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAE,YAAY;IACnB,WAAW,EAAE,2CAA2C;CACzD,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,EAAoB;IACzD,OAAO,eAAe,CACpB,YAAY,EACZ,2CAA2C,EAC3C,KAAK,EAAE,MAA0C,EAAE,EAAE;QACnD,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,YAAY,GAAG,EAAE,CAAC,SAAS,CAC/B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EACpB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CACrB,CAAC;QACF,MAAM,OAAO,GAAG,YAAY,GAAG,CAAC,CAAC;QAEjC,MAAM,UAAU,GAAG,OAAO;YACxB,CAAC,CAAC,oBAAoB,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,QAAQ,YAAY,oBAAoB,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC9H,CAAC,CAAC,2CAA2C,MAAM,CAAC,MAAM,GAAG,CAAC;QAEhE,OAAO,kBAAkB,CAAC,UAAU,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC,CACF,CAAC;AACJ,CAAC"}