techprufer-mcp 0.4.1 → 0.4.3

package/dist/server.js

@@ -8,6 +8,13 @@ import { runLogin } from './login.js';
 function textResult(text, isError = false) {
     return { content: [{ type: 'text', text }], isError };
 }
+/** Prefer API `markdown` field; fall back to JSON for structured payloads. */
+function apiResult(data, isError = false) {
+    const md = typeof data.markdown === 'string' ? data.markdown : null;
+    if (md)
+        return textResult(md, isError);
+    return textResult(JSON.stringify(data, null, 2), isError);
+}
 function requireAuthMessage() {
     return (`Not logged in. Run: npx techprufer-mcp login\n` +
         `Credentials file: ${credentialsFilePath()}\n` +
@@ -21,7 +28,7 @@ export function createServer() {
     const server = new McpServer({
         name: 'techprufer',
         title: 'TechPrufer',
-        version: '0.4.1',
+        version: '0.4.3',
         description: 'Tailor resumes and build profiles with your AI tool — no Gemini API key.',
         websiteUrl: 'https://techprufer.com',
         icons: brandIcons(),
@@ -155,8 +162,9 @@ export function createServer() {
                         '   - Tell the user: this company has N other tracked roles — attach this resume to them?',
                         '   - If yes: preview_company_siblings then attach_tailored_to_siblings({ sourceApplicationId, sessionId }).',
                         '   - If no: leave siblings alone.',
-                        '6) Always show the user from submit result: jdUrl (job link), resumePdfUrl, dashboardUrl.',
-                        '   On that job page the Chrome extension can inject or download the PDF when resumePdfUrl is set.',
+                        '6) Always show the user from submit result: jdUrl (job link), dashboardUrl.',
+                        '   resumePdfUrl is an on-demand API URL (requires login) — never show /generated/ paths.',
+                        '   On the dashboard application page the Chrome extension can inject or download the PDF.',
                         '',
                         'Zero hallucination. Complete JSON only when submitting or saving.',
                     ].join('\n'),
@@ -164,6 +172,73 @@ export function createServer() {
             },
         ],
     }));
+    server.tool('list_profile_templates', 'List all 6 TechPrufer resume templates with descriptions, tiers, focus order, and boosts. ' +
+        'Use when the user wants to compare template options during build-profile.', {}, async () => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            const data = await apiFetch('/api/agent/templates');
+            return apiResult(data);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Failed to list templates: ${msg}`, true);
+        }
+    });
+    server.tool('recommend_profile_template', 'Analyze resume text and recommend the best of 6 templates, with ranked alternatives and a comparison guide. ' +
+        'Run after extracting text from a PDF the user attached in chat.', {
+        resumeText: z.string().describe('Full plain text extracted from the resume PDF'),
+    }, async ({ resumeText }) => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            const data = await apiFetch('/api/agent/templates/recommend', {
+                method: 'POST',
+                body: JSON.stringify({ resumeText }),
+            });
+            return apiResult(data);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Template recommendation failed: ${msg}`, true);
+        }
+    });
+    server.tool('analyze_profile_job', 'Analyze a queued site PDF job for template recommendation without claiming it. ' +
+        'Use before get_profile_job when templateSlug is not set.', {
+        jobId: z.string().describe('Profile job id from list_pending_profile_jobs'),
+    }, async ({ jobId }) => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            const data = await apiFetch(`/api/agent/profile-jobs/${encodeURIComponent(jobId)}/analyze`);
+            return apiResult(data);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Analyze job failed: ${msg}`, true);
+        }
+    });
+    server.tool('set_profile_job_template', 'Set the gallery template slug on a queued profile job before parsing/build.', {
+        jobId: z.string(),
+        templateSlug: z
+            .string()
+            .describe('Slug from list_profile_templates / recommend_profile_template (e.g. student-classic)'),
+    }, async ({ jobId, templateSlug }) => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            const data = await apiFetch(`/api/agent/profile-jobs/${encodeURIComponent(jobId)}/template`, { method: 'PATCH', body: JSON.stringify({ templateSlug }) });
+            return textResult(JSON.stringify(data, null, 2));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Set template failed: ${msg}`, true);
+        }
+    });
     server.tool('list_pending_profile_jobs', 'List TechPrufer profile-build jobs queued for MCP (from PDF upload on the site).', {}, async () => {
         const token = await ensureToken();
         if (!token)
@@ -198,7 +273,7 @@ export function createServer() {
                 id = first.id;
             }
             const payload = await apiFetch(`/api/agent/profile-jobs/${encodeURIComponent(id)}/payload`);
-            return textResult(JSON.stringify(payload, null, 2));
+            return apiResult(payload);
         }
         catch (e) {
             const msg = e instanceof Error ? e.message : String(e);
@@ -253,7 +328,11 @@ export function createServer() {
         name: z.string().optional().describe('Profile display name'),
         isDefault: z.boolean().optional(),
         model: z.string().optional(),
-    }, async ({ profileJson, name, isDefault, model }) => {
+        templateSlug: z
+            .string()
+            .optional()
+            .describe('Gallery template slug chosen by the user (from recommend_profile_template)'),
+    }, async ({ profileJson, name, isDefault, model, templateSlug }) => {
         const token = await ensureToken();
         if (!token)
             return textResult(requireAuthMessage(), true);
@@ -261,7 +340,7 @@ export function createServer() {
             const parsed = typeof profileJson === 'string' ? JSON.parse(profileJson) : profileJson;
             const result = await apiFetch('/api/agent/profiles', {
                 method: 'POST',
-                body: JSON.stringify({ profileJson: parsed, name, isDefault, model }),
+                body: JSON.stringify({ profileJson: parsed, name, isDefault, model, templateSlug }),
             });
             return textResult(JSON.stringify(result, null, 2));
         }
@@ -526,20 +605,30 @@ export function createServer() {
                     text: [
                         'Build TechPrufer master profile(s) via MCP.',
                         '',
+                        'TEMPLATE STEP (always before parsing — PDF in chat or queued job):',
+                        '1. Extract full resume text (from attached PDF or analyze_profile_job for site queue).',
+                        '2. Call recommend_profile_template(resumeText) OR analyze_profile_job(jobId).',
+                        '3. Tell the user: show the **markdown** from the tool response (recommended template + ask if they want other options).',
+                        '4. Ask: "Want to see other template versions?"',
+                        '   - If yes: the markdown already includes ranked alternatives and a comparison section — walk through the differences.',
+                        '5. Wait for the user to pick a template slug.',
+                        '   - Queued job: set_profile_job_template(jobId, slug) before get_profile_job.',
+                        '   - Local PDF: pass templateSlug to submit_built_profile.',
+                        '',
                         'Path A — queued PDF jobs from the site:',
                         jobId
-                            ? `1. Call get_profile_job with jobId=${jobId}.`
-                            : '1. Call list_pending_profile_jobs; for each QUEUED/CLAIMED job call get_profile_job.',
+                            ? `1. analyze_profile_job(${jobId}) → template pick → set_profile_job_template → get_profile_job.`
+                            : '1. list_pending_profile_jobs → analyze_profile_job → template pick → set_profile_job_template → get_profile_job.',
                         '2. Execute returned messages verbatim; output ONLY CPM profile JSON.',
                         '3. Call submit_profile_job_result. On correctiveMessage, fix once and resubmit.',
                         '',
-                        'Path B — local resume file (user selected / open in this tool):',
-                        '1. Read the resume file and extract full text.',
-                        '2. Call get_profile_build_messages with that resumeText.',
-                        '3. Execute messages verbatim; output ONLY CPM profile JSON.',
-                        '4. Call submit_built_profile (optional name from file / identity.name).',
+                        'Path B — PDF/resume attached in this chat:',
+                        '1. Read/extract full text from the attached PDF.',
+                        '2. recommend_profile_template → user picks template (steps above).',
+                        '3. get_profile_build_messages(resumeText) → execute verbatim → CPM JSON only.',
+                        '4. submit_built_profile with templateSlug + optional name.',
                         '',
-                        'Prefer Path A if pending jobs exist; otherwise Path B when a local resume is available.',
+                        'Prefer Path A if pending jobs exist; otherwise Path B when user attached a PDF.',
                         'Zero hallucination. Complete JSON only. Faithful extraction, not rewriting.',
                     ].join('\n'),
                 },

package/dist/tools.js

@@ -167,26 +167,26 @@ const CODEX_TAILOR_PROMPT = [
     '1) list_pending_tailor_jobs — if jobs[]: offer to process; if empty: show prepareSummary + prepareApplications (Prepare pipeline roles needing a resume).',
     '2) applicationId / profileId: enqueue or edit/delete.',
     '3) Company picker: list_tracked_companies (top 10 / query) → list_applications_at_company → enqueue_tailor_job → process.',
-    '4) After submit_tailor_result: show jdUrl + resumePdfUrl. If siblingCount>0, ask to attach to other roles (preview_company_siblings → attach_tailored_to_siblings).',
+    '4) After submit_tailor_result: show jdUrl + dashboardUrl. resumePdfUrl only if present (API URL, not /generated/). If siblingCount>0, ask to attach to other roles (preview_company_siblings → attach_tailored_to_siblings).',
     '',
     'Zero hallucination. Complete JSON only when submitting or saving.',
     '',
 ].join('\n');
 const CODEX_BUILD_PROFILE_PROMPT = [
-    'Process TechPrufer MCP profile-build jobs (or build from a local resume).',
+    'Process TechPrufer MCP profile-build jobs (or build from a PDF/resume in chat).',
+    '',
+    'TEMPLATE STEP (before parsing):',
+    '1. Extract resume text (PDF attachment or analyze_profile_job for site queue).',
+    '2. recommend_profile_template → show the markdown to the user (recommended + ask if they want other options).',
+    '3. If yes: markdown includes ranked alternatives and comparison — explain differences.',
+    '4. User picks slug → set_profile_job_template (queued) or templateSlug on submit_built_profile (local).',
     '',
     'Path A — queued PDF jobs from the site:',
-    '1. Call list_pending_profile_jobs; for each QUEUED/CLAIMED job call get_profile_job.',
-    '2. Execute returned messages verbatim; output ONLY CPM profile JSON.',
-    '3. Call submit_profile_job_result. On correctiveMessage, fix once and resubmit.',
+    'analyze_profile_job → template pick → set_profile_job_template → get_profile_job → submit_profile_job_result.',
     '',
-    'Path B — local resume file (user selected / open in this tool):',
-    '1. Read the resume file and extract full text.',
-    '2. Call get_profile_build_messages with that resumeText.',
-    '3. Execute messages verbatim; output ONLY CPM profile JSON.',
-    '4. Call submit_built_profile (optional name from file / identity.name).',
+    'Path B — PDF attached in chat:',
+    'extract text → recommend_profile_template → user picks → get_profile_build_messages → submit_built_profile(templateSlug).',
     '',
-    'Prefer Path A if pending jobs exist; otherwise Path B when a local resume is available.',
     'Zero hallucination. Complete JSON only. Faithful extraction, not rewriting.',
     '',
 ].join('\n');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "techprufer-mcp",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "TechPrufer MCP — tailor resumes and build profiles from your AI tool",
   "homepage": "https://techprufer.com",
   "type": "module",