@pcircle/footprint 1.3.0 → 1.6.0

package/dist/src/tools/reject-context-link.d.ts

@@ -0,0 +1,58 @@
+import * as z from "zod";
+import type { EvidenceDatabase } from "../lib/storage/index.js";
+export declare const rejectContextLinkSchema: {
+    inputSchema: {
+        sessionId: z.ZodString;
+        contextId: z.ZodString;
+    };
+    outputSchema: {
+        action: z.ZodEnum<{
+            rejected: "rejected";
+            merged: "merged";
+            confirmed: "confirmed";
+            moved: "moved";
+            split: "split";
+            preferred: "preferred";
+        }>;
+        context: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            workspaceKey: z.ZodString;
+            latestSessionId: z.ZodString;
+            latestSessionLabel: z.ZodString;
+            latestStartedAt: z.ZodString;
+            latestEndedAt: z.ZodNullable<z.ZodString>;
+            sessionCount: z.ZodNumber;
+            hosts: z.ZodArray<z.ZodEnum<{
+                claude: "claude";
+                gemini: "gemini";
+                codex: "codex";
+            }>>;
+            statuses: z.ZodArray<z.ZodEnum<{
+                running: "running";
+                completed: "completed";
+                failed: "failed";
+                interrupted: "interrupted";
+            }>>;
+            confidence: z.ZodEnum<{
+                high: "high";
+                medium: "medium";
+                low: "low";
+            }>;
+            confidenceScore: z.ZodNumber;
+            signals: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+        affectedSessionIds: z.ZodArray<z.ZodString>;
+        contextId: z.ZodNullable<z.ZodString>;
+        mergedFromContextId: z.ZodNullable<z.ZodString>;
+    };
+};
+export declare const rejectContextLinkMetadata: {
+    title: string;
+    description: string;
+};
+export declare function createRejectContextLinkHandler(db: EvidenceDatabase): (params: {
+    sessionId: string;
+    contextId: string;
+}) => Promise<import("../lib/tool-response.js").ToolResponse<import("../lib/context-memory.js").ContextLinkMutationResult>>;
+//# sourceMappingURL=reject-context-link.d.ts.map

package/dist/src/tools/reject-context-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reject-context-link.d.ts","sourceRoot":"","sources":["../../../src/tools/reject-context-link.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMnC,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;CAIrC,CAAC;AAEF,wBAAgB,8BAA8B,CAAC,EAAE,EAAE,gBAAgB;eAInC,MAAM;eAAa,MAAM;4HAiBxD"}

package/dist/src/tools/reject-context-link.js

@@ -0,0 +1,26 @@
+import * as z from "zod";
+import { rejectContextLink } from "../lib/context-memory.js";
+import { formatSuccessResponse } from "../lib/tool-response.js";
+import { wrapToolHandler } from "../lib/tool-wrapper.js";
+import { contextMutationSchema } from "./context-schemas.js";
+export const rejectContextLinkSchema = {
+    inputSchema: {
+        sessionId: z.string().min(1, "sessionId is required"),
+        contextId: z.string().min(1, "contextId is required"),
+    },
+    outputSchema: contextMutationSchema.shape,
+};
+export const rejectContextLinkMetadata = {
+    title: "Reject Context Link",
+    description: "Reject a suggested session/context pair so Footprint does not keep proposing the same incorrect link.",
+};
+export function createRejectContextLinkHandler(db) {
+    return wrapToolHandler("reject-context-link", "Persist a negative correction for a suggested session/context pair.", async (params) => {
+        const result = rejectContextLink(db, params.sessionId.trim(), params.contextId.trim());
+        return formatSuccessResponse("Context link rejected successfully", {
+            Session: result.affectedSessionIds[0] ?? "unknown",
+            Context: result.contextId ?? "unknown",
+        }, result);
+    });
+}
+//# sourceMappingURL=reject-context-link.js.map

