thread-mcp 1.0.0

package/dist/tools/save-thread.d.ts

@@ -0,0 +1,155 @@
+import { z } from "zod";
+export declare const SaveThreadInputSchema: z.ZodObject<{
+    title: z.ZodString;
+    messages: z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<["user", "assistant", "system"]>;
+        content: z.ZodString;
+        timestamp: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        role: "user" | "assistant" | "system";
+        content: string;
+        timestamp?: string | undefined;
+    }, {
+        role: "user" | "assistant" | "system";
+        content: string;
+        timestamp?: string | undefined;
+    }>, "many">;
+    destination: z.ZodDefault<z.ZodEnum<["local", "remote"]>>;
+    format: z.ZodDefault<z.ZodEnum<["markdown", "json"]>>;
+    sourceApp: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    summary: z.ZodOptional<z.ZodString>;
+    outputDir: z.ZodOptional<z.ZodString>;
+    remoteUrl: z.ZodOptional<z.ZodString>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    includeMetadata: z.ZodDefault<z.ZodBoolean>;
+    includeTimestamps: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    messages: {
+        role: "user" | "assistant" | "system";
+        content: string;
+        timestamp?: string | undefined;
+    }[];
+    format: "markdown" | "json";
+    includeMetadata: boolean;
+    includeTimestamps: boolean;
+    destination: "local" | "remote";
+    sourceApp?: string | undefined;
+    tags?: string[] | undefined;
+    summary?: string | undefined;
+    apiKey?: string | undefined;
+    headers?: Record<string, string> | undefined;
+    remoteUrl?: string | undefined;
+    outputDir?: string | undefined;
+}, {
+    title: string;
+    messages: {
+        role: "user" | "assistant" | "system";
+        content: string;
+        timestamp?: string | undefined;
+    }[];
+    sourceApp?: string | undefined;
+    tags?: string[] | undefined;
+    summary?: string | undefined;
+    format?: "markdown" | "json" | undefined;
+    includeMetadata?: boolean | undefined;
+    includeTimestamps?: boolean | undefined;
+    apiKey?: string | undefined;
+    headers?: Record<string, string> | undefined;
+    remoteUrl?: string | undefined;
+    destination?: "local" | "remote" | undefined;
+    outputDir?: string | undefined;
+}>;
+export type SaveThreadInput = z.infer<typeof SaveThreadInputSchema>;
+export declare function saveThread(input: SaveThreadInput): Promise<{
+    success: boolean;
+    id: string;
+    title: string;
+    destination: string;
+    remoteUrl: string | undefined;
+    format: "markdown" | "json";
+    savedAt: string;
+    messageCount: number;
+    filePath?: undefined;
+} | {
+    success: boolean;
+    id: string;
+    title: string;
+    destination: string;
+    filePath: string | undefined;
+    format: "markdown" | "json";
+    savedAt: string;
+    messageCount: number;
+    remoteUrl?: undefined;
+}>;
+export declare const saveThreadTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        title: z.ZodString;
+        messages: z.ZodArray<z.ZodObject<{
+            role: z.ZodEnum<["user", "assistant", "system"]>;
+            content: z.ZodString;
+            timestamp: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            role: "user" | "assistant" | "system";
+            content: string;
+            timestamp?: string | undefined;
+        }, {
+            role: "user" | "assistant" | "system";
+            content: string;
+            timestamp?: string | undefined;
+        }>, "many">;
+        destination: z.ZodDefault<z.ZodEnum<["local", "remote"]>>;
+        format: z.ZodDefault<z.ZodEnum<["markdown", "json"]>>;
+        sourceApp: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        summary: z.ZodOptional<z.ZodString>;
+        outputDir: z.ZodOptional<z.ZodString>;
+        remoteUrl: z.ZodOptional<z.ZodString>;
+        apiKey: z.ZodOptional<z.ZodString>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        includeMetadata: z.ZodDefault<z.ZodBoolean>;
+        includeTimestamps: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        messages: {
+            role: "user" | "assistant" | "system";
+            content: string;
+            timestamp?: string | undefined;
+        }[];
+        format: "markdown" | "json";
+        includeMetadata: boolean;
+        includeTimestamps: boolean;
+        destination: "local" | "remote";
+        sourceApp?: string | undefined;
+        tags?: string[] | undefined;
+        summary?: string | undefined;
+        apiKey?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        remoteUrl?: string | undefined;
+        outputDir?: string | undefined;
+    }, {
+        title: string;
+        messages: {
+            role: "user" | "assistant" | "system";
+            content: string;
+            timestamp?: string | undefined;
+        }[];
+        sourceApp?: string | undefined;
+        tags?: string[] | undefined;
+        summary?: string | undefined;
+        format?: "markdown" | "json" | undefined;
+        includeMetadata?: boolean | undefined;
+        includeTimestamps?: boolean | undefined;
+        apiKey?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        remoteUrl?: string | undefined;
+        destination?: "local" | "remote" | undefined;
+        outputDir?: string | undefined;
+    }>;
+    handler: typeof saveThread;
+};
+//# sourceMappingURL=save-thread.d.ts.map

