@voidwire/llm-summarize 3.1.0 → 3.2.0

package/index.ts

@@ -46,6 +46,8 @@ export interface SummarizeOptions {
   model?: string;
   maxTokens?: number;
   mode?: "quick" | "insights";
+  /** User name to include in summary (e.g., "Rudy") */
+  userName?: string;
 }
 
 export type ProviderType = "anthropic" | "openai" | "ollama";
@@ -56,45 +58,57 @@ export type SummarizeMode = "quick" | "insights";
 // ============================================================================
 
 /**
- * Quick mode: Fast one-liner summary for user prompts
+ * Build quick mode prompt with optional user name
  */
-const QUICK_PROMPT = `Summarize what the user is asking or doing in one sentence.
-Use the user's name from the context in your summary (e.g., "Rudy asked about...").
+function buildQuickPrompt(userName?: string): string {
+  const nameInstruction = userName ? `Start with "${userName}".` : "";
 
+  return `Summarize what the user is asking or doing in one sentence.
+${nameInstruction}
 Output JSON only: {"summary": "One sentence summary"}`;
+}
 
 /**
- * Insights mode: Full SessionInsights extraction for responses
+ * Build insights mode prompt with optional user name
  */
-const INSIGHTS_PROMPT = `You are an experienced engineering manager reviewing session transcripts to extract actionable team insights.
+function buildInsightsPrompt(userName?: string): string {
+  const nameInstruction = userName
+    ? `Start the summary with "${userName}".`
+    : "";
+
+  return `You are an experienced engineering manager reviewing session transcripts to extract actionable insights.
 
-Analyze the development session conversation and extract structured observations.
+Analyze the development session and extract structured observations.
 
 <output_schema>
 {
   "summary": "One sentence: what was accomplished or decided",
   "decisions": ["Specific decision and its reasoning"],
   "patterns_used": ["Development pattern or approach observed"],
-  "preferences_expressed": ["User preference revealed through actions or statements"],
-  "problems_solved": ["Problem that was addressed and how"],
-  "tools_heavy": ["Tool used repeatedly or in notable ways"]
+  "preferences_expressed": ["Preference revealed through actions - DO NOT include user name"],
+  "problems_solved": ["Problem addressed and how - DO NOT include user name"],
+  "tools_heavy": ["Tool used repeatedly or notably"]
 }
 </output_schema>
 
 <rules>
-- Use the user's name from the context in the summary field (e.g., "Rudy implemented...")
+- ${nameInstruction || "Write summary in third person."}
 - Include a field ONLY when the conversation provides clear evidence
 - Extract specifics: "Chose SQLite over Postgres for single-user simplicity" not "Made a database decision"
 - Omit empty arrays entirely
+- IMPORTANT: Only use user name in the summary field, nowhere else
 </rules>
 
 Output valid JSON only. No markdown code blocks, no explanation.`;
+}
 
 /**
  * Get prompt for the specified mode
  */
-function getPromptForMode(mode: SummarizeMode): string {
-  return mode === "quick" ? QUICK_PROMPT : INSIGHTS_PROMPT;
+function getPromptForMode(mode: SummarizeMode, userName?: string): string {
+  return mode === "quick"
+    ? buildQuickPrompt(userName)
+    : buildInsightsPrompt(userName);
 }
 
 // ============================================================================
@@ -494,7 +508,8 @@ export async function summarize(
   const maxTokens = options?.maxTokens || config.maxTokens;
   const apiKey = config.apiKey;
   const mode: SummarizeMode = options?.mode || "insights";
-  const systemPrompt = getPromptForMode(mode);
+  const userName = options?.userName;
+  const systemPrompt = getPromptForMode(mode, userName);
 
   // Validate config
   if (!provider) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voidwire/llm-summarize",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "Structured session insight extraction for knowledge systems",
   "type": "module",
   "main": "./index.ts",