techprufer-mcp 0.4.0 → 0.4.3

package/dist/api.d.ts

@@ -5,6 +5,7 @@ export declare class ApiError extends Error {
     constructor(status: number, body: unknown, message?: string);
 }
 export declare function setActiveClientInfo(info: ClientInfo | null): void;
+export declare function setClientInfoSync(fn: (() => ClientInfo | null | undefined) | null): void;
 export declare function getActiveClientInfo(): ClientInfo | null;
 export declare function apiFetch<T>(path: string, init?: RequestInit & {
     token?: string | null;

package/dist/api.js

@@ -22,12 +22,28 @@ function formatFetchError(err) {
 }
 /** Set by the stdio server after the MCP initialize handshake. */
 let activeClientInfo = null;
+/** Re-read MCP clientInfo from the SDK before each API call (hosts may omit it until later). */
+let clientInfoSync = null;
 export function setActiveClientInfo(info) {
     activeClientInfo = info;
 }
+export function setClientInfoSync(fn) {
+    clientInfoSync = fn;
+}
 export function getActiveClientInfo() {
     return activeClientInfo;
 }
+function refreshActiveClientInfo() {
+    if (!clientInfoSync)
+        return;
+    const info = clientInfoSync();
+    if (info?.name?.trim()) {
+        setActiveClientInfo({
+            name: info.name.trim(),
+            version: info.version?.trim() || undefined,
+        });
+    }
+}
 export async function apiFetch(path, init = {}) {
     const creds = loadCredentials();
     const token = init.token === undefined ? creds?.token : init.token;
@@ -45,6 +61,7 @@ export async function apiFetch(path, init = {}) {
     }
     if (token)
         headers.set('Authorization', `Bearer ${token}`);
+    refreshActiveClientInfo();
     const clientHeader = formatClientHeader(activeClientInfo);
     if (clientHeader)
         headers.set(TP_CLIENT_HEADER, clientHeader);

package/dist/cli.js

@@ -46,11 +46,13 @@ async function main() {
     const cmd = args[0];
     if (cmd === 'login') {
         const nameIdx = args.indexOf('--name');
-        const deviceName = nameIdx >= 0 ? args[nameIdx + 1] : undefined;
+        const explicitDeviceName = nameIdx >= 0 ? args[nameIdx + 1] : undefined;
         const skipSetup = hasFlag(args, '--no-setup');
         const timeoutSec = parseTimeoutSec(args);
         const tools = parseToolsFlag(args);
-        let configuredIds = [];
+        let configuredIds = tools?.length
+            ? tools
+            : [];
         if (!skipSetup) {
             const outcome = await runSetup({
                 beforeLogin: true,
@@ -65,6 +67,7 @@ async function main() {
                 return;
             console.error('');
         }
+        const deviceName = explicitDeviceName ?? configuredIds[0];
         await runLogin(deviceName, {
             stepLabel: skipSetup ? undefined : 'login',
             timeoutSec,

package/dist/server.js

@@ -1,13 +1,20 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
-import { apiFetch, ApiError, setActiveClientInfo } from './api.js';
+import { apiFetch, ApiError, setActiveClientInfo, setClientInfoSync } from './api.js';
 import { brandIcons } from './brand.js';
 import { loadCredentials, credentialsFilePath } from './config.js';
 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,18 +28,25 @@ export function createServer() {
     const server = new McpServer({
         name: 'techprufer',
         title: 'TechPrufer',
-        version: '0.4.0',
+        version: '0.4.3',
         description: 'Tailor resumes and build profiles with your AI tool — no Gemini API key.',
         websiteUrl: 'https://techprufer.com',
         icons: brandIcons(),
     });
-    server.tool('list_pending_tailor_jobs', 'List TechPrufer tailor jobs queued for MCP. Returns id, company, role, status.', {}, async () => {
+    server.tool('list_pending_tailor_jobs', 'List queued MCP tailor jobs. Always includes Prepare-stage applications needing a resume ' +
+        '(prepareSummary + prepareApplications) so when the queue is empty you can show the user ' +
+        'their Prepare pipeline backlog and proceed to enqueue_tailor_job / company picker.', {}, async () => {
         const token = await ensureToken();
         if (!token)
             return textResult(requireAuthMessage(), true);
         try {
             const data = await apiFetch('/api/agent/jobs');
-            return textResult(JSON.stringify(data.jobs ?? [], null, 2));
+            return textResult(JSON.stringify({
+                jobs: data.jobs ?? [],
+                prepareSummary: data.prepareSummary ?? null,
+                prepareApplications: data.prepareApplications ?? [],
+                prepareTotal: data.prepareTotal ?? 0,
+            }, null, 2));
         }
         catch (e) {
             const msg = e instanceof Error ? e.message : String(e);
@@ -124,14 +138,21 @@ export function createServer() {
                         '### Flow',
                         jobId
                             ? `1) Process jobId=${jobId}: get_tailor_job → execute → submit_tailor_result.`
-                            : '1) Call list_pending_tailor_jobs. Show company/role for each. Ask: process them now, or SKIP to company picker? If process: ONE AT A TIME (get_tailor_job → execute → submit_tailor_result; fix once on correctiveMessage).',
+                            : [
+                                '1) Call list_pending_tailor_jobs.',
+                                '   - If jobs[] is non-empty: show company/role for each queued job. Ask: process them now, or SKIP to Prepare picker?',
+                                '     If process: ONE AT A TIME (get_tailor_job → execute → submit_tailor_result; fix once on correctiveMessage).',
+                                '   - If jobs[] is empty: show prepareSummary (totalPrepare / needingTailor) and prepareApplications',
+                                '     (company, role, dashboardUrl for each Prepare-stage role still missing a tailored resume).',
+                                '     Ask which to tailor, or SKIP to the company picker (step 4).',
+                            ].join('\n'),
                         applicationId
                             ? `2) applicationId=${applicationId}: enqueue_tailor_job({ applicationId }) then process, OR get_resume(kind=tailored) to edit/delete.`
                             : '2) If user gave an application id: enqueue_tailor_job or edit/delete that app.',
                         profileId
                             ? `3) profileId=${profileId}: get_resume(kind=base) → update_resume / delete_resume.`
                             : '3) If user gave a base profile id: edit/delete that base resume.',
-                        '4) Company picker (when skipping pending / no id):',
+                        '4) Company picker (when skipping pending / no id / user picks from Prepare list):',
                         '   - list_tracked_companies (top 10, paginate, or query= typed name). Show total / withTailored / withoutTailored.',
                         '   - Ask which company (or they type the name).',
                         '   - list_applications_at_company(company, onlyUntailored=true preferred for new tailor). If multiple roles, list roles and ask which.',
@@ -141,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'),
@@ -150,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)
@@ -184,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);
@@ -239,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);
@@ -247,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));
         }
@@ -512,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'),
                 },
@@ -536,15 +639,18 @@ export function createServer() {
 }
 export async function startStdioServer() {
     const server = createServer();
+    const syncClientInfo = () => {
+        const info = server.server.getClientVersion();
+        if (!info?.name?.trim())
+            return null;
+        return { name: info.name.trim(), version: info.version?.trim() || undefined };
+    };
     // Capture IDE identity from the MCP initialize handshake (not env vars).
+    setClientInfoSync(syncClientInfo);
     server.server.oninitialized = () => {
-        const info = server.server.getClientVersion();
-        if (info?.name) {
-            setActiveClientInfo({
-                name: info.name,
-                version: info.version,
-            });
-        }
+        const info = syncClientInfo();
+        if (info)
+            setActiveClientInfo(info);
     };
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/tools.js

@@ -164,29 +164,29 @@ export function codexPromptsDir() {
 const CODEX_TAILOR_PROMPT = [
     'TechPrufer MCP — all resume control under /techprufer-tailor.',
     '',
-    '1) list_pending_tailor_jobs — show them; ask process now or SKIP to company picker.',
+    '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.0",
+  "version": "0.4.3",
   "description": "TechPrufer MCP — tailor resumes and build profiles from your AI tool",
   "homepage": "https://techprufer.com",
   "type": "module",
@@ -15,6 +15,11 @@
   "engines": {
     "node": ">=18"
   },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && node --test dist/*.test.js",
+    "prepublishOnly": "npm run build"
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
     "zod": "^3.24.2"
@@ -29,9 +34,5 @@
     "resume",
     "tailor"
   ],
-  "license": "MIT",
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "test": "npm run build && node --test dist/*.test.js"
-  }
-}
+  "license": "MIT"
+}