package/dist/tools/save-thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-thread.d.ts","sourceRoot":"","sources":["../../src/tools/save-thread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;GAiEtD;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAO1B,CAAC"}

package/dist/tools/save-thread.js

@@ -0,0 +1,116 @@
+import { z } from "zod";
+import { OutputFormatSchema } from "../types.js";
+import { getDefaultLocalStorage, createLocalStorage } from "../storage/local.js";
+import { createRemoteStorage } from "../storage/remote.js";
+export const SaveThreadInputSchema = z.object({
+    title: z.string().describe("Title for the thread"),
+    messages: z
+        .array(z.object({
+        role: z.enum(["user", "assistant", "system"]),
+        content: z.string(),
+        timestamp: z.string().optional(),
+    }))
+        .describe("Array of messages in the thread"),
+    destination: z
+        .enum(["local", "remote"])
+        .default("local")
+        .describe("Where to save: 'local' for filesystem, 'remote' for server"),
+    format: OutputFormatSchema.default("markdown").describe("Output format: 'markdown' or 'json'"),
+    sourceApp: z
+        .string()
+        .optional()
+        .describe("Name of the AI application (e.g., 'Claude', 'ChatGPT')"),
+    tags: z.array(z.string()).optional().describe("Tags for categorization"),
+    summary: z.string().optional().describe("Summary of the thread"),
+    // Local options
+    outputDir: z
+        .string()
+        .optional()
+        .describe("Custom output directory for local storage (defaults to ~/.thread-mcp)"),
+    // Remote options
+    remoteUrl: z
+        .string()
+        .url()
+        .optional()
+        .describe("Base URL of the remote server (required if destination is 'remote')"),
+    apiKey: z.string().optional().describe("API key for remote authentication"),
+    headers: z
+        .record(z.string())
+        .optional()
+        .describe("Additional headers for remote requests"),
+    // Output options
+    includeMetadata: z
+        .boolean()
+        .default(true)
+        .describe("Whether to include metadata in the output"),
+    includeTimestamps: z
+        .boolean()
+        .default(true)
+        .describe("Whether to include timestamps for each message"),
+});
+export async function saveThread(input) {
+    const conversation = {
+        id: crypto.randomUUID(),
+        metadata: {
+            title: input.title,
+            sourceApp: input.sourceApp,
+            createdAt: new Date().toISOString(),
+            tags: input.tags,
+            summary: input.summary,
+        },
+        messages: input.messages.map((msg) => ({
+            role: msg.role,
+            content: msg.content,
+            timestamp: msg.timestamp,
+        })),
+    };
+    const options = {
+        format: input.format,
+        includeMetadata: input.includeMetadata,
+        includeTimestamps: input.includeTimestamps,
+    };
+    if (input.destination === "remote") {
+        if (!input.remoteUrl) {
+            throw new Error("remoteUrl is required when destination is 'remote'");
+        }
+        const storage = createRemoteStorage({
+            url: input.remoteUrl,
+            apiKey: input.apiKey,
+            headers: input.headers,
+        });
+        const result = await storage.save(conversation, options);
+        return {
+            success: true,
+            id: result.id,
+            title: result.title,
+            destination: "remote",
+            remoteUrl: result.remoteUrl,
+            format: result.format,
+            savedAt: result.savedAt,
+            messageCount: conversation.messages.length,
+        };
+    }
+    // Local storage
+    const storage = input.outputDir
+        ? createLocalStorage(input.outputDir)
+        : getDefaultLocalStorage();
+    const result = await storage.save(conversation, options);
+    return {
+        success: true,
+        id: result.id,
+        title: result.title,
+        destination: "local",
+        filePath: result.filePath,
+        format: result.format,
+        savedAt: result.savedAt,
+        messageCount: conversation.messages.length,
+    };
+}
+export const saveThreadTool = {
+    name: "save_thread",
+    description: "Save a conversation thread to local storage or a remote server. " +
+        "Supports Markdown and JSON formats with rich metadata including tags, summary, and timestamps.",
+    inputSchema: SaveThreadInputSchema,
+    handler: saveThread,
+};
+//# sourceMappingURL=save-thread.js.map

