thread-mcp 1.0.0

package/dist/tools/index.d.ts

@@ -0,0 +1,270 @@
+export { saveThreadTool, saveThread, SaveThreadInputSchema } from "./save-thread.js";
+export { findThreadsTool, findThreads, FindThreadsInputSchema } from "./find-threads.js";
+export { updateThreadTool, updateThread, UpdateThreadInputSchema } from "./update-thread.js";
+export { deleteThreadTool, deleteThread, DeleteThreadInputSchema } from "./delete-thread.js";
+export { resumeThreadTool, resumeThread, ResumeThreadInputSchema } from "./resume-thread.js";
+export declare const allTools: readonly [{
+    name: string;
+    description: string;
+    inputSchema: import("zod").ZodObject<{
+        title: import("zod").ZodString;
+        messages: import("zod").ZodArray<import("zod").ZodObject<{
+            role: import("zod").ZodEnum<["user", "assistant", "system"]>;
+            content: import("zod").ZodString;
+            timestamp: import("zod").ZodOptional<import("zod").ZodString>;
+        }, "strip", import("zod").ZodTypeAny, {
+            role: "user" | "assistant" | "system";
+            content: string;
+            timestamp?: string | undefined;
+        }, {
+            role: "user" | "assistant" | "system";
+            content: string;
+            timestamp?: string | undefined;
+        }>, "many">;
+        destination: import("zod").ZodDefault<import("zod").ZodEnum<["local", "remote"]>>;
+        format: import("zod").ZodDefault<import("zod").ZodEnum<["markdown", "json"]>>;
+        sourceApp: import("zod").ZodOptional<import("zod").ZodString>;
+        tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        summary: import("zod").ZodOptional<import("zod").ZodString>;
+        outputDir: import("zod").ZodOptional<import("zod").ZodString>;
+        remoteUrl: import("zod").ZodOptional<import("zod").ZodString>;
+        apiKey: import("zod").ZodOptional<import("zod").ZodString>;
+        headers: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        includeMetadata: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        includeTimestamps: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    }, "strip", import("zod").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 import("./save-thread.js").saveThread;
+}, {
+    name: string;
+    description: string;
+    inputSchema: import("zod").ZodObject<{
+        id: import("zod").ZodOptional<import("zod").ZodString>;
+        title: import("zod").ZodOptional<import("zod").ZodString>;
+        titleContains: import("zod").ZodOptional<import("zod").ZodString>;
+        query: import("zod").ZodOptional<import("zod").ZodString>;
+        tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        sourceApp: import("zod").ZodOptional<import("zod").ZodString>;
+        dateFrom: import("zod").ZodOptional<import("zod").ZodString>;
+        dateTo: import("zod").ZodOptional<import("zod").ZodString>;
+        includeContent: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        includeRelevanceInfo: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+        source: import("zod").ZodDefault<import("zod").ZodEnum<["local", "remote"]>>;
+        outputDir: import("zod").ZodOptional<import("zod").ZodString>;
+        remoteUrl: import("zod").ZodOptional<import("zod").ZodString>;
+        apiKey: import("zod").ZodOptional<import("zod").ZodString>;
+        headers: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+    }, "strip", import("zod").ZodTypeAny, {
+        includeContent: boolean;
+        includeRelevanceInfo: boolean;
+        limit: number;
+        source: "local" | "remote";
+        title?: string | undefined;
+        sourceApp?: string | undefined;
+        tags?: string[] | undefined;
+        id?: string | undefined;
+        apiKey?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        remoteUrl?: string | undefined;
+        outputDir?: string | undefined;
+        titleContains?: string | undefined;
+        query?: string | undefined;
+        dateFrom?: string | undefined;
+        dateTo?: string | undefined;
+    }, {
+        title?: string | undefined;
+        sourceApp?: string | undefined;
+        tags?: string[] | undefined;
+        id?: string | undefined;
+        apiKey?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        remoteUrl?: string | undefined;
+        outputDir?: string | undefined;
+        titleContains?: string | undefined;
+        query?: string | undefined;
+        dateFrom?: string | undefined;
+        dateTo?: string | undefined;
+        includeContent?: boolean | undefined;
+        includeRelevanceInfo?: boolean | undefined;
+        limit?: number | undefined;
+        source?: "local" | "remote" | undefined;
+    }>;
+    handler: typeof import("./find-threads.js").findThreads;
+}, {
+    name: string;
+    description: string;
+    inputSchema: import("zod").ZodObject<{
+        id: import("zod").ZodOptional<import("zod").ZodString>;
+        title: import("zod").ZodOptional<import("zod").ZodString>;
+        messages: import("zod").ZodArray<import("zod").ZodObject<{
+            role: import("zod").ZodEnum<["user", "assistant", "system"]>;
+            content: import("zod").ZodString;
+            timestamp: import("zod").ZodOptional<import("zod").ZodString>;
+        }, "strip", import("zod").ZodTypeAny, {
+            role: "user" | "assistant" | "system";
+            content: string;
+            timestamp?: string | undefined;
+        }, {
+            role: "user" | "assistant" | "system";
+            content: string;
+            timestamp?: string | undefined;
+        }>, "many">;
+        mode: import("zod").ZodDefault<import("zod").ZodEnum<["append", "replace"]>>;
+        deduplicate: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        newTitle: import("zod").ZodOptional<import("zod").ZodString>;
+        newTags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        newSummary: import("zod").ZodOptional<import("zod").ZodString>;
+        source: import("zod").ZodDefault<import("zod").ZodEnum<["local", "remote"]>>;
+        outputDir: import("zod").ZodOptional<import("zod").ZodString>;
+        remoteUrl: import("zod").ZodOptional<import("zod").ZodString>;
+        apiKey: import("zod").ZodOptional<import("zod").ZodString>;
+        headers: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        format: import("zod").ZodOptional<import("zod").ZodEnum<["markdown", "json"]>>;
+    }, "strip", import("zod").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 import("./update-thread.js").updateThread;
+}, {
+    name: string;
+    description: string;
+    inputSchema: import("zod").ZodObject<{
+        id: import("zod").ZodOptional<import("zod").ZodString>;
+        title: import("zod").ZodOptional<import("zod").ZodString>;
+        source: import("zod").ZodDefault<import("zod").ZodEnum<["local", "remote"]>>;
+        outputDir: import("zod").ZodOptional<import("zod").ZodString>;
+        remoteUrl: import("zod").ZodOptional<import("zod").ZodString>;
+        apiKey: import("zod").ZodOptional<import("zod").ZodString>;
+        headers: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+    }, "strip", import("zod").ZodTypeAny, {
+        source: "local" | "remote";
+        title?: string | undefined;
+        id?: string | undefined;
+        apiKey?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        remoteUrl?: string | undefined;
+        outputDir?: string | undefined;
+    }, {
+        title?: string | undefined;
+        id?: string | undefined;
+        apiKey?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        remoteUrl?: string | undefined;
+        outputDir?: string | undefined;
+        source?: "local" | "remote" | undefined;
+    }>;
+    handler: typeof import("./delete-thread.js").deleteThread;
+}, {
+    name: string;
+    description: string;
+    inputSchema: import("zod").ZodObject<{
+        id: import("zod").ZodOptional<import("zod").ZodString>;
+        title: import("zod").ZodOptional<import("zod").ZodString>;
+        titleContains: import("zod").ZodOptional<import("zod").ZodString>;
+        format: import("zod").ZodDefault<import("zod").ZodEnum<["structured", "narrative", "messages"]>>;
+        maxMessages: import("zod").ZodOptional<import("zod").ZodNumber>;
+        includeSummary: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        source: import("zod").ZodDefault<import("zod").ZodEnum<["local", "remote"]>>;
+        outputDir: import("zod").ZodOptional<import("zod").ZodString>;
+        remoteUrl: import("zod").ZodOptional<import("zod").ZodString>;
+        apiKey: import("zod").ZodOptional<import("zod").ZodString>;
+        headers: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+    }, "strip", import("zod").ZodTypeAny, {
+        format: "messages" | "structured" | "narrative";
+        source: "local" | "remote";
+        includeSummary: boolean;
+        title?: string | undefined;
+        id?: string | undefined;
+        apiKey?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        remoteUrl?: string | undefined;
+        outputDir?: string | undefined;
+        titleContains?: string | undefined;
+        maxMessages?: number | undefined;
+    }, {
+        title?: string | undefined;
+        id?: string | undefined;
+        format?: "messages" | "structured" | "narrative" | undefined;
+        apiKey?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        remoteUrl?: string | undefined;
+        outputDir?: string | undefined;
+        titleContains?: string | undefined;
+        source?: "local" | "remote" | undefined;
+        maxMessages?: number | undefined;
+        includeSummary?: boolean | undefined;
+    }>;
+    handler: typeof import("./resume-thread.js").resumeThread;
+}];
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7F,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMX,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,18 @@
+import { saveThreadTool } from "./save-thread.js";
+import { findThreadsTool } from "./find-threads.js";
+import { updateThreadTool } from "./update-thread.js";
+import { deleteThreadTool } from "./delete-thread.js";
+import { resumeThreadTool } from "./resume-thread.js";
+export { saveThreadTool, saveThread, SaveThreadInputSchema } from "./save-thread.js";
+export { findThreadsTool, findThreads, FindThreadsInputSchema } from "./find-threads.js";
+export { updateThreadTool, updateThread, UpdateThreadInputSchema } from "./update-thread.js";
+export { deleteThreadTool, deleteThread, DeleteThreadInputSchema } from "./delete-thread.js";
+export { resumeThreadTool, resumeThread, ResumeThreadInputSchema } from "./resume-thread.js";
+export const allTools = [
+    saveThreadTool,
+    findThreadsTool,
+    updateThreadTool,
+    deleteThreadTool,
+    resumeThreadTool,
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7F,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,cAAc;IACd,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;CACR,CAAC"}

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

@@ -0,0 +1,138 @@
+import { z } from "zod";
+import type { Message } from "../types.js";
+export declare const ResumeThreadInputSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    titleContains: z.ZodOptional<z.ZodString>;
+    format: z.ZodDefault<z.ZodEnum<["structured", "narrative", "messages"]>>;
+    maxMessages: z.ZodOptional<z.ZodNumber>;
+    includeSummary: z.ZodDefault<z.ZodBoolean>;
+    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>>;
+}, "strip", z.ZodTypeAny, {
+    format: "messages" | "structured" | "narrative";
+    source: "local" | "remote";
+    includeSummary: boolean;
+    title?: string | undefined;
+    id?: string | undefined;
+    apiKey?: string | undefined;
+    headers?: Record<string, string> | undefined;
+    remoteUrl?: string | undefined;
+    outputDir?: string | undefined;
+    titleContains?: string | undefined;
+    maxMessages?: number | undefined;
+}, {
+    title?: string | undefined;
+    id?: string | undefined;
+    format?: "messages" | "structured" | "narrative" | undefined;
+    apiKey?: string | undefined;
+    headers?: Record<string, string> | undefined;
+    remoteUrl?: string | undefined;
+    outputDir?: string | undefined;
+    titleContains?: string | undefined;
+    source?: "local" | "remote" | undefined;
+    maxMessages?: number | undefined;
+    includeSummary?: boolean | undefined;
+}>;
+export type ResumeThreadInput = z.infer<typeof ResumeThreadInputSchema>;
+export declare function resumeThread(input: ResumeThreadInput): Promise<{
+    found: boolean;
+    error: string;
+    source: "local" | "remote";
+    id?: undefined;
+    title?: undefined;
+    format?: undefined;
+    messages?: undefined;
+    totalMessages?: undefined;
+    content?: undefined;
+} | {
+    found: boolean;
+    id: string | undefined;
+    title: string;
+    source: "local" | "remote";
+    format: string;
+    messages: {
+        role: "user" | "assistant" | "system";
+        content: string;
+        timestamp?: string | undefined;
+    }[];
+    totalMessages: number;
+    error?: undefined;
+    content?: undefined;
+} | {
+    found: boolean;
+    id: string | undefined;
+    title: string;
+    source: "local" | "remote";
+    format: string;
+    content: string;
+    totalMessages: number;
+    error?: undefined;
+    messages?: undefined;
+} | {
+    totalMessages: number;
+    context: {
+        title: string;
+        summary?: string;
+        tags?: string[];
+        sourceApp?: string;
+        messageCount: number;
+        startedAt: string;
+        lastUpdated?: string;
+    };
+    messages: Message[];
+    continuationHint: string;
+    found: boolean;
+    id: string | undefined;
+    source: "local" | "remote";
+    format: string;
+    error?: undefined;
+    title?: undefined;
+    content?: undefined;
+}>;
+export declare const resumeThreadTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        titleContains: z.ZodOptional<z.ZodString>;
+        format: z.ZodDefault<z.ZodEnum<["structured", "narrative", "messages"]>>;
+        maxMessages: z.ZodOptional<z.ZodNumber>;
+        includeSummary: z.ZodDefault<z.ZodBoolean>;
+        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>>;
+    }, "strip", z.ZodTypeAny, {
+        format: "messages" | "structured" | "narrative";
+        source: "local" | "remote";
+        includeSummary: boolean;
+        title?: string | undefined;
+        id?: string | undefined;
+        apiKey?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        remoteUrl?: string | undefined;
+        outputDir?: string | undefined;
+        titleContains?: string | undefined;
+        maxMessages?: number | undefined;
+    }, {
+        title?: string | undefined;
+        id?: string | undefined;
+        format?: "messages" | "structured" | "narrative" | undefined;
+        apiKey?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        remoteUrl?: string | undefined;
+        outputDir?: string | undefined;
+        titleContains?: string | undefined;
+        source?: "local" | "remote" | undefined;
+        maxMessages?: number | undefined;
+        includeSummary?: boolean | undefined;
+    }>;
+    handler: typeof resumeThread;
+};
+//# sourceMappingURL=resume-thread.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resume-thread.d.ts","sourceRoot":"","sources":["../../src/tools/resume-thread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAgB,OAAO,EAAE,MAAM,aAAa,CAAC;AAIzD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAyFxE,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aA3ChD;QACP,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;cACS,OAAO,EAAE;sBACD,MAAM;;;;;;;;GA2IzB;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAS5B,CAAC"}

