@steipete/summarize-core 0.7.1 → 0.8.1

package/dist/esm/prompts/cli.js

@@ -1,20 +1,40 @@
 import { formatOutputLanguageInstruction } from '../language.js';
+import { buildInstructions, buildTaggedPrompt } from './format.js';
 function formatTargetLength(summaryLength) {
     if (typeof summaryLength === 'string')
         return '';
     const max = summaryLength.maxCharacters;
     return `Target length: around ${max.toLocaleString()} characters total (including Markdown and whitespace). This is a soft guideline; prioritize clarity.`;
 }
-export function buildPathSummaryPrompt({ kindLabel, filePath, filename, mediaType, outputLanguage, summaryLength, }) {
+export function buildPathSummaryPrompt({ kindLabel, filePath, filename, mediaType, outputLanguage, summaryLength, promptOverride, lengthInstruction, languageInstruction, }) {
     const headerLines = [
         `Path: ${filePath}`,
         filename ? `Filename: ${filename}` : null,
         mediaType ? `Media type: ${mediaType}` : null,
     ].filter(Boolean);
     const maxCharactersLine = formatTargetLength(summaryLength);
-    const languageInstruction = formatOutputLanguageInstruction(outputLanguage ?? { kind: 'auto' });
-    return `You summarize ${kindLabel === 'image' ? 'images' : 'files'} for curious users. Summarize the ${kindLabel} at the path below. Be factual and do not invent details. Format the answer in Markdown. Do not use emojis. ${maxCharactersLine} ${languageInstruction}
-
-${headerLines.length > 0 ? `${headerLines.join('\n')}\n\n` : ''}Return only the summary.`;
+    const baseInstructions = [
+        `You summarize ${kindLabel === 'image' ? 'images' : 'files'} for curious users.`,
+        `Summarize the ${kindLabel} at the path below.`,
+        'Be factual and do not invent details.',
+        'Format the answer in Markdown.',
+        'Use short paragraphs; use bullet lists only when they improve scanability; avoid rigid templates.',
+        'Do not use emojis.',
+        maxCharactersLine,
+        formatOutputLanguageInstruction(outputLanguage ?? { kind: 'auto' }),
+        'Return only the summary.',
+    ]
+        .filter((line) => typeof line === 'string' && line.trim().length > 0)
+        .join('\n');
+    const instructions = buildInstructions({
+        base: baseInstructions,
+        overrides: { promptOverride, lengthInstruction, languageInstruction },
+    });
+    const context = headerLines.join('\n');
+    return buildTaggedPrompt({
+        instructions,
+        context,
+        content: '',
+    });
 }
 //# sourceMappingURL=cli.js.map

package/dist/esm/prompts/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/prompts/cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,gBAAgB,CAAA;AAGhE,SAAS,kBAAkB,CAAC,aAAkC;IAC5D,IAAI,OAAO,aAAa,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAA;IAChD,MAAM,GAAG,GAAG,aAAa,CAAC,aAAa,CAAA;IACvC,OAAO,yBAAyB,GAAG,CAAC,cAAc,EAAE,sGAAsG,CAAA;AAC5J,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,EACrC,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,cAAc,EACd,aAAa,GAQd;IACC,MAAM,WAAW,GAAG;QAClB,SAAS,QAAQ,EAAE;QACnB,QAAQ,CAAC,CAAC,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI;QACzC,SAAS,CAAC,CAAC,CAAC,eAAe,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI;KAC9C,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAEjB,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAA;IAC3D,MAAM,mBAAmB,GAAG,+BAA+B,CAAC,cAAc,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;IAC/F,OAAO,iBAAiB,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,qCAAqC,SAAS,+GAA+G,iBAAiB,IAAI,mBAAmB;;EAEvQ,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,0BAA0B,CAAA;AACzF,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/prompts/cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,gBAAgB,CAAA;AAChE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAwB,MAAM,aAAa,CAAA;AAGxF,SAAS,kBAAkB,CAAC,aAAkC;IAC5D,IAAI,OAAO,aAAa,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAA;IAChD,MAAM,GAAG,GAAG,aAAa,CAAC,aAAa,CAAA;IACvC,OAAO,yBAAyB,GAAG,CAAC,cAAc,EAAE,sGAAsG,CAAA;AAC5J,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,EACrC,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,cAAc,EACd,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GAWpB;IACC,MAAM,WAAW,GAAG;QAClB,SAAS,QAAQ,EAAE;QACnB,QAAQ,CAAC,CAAC,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI;QACzC,SAAS,CAAC,CAAC,CAAC,eAAe,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI;KAC9C,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAEjB,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAA;IAC3D,MAAM,gBAAgB,GAAG;QACvB,iBAAiB,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,qBAAqB;QAChF,iBAAiB,SAAS,qBAAqB;QAC/C,uCAAuC;QACvC,gCAAgC;QAChC,mGAAmG;QACnG,oBAAoB;QACpB,iBAAiB;QACjB,+BAA+B,CAAC,cAAc,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACnE,0BAA0B;KAC3B;SACE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;SACpE,IAAI,CAAC,IAAI,CAAC,CAAA;IAEb,MAAM,YAAY,GAAG,iBAAiB,CAAC;QACrC,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,EAAE,cAAc,EAAE,iBAAiB,EAAE,mBAAmB,EAA4B;KAChG,CAAC,CAAA;IACF,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEtC,OAAO,iBAAiB,CAAC;QACvB,YAAY;QACZ,OAAO;QACP,OAAO,EAAE,EAAE;KACZ,CAAC,CAAA;AACJ,CAAC"}

package/dist/esm/prompts/file.js

@@ -1,5 +1,6 @@
 import { formatOutputLanguageInstruction } from '../language.js';
-export function buildFileSummaryPrompt({ filename, mediaType, outputLanguage, summaryLength, contentLength, }) {
+import { buildInstructions, buildTaggedPrompt } from './format.js';
+export function buildFileSummaryPrompt({ filename, mediaType, outputLanguage, summaryLength, contentLength, promptOverride, lengthInstruction, languageInstruction, }) {
     const contentCharacters = typeof contentLength === 'number' ? contentLength : null;
     const effectiveSummaryLength = typeof summaryLength === 'string'
         ? summaryLength
@@ -18,14 +19,32 @@ export function buildFileSummaryPrompt({ filename, mediaType, outputLanguage, su
         filename ? `Filename: ${filename}` : null,
         mediaType ? `Media type: ${mediaType}` : null,
     ].filter(Boolean);
-    const languageInstruction = formatOutputLanguageInstruction(outputLanguage ?? { kind: 'auto' });
-    const prompt = `You summarize files for curious users. Summarize the attached file. Be factual and do not invent details. Format the answer in Markdown. Do not use emojis. ${maxCharactersLine} ${contentLengthLine}
-${languageInstruction}
-
-${headerLines.length > 0 ? `${headerLines.join('\n')}\n\n` : ''}Return only the summary.`;
-    return prompt;
+    const baseInstructions = [
+        'You summarize files for curious users.',
+        'Summarize the attached file.',
+        'Be factual and do not invent details.',
+        'Format the answer in Markdown.',
+        'Use short paragraphs; use bullet lists only when they improve scanability; avoid rigid templates.',
+        'Do not use emojis.',
+        maxCharactersLine,
+        contentLengthLine,
+        formatOutputLanguageInstruction(outputLanguage ?? { kind: 'auto' }),
+        'Return only the summary.',
+    ]
+        .filter((line) => typeof line === 'string' && line.trim().length > 0)
+        .join('\n');
+    const instructions = buildInstructions({
+        base: baseInstructions,
+        overrides: { promptOverride, lengthInstruction, languageInstruction },
+    });
+    const context = headerLines.join('\n');
+    return buildTaggedPrompt({
+        instructions,
+        context,
+        content: '',
+    });
 }
-export function buildFileTextSummaryPrompt({ filename, originalMediaType, contentMediaType, outputLanguage, summaryLength, contentLength, }) {
+export function buildFileTextSummaryPrompt({ filename, originalMediaType, contentMediaType, outputLanguage, summaryLength, contentLength, content, promptOverride, lengthInstruction, languageInstruction, }) {
     const effectiveSummaryLength = typeof summaryLength === 'string'
         ? summaryLength
         : summaryLength.maxCharacters > contentLength
@@ -40,9 +59,29 @@ export function buildFileTextSummaryPrompt({ filename, originalMediaType, conten
         `Provided as: ${contentMediaType}`,
         `Extracted content length: ${contentLength.toLocaleString()} characters. Hard limit: never exceed this length. If the requested length is larger, do not pad—finish early rather than adding filler.`,
     ].filter(Boolean);
-    const languageInstruction = formatOutputLanguageInstruction(outputLanguage ?? { kind: 'auto' });
-    return `You summarize files for curious users. Summarize the file content below. Be factual and do not invent details. Format the answer in Markdown. Do not use emojis. ${maxCharactersLine} ${languageInstruction}
-
-${headerLines.length > 0 ? `${headerLines.join('\n')}\n\n` : ''}Return only the summary.`;
+    const baseInstructions = [
+        'You summarize files for curious users.',
+        'Summarize the file content below.',
+        'Be factual and do not invent details.',
+        'Format the answer in Markdown.',
+        'Use short paragraphs; use bullet lists only when they improve scanability; avoid rigid templates.',
+        'Do not use emojis.',
+        maxCharactersLine,
+        formatOutputLanguageInstruction(outputLanguage ?? { kind: 'auto' }),
+        'Return only the summary.',
+    ]
+        .filter((line) => typeof line === 'string' && line.trim().length > 0)
+        .join('\n');
+    const instructions = buildInstructions({
+        base: baseInstructions,
+        overrides: { promptOverride, lengthInstruction, languageInstruction },
+    });
+    const context = headerLines.join('\n');
+    const contentText = typeof content === 'string' ? content : '';
+    return buildTaggedPrompt({
+        instructions,
+        context,
+        content: contentText,
+    });
 }
 //# sourceMappingURL=file.js.map

package/dist/esm/prompts/file.js.map

@@ -1 +1 @@
-{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../src/prompts/file.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../src/prompts/file.ts"],"names":[],"mappings":"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"}

package/dist/esm/prompts/format.js

@@ -0,0 +1,26 @@
+export function buildInstructions({ base, overrides, }) {
+    const lines = [];
+    const override = overrides?.promptOverride?.trim();
+    if (override) {
+        lines.push(override);
+    }
+    else {
+        const trimmedBase = base.trim();
+        if (trimmedBase)
+            lines.push(trimmedBase);
+    }
+    const lengthInstruction = overrides?.lengthInstruction?.trim();
+    if (lengthInstruction)
+        lines.push(lengthInstruction);
+    const languageInstruction = overrides?.languageInstruction?.trim();
+    if (languageInstruction)
+        lines.push(languageInstruction);
+    return lines.join('\n');
+}
+export function buildTaggedPrompt({ instructions, context, content, }) {
+    const safeInstructions = instructions.trim();
+    const safeContext = context.trim();
+    const safeContent = typeof content === 'string' ? content : '';
+    return `<instructions>\n${safeInstructions}\n</instructions>\n\n<context>\n${safeContext}\n</context>\n\n<content>\n${safeContent}\n</content>\n`;
+}
+//# sourceMappingURL=format.js.map

package/dist/esm/prompts/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/prompts/format.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,iBAAiB,CAAC,EAChC,IAAI,EACJ,SAAS,GAIV;IACC,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,MAAM,QAAQ,GAAG,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE,CAAA;IAClD,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACtB,CAAC;SAAM,CAAC;QACN,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAC/B,IAAI,WAAW;YAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAC1C,CAAC;IAED,MAAM,iBAAiB,GAAG,SAAS,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAA;IAC9D,IAAI,iBAAiB;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;IAEpD,MAAM,mBAAmB,GAAG,SAAS,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAA;IAClE,IAAI,mBAAmB;QAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;IAExD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAChC,YAAY,EACZ,OAAO,EACP,OAAO,GAKR;IACC,MAAM,gBAAgB,GAAG,YAAY,CAAC,IAAI,EAAE,CAAA;IAC5C,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;IAClC,MAAM,WAAW,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9D,OAAO,mBAAmB,gBAAgB,mCAAmC,WAAW,8BAA8B,WAAW,gBAAgB,CAAA;AACnJ,CAAC"}

package/dist/esm/prompts/link-summary.js

@@ -1,26 +1,28 @@
 import { formatOutputLanguageInstruction } from '../language.js';
+import { buildInstructions, buildTaggedPrompt } from './format.js';
 const SUMMARY_LENGTH_DIRECTIVES = {
     short: {
-        guidance: 'Write a tight paragraph (2–3 sentences) that delivers the primary claim plus one high-signal supporting detail.',
-        formatting: 'Output a single paragraph with normal sentences; avoid headings or bullet lists.',
+        guidance: 'Write a tight summary in 2–3 sentences that delivers the primary claim plus one high-signal supporting detail.',
+        formatting: 'Return a single short paragraph.',
     },
     medium: {
-        guidance: 'Write two short paragraphs covering the core claim in the first paragraph and the most important supporting evidence, data points, or implications in the second.',
-        formatting: 'Each paragraph should contain 2–3 sentences. Separate paragraphs with a blank line. Do not use bullet lists or headings.',
+        guidance: 'Write two short paragraphs covering the core claim in the first paragraph and the most important supporting evidence or data points in the second.',
+        formatting: 'Each paragraph should contain 2–3 sentences. Separate paragraphs with a blank line.',
     },
     long: {
-        guidance: 'Write three paragraphs: (1) summarize the claim and scope, (2) walk through the major supporting arguments or events, (3) explain implications, risks, or recommended next steps.',
-        formatting: 'Keep paragraphs balanced (3–4 sentences each) and separate them with single blank lines. No bullet lists or headings.',
+        guidance: 'Write three short paragraphs that summarize the text in order of importance: (1) core claim and scope, (2) key supporting facts or events, (3) other notable details or conclusions stated in the source.',
+        formatting: 'Each paragraph should contain 2–4 sentences. Separate paragraphs with a blank line.',
     },
     xl: {
-        guidance: 'Produce a structured Markdown outline with short section headings (“Overview”, “Key Evidence”, “Implications”, “Next Steps”) followed by 2–3 bullet points under each heading. Surface quantitative details, quotes, or contrasting views when available.',
-        formatting: 'Use level-3 Markdown headings (###) for each section followed by bullet lists. Bullets may span 1–2 sentences and can exceed 20 words when necessary.',
+        guidance: 'Write a detailed summary in 4–6 short paragraphs. Focus on what the text says (facts, events, arguments) and include concrete numbers or quotes when present.',
+        formatting: 'Use Markdown paragraphs separated by single blank lines.',
     },
     xxl: {
-        guidance: 'Produce a comprehensive Markdown report: start with a short executive summary paragraph, then add sections for Background, Detailed Findings, Implications, and Open Questions. Within sections, use bullet lists or short paragraphs to cover nuanced context, statistics, quotes, counterpoints, and recommended follow-up actions.',
-        formatting: 'Use Markdown headings (###) for each section, combine paragraphs and bullet lists as needed, and ensure the overall response is substantial (multiple paragraphs and bullets totalling several hundred words) while remaining factual.',
+        guidance: 'Write a comprehensive summary in 6–10 short paragraphs. Cover background, main points, evidence, and stated outcomes in the source text; avoid adding implications or recommendations unless explicitly stated.',
+        formatting: 'Use Markdown paragraphs separated by single blank lines.',
     },
 };
+const HEADING_LENGTH_CHAR_THRESHOLD = 6000;
 export const SUMMARY_LENGTH_TO_TOKENS = {
     short: 768,
     medium: 1536,
@@ -48,7 +50,7 @@ const resolveSummaryDirective = (length) =>
 // eslint-disable-next-line security/detect-object-injection
 SUMMARY_LENGTH_DIRECTIVES[length];
 const formatCount = (value) => value.toLocaleString();
-export function buildLinkSummaryPrompt({ url, title, siteName, description, content, truncated, hasTranscript, outputLanguage, summaryLength, shares, }) {
+export function buildLinkSummaryPrompt({ url, title, siteName, description, content, truncated, hasTranscript, outputLanguage, summaryLength, shares, promptOverride, lengthInstruction, languageInstruction, }) {
     const contentCharacters = content.length;
     const contextLines = [`Source URL: ${url}`];
     if (title) {
@@ -76,6 +78,13 @@ export function buildLinkSummaryPrompt({ url, title, siteName, description, cont
         ? effectiveSummaryLength
         : pickSummaryLengthForCharacters(effectiveSummaryLength.maxCharacters);
     const directive = resolveSummaryDirective(preset);
+    const needsHeadings = preset === 'xl' ||
+        preset === 'xxl' ||
+        (typeof effectiveSummaryLength !== 'string' &&
+            effectiveSummaryLength.maxCharacters >= HEADING_LENGTH_CHAR_THRESHOLD);
+    const headingInstruction = needsHeadings
+        ? 'Use Markdown headings with the "### " prefix to break sections. Include at least 3 headings and start with a heading. Do not use bold for headings.'
+        : '';
     const maxCharactersLine = typeof effectiveSummaryLength === 'string'
         ? ''
         : `Target length: up to ${formatCount(effectiveSummaryLength.maxCharacters)} characters total (including Markdown and whitespace). Hard limit: do not exceed it.`;
@@ -101,16 +110,36 @@ export function buildLinkSummaryPrompt({ url, title, siteName, description, cont
     const shareGuidance = shares.length > 0
         ? 'You are also given quotes from people who recently shared this link. When these quotes contain substantive commentary, append a brief subsection titled "What sharers are saying" with one or two bullet points summarizing the key reactions. If they are generic reshares with no commentary, omit that subsection.'
         : 'You are not given any quotes from people who shared this link. Do not fabricate reactions or add a "What sharers are saying" subsection.';
-    const sharesBlock = shares.length > 0 ? `Tweets from sharers:\n${shareLines.join('\n')}\n\n` : '';
-    const languageInstruction = formatOutputLanguageInstruction(outputLanguage ?? { kind: 'auto' });
-    return `${audienceLine} ${directive.guidance} ${directive.formatting} ${maxCharactersLine} ${contentLengthLine} ${languageInstruction} Keep the response compact by avoiding blank lines between sentences or list items; use only the single newlines required by the formatting instructions. Do not use emojis, disclaimers, or speculation. Write in direct, factual language. Format the answer in Markdown and obey the length-specific formatting above. Base everything strictly on the provided content and never invent details. ${shareGuidance}
-
-${contextHeader}
-
-${sharesBlock}Extracted content:
-"""
-${content}
-"""
-`;
+    const shareBlock = shares.length > 0 ? `Tweets from sharers:\n${shareLines.join('\n')}` : '';
+    const baseInstructions = [
+        audienceLine,
+        directive.guidance,
+        directive.formatting,
+        headingInstruction,
+        maxCharactersLine,
+        contentLengthLine,
+        formatOutputLanguageInstruction(outputLanguage ?? { kind: 'auto' }),
+        'Keep the response compact by avoiding blank lines between sentences or list items; use only the single newlines required by the formatting instructions.',
+        'Do not use emojis, disclaimers, or speculation.',
+        'Write in direct, factual language.',
+        'Format the answer in Markdown and obey the length-specific formatting above.',
+        'Use short paragraphs; use bullet lists only when they improve scanability; avoid rigid templates.',
+        'Base everything strictly on the provided content and never invent details.',
+        shareGuidance,
+    ]
+        .filter((line) => typeof line === 'string' && line.trim().length > 0)
+        .join('\n');
+    const instructions = buildInstructions({
+        base: baseInstructions,
+        overrides: { promptOverride, lengthInstruction, languageInstruction },
+    });
+    const context = [contextHeader, shareBlock]
+        .filter((line) => typeof line === 'string' && line.trim().length > 0)
+        .join('\n');
+    return buildTaggedPrompt({
+        instructions,
+        context,
+        content,
+    });
 }
 //# sourceMappingURL=link-summary.js.map

package/dist/esm/prompts/link-summary.js.map

@@ -1 +1 @@
-{"version":3,"file":"link-summary.js","sourceRoot":"","sources":["../../../src/prompts/link-summary.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"link-summary.js","sourceRoot":"","sources":["../../../src/prompts/link-summary.ts"],"names":[],"mappings":"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"}

package/dist/types/content/cache/types.d.ts

@@ -0,0 +1,25 @@
+import type { TranscriptSource } from '../link-preview/types.js';
+/** Public shape returned by transcript cache implementations. */
+export interface TranscriptCacheGetResult {
+    content: string | null;
+    source: TranscriptSource | null;
+    expired: boolean;
+    metadata?: Record<string, unknown> | null;
+}
+/** Public write arguments for transcript cache implementations. */
+export interface TranscriptCacheSetArgs {
+    url: string;
+    service: string;
+    resourceKey: string | null;
+    content: string | null;
+    source: TranscriptSource | null;
+    ttlMs: number;
+    metadata?: Record<string, unknown> | null;
+}
+/** Public interface for pluggable transcript caches (CLI, daemon, apps). */
+export interface TranscriptCache {
+    get(args: {
+        url: string;
+    }): Promise<TranscriptCacheGetResult | null>;
+    set(args: TranscriptCacheSetArgs): Promise<void>;
+}

package/dist/types/content/index.d.ts

@@ -1,5 +1,7 @@
+export type { TranscriptCache, TranscriptCacheGetResult, TranscriptCacheSetArgs, } from './cache/types.js';
 export { createLinkPreviewClient, type LinkPreviewClient, type LinkPreviewClientOptions, } from './link-preview/client.js';
 export { DEFAULT_CACHE_MODE, DEFAULT_MAX_CONTENT_CHARACTERS, DEFAULT_TIMEOUT_MS, type ExtractedLinkContent, type FetchLinkContentOptions, } from './link-preview/content/types.js';
-export type { ConvertHtmlToMarkdown, FirecrawlScrapeResult, LinkPreviewDeps, LinkPreviewProgressEvent, ReadTweetWithBird, ScrapeWithFirecrawl, TranscriptCache, } from './link-preview/deps.js';
+export type { ConvertHtmlToMarkdown, FirecrawlScrapeResult, LinkPreviewDeps, LinkPreviewProgressEvent, ReadTweetWithBird, ScrapeWithFirecrawl, } from './link-preview/deps.js';
 export { ProgressKind } from './link-preview/deps.js';
 export { CACHE_MODES, type CacheMode, type CacheStatus, type TranscriptSource, } from './link-preview/types.js';
+export { extractYouTubeVideoId, isDirectMediaUrl, isPodcastHost, isTwitterStatusUrl, isYouTubeUrl, isYouTubeVideoUrl, shouldPreferUrlMode, } from './url.js';

package/dist/types/content/link-preview/client.d.ts

@@ -1,8 +1,11 @@
+import type { TranscriptCache } from '../cache/types.js';
 import type { ExtractedLinkContent, FetchLinkContentOptions } from './content/types.js';
-import type { ConvertHtmlToMarkdown, LinkPreviewDeps, LinkPreviewProgressEvent, ScrapeWithFirecrawl, TranscriptCache } from './deps.js';
+import type { ConvertHtmlToMarkdown, LinkPreviewDeps, LinkPreviewProgressEvent, ResolveTwitterCookies, ScrapeWithFirecrawl } from './deps.js';
+/** Public client used by external consumers to fetch link content. */
 export interface LinkPreviewClient {
     fetchLinkContent(url: string, options?: FetchLinkContentOptions): Promise<ExtractedLinkContent>;
 }
+/** Public options for wiring dependencies into the link preview client. */
 export interface LinkPreviewClientOptions {
     fetch?: typeof fetch;
     scrapeWithFirecrawl?: ScrapeWithFirecrawl | null;
@@ -13,6 +16,8 @@ export interface LinkPreviewClientOptions {
     convertHtmlToMarkdown?: ConvertHtmlToMarkdown | null;
     transcriptCache?: TranscriptCache | null;
     readTweetWithBird?: LinkPreviewDeps['readTweetWithBird'];
+    resolveTwitterCookies?: ResolveTwitterCookies | null;
     onProgress?: ((event: LinkPreviewProgressEvent) => void) | null;
 }
+/** Public factory for a link preview client with injectable dependencies. */
 export declare function createLinkPreviewClient(options?: LinkPreviewClientOptions): LinkPreviewClient;

package/dist/types/content/link-preview/content/types.d.ts

@@ -2,7 +2,7 @@ import type { CacheMode, ContentFetchDiagnostics, TranscriptDiagnostics, Transcr
 export declare const DEFAULT_TIMEOUT_MS = 120000;
 export declare const DEFAULT_MAX_CONTENT_CHARACTERS = 8000;
 export declare const DEFAULT_CACHE_MODE: CacheMode;
-export type YoutubeTranscriptMode = 'auto' | 'web' | 'apify' | 'yt-dlp';
+export type YoutubeTranscriptMode = 'auto' | 'web' | 'apify' | 'yt-dlp' | 'no-auto';
 export type FirecrawlMode = 'off' | 'auto' | 'always';
 export type ContentFormat = 'text' | 'markdown';
 export type MarkdownMode = 'off' | 'auto' | 'llm' | 'readability';

package/dist/types/content/link-preview/deps.d.ts

@@ -1,3 +1,4 @@
+import type { TranscriptCache } from '../cache/types.js';
 import type { CacheMode, TranscriptSource } from './types.js';
 export declare const ProgressKind: {
     readonly FetchHtmlStart: "fetch-html-start";
@@ -17,6 +18,7 @@ export declare const ProgressKind: {
     readonly BirdStart: "bird-start";
     readonly BirdDone: "bird-done";
 };
+/** Public progress events emitted by link preview fetchers. */
 export type LinkPreviewProgressEvent = {
     kind: 'fetch-html-start';
     url: string;
@@ -132,27 +134,15 @@ export type ReadTweetWithBird = (args: {
     url: string;
     timeoutMs: number;
 }) => Promise<BirdTweetPayload | null>;
-export interface TranscriptCacheGetResult {
-    content: string | null;
-    source: TranscriptSource | null;
-    expired: boolean;
-    metadata?: Record<string, unknown> | null;
-}
-export interface TranscriptCacheSetArgs {
+export type TwitterCookieSource = {
+    cookiesFromBrowser: string | null;
+    source?: string | null;
+    warnings?: string[];
+};
+export type ResolveTwitterCookies = (args: {
     url: string;
-    service: string;
-    resourceKey: string | null;
-    content: string | null;
-    source: TranscriptSource | null;
-    ttlMs: number;
-    metadata?: Record<string, unknown> | null;
-}
-export interface TranscriptCache {
-    get(args: {
-        url: string;
-    }): Promise<TranscriptCacheGetResult | null>;
-    set(args: TranscriptCacheSetArgs): Promise<void>;
-}
+}) => Promise<TwitterCookieSource>;
+/** Internal dependency bag; prefer createLinkPreviewClient unless you need custom wiring. */
 export interface LinkPreviewDeps {
     fetch: typeof fetch;
     scrapeWithFirecrawl: ScrapeWithFirecrawl | null;
@@ -163,5 +153,6 @@ export interface LinkPreviewDeps {
     convertHtmlToMarkdown: ConvertHtmlToMarkdown | null;
     transcriptCache: TranscriptCache | null;
     readTweetWithBird?: ReadTweetWithBird | null;
+    resolveTwitterCookies?: ResolveTwitterCookies | null;
     onProgress?: ((event: LinkPreviewProgressEvent) => void) | null;
 }

package/dist/types/content/transcript/cache.d.ts

@@ -1,4 +1,4 @@
-import type { TranscriptCache } from '../link-preview/deps.js';
+import type { TranscriptCache } from '../cache/types.js';
 import type { CacheMode, TranscriptDiagnostics, TranscriptResolution, TranscriptSource } from '../link-preview/types.js';
 export declare const DEFAULT_TTL_MS: number;
 export declare const NEGATIVE_TTL_MS: number;

package/dist/types/content/transcript/providers/generic.d.ts

@@ -1,3 +1,3 @@
 import type { ProviderContext, ProviderFetchOptions, ProviderResult } from '../types.js';
 export declare const canHandle: () => boolean;
-export declare const fetchTranscript: (_context: ProviderContext, _options: ProviderFetchOptions) => Promise<ProviderResult>;
+export declare const fetchTranscript: (context: ProviderContext, options: ProviderFetchOptions) => Promise<ProviderResult>;

package/dist/types/content/transcript/providers/youtube/captions.d.ts

@@ -3,5 +3,7 @@ interface YoutubeTranscriptContext {
     originalUrl: string;
     videoId: string;
 }
-export declare const fetchTranscriptFromCaptionTracks: (fetchImpl: typeof fetch, { html, originalUrl, videoId }: YoutubeTranscriptContext) => Promise<string | null>;
+export declare const fetchTranscriptFromCaptionTracks: (fetchImpl: typeof fetch, { html, originalUrl, videoId, skipAutoGenerated, }: YoutubeTranscriptContext & {
+    skipAutoGenerated?: boolean;
+}) => Promise<string | null>;
 export {};

package/dist/types/content/transcript/providers/youtube/yt-dlp.d.ts

@@ -12,6 +12,8 @@ type YtDlpRequest = {
     falApiKey: string | null;
     url: string;
     onProgress?: ((event: LinkPreviewProgressEvent) => void) | null;
+    service?: 'youtube' | 'podcast' | 'generic';
+    extraArgs?: string[];
 };
-export declare const fetchTranscriptWithYtDlp: ({ ytDlpPath, openaiApiKey, falApiKey, url, onProgress, }: YtDlpRequest) => Promise<YtDlpTranscriptResult>;
+export declare const fetchTranscriptWithYtDlp: ({ ytDlpPath, openaiApiKey, falApiKey, url, onProgress, service, extraArgs, }: YtDlpRequest) => Promise<YtDlpTranscriptResult>;
 export {};

package/dist/types/content/transcript/types.d.ts

@@ -1,5 +1,5 @@
 import type { YoutubeTranscriptMode } from '../link-preview/content/types.js';
-import type { LinkPreviewProgressEvent, ScrapeWithFirecrawl } from '../link-preview/deps.js';
+import type { LinkPreviewProgressEvent, ResolveTwitterCookies, ScrapeWithFirecrawl } from '../link-preview/deps.js';
 import type { TranscriptResolution, TranscriptSource } from '../link-preview/types.js';
 export type TranscriptService = 'youtube' | 'podcast' | 'generic';
 export interface ProviderContext {
@@ -15,6 +15,7 @@ export interface ProviderFetchOptions {
     ytDlpPath: string | null;
     falApiKey: string | null;
     openaiApiKey: string | null;
+    resolveTwitterCookies?: ResolveTwitterCookies | null;
     onProgress?: ((event: LinkPreviewProgressEvent) => void) | null;
 }
 export interface ProviderResult extends TranscriptResolution {

package/dist/types/content/transcript/utils.d.ts

@@ -1,7 +1,5 @@
+export { extractYouTubeVideoId, isYouTubeUrl, isYouTubeVideoUrl } from '../url.js';
 export declare function isRecord(value: unknown): value is Record<string, unknown>;
-export declare const isYouTubeUrl: (rawUrl: string) => boolean;
-export declare function isYouTubeVideoUrl(rawUrl: string): boolean;
-export declare function extractYouTubeVideoId(rawUrl: string): string | null;
 export declare function extractEmbeddedYouTubeUrlFromHtml(html: string, maxTextChars?: number, maxReadabilityChars?: number): Promise<string | null>;
 export declare function sanitizeYoutubeJsonResponse(input: string): string;
 export declare function decodeHtmlEntities(input: string): string;

package/dist/types/content/url.d.ts

@@ -0,0 +1,8 @@
+import { isPodcastHost } from './link-preview/content/podcast-utils.js';
+import { isTwitterStatusUrl } from './link-preview/content/twitter-utils.js';
+export declare const isYouTubeUrl: (rawUrl: string) => boolean;
+export declare function isYouTubeVideoUrl(rawUrl: string): boolean;
+export declare function extractYouTubeVideoId(rawUrl: string): string | null;
+export declare function isDirectMediaUrl(url: string): boolean;
+export declare function shouldPreferUrlMode(url: string): boolean;
+export { isTwitterStatusUrl, isPodcastHost };

package/dist/types/prompts/cli.d.ts

@@ -1,10 +1,13 @@
 import type { OutputLanguage } from '../language.js';
 import type { SummaryLengthTarget } from './link-summary.js';
-export declare function buildPathSummaryPrompt({ kindLabel, filePath, filename, mediaType, outputLanguage, summaryLength, }: {
+export declare function buildPathSummaryPrompt({ kindLabel, filePath, filename, mediaType, outputLanguage, summaryLength, promptOverride, lengthInstruction, languageInstruction, }: {
     kindLabel: 'file' | 'image';
     filePath: string;
     filename: string | null;
     mediaType: string | null;
     summaryLength: SummaryLengthTarget;
     outputLanguage?: OutputLanguage | null;
+    promptOverride?: string | null;
+    lengthInstruction?: string | null;
+    languageInstruction?: string | null;
 }): string;

package/dist/types/prompts/file.d.ts

@@ -1,17 +1,24 @@
 import type { OutputLanguage } from '../language.js';
 import type { SummaryLengthTarget } from './link-summary.js';
-export declare function buildFileSummaryPrompt({ filename, mediaType, outputLanguage, summaryLength, contentLength, }: {
+export declare function buildFileSummaryPrompt({ filename, mediaType, outputLanguage, summaryLength, contentLength, promptOverride, lengthInstruction, languageInstruction, }: {
     filename: string | null;
     mediaType: string | null;
     summaryLength: SummaryLengthTarget;
     contentLength?: number | null;
     outputLanguage?: OutputLanguage | null;
+    promptOverride?: string | null;
+    lengthInstruction?: string | null;
+    languageInstruction?: string | null;
 }): string;
-export declare function buildFileTextSummaryPrompt({ filename, originalMediaType, contentMediaType, outputLanguage, summaryLength, contentLength, }: {
+export declare function buildFileTextSummaryPrompt({ filename, originalMediaType, contentMediaType, outputLanguage, summaryLength, contentLength, content, promptOverride, lengthInstruction, languageInstruction, }: {
     filename: string | null;
     originalMediaType: string | null;
     contentMediaType: string;
     summaryLength: SummaryLengthTarget;
     contentLength: number;
     outputLanguage?: OutputLanguage | null;
+    content?: string | null;
+    promptOverride?: string | null;
+    lengthInstruction?: string | null;
+    languageInstruction?: string | null;
 }): string;

package/dist/types/prompts/format.d.ts

@@ -0,0 +1,14 @@
+export type PromptOverrides = {
+    promptOverride?: string | null;
+    lengthInstruction?: string | null;
+    languageInstruction?: string | null;
+};
+export declare function buildInstructions({ base, overrides, }: {
+    base: string;
+    overrides?: PromptOverrides | null;
+}): string;
+export declare function buildTaggedPrompt({ instructions, context, content, }: {
+    instructions: string;
+    context: string;
+    content: string;
+}): string;

package/dist/types/prompts/link-summary.d.ts

@@ -15,7 +15,7 @@ export type ShareContextEntry = {
     replyCount?: number | null;
     timestamp?: string | null;
 };
-export declare function buildLinkSummaryPrompt({ url, title, siteName, description, content, truncated, hasTranscript, outputLanguage, summaryLength, shares, }: {
+export declare function buildLinkSummaryPrompt({ url, title, siteName, description, content, truncated, hasTranscript, outputLanguage, summaryLength, shares, promptOverride, lengthInstruction, languageInstruction, }: {
     url: string;
     title: string | null;
     siteName: string | null;
@@ -26,4 +26,7 @@ export declare function buildLinkSummaryPrompt({ url, title, siteName, descripti
     summaryLength: SummaryLengthTarget;
     outputLanguage?: OutputLanguage | null;
     shares: ShareContextEntry[];
+    promptOverride?: string | null;
+    lengthInstruction?: string | null;
+    languageInstruction?: string | null;
 }): string;