package/dist/tools/save-thread.js.map

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

package/dist/tools/update-thread.d.ts

@@ -0,0 +1,180 @@
+import { z } from "zod";
+export declare const UpdateThreadInputSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    messages: z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<["user", "assistant", "system"]>;
+        content: z.ZodString;
+        timestamp: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        role: "user" | "assistant" | "system";
+        content: string;
+        timestamp?: string | undefined;
+    }, {
+        role: "user" | "assistant" | "system";
+        content: string;
+        timestamp?: string | undefined;
+    }>, "many">;
+    mode: z.ZodDefault<z.ZodEnum<["append", "replace"]>>;
+    deduplicate: z.ZodDefault<z.ZodBoolean>;
+    newTitle: z.ZodOptional<z.ZodString>;
+    newTags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    newSummary: z.ZodOptional<z.ZodString>;
+    source: z.ZodDefault<z.ZodEnum<["local", "remote"]>>;
+    outputDir: z.ZodOptional<z.ZodString>;
+    remoteUrl: z.ZodOptional<z.ZodString>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    format: z.ZodOptional<z.ZodEnum<["markdown", "json"]>>;
+}, "strip", z.ZodTypeAny, {
+    messages: {
+        role: "user" | "assistant" | "system";
+        content: string;
+        timestamp?: string | undefined;
+    }[];
+    source: "local" | "remote";
+    mode: "replace" | "append";
+    deduplicate: boolean;
+    title?: string | undefined;
+    id?: string | undefined;
+    format?: "markdown" | "json" | undefined;
+    apiKey?: string | undefined;
+    headers?: Record<string, string> | undefined;
+    remoteUrl?: string | undefined;
+    outputDir?: string | undefined;
+    newTitle?: string | undefined;
+    newTags?: string[] | undefined;
+    newSummary?: string | undefined;
+}, {
+    messages: {
+        role: "user" | "assistant" | "system";
+        content: string;
+        timestamp?: string | undefined;
+    }[];
+    title?: string | undefined;
+    id?: string | undefined;
+    format?: "markdown" | "json" | undefined;
+    apiKey?: string | undefined;
+    headers?: Record<string, string> | undefined;
+    remoteUrl?: string | undefined;
+    outputDir?: string | undefined;
+    source?: "local" | "remote" | undefined;
+    mode?: "replace" | "append" | undefined;
+    deduplicate?: boolean | undefined;
+    newTitle?: string | undefined;
+    newTags?: string[] | undefined;
+    newSummary?: string | undefined;
+}>;
+export type UpdateThreadInput = z.infer<typeof UpdateThreadInputSchema>;
+export declare function updateThread(input: UpdateThreadInput): Promise<{
+    success: boolean;
+    error: string;
+    source: "local" | "remote";
+    id?: undefined;
+    title?: undefined;
+    filePath?: undefined;
+    remoteUrl?: undefined;
+    format?: undefined;
+    savedAt?: undefined;
+    messageCount?: undefined;
+    messagesAdded?: undefined;
+    mode?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    id: string | undefined;
+    source: "local" | "remote";
+    title?: undefined;
+    filePath?: undefined;
+    remoteUrl?: undefined;
+    format?: undefined;
+    savedAt?: undefined;
+    messageCount?: undefined;
+    messagesAdded?: undefined;
+    mode?: undefined;
+} | {
+    success: boolean;
+    id: string;
+    title: string;
+    source: "local" | "remote";
+    filePath: string | undefined;
+    remoteUrl: string | undefined;
+    format: "markdown" | "json";
+    savedAt: string;
+    messageCount: number;
+    messagesAdded: number;
+    mode: "replace" | "append";
+    error?: undefined;
+}>;
+export declare const updateThreadTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        messages: z.ZodArray<z.ZodObject<{
+            role: z.ZodEnum<["user", "assistant", "system"]>;
+            content: z.ZodString;
+            timestamp: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            role: "user" | "assistant" | "system";
+            content: string;
+            timestamp?: string | undefined;
+        }, {
+            role: "user" | "assistant" | "system";
+            content: string;
+            timestamp?: string | undefined;
+        }>, "many">;
+        mode: z.ZodDefault<z.ZodEnum<["append", "replace"]>>;
+        deduplicate: z.ZodDefault<z.ZodBoolean>;
+        newTitle: z.ZodOptional<z.ZodString>;
+        newTags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        newSummary: z.ZodOptional<z.ZodString>;
+        source: z.ZodDefault<z.ZodEnum<["local", "remote"]>>;
+        outputDir: z.ZodOptional<z.ZodString>;
+        remoteUrl: z.ZodOptional<z.ZodString>;
+        apiKey: z.ZodOptional<z.ZodString>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        format: z.ZodOptional<z.ZodEnum<["markdown", "json"]>>;
+    }, "strip", z.ZodTypeAny, {
+        messages: {
+            role: "user" | "assistant" | "system";
+            content: string;
+            timestamp?: string | undefined;
+        }[];
+        source: "local" | "remote";
+        mode: "replace" | "append";
+        deduplicate: boolean;
+        title?: string | undefined;
+        id?: string | undefined;
+        format?: "markdown" | "json" | undefined;
+        apiKey?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        remoteUrl?: string | undefined;
+        outputDir?: string | undefined;
+        newTitle?: string | undefined;
+        newTags?: string[] | undefined;
+        newSummary?: string | undefined;
+    }, {
+        messages: {
+            role: "user" | "assistant" | "system";
+            content: string;
+            timestamp?: string | undefined;
+        }[];
+        title?: string | undefined;
+        id?: string | undefined;
+        format?: "markdown" | "json" | undefined;
+        apiKey?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        remoteUrl?: string | undefined;
+        outputDir?: string | undefined;
+        source?: "local" | "remote" | undefined;
+        mode?: "replace" | "append" | undefined;
+        deduplicate?: boolean | undefined;
+        newTitle?: string | undefined;
+        newTags?: string[] | undefined;
+        newSummary?: string | undefined;
+    }>;
+    handler: typeof updateThread;
+};
+//# sourceMappingURL=update-thread.d.ts.map

