@pcircle/footprint 1.3.0 → 1.6.0

package/dist/src/prompts/skill-prompt.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register all Footprint MCP prompts on the server.
+ */
+export declare function registerSkillPrompts(server: McpServer): void;
+//# sourceMappingURL=skill-prompt.d.ts.map

package/dist/src/prompts/skill-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-prompt.d.ts","sourceRoot":"","sources":["../../../src/prompts/skill-prompt.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8DzE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyF5D"}

package/dist/src/prompts/skill-prompt.js

@@ -0,0 +1,138 @@
+import { fileURLToPath } from "url";
+import * as path from "path";
+import * as fs from "fs";
+import * as z from "zod";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Resolve SKILL.md from the package root.
+ * Handles both dev (src/prompts/) and built (dist/prompts/) paths.
+ */
+function findSkillMd() {
+    const candidates = [
+        path.resolve(__dirname, "../../SKILL.md"), // from dist/prompts/ or src/prompts/
+        path.resolve(__dirname, "../../../SKILL.md"), // fallback
+    ];
+    for (const p of candidates) {
+        if (fs.existsSync(p))
+            return fs.readFileSync(p, "utf-8");
+    }
+    throw new Error("SKILL.md not found");
+}
+const QUICK_REFERENCE = `# Footprint Quick Reference
+
+## Decision Tree
+Should I capture this conversation?
+\u251C\u2500 User explicitly asked \u2192 YES (capture immediately)
+\u251C\u2500 High-value content (IP/Legal/Business/Research/Compliance) \u2192 SUGGEST to user
+\u251C\u2500 Casual chat/small talk \u2192 NO
+\u2514\u2500 Uncertain \u2192 ASK user
+
+Should I reuse prior work context?
+\u251C\u2500 Continuing or resuming work \u2192 resolve-context first
+\u251C\u2500 resolve-context says confirmationRequired \u2192 ASK user
+\u251C\u2500 In interactive CLI, use context prepare / run --prepare-context to ask before recording
+\u251C\u2500 No strong candidate \u2192 create or confirm a new context
+\u2514\u2500 User corrected the context before \u2192 trust confirmed context, not guesswork
+
+## Tool Selection
+- Save conversation \u2192 capture-footprint
+- Browse/overview \u2192 list-footprints
+- Full content retrieval \u2192 get-footprint
+- Find by query/tags/dates \u2192 search-footprints
+- Legal/audit export \u2192 export-footprints
+- Session browse/detail \u2192 list-sessions / get-session
+- Session handoff export \u2192 export-sessions
+- Resolve likely work context \u2192 resolve-context
+- Inspect confirmed context briefing \u2192 list-contexts / get-context
+- Confirm or correct session-to-context links \u2192 confirm-context-link / reject-context-link / move-session-context
+- Reorganize contexts \u2192 merge-contexts / split-context / set-active-context
+- Verify integrity \u2192 verify-footprint
+- Tag management \u2192 manage-tags (stats/rename/remove)
+- Keyword pre-filter \u2192 suggest-capture
+- Semantic assessment \u2192 Use footprint-should-capture prompt
+
+## Tag Conventions
+Format: 3-6 tags, comma-separated
+Types: decision, milestone, research, review, approval
+Domains: api, ui, database, security, legal, business
+Status: draft, finalized, approved, rejected
+
+## conversationId Format
+{topic-type}-{descriptive-name}-{YYYY-MM-DD}`;
+/**
+ * Register all Footprint MCP prompts on the server.
+ */
+export function registerSkillPrompts(server) {
+    const skillContent = findSkillMd();
+    // Full SKILL.md content
+    server.registerPrompt("footprint-skill", {
+        description: "Complete Footprint agent skill guide — decision tree, tool reference, best practices, error recovery, and workflow examples",
+    }, async () => ({
+        messages: [
+            {
+                role: "user",
+                content: { type: "text", text: skillContent },
+            },
+        ],
+    }));
+    // Condensed quick reference
+    server.registerPrompt("footprint-quick-ref", {
+        description: "Condensed quick reference for Footprint — decision tree, tool selection, tag conventions",
+    }, async () => ({
+        messages: [
+            {
+                role: "user",
+                content: { type: "text", text: QUICK_REFERENCE },
+            },
+        ],
+    }));
+    // Semantic capture decision framework
+    server.registerPrompt("footprint-should-capture", {
+        description: "Semantic decision framework for whether to capture a conversation as evidence. Provides structured criteria for the AI to assess, unlike suggest-capture which uses keyword matching.",
+        argsSchema: {
+            conversationSummary: z
+                .string()
+                .min(1, "Conversation summary cannot be empty")
+                .max(10000, "Conversation summary too long (max 10000 characters)")
+                .describe("Brief summary of the conversation content to evaluate"),
+        },
+    }, async ({ conversationSummary }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Evaluate whether this conversation should be captured as evidence using Footprint.
+
+## Conversation Summary
+${conversationSummary}
+
+## Decision Criteria
+Rate each category 0-3 (0=none, 1=low, 2=medium, 3=high):
+
+1. **Intellectual Property Value**: Does it contain inventions, algorithms, novel approaches, patents, trade secrets?
+2. **Legal Significance**: Does it involve contracts, agreements, licenses, legal obligations, regulatory requirements?
+3. **Business Decision Impact**: Does it record decisions, approvals, milestones, deliverables, strategic direction?
+4. **Research Value**: Does it contain hypotheses, findings, experimental results, data analysis, methodology?
+5. **Compliance/Audit Need**: Does it need to be documented for audit trails, regulatory compliance, evidence preservation?
+
+## Decision Rules
+- Any category >= 2 \u2192 RECOMMEND CAPTURE
+- Multiple categories >= 1 \u2192 RECOMMEND CAPTURE
+- All categories = 0 \u2192 DO NOT CAPTURE
+- Uncertain \u2192 ASK USER
+
+## Response Format
+Respond with:
+- **Capture**: yes/no/ask
+- **Confidence**: 0.0-1.0
+- **Primary Reason**: One sentence
+- **Suggested Tags**: comma-separated
+- **Suggested conversationId**: {topic}-{descriptor}-{YYYY-MM-DD} format`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=skill-prompt.js.map

package/dist/src/prompts/skill-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-prompt.js","sourceRoot":"","sources":["../../../src/prompts/skill-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C;;;GAGG;AACH,SAAS,WAAW;IAClB,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,gBAAgB,CAAC,EAAE,qCAAqC;QAChF,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,mBAAmB,CAAC,EAAE,WAAW;KAC1D,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6CAwCqB,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,YAAY,GAAG,WAAW,EAAE,CAAC;IAEnC,wBAAwB;IACxB,MAAM,CAAC,cAAc,CACnB,iBAAiB,EACjB;QACE,WAAW,EACT,6HAA6H;KAChI,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,YAAY,EAAE;aACvD;SACF;KACF,CAAC,CACH,CAAC;IAEF,4BAA4B;IAC5B,MAAM,CAAC,cAAc,CACnB,qBAAqB,EACrB;QACE,WAAW,EACT,0FAA0F;KAC7F,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,eAAe,EAAE;aAC1D;SACF;KACF,CAAC,CACH,CAAC;IAEF,sCAAsC;IACtC,MAAM,CAAC,cAAc,CACnB,0BAA0B,EAC1B;QACE,WAAW,EACT,uLAAuL;QACzL,UAAU,EAAE;YACV,mBAAmB,EAAE,CAAC;iBACnB,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,EAAE,sCAAsC,CAAC;iBAC9C,GAAG,CAAC,KAAK,EAAE,sDAAsD,CAAC;iBAClE,QAAQ,CAAC,uDAAuD,CAAC;SACrE;KACF,EACD,KAAK,EAAE,EAAE,mBAAmB,EAAE,EAAE,EAAE,CAAC,CAAC;QAClC,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE;;;EAGhB,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;yEAuBoD;iBAC9D;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

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

@@ -4,9 +4,9 @@ import type { CaptureEvidenceParams } from "../types.js";
 export declare const captureFootprintSchema: {
     inputSchema: {
         conversationId: z.ZodString;
-        llmProvider: z.ZodString;
+        llmProvider: z.ZodDefault<z.ZodString>;
         content: z.ZodString;
-        messageCount: z.ZodNumber;
+        messageCount: z.ZodOptional<z.ZodNumber>;
         tags: z.ZodOptional<z.ZodString>;
     };
     outputSchema: {

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

@@ -1 +1 @@
-{"version":3,"file":"capture-footprint.d.ts","sourceRoot":"","sources":["../../../src/tools/capture-footprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAKzB,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;CAkBlC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;CAGpC,CAAC;AAEF,wBAAgB,6BAA6B,CAC3C,EAAE,EAAE,gBAAgB,EACpB,aAAa,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC;;;;;IAmFzC"}
+{"version":3,"file":"capture-footprint.d.ts","sourceRoot":"","sources":["../../../src/tools/capture-footprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAKzB,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;CAyClC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;CAIpC,CAAC;AAEF,wBAAgB,6BAA6B,CAC3C,EAAE,EAAE,gBAAgB,EACpB,aAAa,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC;;;;;IAyHzC"}

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

@@ -6,15 +6,28 @@ import { encrypt } from "../lib/crypto/index.js";
 import { getCurrentCommit, } from "../lib/storage/index.js";
 export const captureFootprintSchema = {
     inputSchema: {
-        conversationId: z.string().describe("Conversation ID"),
+        conversationId: z
+            .string()
+            .max(500, "Conversation ID too long (max 500 chars)")
+            .describe("Unique conversation identifier. Recommended format: {topic}-{descriptor}-{YYYY-MM-DD} (e.g., api-auth-decision-2026-01-28)"),
         llmProvider: z
             .string()
-            .describe("LLM provider name (e.g., Claude Sonnet 4.5)"),
+            .default("unknown")
+            .describe("LLM provider name (e.g., Claude Sonnet 4.5). Defaults to 'unknown' if not specified."),
         content: z
             .string()
-            .describe("Conversation content (messages, prompts, responses)"),
-        messageCount: z.number().int().positive().describe("Number of messages"),
-        tags: z.string().optional().describe("Optional tags (comma-separated)"),
+            .max(10 * 1024 * 1024, "Content exceeds 10MB limit")
+            .describe("Full conversation text including both human and assistant messages. Include complete message history for accurate evidence preservation."),
+        messageCount: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Number of messages in the conversation. If omitted, auto-calculated by counting conversation turn markers (Human:/Assistant:/User:/AI:/System:)."),
+        tags: z
+            .string()
+            .optional()
+            .describe("Comma-separated tags for categorization (e.g., 'ip,patent,decision'). Use 3-6 tags. Common types: decision, milestone, research, legal, compliance."),
     },
     outputSchema: {
         id: z.string(),
@@ -25,7 +38,7 @@ export const captureFootprintSchema = {
 };
 export const captureFootprintMetadata = {
     title: "Capture Footprint",
-    description: "Capture and encrypt LLM conversation as footprint",
+    description: "Capture and encrypt an LLM conversation as a tamper-evident footprint. Use when: user explicitly asks to save, or high-value content detected (IP, legal, business, research, compliance). Creates encrypted record with SHA-256 hash and Git timestamp anchor.",
 };
 export function createCaptureFootprintHandler(db, getDerivedKey) {
     return wrapToolHandler("capture-footprint", "Check content is not empty, messageCount is positive, and tags format is valid.", async (params) => {
@@ -33,7 +46,14 @@ export function createCaptureFootprintHandler(db, getDerivedKey) {
         if (!params.content || params.content.trim().length === 0) {
             throw new Error("Content cannot be empty");
         }
-        if (params.messageCount <= 0) {
+        const MAX_CONTENT_LENGTH = 10 * 1024 * 1024; // 10MB
+        if (params.content.length > MAX_CONTENT_LENGTH) {
+            throw new Error(`Content too large (${(params.content.length / (1024 * 1024)).toFixed(1)}MB). Maximum 10MB allowed.`);
+        }
+        if (params.conversationId.length > 500) {
+            throw new Error("Conversation ID too long (max 500 chars)");
+        }
+        if (params.messageCount !== undefined && params.messageCount <= 0) {
             throw new Error("Message count must be positive");
         }
         // eslint-disable-next-line no-control-regex
@@ -42,6 +62,8 @@ export function createCaptureFootprintHandler(db, getDerivedKey) {
         }
         // Validate and sanitize tags if provided
         if (params.tags) {
+            const MAX_TAG_LENGTH = 100;
+            const MAX_TAGS_COUNT = 20;
             const tags = params.tags
                 .split(",")
                 .map((t) => t.trim())
@@ -49,14 +71,33 @@ export function createCaptureFootprintHandler(db, getDerivedKey) {
             if (tags.length === 0) {
                 throw new Error("All provided tags are empty or whitespace");
             }
+            if (tags.length > MAX_TAGS_COUNT) {
+                throw new Error(`Too many tags (${tags.length}). Maximum ${MAX_TAGS_COUNT} tags allowed.`);
+            }
             for (const tag of tags) {
+                if (tag.length > MAX_TAG_LENGTH) {
+                    throw new Error(`Tag too long (${tag.length} chars). Maximum ${MAX_TAG_LENGTH} characters per tag.`);
+                }
                 // eslint-disable-next-line no-control-regex
                 if (/[\x00\n\r,]/.test(tag)) {
                     throw new Error(`Invalid tag format: "${tag}". Tags cannot contain null bytes, newlines, or commas.`);
                 }
             }
-            params.tags = tags.join(",");
+            // Use sanitized tags without mutating original params
+            params = { ...params, tags: tags.join(",") };
+        }
+        // Auto-calculate messageCount if not provided
+        let messageCount = params.messageCount;
+        if (!messageCount) {
+            const turnPattern = /^(Human|Assistant|User|System|AI):/im;
+            const lines = params.content.split("\n");
+            messageCount = lines.filter((line) => turnPattern.test(line.trim())).length;
+            if (messageCount === 0)
+                messageCount = 1; // Default to 1 if no turns detected
         }
+        // Apply runtime defaults for parameters with Zod schema defaults
+        // (Zod defaults only apply through MCP SDK transport layer)
+        const llmProvider = params.llmProvider || "unknown";
         // Encrypt and capture
         const key = await getDerivedKey();
         const encrypted = await encrypt(params.content, key);
@@ -69,11 +110,11 @@ export function createCaptureFootprintHandler(db, getDerivedKey) {
         const id = db.create({
             timestamp,
             conversationId: params.conversationId,
-            llmProvider: params.llmProvider,
+            llmProvider,
             encryptedContent: encrypted.ciphertext,
             nonce: encrypted.nonce,
             contentHash,
-            messageCount: params.messageCount,
+            messageCount,
             gitCommitHash: gitInfo?.commitHash || null,
             gitTimestamp: gitInfo?.timestamp || null,
             tags: params.tags || null,
@@ -82,7 +123,7 @@ export function createCaptureFootprintHandler(db, getDerivedKey) {
             ID: id,
             Timestamp: timestamp,
             "Git Commit": gitInfo?.commitHash || "N/A",
-            "Message Count": params.messageCount,
+            "Message Count": messageCount,
         }, {
             id,
             timestamp,

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

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

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

@@ -0,0 +1,62 @@
+import * as z from "zod";
+import type { EvidenceDatabase } from "../lib/storage/index.js";
+export declare const confirmContextLinkSchema: {
+    inputSchema: {
+        sessionIds: z.ZodArray<z.ZodString>;
+        contextId: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+        setPreferred: z.ZodOptional<z.ZodBoolean>;
+    };
+    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 confirmContextLinkMetadata: {
+    title: string;
+    description: string;
+};
+export declare function createConfirmContextLinkHandler(db: EvidenceDatabase): (params: {
+    sessionIds: string[];
+    contextId?: string;
+    label?: string;
+    setPreferred?: boolean;
+}) => Promise<import("../lib/tool-response.js").ToolResponse<import("../lib/context-memory.js").ContextLinkMutationResult>>;
+//# sourceMappingURL=confirm-context-link.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-context-link.d.ts","sourceRoot":"","sources":["../../../src/tools/confirm-context-link.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAUpC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;CAItC,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,EAAE,EAAE,gBAAgB;gBAKlD,MAAM,EAAE;gBACR,MAAM;YACV,MAAM;mBACC,OAAO;4HAoB3B"}

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

@@ -0,0 +1,36 @@
+import * as z from "zod";
+import { confirmContextLink } 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 confirmContextLinkSchema = {
+    inputSchema: {
+        sessionIds: z
+            .array(z.string().min(1))
+            .min(1, "At least one sessionId is required"),
+        contextId: z.string().optional(),
+        label: z.string().optional(),
+        setPreferred: z.boolean().optional(),
+    },
+    outputSchema: contextMutationSchema.shape,
+};
+export const confirmContextLinkMetadata = {
+    title: "Confirm Context Link",
+    description: "Confirm one or more sessions into an existing or new canonical context. This is the mutation step after resolve-context suggested candidates.",
+};
+export function createConfirmContextLinkHandler(db) {
+    return wrapToolHandler("confirm-context-link", "Confirm one or more sessions into an existing context or create a new context with label.", async (params) => {
+        const result = confirmContextLink(db, {
+            sessionIds: params.sessionIds,
+            contextId: params.contextId?.trim() || undefined,
+            label: params.label?.trim() || undefined,
+            setPreferred: params.setPreferred,
+        });
+        return formatSuccessResponse("Context link confirmed successfully", {
+            Action: result.action,
+            Context: result.context?.label ?? result.contextId ?? "created",
+            Sessions: result.affectedSessionIds.length,
+        }, result);
+    });
+}
+//# sourceMappingURL=confirm-context-link.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-context-link.js","sourceRoot":"","sources":["../../../src/tools/confirm-context-link.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,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,wBAAwB,GAAG;IACtC,WAAW,EAAE;QACX,UAAU,EAAE,CAAC;aACV,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;aACxB,GAAG,CAAC,CAAC,EAAE,oCAAoC,CAAC;QAC/C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KACrC;IACD,YAAY,EAAE,qBAAqB,CAAC,KAAK;CAC1C,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EACT,+IAA+I;CAClJ,CAAC;AAEF,MAAM,UAAU,+BAA+B,CAAC,EAAoB;IAClE,OAAO,eAAe,CACpB,sBAAsB,EACtB,2FAA2F,EAC3F,KAAK,EAAE,MAKN,EAAE,EAAE;QACH,MAAM,MAAM,GAAG,kBAAkB,CAAC,EAAE,EAAE;YACpC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,SAAS;YAChD,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,SAAS;YACxC,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,CAAC,CAAC;QAEH,OAAO,qBAAqB,CAC1B,qCAAqC,EACrC;YACE,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,IAAI,MAAM,CAAC,SAAS,IAAI,SAAS;YAC/D,QAAQ,EAAE,MAAM,CAAC,kBAAkB,CAAC,MAAM;SAC3C,EACD,MAAM,CACP,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}