package/dist/src/tools/reject-context-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reject-context-link.js","sourceRoot":"","sources":["../../../src/tools/reject-context-link.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,WAAW,EAAE;QACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC;QACrD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC;KACtD;IACD,YAAY,EAAE,qBAAqB,CAAC,KAAK;CAC1C,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EACT,uGAAuG;CAC1G,CAAC;AAEF,MAAM,UAAU,8BAA8B,CAAC,EAAoB;IACjE,OAAO,eAAe,CACpB,qBAAqB,EACrB,qEAAqE,EACrE,KAAK,EAAE,MAAgD,EAAE,EAAE;QACzD,MAAM,MAAM,GAAG,iBAAiB,CAC9B,EAAE,EACF,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,EACvB,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CACxB,CAAC;QAEF,OAAO,qBAAqB,CAC1B,oCAAoC,EACpC;YACE,OAAO,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,SAAS;YAClD,OAAO,EAAE,MAAM,CAAC,SAAS,IAAI,SAAS;SACvC,EACD,MAAM,CACP,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/src/tools/resolve-context.d.ts

@@ -0,0 +1,287 @@
+import * as z from "zod";
+import type { EvidenceDatabase, SessionHost } from "../lib/storage/index.js";
+export declare const resolveContextSchema: {
+    inputSchema: {
+        sessionId: z.ZodOptional<z.ZodString>;
+        cwd: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        host: z.ZodOptional<z.ZodEnum<{
+            claude: "claude";
+            gemini: "gemini";
+            codex: "codex";
+        }>>;
+    };
+    outputSchema: {
+        mode: z.ZodEnum<{
+            preferred: "preferred";
+            linked: "linked";
+            suggested: "suggested";
+            none: "none";
+        }>;
+        sessionId: z.ZodNullable<z.ZodString>;
+        cwd: z.ZodNullable<z.ZodString>;
+        confirmationRequired: z.ZodBoolean;
+        recommendedAction: z.ZodEnum<{
+            none: "none";
+            "use-linked": "use-linked";
+            "use-preferred": "use-preferred";
+            "confirm-existing": "confirm-existing";
+            "create-new-context": "create-new-context";
+            "choose-candidate": "choose-candidate";
+        }>;
+        linkedContextId: z.ZodNullable<z.ZodString>;
+        currentContext: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            workspaceKey: z.ZodString;
+            latestSessionId: z.ZodString;
+            latestSessionLabel: z.ZodString;
+            latestStartedAt: z.ZodString;
+            latestEndedAt: z.ZodNullable<z.ZodString>;
+            sessionCount: z.ZodNumber;
+            hosts: z.ZodArray<z.ZodEnum<{
+                claude: "claude";
+                gemini: "gemini";
+                codex: "codex";
+            }>>;
+            statuses: z.ZodArray<z.ZodEnum<{
+                running: "running";
+                completed: "completed";
+                failed: "failed";
+                interrupted: "interrupted";
+            }>>;
+            confidence: z.ZodEnum<{
+                high: "high";
+                medium: "medium";
+                low: "low";
+            }>;
+            confidenceScore: z.ZodNumber;
+            signals: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+        briefing: z.ZodNullable<z.ZodObject<{
+            context: z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                workspaceKey: z.ZodString;
+                latestSessionId: z.ZodString;
+                latestSessionLabel: z.ZodString;
+                latestStartedAt: z.ZodString;
+                latestEndedAt: z.ZodNullable<z.ZodString>;
+                sessionCount: z.ZodNumber;
+                hosts: z.ZodArray<z.ZodEnum<{
+                    claude: "claude";
+                    gemini: "gemini";
+                    codex: "codex";
+                }>>;
+                statuses: z.ZodArray<z.ZodEnum<{
+                    running: "running";
+                    completed: "completed";
+                    failed: "failed";
+                    interrupted: "interrupted";
+                }>>;
+                confidence: z.ZodEnum<{
+                    high: "high";
+                    medium: "medium";
+                    low: "low";
+                }>;
+                confidenceScore: z.ZodNumber;
+                signals: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>;
+            currentTruth: z.ZodObject<{
+                summary: z.ZodString;
+                latestSessionId: z.ZodString;
+                latestSessionLabel: z.ZodString;
+                latestSummaryNarrative: z.ZodNullable<z.ZodString>;
+                latestHandoff: z.ZodNullable<z.ZodString>;
+                activeBlockers: z.ZodArray<z.ZodString>;
+                openQuestions: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>;
+            activeDecisions: z.ZodArray<z.ZodObject<{
+                decisionId: z.ZodString;
+                topic: z.ZodString;
+                sessionId: z.ZodString;
+                sessionLabel: z.ZodString;
+                title: z.ZodString;
+                summary: z.ZodString;
+                rationale: z.ZodNullable<z.ZodString>;
+                status: z.ZodEnum<{
+                    proposed: "proposed";
+                    accepted: "accepted";
+                    rejected: "rejected";
+                    open: "open";
+                }>;
+                createdAt: z.ZodString;
+            }, z.core.$strip>>;
+            supersededDecisions: z.ZodArray<z.ZodObject<{
+                decisionId: z.ZodString;
+                topic: z.ZodString;
+                sessionId: z.ZodString;
+                sessionLabel: z.ZodString;
+                title: z.ZodString;
+                summary: z.ZodString;
+                rationale: z.ZodNullable<z.ZodString>;
+                status: z.ZodEnum<{
+                    proposed: "proposed";
+                    accepted: "accepted";
+                    rejected: "rejected";
+                    open: "open";
+                }>;
+                createdAt: z.ZodString;
+                supersededByDecisionId: z.ZodNullable<z.ZodString>;
+                supersededByTitle: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            changeLog: z.ZodArray<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    "decision-updated": "decision-updated";
+                    "context-refreshed": "context-refreshed";
+                }>;
+                summary: z.ZodString;
+                sessionId: z.ZodNullable<z.ZodString>;
+                sessionLabel: z.ZodNullable<z.ZodString>;
+                createdAt: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            sessions: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                host: z.ZodEnum<{
+                    claude: "claude";
+                    gemini: "gemini";
+                    codex: "codex";
+                }>;
+                status: z.ZodEnum<{
+                    running: "running";
+                    completed: "completed";
+                    failed: "failed";
+                    interrupted: "interrupted";
+                }>;
+                startedAt: z.ZodString;
+                endedAt: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            trends: z.ZodArray<z.ZodObject<{
+                groupBy: z.ZodEnum<{
+                    issue: "issue";
+                    family: "family";
+                }>;
+                issueKey: z.ZodString;
+                label: z.ZodString;
+                kind: z.ZodNullable<z.ZodString>;
+                relatedIssueKeys: z.ZodArray<z.ZodString>;
+                blockerCategory: z.ZodString;
+                blockerState: z.ZodEnum<{
+                    active: "active";
+                    resolved: "resolved";
+                }>;
+                remediationState: z.ZodEnum<{
+                    unresolved: "unresolved";
+                    recovered: "recovered";
+                    regressed: "regressed";
+                    stable: "stable";
+                }>;
+                remediationSummary: z.ZodString;
+                latestOutcome: z.ZodString;
+                latestFailureAt: z.ZodNullable<z.ZodString>;
+                latestSuccessAt: z.ZodNullable<z.ZodString>;
+                lastSeenAt: z.ZodString;
+                attemptCount: z.ZodNumber;
+                sessionCount: z.ZodNumber;
+                failedAttempts: z.ZodNumber;
+                succeededAttempts: z.ZodNumber;
+                otherAttempts: z.ZodNumber;
+                hosts: z.ZodArray<z.ZodEnum<{
+                    claude: "claude";
+                    gemini: "gemini";
+                    codex: "codex";
+                }>>;
+                statuses: z.ZodArray<z.ZodEnum<{
+                    running: "running";
+                    completed: "completed";
+                    failed: "failed";
+                    interrupted: "interrupted";
+                }>>;
+                sessions: z.ZodArray<z.ZodObject<{
+                    sessionId: z.ZodString;
+                    label: z.ZodString;
+                    host: z.ZodEnum<{
+                        claude: "claude";
+                        gemini: "gemini";
+                        codex: "codex";
+                    }>;
+                    status: z.ZodEnum<{
+                        running: "running";
+                        completed: "completed";
+                        failed: "failed";
+                        interrupted: "interrupted";
+                    }>;
+                    startedAt: z.ZodString;
+                    lastAttemptAt: z.ZodString;
+                    attempts: z.ZodNumber;
+                    latestOutcome: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            handoff: z.ZodObject<{
+                summary: z.ZodObject<{
+                    groupBy: z.ZodEnum<{
+                        issue: "issue";
+                        family: "family";
+                    }>;
+                    headline: z.ZodString;
+                    matchingSessions: z.ZodNumber;
+                    matchingHosts: z.ZodArray<z.ZodEnum<{
+                        claude: "claude";
+                        gemini: "gemini";
+                        codex: "codex";
+                    }>>;
+                    statuses: z.ZodArray<z.ZodEnum<{
+                        running: "running";
+                        completed: "completed";
+                        failed: "failed";
+                        interrupted: "interrupted";
+                    }>>;
+                    totalTrends: z.ZodNumber;
+                    blockingTrends: z.ZodNumber;
+                    recoveredTrends: z.ZodNumber;
+                    regressedTrends: z.ZodNumber;
+                    unresolvedQuestions: z.ZodNumber;
+                    latestSessionId: z.ZodNullable<z.ZodString>;
+                    latestSessionLabel: z.ZodNullable<z.ZodString>;
+                    latestStartedAt: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>;
+                followUps: z.ZodArray<z.ZodString>;
+                blockers: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>;
+            markdown: z.ZodString;
+        }, z.core.$strip>>;
+        candidates: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                "existing-context": "existing-context";
+                "new-context": "new-context";
+            }>;
+            contextId: z.ZodNullable<z.ZodString>;
+            label: z.ZodString;
+            workspaceKey: z.ZodString;
+            confidence: z.ZodEnum<{
+                high: "high";
+                medium: "medium";
+                low: "low";
+            }>;
+            confidenceScore: z.ZodNumber;
+            reasons: z.ZodArray<z.ZodString>;
+            sessionIds: z.ZodArray<z.ZodString>;
+            latestSessionId: z.ZodNullable<z.ZodString>;
+            latestSessionLabel: z.ZodNullable<z.ZodString>;
+            preferred: z.ZodBoolean;
+            confirmationRequired: z.ZodBoolean;
+        }, z.core.$strip>>;
+    };
+};
+export declare const resolveContextMetadata: {
+    title: string;
+    description: string;
+};
+export declare function createResolveContextHandler(db: EvidenceDatabase): (params: {
+    sessionId?: string;
+    cwd?: string;
+    title?: string;
+    host?: SessionHost;
+}) => Promise<import("../lib/tool-response.js").ToolResponse<import("../lib/context-memory.js").ContextResolution>>;
+//# sourceMappingURL=resolve-context.d.ts.map

package/dist/src/tools/resolve-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-context.d.ts","sourceRoot":"","sources":["../../../src/tools/resolve-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG7E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQhC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;CAIlC,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,gBAAgB;gBAK9C,MAAM;UACZ,MAAM;YACJ,MAAM;WACP,WAAW;oHAqBvB"}

package/dist/src/tools/resolve-context.js

@@ -0,0 +1,35 @@
+import * as z from "zod";
+import { resolveContext } from "../lib/context-memory.js";
+import { formatSuccessResponse } from "../lib/tool-response.js";
+import { wrapToolHandler } from "../lib/tool-wrapper.js";
+import { contextResolutionSchema, sessionHostEnum } from "./context-schemas.js";
+export const resolveContextSchema = {
+    inputSchema: {
+        sessionId: z.string().optional(),
+        cwd: z.string().optional(),
+        title: z.string().optional(),
+        host: sessionHostEnum.optional(),
+    },
+    outputSchema: contextResolutionSchema.shape,
+};
+export const resolveContextMetadata = {
+    title: "Resolve Context",
+    description: "Resolve the most likely Footprint context for a session or workspace. Returns candidates and whether the client should ask the user to confirm.",
+};
+export function createResolveContextHandler(db) {
+    return wrapToolHandler("resolve-context", "Provide sessionId or cwd. If confirmationRequired is true, the client should ask the user instead of assuming the correct context.", async (params) => {
+        const result = resolveContext(db, {
+            sessionId: params.sessionId?.trim() || undefined,
+            cwd: params.cwd?.trim() || undefined,
+            title: params.title?.trim() || undefined,
+            host: params.host,
+        });
+        return formatSuccessResponse("Context resolution completed", {
+            Mode: result.mode,
+            ConfirmationRequired: result.confirmationRequired ? "yes" : "no",
+            RecommendedAction: result.recommendedAction,
+            Candidates: result.candidates.length,
+        }, result);
+    });
+}
+//# sourceMappingURL=resolve-context.js.map

package/dist/src/tools/resolve-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-context.js","sourceRoot":"","sources":["../../../src/tools/resolve-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,WAAW,EAAE;QACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5B,IAAI,EAAE,eAAe,CAAC,QAAQ,EAAE;KACjC;IACD,YAAY,EAAE,uBAAuB,CAAC,KAAK;CAC5C,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,iJAAiJ;CACpJ,CAAC;AAEF,MAAM,UAAU,2BAA2B,CAAC,EAAoB;IAC9D,OAAO,eAAe,CACpB,iBAAiB,EACjB,oIAAoI,EACpI,KAAK,EAAE,MAKN,EAAE,EAAE;QACH,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,EAAE;YAChC,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,SAAS;YAChD,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,SAAS;YACpC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,SAAS;YACxC,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC,CAAC;QAEH,OAAO,qBAAqB,CAC1B,8BAA8B,EAC9B;YACE,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,oBAAoB,EAAE,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;YAChE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;YAC3C,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM;SACrC,EACD,MAAM,CACP,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

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

@@ -3,7 +3,7 @@ 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>;
@@ -17,21 +17,7 @@ export declare const searchFootprintsSchema: {
             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/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,10 +6,19 @@ 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"),
     },
@@ -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 evidences = 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,
@@ -72,7 +88,7 @@ export function createSearchFootprintsHandler(db) {
             Query: params.query || "None",
             Tags: params.tags?.join(", ") || "None",
             "Date Range": `${params.dateFrom || "Start"} to ${params.dateTo || "End"}`,
-        }, { evidences: mappedEvidences, total: evidences.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/search-history.d.ts

@@ -0,0 +1,86 @@
+import * as z from "zod";
+import type { EvidenceDatabase, SessionHost, SessionStatus } from "../lib/storage/index.js";
+export declare const searchHistorySchema: {
+    inputSchema: {
+        query: z.ZodString;
+        host: z.ZodOptional<z.ZodEnum<{
+            claude: "claude";
+            gemini: "gemini";
+            codex: "codex";
+        }>>;
+        status: z.ZodOptional<z.ZodEnum<{
+            running: "running";
+            completed: "completed";
+            failed: "failed";
+            interrupted: "interrupted";
+        }>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+    };
+    outputSchema: {
+        query: z.ZodString;
+        filters: z.ZodObject<{
+            host: z.ZodOptional<z.ZodEnum<{
+                claude: "claude";
+                gemini: "gemini";
+                codex: "codex";
+            }>>;
+            status: z.ZodOptional<z.ZodEnum<{
+                running: "running";
+                completed: "completed";
+                failed: "failed";
+                interrupted: "interrupted";
+            }>>;
+        }, z.core.$strip>;
+        results: z.ZodArray<z.ZodObject<{
+            sessionId: z.ZodString;
+            host: z.ZodEnum<{
+                claude: "claude";
+                gemini: "gemini";
+                codex: "codex";
+            }>;
+            label: z.ZodString;
+            status: z.ZodEnum<{
+                running: "running";
+                completed: "completed";
+                failed: "failed";
+                interrupted: "interrupted";
+            }>;
+            startedAt: z.ZodString;
+            snippets: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+        total: z.ZodNumber;
+    };
+};
+export declare const searchHistoryMetadata: {
+    _meta: {
+        readonly ui: {
+            readonly resourceUri: "ui://footprint/session-dashboard.html";
+        };
+    };
+    title: string;
+    description: string;
+};
+export declare function createSearchHistoryHandler(db: EvidenceDatabase): (params: {
+    query: string;
+    host?: SessionHost;
+    status?: SessionStatus;
+    limit?: number;
+    offset?: number;
+}) => Promise<import("../lib/tool-response.js").ToolResponse<{
+    query: string;
+    filters: {
+        host: SessionHost | undefined;
+        status: SessionStatus | undefined;
+    };
+    results: {
+        sessionId: string;
+        host: SessionHost;
+        label: string;
+        status: SessionStatus;
+        startedAt: string;
+        snippets: string[];
+    }[];
+    total: number;
+}>>;
+//# sourceMappingURL=search-history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-history.d.ts","sourceRoot":"","sources":["../../../src/tools/search-history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAKzB,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,aAAa,EACd,MAAM,yBAAyB,CAAC;AAcjC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsC/B,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;CAKjC,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,gBAAgB;WAKlD,MAAM;WACN,WAAW;aACT,aAAa;YACd,MAAM;aACL,MAAM;;;;;;;;;;;;;;;;IA0DpB"}