package/dist/tools/update-thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-thread.d.ts","sourceRoot":"","sources":["../../src/tools/update-thread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0ClC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAmBxE,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8G1D;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQ5B,CAAC"}

package/dist/tools/update-thread.js

@@ -0,0 +1,159 @@
+import { z } from "zod";
+import { OutputFormatSchema } from "../types.js";
+import { getDefaultLocalStorage, createLocalStorage } from "../storage/local.js";
+import { createRemoteStorage } from "../storage/remote.js";
+export const UpdateThreadInputSchema = z.object({
+    // Lookup (use one)
+    id: z.string().optional().describe("ID of the thread to update"),
+    title: z.string().optional().describe("Find thread by exact title match"),
+    // Messages to add/replace
+    messages: z
+        .array(z.object({
+        role: z.enum(["user", "assistant", "system"]),
+        content: z.string(),
+        timestamp: z.string().optional(),
+    }))
+        .describe("Messages to append or replace with"),
+    mode: z
+        .enum(["append", "replace"])
+        .default("append")
+        .describe("'append' adds to existing messages, 'replace' overwrites all"),
+    deduplicate: z
+        .boolean()
+        .default(true)
+        .describe("When appending, skip messages that already exist (by role+content)"),
+    // Metadata updates (optional)
+    newTitle: z.string().optional().describe("New title for the thread"),
+    newTags: z.array(z.string()).optional().describe("New tags (replaces existing)"),
+    newSummary: z.string().optional().describe("New summary"),
+    // Source
+    source: z
+        .enum(["local", "remote"])
+        .default("local")
+        .describe("Source where thread is stored"),
+    outputDir: z.string().optional().describe("Custom directory for local storage"),
+    remoteUrl: z.string().url().optional().describe("Remote server URL"),
+    apiKey: z.string().optional().describe("API key for remote"),
+    headers: z.record(z.string()).optional().describe("Additional headers for remote"),
+    format: OutputFormatSchema.optional().describe("Output format (keeps existing if not set)"),
+});
+function messagesEqual(a, b) {
+    return a.role === b.role && a.content === b.content;
+}
+function deduplicateMessages(existing, incoming) {
+    const newMessages = [];
+    for (const msg of incoming) {
+        const isDuplicate = existing.some((e) => messagesEqual(e, msg));
+        if (!isDuplicate) {
+            newMessages.push(msg);
+        }
+    }
+    return newMessages;
+}
+export async function updateThread(input) {
+    if (!input.id && !input.title) {
+        throw new Error("Either 'id' or 'title' must be provided to identify the thread");
+    }
+    if (input.source === "remote" && !input.remoteUrl) {
+        throw new Error("remoteUrl is required when source is 'remote'");
+    }
+    const storage = input.source === "remote"
+        ? createRemoteStorage({
+            url: input.remoteUrl,
+            apiKey: input.apiKey,
+            headers: input.headers,
+        })
+        : input.outputDir
+            ? createLocalStorage(input.outputDir)
+            : getDefaultLocalStorage();
+    // Find the thread
+    let threadId = input.id;
+    let existingInfo;
+    if (!threadId && input.title) {
+        const allInfos = await storage.list();
+        for (const info of allInfos) {
+            const conv = await storage.get(info.id);
+            if (conv && conv.metadata.title === input.title) {
+                threadId = info.id;
+                existingInfo = info;
+                break;
+            }
+        }
+        if (!threadId) {
+            return {
+                success: false,
+                error: `Thread with title '${input.title}' not found`,
+                source: input.source,
+            };
+        }
+    }
+    const existing = await storage.get(threadId);
+    if (!existing) {
+        return {
+            success: false,
+            error: `Thread with ID '${threadId}' not found`,
+            id: threadId,
+            source: input.source,
+        };
+    }
+    // Get format from existing info if not provided
+    if (!existingInfo) {
+        const allInfos = await storage.list();
+        existingInfo = allInfos.find((i) => i.id === threadId);
+    }
+    const originalFormat = existingInfo?.format || "markdown";
+    // Build updated messages
+    let updatedMessages;
+    if (input.mode === "replace") {
+        updatedMessages = input.messages;
+    }
+    else {
+        const messagesToAdd = input.deduplicate
+            ? deduplicateMessages(existing.messages, input.messages)
+            : input.messages;
+        updatedMessages = [...existing.messages, ...messagesToAdd];
+    }
+    // Build updated conversation
+    const updated = {
+        id: existing.id,
+        metadata: {
+            ...existing.metadata,
+            title: input.newTitle ?? existing.metadata.title,
+            tags: input.newTags ?? existing.metadata.tags,
+            summary: input.newSummary ?? existing.metadata.summary,
+            updatedAt: new Date().toISOString(),
+        },
+        messages: updatedMessages,
+    };
+    const options = {
+        format: input.format ?? originalFormat,
+        includeMetadata: true,
+        includeTimestamps: true,
+    };
+    // Delete old and save updated
+    await storage.delete(existing.id);
+    const result = await storage.save(updated, options);
+    const messagesAdded = input.mode === "append" ? updatedMessages.length - existing.messages.length : updatedMessages.length;
+    return {
+        success: true,
+        id: result.id,
+        title: updated.metadata.title,
+        source: input.source,
+        filePath: result.filePath,
+        remoteUrl: result.remoteUrl,
+        format: result.format,
+        savedAt: result.savedAt,
+        messageCount: updatedMessages.length,
+        messagesAdded,
+        mode: input.mode,
+    };
+}
+export const updateThreadTool = {
+    name: "update_thread",
+    description: "Update an existing conversation thread. Can find by ID or title. " +
+        "Use 'append' mode to add new messages (with automatic deduplication). " +
+        "Use 'replace' mode to overwrite all messages. Can also update title, tags, and summary.",
+    inputSchema: UpdateThreadInputSchema,
+    handler: updateThread,
+};
+//# sourceMappingURL=update-thread.js.map

package/dist/tools/update-thread.js.map

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