@steipete/summarize 0.1.2 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. package/CHANGELOG.md +66 -3
  2. package/README.md +40 -6
  3. package/dist/cli.cjs +6502 -634
  4. package/dist/cli.cjs.map +4 -4
  5. package/dist/esm/content/asset.js +18 -0
  6. package/dist/esm/content/asset.js.map +1 -1
  7. package/dist/esm/content/link-preview/client.js +8 -0
  8. package/dist/esm/content/link-preview/client.js.map +1 -1
  9. package/dist/esm/content/link-preview/content/article.js +15 -1
  10. package/dist/esm/content/link-preview/content/article.js.map +1 -1
  11. package/dist/esm/content/link-preview/content/index.js +151 -4
  12. package/dist/esm/content/link-preview/content/index.js.map +1 -1
  13. package/dist/esm/content/link-preview/transcript/index.js +6 -0
  14. package/dist/esm/content/link-preview/transcript/index.js.map +1 -1
  15. package/dist/esm/content/link-preview/transcript/providers/youtube/yt-dlp.js +213 -0
  16. package/dist/esm/content/link-preview/transcript/providers/youtube/yt-dlp.js.map +1 -0
  17. package/dist/esm/content/link-preview/transcript/providers/youtube.js +40 -2
  18. package/dist/esm/content/link-preview/transcript/providers/youtube.js.map +1 -1
  19. package/dist/esm/flags.js +14 -2
  20. package/dist/esm/flags.js.map +1 -1
  21. package/dist/esm/llm/generate-text.js +125 -21
  22. package/dist/esm/llm/generate-text.js.map +1 -1
  23. package/dist/esm/llm/html-to-markdown.js +3 -2
  24. package/dist/esm/llm/html-to-markdown.js.map +1 -1
  25. package/dist/esm/pricing/litellm.js +4 -1
  26. package/dist/esm/pricing/litellm.js.map +1 -1
  27. package/dist/esm/prompts/file.js +15 -4
  28. package/dist/esm/prompts/file.js.map +1 -1
  29. package/dist/esm/prompts/link-summary.js +20 -6
  30. package/dist/esm/prompts/link-summary.js.map +1 -1
  31. package/dist/esm/run.js +545 -407
  32. package/dist/esm/run.js.map +1 -1
  33. package/dist/esm/version.js +1 -1
  34. package/dist/types/content/link-preview/client.d.ts +5 -1
  35. package/dist/types/content/link-preview/content/types.d.ts +1 -1
  36. package/dist/types/content/link-preview/deps.d.ts +33 -0
  37. package/dist/types/content/link-preview/transcript/providers/youtube/yt-dlp.d.ts +15 -0
  38. package/dist/types/content/link-preview/transcript/types.d.ts +4 -0
  39. package/dist/types/content/link-preview/types.d.ts +1 -1
  40. package/dist/types/costs.d.ts +1 -1
  41. package/dist/types/flags.d.ts +1 -1
  42. package/dist/types/llm/generate-text.d.ts +8 -2
  43. package/dist/types/llm/html-to-markdown.d.ts +4 -1
  44. package/dist/types/pricing/litellm.d.ts +1 -0
  45. package/dist/types/prompts/file.d.ts +2 -1
  46. package/dist/types/version.d.ts +1 -1
  47. package/docs/extract-only.md +1 -1
  48. package/docs/firecrawl.md +2 -2
  49. package/docs/llm.md +7 -0
  50. package/docs/site/docs/config.html +1 -1
  51. package/docs/site/docs/firecrawl.html +1 -1
  52. package/docs/website.md +3 -3
  53. package/docs/youtube.md +5 -2
  54. package/package.json +7 -2
package/docs/youtube.md CHANGED
@@ -2,11 +2,12 @@
2
2
 
3
3
  YouTube URLs use transcript-first extraction.
4
4
 
5
- ## `--youtube auto|web|apify`
5
+ ## `--youtube auto|web|apify|yt-dlp`
6
6
 
7
- - `auto` (default): try `youtubei` → `captionTracks` → Apify (if token exists)
7
+ - `auto` (default): try `youtubei` → `captionTracks` → Apify (if token exists) → `yt-dlp` (if configured)
8
8
  - `web`: try `youtubei` → `captionTracks` only
9
9
  - `apify`: Apify only
10
+ - `yt-dlp`: download audio + transcribe (OpenAI Whisper preferred; FAL fallback)
10
11
 
11
12
  ## `youtubei` vs `captionTracks`
12
13
 
@@ -24,6 +25,8 @@ YouTube URLs use transcript-first extraction.
24
25
  - If no transcript is available, we still extract `ytInitialPlayerResponse.videoDetails.shortDescription` so YouTube links can still summarize meaningfully.
25
26
  - Apify is an optional fallback (needs `APIFY_API_TOKEN`).
26
27
  - By default, we use the actor id `faVsWy9VTSNVIhWpR` (Pinto Studio’s “Youtube Transcript Scraper”).
28
+ - `yt-dlp` requires `YT_DLP_PATH` and either `OPENAI_API_KEY` (preferred) or `FAL_KEY`.
29
+ - If OpenAI transcription fails and `FAL_KEY` is set, we fall back to FAL automatically.
27
30
 
28
31
  ## Example
29
32
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@steipete/summarize",
3
- "version": "0.1.2",
3
+ "version": "0.3.0",
4
4
  "description": "Link → clean text → summary.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -30,9 +30,14 @@
30
30
  "README.md",
31
31
  "LICENSE"
32
32
  ],
33
+ "engines": {
34
+ "node": ">=22"
35
+ },
33
36
  "dependencies": {
37
+ "@fal-ai/client": "^1.2.1",
34
38
  "cheerio": "^1.1.2",
35
39
  "es-toolkit": "^1.43.0",
40
+ "gpt-tokenizer": "^3.4.0",
36
41
  "sanitize-html": "^2.17.0"
37
42
  },
38
43
  "devDependencies": {
@@ -50,8 +55,8 @@
50
55
  "file-type": "^21.1.1",
51
56
  "markdansi": "0.1.7",
52
57
  "mime": "^4.1.0",
53
- "osc-progress": "^0.1.0",
54
58
  "ora": "^9.0.0",
59
+ "osc-progress": "^0.1.0",
55
60
  "tokentally": "github:steipete/tokentally#v0.1.0",
56
61
  "tsx": "^4.21.0",
57
62
  "typescript": "^5.9.3",