latitude-mcp-server 3.0.1 → 3.1.0

package/dist/tools.d.ts

@@ -1,15 +1,14 @@
 /**
  * MCP Tools for Latitude
  *
- * 8 Tools:
- * - list_prompts   : List all prompt names in LIVE
- * - get_prompt     : Get full prompt content by name
- * - run_prompt     : Execute a prompt with parameters
- * - push_prompts   : FULL SYNC to remote (adds, modifies, DELETES remote prompts not in local)
- * - pull_prompts   : FULL SYNC from remote (deletes ALL local, downloads ALL from LIVE)
- * - append_prompts : ADDITIVE only (adds new, optionally updates existing, NEVER deletes)
- * - replace_prompt : Replace/create a single prompt (supports file path)
- * - docs           : Documentation (help, get topic, find query)
+ * 7 Tools:
+ * - list_prompts : List all prompt names in LIVE
+ * - get_prompt   : Get full prompt content by name
+ * - run_prompt   : Execute a prompt with parameters (dynamic prompt list + variables)
+ * - push_prompts : FULL SYNC to remote (adds, modifies, DELETES remote prompts not in local)
+ * - pull_prompts : FULL SYNC from remote (deletes ALL local, downloads ALL from LIVE)
+ * - add_prompt   : ADDITIVE - add/overwrite prompts without deleting others (dynamic prompt list)
+ * - docs         : Documentation (help, get topic, find query)
  */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare function registerTools(server: McpServer): Promise<void>;

package/dist/tools.js