package/dist/tools/resume-thread.js

@@ -0,0 +1,191 @@
+import { z } from "zod";
+import { getDefaultLocalStorage, createLocalStorage } from "../storage/local.js";
+import { createRemoteStorage } from "../storage/remote.js";
+export const ResumeThreadInputSchema = z.object({
+    // Lookup (use one)
+    id: z.string().optional().describe("ID of the thread to resume"),
+    title: z.string().optional().describe("Find thread by exact title match"),
+    titleContains: z.string().optional().describe("Find most recent thread with title containing this"),
+    // Output format
+    format: z
+        .enum(["structured", "narrative", "messages"])
+        .default("structured")
+        .describe("'structured' returns organized context, 'narrative' returns readable summary, 'messages' returns raw messages"),
+    // Options
+    maxMessages: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Limit to last N messages (default: all)"),
+    includeSummary: z.boolean().default(true).describe("Include thread summary if available"),
+    // 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"),
+});
+function formatNarrative(conversation, maxMessages) {
+    const lines = [];
+    lines.push(`# Resuming: ${conversation.metadata.title}`);
+    lines.push("");
+    if (conversation.metadata.summary) {
+        lines.push(`**Summary:** ${conversation.metadata.summary}`);
+        lines.push("");
+    }
+    if (conversation.metadata.tags && conversation.metadata.tags.length > 0) {
+        lines.push(`**Topics:** ${conversation.metadata.tags.join(", ")}`);
+        lines.push("");
+    }
+    const messages = maxMessages
+        ? conversation.messages.slice(-maxMessages)
+        : conversation.messages;
+    if (maxMessages && conversation.messages.length > maxMessages) {
+        lines.push(`*Showing last ${maxMessages} of ${conversation.messages.length} messages*`);
+        lines.push("");
+    }
+    lines.push("## Previous Conversation");
+    lines.push("");
+    for (const msg of messages) {
+        const role = msg.role.charAt(0).toUpperCase() + msg.role.slice(1);
+        lines.push(`**${role}:** ${msg.content}`);
+        lines.push("");
+    }
+    lines.push("---");
+    lines.push("*Continue the conversation from here...*");
+    return lines.join("\n");
+}
+function formatStructured(conversation, maxMessages) {
+    const messages = maxMessages
+        ? conversation.messages.slice(-maxMessages)
+        : conversation.messages;
+    // Generate a continuation hint based on the last message
+    const lastMessage = messages[messages.length - 1];
+    let continuationHint = "Continue the conversation.";
+    if (lastMessage) {
+        if (lastMessage.role === "user") {
+            continuationHint = "The user's last message is awaiting a response.";
+        }
+        else if (lastMessage.role === "assistant") {
+            continuationHint = "The assistant last responded. The user may have follow-up questions.";
+        }
+    }
+    return {
+        context: {
+            title: conversation.metadata.title,
+            summary: conversation.metadata.summary,
+            tags: conversation.metadata.tags,
+            sourceApp: conversation.metadata.sourceApp,
+            messageCount: conversation.messages.length,
+            startedAt: conversation.metadata.createdAt,
+            lastUpdated: conversation.metadata.updatedAt,
+        },
+        messages,
+        continuationHint,
+    };
+}
+export async function resumeThread(input) {
+    if (!input.id && !input.title && !input.titleContains) {
+        throw new Error("One of 'id', 'title', or 'titleContains' must be provided");
+    }
+    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 conversation = null;
+    let threadId;
+    if (input.id) {
+        conversation = await storage.get(input.id);
+        threadId = input.id;
+    }
+    else {
+        const allInfos = await storage.list();
+        for (const info of allInfos) {
+            const conv = await storage.get(info.id);
+            if (!conv)
+                continue;
+            if (input.title && conv.metadata.title === input.title) {
+                conversation = conv;
+                threadId = info.id;
+                break;
+            }
+            if (input.titleContains &&
+                conv.metadata.title.toLowerCase().includes(input.titleContains.toLowerCase())) {
+                // Take the first (most recent) match
+                conversation = conv;
+                threadId = info.id;
+                break;
+            }
+        }
+    }
+    if (!conversation) {
+        const lookupMethod = input.id
+            ? `ID '${input.id}'`
+            : input.title
+                ? `title '${input.title}'`
+                : `title containing '${input.titleContains}'`;
+        return {
+            found: false,
+            error: `Thread not found with ${lookupMethod}`,
+            source: input.source,
+        };
+    }
+    // Format output based on requested format
+    if (input.format === "messages") {
+        const messages = input.maxMessages
+            ? conversation.messages.slice(-input.maxMessages)
+            : conversation.messages;
+        return {
+            found: true,
+            id: threadId,
+            title: conversation.metadata.title,
+            source: input.source,
+            format: "messages",
+            messages,
+            totalMessages: conversation.messages.length,
+        };
+    }
+    if (input.format === "narrative") {
+        return {
+            found: true,
+            id: threadId,
+            title: conversation.metadata.title,
+            source: input.source,
+            format: "narrative",
+            content: formatNarrative(conversation, input.maxMessages),
+            totalMessages: conversation.messages.length,
+        };
+    }
+    // Default: structured
+    const structured = formatStructured(conversation, input.maxMessages);
+    return {
+        found: true,
+        id: threadId,
+        source: input.source,
+        format: "structured",
+        ...structured,
+        totalMessages: conversation.messages.length,
+    };
+}
+export const resumeThreadTool = {
+    name: "resume_thread",
+    description: "Load a saved conversation thread to continue where you left off. " +
+        "Returns the conversation context in different formats: " +
+        "'structured' (organized data), 'narrative' (readable summary), or 'messages' (raw). " +
+        "Use this to pick up previous conversations.",
+    inputSchema: ResumeThreadInputSchema,
+    handler: resumeThread,
+};
+//# sourceMappingURL=resume-thread.js.map

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

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