Merge pull request #1240 from AnishSarkar22/feat/resume-builder

feat: resume builder

Author: MODSetter

surfsense_backend/alembic/versions/126_add_report_content_type.py

@@ -0,0 +1,42 @@
+"""126_add_report_content_type
+
+Revision ID: 126
+Revises: 125
+Create Date: 2026-04-15
+
+Adds content_type column to reports table to distinguish between
+Markdown reports and Typst-based resumes.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+
+from alembic import op
+
+revision: str = "126"
+down_revision: str | None = "125"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    conn = op.get_bind()
+    columns = [c["name"] for c in sa.inspect(conn).get_columns("reports")]
+    if "content_type" in columns:
+        return
+    op.add_column(
+        "reports",
+        sa.Column(
+            "content_type",
+            sa.String(20),
+            nullable=False,
+            server_default="markdown",
+        ),
+    )
+
+
+def downgrade() -> None:
+    op.drop_column("reports", "content_type")

surfsense_backend/alembic/versions/127_seed_build_resume_prompt.py

@@ -0,0 +1,43 @@
+"""127_seed_build_resume_prompt
+
+Revision ID: 127
+Revises: 126
+Create Date: 2026-04-15
+
+Seeds the 'Build Resume' default prompt for all existing users.
+New users get it automatically via SYSTEM_PROMPT_DEFAULTS on signup.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+
+from alembic import op
+
+revision: str = "127"
+down_revision: str | None = "126"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    conn = op.get_bind()
+    conn.execute(
+        sa.text(
+            """
+            INSERT INTO prompts
+                (user_id, default_prompt_slug, name, prompt, mode, version, is_public, created_at)
+            SELECT u.id, 'build-resume', 'Build Resume',
+                   E'Build me a professional resume. Here is my information:\\n\\n{selection}',
+                   'explore'::prompt_mode, 1, false, now()
+            FROM "user" u
+            ON CONFLICT (user_id, default_prompt_slug) DO NOTHING
+            """
+        )
+    )
+
+
+def downgrade() -> None:
+    op.execute("DELETE FROM prompts WHERE default_prompt_slug = 'build-resume'")

surfsense_backend/app/agents/new_chat/system_prompt.py

@@ -443,13 +443,60 @@ def _get_system_instructions(
   - Call: `web_search(query="weather New York today")`
 """
 
+_TOOL_INSTRUCTIONS["generate_resume"] = """
+- generate_resume: Generate or revise a professional resume as a Typst document.
+  - WHEN TO CALL: The user asks to create, build, generate, write, or draft a resume or CV.
+    Also when they ask to modify, update, or revise an existing resume from this conversation.
+  - WHEN NOT TO CALL: General career advice, resume tips, cover letters, or reviewing
+    a resume without making changes. For cover letters, use generate_report instead.
+  - The tool produces Typst source code that is compiled to a PDF preview automatically.
+  - Args:
+    - user_info: The user's resume content — work experience, education, skills, contact
+      info, etc. Can be structured or unstructured text.
+      CRITICAL: user_info must be COMPREHENSIVE. Do NOT just pass the user's raw message.
+      You MUST gather and consolidate ALL available information:
+        * Content from referenced/mentioned documents (e.g., uploaded resumes, CVs, LinkedIn profiles)
+          that appear in the conversation context — extract and include their FULL content.
+        * Information the user shared across multiple messages in the conversation.
+        * Any relevant details from knowledge base search results in the context.
+      The more complete the user_info, the better the resume. Include names, contact info,
+      work experience with dates, education, skills, projects, certifications — everything available.
+    - user_instructions: Optional style or content preferences (e.g. "emphasize leadership",
+      "keep it to one page"). For revisions, describe what to change.
+    - parent_report_id: Set this when the user wants to MODIFY an existing resume from
+      this conversation. Use the report_id from a previous generate_resume result.
+  - Returns: Dict with status, report_id, title, and content_type.
+  - After calling: Give a brief confirmation. Do NOT paste resume content in chat. Do NOT mention report_id or any internal IDs — the resume card is shown automatically.
+  - VERSIONING: Same rules as generate_report — set parent_report_id for modifications
+    of an existing resume, leave as None for new resumes.
+"""
+
+_TOOL_EXAMPLES["generate_resume"] = """
+- User: "Build me a resume. I'm John Doe, engineer at Acme Corp..."
+  - Call: `generate_resume(user_info="John Doe, engineer at Acme Corp...")`
+  - WHY: Has creation verb "build" + resume → call the tool.
+- User: "Create my CV with this info: [experience, education, skills]"
+  - Call: `generate_resume(user_info="[experience, education, skills]")`
+- User: "Build me a resume" (and there is a resume/CV document in the conversation context)
+  - Extract the FULL content from the document in context, then call:
+    `generate_resume(user_info="Name: John Doe\\nEmail: john@example.com\\n\\nExperience:\\n- Senior Engineer at Acme Corp (2020-2024)\\n  Led team of 5...\\n\\nEducation:\\n- BS Computer Science, MIT (2016-2020)\\n\\nSkills: Python, TypeScript, AWS...")`
+  - WHY: Document content is available in context — extract ALL of it into user_info. Do NOT ignore referenced documents.
+- User: (after resume generated) "Change my title to Senior Engineer"
+  - Call: `generate_resume(user_info="", user_instructions="Change the job title to Senior Engineer", parent_report_id=<previous_report_id>)`
+  - WHY: Modification verb "change" + refers to existing resume → set parent_report_id.
+- User: "How should I structure my resume?"
+  - Do NOT call generate_resume. Answer in chat with advice.
+  - WHY: No creation/modification verb.
+"""
+
 # All tool names that have prompt instructions (order matters for prompt readability)
 _ALL_TOOL_NAMES_ORDERED = [
     "search_surfsense_docs",
     "web_search",
     "generate_podcast",
     "generate_video_presentation",
     "generate_report",
+    "generate_resume",
     "generate_image",
     "scrape_webpage",
     "update_memory",

surfsense_backend/app/agents/new_chat/tools/registry.py

@@ -92,6 +92,7 @@ async def my_tool(param: str) -> dict:
 )
 from .podcast import create_generate_podcast_tool
 from .report import create_generate_report_tool
+from .resume import create_generate_resume_tool
 from .scrape_webpage import create_scrape_webpage_tool
 from .search_surfsense_docs import create_search_surfsense_docs_tool
 from .update_memory import create_update_memory_tool, create_update_team_memory_tool
@@ -171,6 +172,16 @@ class ToolDefinition:
         # are optional — when missing, source_strategy="kb_search" degrades
         # gracefully to "provided"
     ),
+    # Resume generation tool (Typst-based, uses rendercv package)
+    ToolDefinition(
+        name="generate_resume",
+        description="Generate a professional resume as a Typst document",
+        factory=lambda deps: create_generate_resume_tool(
+            search_space_id=deps["search_space_id"],
+            thread_id=deps["thread_id"],
+        ),
+        requires=["search_space_id", "thread_id"],
+    ),
     # Generate image tool - creates images using AI models (DALL-E, GPT Image, etc.)
     ToolDefinition(
         name="generate_image",