@@ -2,15 +2,14 @@
 /**
  * MCP Tools for Latitude
  *
- * 8 Tools:
- * - list_prompts   : List all prompt names in LIVE
- * - get_prompt     : Get full prompt content by name
- * - run_prompt     : Execute a prompt with parameters
- * - push_prompts   : FULL SYNC to remote (adds, modifies, DELETES remote prompts not in local)
- * - pull_prompts   : FULL SYNC from remote (deletes ALL local, downloads ALL from LIVE)
- * - append_prompts : ADDITIVE only (adds new, optionally updates existing, NEVER deletes)
- * - replace_prompt : Replace/create a single prompt (supports file path)
- * - docs           : Documentation (help, get topic, find query)
+ * 7 Tools:
+ * - list_prompts : List all prompt names in LIVE
+ * - get_prompt   : Get full prompt content by name
+ * - run_prompt   : Execute a prompt with parameters (dynamic prompt list + variables)
+ * - push_prompts : FULL SYNC to remote (adds, modifies, DELETES remote prompts not in local)
+ * - pull_prompts : FULL SYNC from remote (deletes ALL local, downloads ALL from LIVE)
+ * - add_prompt   : ADDITIVE - add/overwrite prompts without deleting others (dynamic prompt list)
+ * - docs         : Documentation (help, get topic, find query)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerTools = registerTools;
@@ -106,6 +105,73 @@ function formatAvailablePrompts(names) {
     const formatted = names.map(n => `\`${n}\``).join(', ');
     return `\n\n**Available prompts (${names.length}):** ${formatted}`;
 }
+/**
+ * Extract variable names from prompt content
+ * Looks for {{ variable }} and { variable } patterns
+ */
+function extractVariables(content) {
+    const variables = new Set();
+    // Match {{ variable }} and { variable } patterns (PromptL syntax)
+    const patterns = [
+        /\{\{\s*(\w+)\s*\}\}/g, // {{ variable }}
+        /\{\s*(\w+)\s*\}/g, // { variable }
+    ];
+    for (const pattern of patterns) {
+        let match;
+        while ((match = pattern.exec(content)) !== null) {
+            // Exclude control flow keywords
+            const varName = match[1];
+            if (!['if', 'else', 'each', 'let', 'end', 'for', 'unless'].includes(varName)) {
+                variables.add(varName);
+            }
+        }
+    }
+    return Array.from(variables);
+}
+/**
+ * Build dynamic description for run_prompt with prompt names and their variables
+ */
+async function buildRunPromptDescription() {
+    const names = await getCachedPromptNames();
+    let desc = 'Execute a prompt with parameters.';
+    if (names.length === 0) {
+        desc += '\n\n**No prompts in LIVE yet.**';
+        return desc;
+    }
+    desc += `\n\n**Available prompts (${names.length}):**`;
+    // Fetch each prompt to get its variables (limit to avoid too long description)
+    const maxToShow = Math.min(names.length, 10);
+    for (let i = 0; i < maxToShow; i++) {
+        try {
+            const doc = await (0, api_js_1.getDocument)(names[i], 'live');
+            const vars = extractVariables(doc.content);
+            if (vars.length > 0) {
+                desc += `\n- \`${names[i]}\` (params: ${vars.map(v => `\`${v}\``).join(', ')})`;
+            }
+            else {
+                desc += `\n- \`${names[i]}\` (no params)`;
+            }
+        }
+        catch {
+            desc += `\n- \`${names[i]}\``;
+        }
+    }
+    if (names.length > maxToShow) {
+        desc += `\n- ... and ${names.length - maxToShow} more`;
+    }
+    return desc;
+}
+/**
+ * Build dynamic description for add_prompt with available prompts
+ */
+async function buildAddPromptDescription() {
+    const names = await getCachedPromptNames();
+    let desc = 'Add or update prompt(s) in LIVE without deleting others. ';
+    desc += 'If a prompt with the same name exists, it will be overwritten. ';
+    desc += 'Provide `prompts` array OR `filePaths` to .promptl files.';
+    desc += formatAvailablePrompts(names);
+    return desc;
+}
 /**
  * Validate all prompts BEFORE pushing.
  * If ANY prompt fails validation, returns all errors and NOTHING is pushed.
@@ -303,25 +369,20 @@ async function handlePushPrompts(args) {
         return formatError(error);
     }
 }
-const AppendPromptsSchema = zod_1.z.object({
+const AddPromptSchema = zod_1.z.object({
     prompts: zod_1.z
         .array(zod_1.z.object({
         name: zod_1.z.string().describe('Prompt name'),
         content: zod_1.z.string().describe('Prompt content'),
     }))
         .optional()
-        .describe('Prompts to append - ADDITIVE: keeps existing prompts, adds new ones'),
+        .describe('Prompts to add/update - overwrites if exists, adds if new'),
     filePaths: zod_1.z
         .array(zod_1.z.string())
         .optional()
-        .describe('File paths to .promptl files - ADDITIVE: never deletes existing prompts'),
-    overwrite: zod_1.z
-        .boolean()
-        .optional()
-        .default(false)
-        .describe('If true, update existing prompts with same name (still no deletions)'),
+        .describe('File paths to .promptl files - overwrites if exists, adds if new'),
 });
-async function handleAppendPrompts(args) {
+async function handleAddPrompt(args) {
     try {
         // Build prompts from either direct input or file paths
         let prompts = [];
@@ -337,9 +398,9 @@ async function handleAppendPrompts(args) {
         if (prompts.length === 0) {
             return formatError(new Error('No prompts provided. Use either prompts array or filePaths.'));
         }
-        // PRE-VALIDATE ALL PROMPTS BEFORE APPENDING
-        // If ANY prompt fails validation, return errors and append NOTHING
-        logger.info(`Validating ${prompts.length} prompt(s) before append...`);
+        // PRE-VALIDATE ALL PROMPTS BEFORE ADDING
+        // If ANY prompt fails validation, return errors and add NOTHING
+        logger.info(`Validating ${prompts.length} prompt(s) before add...`);
         const validation = await validateAllPrompts(prompts);
         if (!validation.valid) {
             logger.warn(`Validation failed for ${validation.errors.length} prompt(s)`);
@@ -349,26 +410,20 @@ async function handleAppendPrompts(args) {
         // Get existing prompts
         const existingDocs = await (0, api_js_1.listDocuments)('live');
         const existingMap = new Map(existingDocs.map((d) => [d.path, d]));
-        // Build changes - append does NOT delete existing prompts
+        // Build changes - ALWAYS overwrite if exists, add if new, NEVER delete
         const changes = [];
-        const skipped = [];
         for (const prompt of prompts) {
             const existingDoc = existingMap.get(prompt.name);
             if (existingDoc) {
-                if (args.overwrite) {
-                    // Only include if content is different
-                    if (existingDoc.content !== prompt.content) {
-                        changes.push({
-                            path: prompt.name,
-                            content: prompt.content,
-                            status: 'modified',
-                        });
-                    }
-                    // If same content, skip silently (unchanged)
-                }
-                else {
-                    skipped.push(prompt.name);
+                // Only include if content is different
+                if (existingDoc.content !== prompt.content) {
+                    changes.push({
+                        path: prompt.name,
+                        content: prompt.content,
+                        status: 'modified',
+                    });
                 }
+                // If same content, skip silently (unchanged)
             }
             else {
                 // New prompt
@@ -382,28 +437,19 @@ async function handleAppendPrompts(args) {
         // Summarize
         const added = changes.filter((c) => c.status === 'added');
         const modified = changes.filter((c) => c.status === 'modified');
-        if (changes.length === 0 && skipped.length === 0) {
+        if (changes.length === 0) {
             const newNames = await forceRefreshAndGetNames();
             return formatSuccess('No Changes Needed', `All ${prompts.length} prompt(s) are already up to date.\n\n` +
                 `**Current LIVE prompts (${newNames.length}):** ${newNames.map(n => `\`${n}\``).join(', ')}`);
         }
-        if (changes.length === 0) {
-            const newNames = await forceRefreshAndGetNames();
-            let content = `**Skipped:** ${skipped.length} (already exist, use overwrite=true to update)\n`;
-            content += `\n---\n**Current LIVE prompts (${newNames.length}):** ${newNames.map(n => `\`${n}\``).join(', ')}`;
-            return formatSuccess('No Changes Made', content);
-        }
         // Push all changes in one batch
         try {
-            const result = await (0, api_js_1.deployToLive)(changes, 'append');
+            const result = await (0, api_js_1.deployToLive)(changes, 'add');
             // Force refresh cache after mutations
             const newNames = await forceRefreshAndGetNames();
             let content = `**Summary:**\n`;
             content += `- Added: ${added.length}\n`;
             content += `- Updated: ${modified.length}\n`;
-            if (skipped.length > 0) {
-                content += `- Skipped: ${skipped.length} (use overwrite=true)\n`;
-            }
             content += `- Documents processed: ${result.documentsProcessed}\n\n`;
             if (added.length > 0) {
                 content += `### Added\n${added.map((c) => `- \`${c.path}\``).join('\n')}\n\n`;
@@ -411,11 +457,8 @@ async function handleAppendPrompts(args) {
             if (modified.length > 0) {
                 content += `### Updated\n${modified.map((c) => `- \`${c.path}\``).join('\n')}\n\n`;
             }
-            if (skipped.length > 0) {
-                content += `### Skipped (already exist)\n${skipped.map(n => `- \`${n}\``).join('\n')}\n\n`;
-            }
             content += `---\n**Current LIVE prompts (${newNames.length}):** ${newNames.map(n => `\`${n}\``).join(', ')}`;
-            return formatSuccess('Prompts Appended to LIVE', content);
+            return formatSuccess('Prompts Added to LIVE', content);
         }
         catch (error) {
             // Detailed error from API
@@ -472,93 +515,13 @@ async function handlePullPrompts(args) {
         content += `**Written:** ${written.length} file(s)\n\n`;
         content += `### Files\n\n`;
         content += written.map((f) => `- \`${f}\``).join('\n');
-        content += `\n\n**Tip:** Edit files locally, then use \`replace_prompt\` with \`filePath\` to push changes.`;
+        content += `\n\n**Tip:** Edit files locally, then use \`add_prompt\` with \`filePaths\` to push changes.`;
         return formatSuccess('Prompts Pulled from LIVE', content);
     }
     catch (error) {
         return formatError(error);
     }
 }
-// Dynamic description builder for replace_prompt
-async function buildReplacePromptDescription() {
-    const names = await getCachedPromptNames();
-    let desc = 'Replace or create a single prompt in LIVE. ';
-    desc += 'Provide either `content` directly or `filePath` to read from local file.';
-    desc += formatAvailablePrompts(names);
-    return desc;
-}
-const ReplacePromptSchema = zod_1.z.object({
-    name: zod_1.z
-        .string()
-        .optional()
-        .describe('Prompt name to replace (auto-detected from filePath if not provided)'),
-    content: zod_1.z
-        .string()
-        .optional()
-        .describe('New prompt content (alternative to filePath)'),
-    filePath: zod_1.z
-        .string()
-        .optional()
-        .describe('Path to .promptl file to read content from (alternative to content)'),
-});
-async function handleReplacePrompt(args) {
-    try {
-        let name = args.name;
-        let content = args.content;
-        // If filePath provided, read from file
-        if (args.filePath) {
-            const fileData = readPromptFile(args.filePath);
-            content = fileData.content;
-            // Use filename as name if not explicitly provided
-            if (!name) {
-                name = fileData.name;
-            }
-        }
-        // Validate we have both name and content
-        if (!name) {
-            return formatError(new Error('Prompt name is required. Provide `name` or use `filePath` (name derived from filename).'));
-        }
-        if (!content) {
-            return formatError(new Error('Prompt content is required. Provide either `content` or `filePath`.'));
-        }
-        // PRE-VALIDATE PROMPT BEFORE REPLACING
-        // If validation fails, return error and replace NOTHING
-        logger.info(`Validating prompt "${name}" before replace...`);
-        const validation = await validateAllPrompts([{ name, content }]);
-        if (!validation.valid) {
-            logger.warn(`Validation failed for prompt "${name}"`);
-            return formatValidationErrors(validation.errors);
-        }
-        logger.info(`Prompt "${name}" passed validation`);
-        // Check if prompt exists
-        const existingDocs = await (0, api_js_1.listDocuments)('live');
-        const exists = existingDocs.some((d) => d.path === name);
-        const changes = [
-            {
-                path: name,
-                content: content,
-                status: exists ? 'modified' : 'added',
-            },
-        ];
-        // Deploy to LIVE (creates branch → pushes → publishes)
-        const { version } = await (0, api_js_1.deployToLive)(changes, `replace ${name}`);
-        // Force refresh cache after mutation
-        const newNames = await forceRefreshAndGetNames();
-        const action = exists ? 'Replaced' : 'Created';
-        let result = `**Prompt:** \`${name}\`\n`;
-        result += `**Action:** ${action}\n`;
-        result += `**Version:** \`${version.uuid}\`\n`;
-        if (args.filePath) {
-            result += `**Source:** \`${args.filePath}\`\n`;
-        }
-        result += `\n### Content Preview\n\n\`\`\`promptl\n${content.substring(0, 500)}${content.length > 500 ? '...' : ''}\n\`\`\``;
-        result += `\n\n---\n**Current LIVE prompts (${newNames.length}):** ${newNames.map(n => `\`${n}\``).join(', ')}`;
-        return formatSuccess(`Prompt ${action}`, result);
-    }
-    catch (error) {
-        return formatError(error);
-    }
-}
 const DocsSchema = zod_1.z.object({
     action: zod_1.z
         .enum(['help', 'get', 'find'])
@@ -614,37 +577,34 @@ async function registerTools(server) {
         description: 'Get full prompt content by name',
         inputSchema: GetPromptSchema,
     }, handleGetPrompt);
+    // Build dynamic description with prompt names and their variables
+    const runDesc = await buildRunPromptDescription();
     server.registerTool('run_prompt', {
         title: 'Run Prompt',
-        description: 'Execute a prompt with parameters',
+        description: runDesc,
         inputSchema: RunPromptSchema,
     }, handleRunPrompt);
     server.registerTool('push_prompts', {
-        title: 'Push Prompts',
-        description: 'Replace ALL prompts in LIVE. Provide `prompts` array OR `filePaths` to .promptl files. Creates branch → pushes → publishes automatically.',
+        title: 'Push Prompts (FULL SYNC)',
+        description: 'FULL SYNC: Replace ALL prompts in LIVE. Deletes remote prompts not in your list. Use for initialization or complete sync.',
         inputSchema: PushPromptsSchema,
     }, handlePushPrompts);
-    server.registerTool('append_prompts', {
-        title: 'Append Prompts',
-        description: 'Add prompts to LIVE without removing existing. Provide `prompts` array OR `filePaths`. Use overwrite=true to replace existing.',
-        inputSchema: AppendPromptsSchema,
-    }, handleAppendPrompts);
     server.registerTool('pull_prompts', {
-        title: 'Pull Prompts',
-        description: 'Download all prompts from LIVE to local ./prompts/*.promptl files',
+        title: 'Pull Prompts (FULL SYNC)',
+        description: 'FULL SYNC: Download all prompts from LIVE to local ./prompts/*.promptl files. Deletes existing local files first.',
         inputSchema: PullPromptsSchema,
     }, handlePullPrompts);
     // Build dynamic description with available prompts
-    const replaceDesc = await buildReplacePromptDescription();
-    server.registerTool('replace_prompt', {
-        title: 'Replace Prompt',
-        description: replaceDesc,
-        inputSchema: ReplacePromptSchema,
-    }, handleReplacePrompt);
+    const addDesc = await buildAddPromptDescription();
+    server.registerTool('add_prompt', {
+        title: 'Add/Update Prompt',
+        description: addDesc,
+        inputSchema: AddPromptSchema,
+    }, handleAddPrompt);
     server.registerTool('docs', {
         title: 'Documentation',
         description: 'Get documentation. Actions: help (overview), get (topic), find (search)',
         inputSchema: DocsSchema,
     }, handleDocs);
-    logger.info(`Registered 8 MCP tools (${cachedPromptNames.length} prompts cached)`);
+    logger.info(`Registered 7 MCP tools (${cachedPromptNames.length} prompts cached)`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "latitude-mcp-server",
-	"version": "3.0.1",
+	"version": "3.1.0",
 	"description": "Simplified MCP server for Latitude.so prompt management - 8 focused tools for push, pull, run, and manage prompts",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",

package/prompts/cover-letter-generate.promptl

@@ -0,0 +1,71 @@
+---
+provider: LiteLLM
+model: claude-haiku-4-5
+temperature: 0.7
+schema:
+  type: object
+  properties:
+    cover_letter:
+      type: string
+      description: "The complete cover letter text"
+    key_points:
+      type: array
+      items:
+        type: string
+      description: "3-5 key points that make this candidate special for this role"
+    tone:
+      type: string
+      enum: [professional, enthusiastic, confident, conversational]
+      description: "The tone used in the letter"
+  required: [cover_letter, key_points, tone]
+---
+
+<system>
+# ROLE: The Ghostwriter - Elite Cover Letter Specialist
+
+You write cover letters that get interviews. Your letters are:
+- **Personal**: Reference specific career achievements
+- **Targeted**: Connect experience directly to job requirements  
+- **Concise**: 250-350 words, no fluff
+- **Unique**: Never generic, always tailored
+
+## FORMAT
+
+```
+[Opening: Hook with relevant achievement]
+
+[Body 1: Connect 2-3 career patterns to job requirements]
+
+[Body 2: Address company/role specifically]
+
+[Closing: Clear call to action]
+```
+
+## RULES
+
+1. **Use specific numbers** from patterns (years, percentages, team sizes)
+2. **Mirror job language** - use their keywords naturally
+3. **Show, don't tell** - achievements over adjectives
+4. **Address gaps proactively** if skills don't match
+5. **NO clichés**: "passionate", "team player", "hard worker", "excited to apply"
+
+## KEY POINTS SELECTION
+
+Extract 3-5 points that:
+- Directly match required skills
+- Show quantifiable impact
+- Demonstrate growth/leadership
+- Are unique to this candidate
+</system>
+
+<user>
+Write a cover letter for this job:
+
+**Job Details:**
+{{ job_details }}
+
+**Candidate's Career Patterns:**
+{{ career_patterns }}
+
+Generate a personalized cover letter that connects their experience to this specific role at {{ company_name }}.
+</user>