@steipete/summarize 0.10.0 → 0.11.1

package/dist/types/slides/extract.d.ts

@@ -1,6 +1,6 @@
-import type { ExtractedLinkContent, MediaCache } from '../content/index.js';
-import type { SlideSettings } from './settings.js';
-import type { SlideExtractionResult, SlideImage, SlideSource, SlideSourceKind } from './types.js';
+import type { ExtractedLinkContent, MediaCache } from "../content/index.js";
+import type { SlideSettings } from "./settings.js";
+import type { SlideExtractionResult, SlideImage, SlideSource, SlideSourceKind } from "./types.js";
 type ExtractSlidesArgs = {
     source: SlideSource;
     settings: SlideSettings;
@@ -9,6 +9,7 @@ type ExtractSlidesArgs = {
     env: Record<string, string | undefined>;
     timeoutMs: number;
     ytDlpPath: string | null;
+    ytDlpCookiesFromBrowser?: string | null;
     ffmpegPath: string | null;
     tesseractPath: string | null;
     hooks?: {
@@ -32,7 +33,7 @@ export declare function resolveSlideSource({ url, extracted, }: {
     extracted: ExtractedLinkContent;
 }): SlideSource | null;
 export declare function resolveSlideSourceFromUrl(url: string): SlideSource | null;
-export declare function extractSlidesForSource({ source, settings, noCache, mediaCache, env, timeoutMs, ytDlpPath, ffmpegPath, tesseractPath, hooks, }: ExtractSlidesArgs): Promise<SlideExtractionResult>;
+export declare function extractSlidesForSource({ source, settings, noCache, mediaCache, env, timeoutMs, ytDlpPath, ytDlpCookiesFromBrowser, ffmpegPath, tesseractPath, hooks, }: ExtractSlidesArgs): Promise<SlideExtractionResult>;
 export declare function parseShowinfoTimestamp(line: string): number | null;
 export declare function resolveExtractedTimestamp({ requested, actual, seekBase, }: {
     requested: number;

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

@@ -1,5 +1,5 @@
-export { extractSlidesForSource, parseShowinfoTimestamp, resolveExtractedTimestamp, resolveSlideSource, resolveSlideSourceFromUrl, } from './extract.js';
-export type { SlideSettings, SlideSettingsInput } from './settings.js';
-export { resolveSlideSettings } from './settings.js';
-export { buildSlidesDirId, readSlidesCacheIfValid, resolveSlideImagePath, resolveSlidesDir, serializeSlideImagePath, validateSlidesCache, } from './store.js';
-export type { SlideAutoTune, SlideExtractionResult, SlideImage, SlideSource, SlideSourceKind, } from './types.js';
+export { extractSlidesForSource, parseShowinfoTimestamp, resolveExtractedTimestamp, resolveSlideSource, resolveSlideSourceFromUrl, } from "./extract.js";
+export type { SlideSettings, SlideSettingsInput } from "./settings.js";
+export { resolveSlideSettings } from "./settings.js";
+export { buildSlidesDirId, readSlidesCacheIfValid, resolveSlideImagePath, resolveSlidesDir, serializeSlideImagePath, validateSlidesCache, } from "./store.js";
+export type { SlideAutoTune, SlideExtractionResult, SlideImage, SlideSource, SlideSourceKind, } from "./types.js";

package/dist/types/slides/store.d.ts

@@ -1,5 +1,5 @@
-import type { SlideSettings } from './settings.js';
-import type { SlideExtractionResult, SlideSource } from './types.js';
+import type { SlideSettings } from "./settings.js";
+import type { SlideExtractionResult, SlideSource } from "./types.js";
 export declare function resolveSlidesDir(outputDir: string, sourceId: string): string;
 export declare function buildSlidesDirId(slidesDir: string): string;
 export declare function resolveSlideImagePath(slidesDir: string, imagePath: string): string | null;

package/dist/types/slides/types.d.ts

@@ -1,4 +1,4 @@
-export type SlideSourceKind = 'youtube' | 'direct';
+export type SlideSourceKind = "youtube" | "direct";
 export type SlideSource = {
     url: string;
     kind: SlideSourceKind;
@@ -20,7 +20,7 @@ export type SlideAutoTune = {
     enabled: boolean;
     chosenThreshold: number;
     confidence: number;
-    strategy: 'hash' | 'none';
+    strategy: "hash" | "none";
 };
 export type SlideExtractionResult = {
     sourceUrl: string;

package/dist/types/tty/osc-progress.d.ts

@@ -1,5 +1,5 @@
-import type { OscProgressController } from 'osc-progress';
-export type { OscProgressController, OscProgressOptions, OscProgressSupportOptions, OscProgressTerminator, } from 'osc-progress';
-export declare function createOscProgressController(options: import('osc-progress').OscProgressOptions): OscProgressController;
-export declare function startOscProgress(options: import('osc-progress').OscProgressOptions): () => void;
-export declare function supportsOscProgress(env: Record<string, string | undefined>, isTty: boolean, options?: import('osc-progress').OscProgressSupportOptions): boolean;
+import type { OscProgressController } from "osc-progress";
+export type { OscProgressController, OscProgressOptions, OscProgressSupportOptions, OscProgressTerminator, } from "osc-progress";
+export declare function createOscProgressController(options: import("osc-progress").OscProgressOptions): OscProgressController;
+export declare function startOscProgress(options: import("osc-progress").OscProgressOptions): () => void;
+export declare function supportsOscProgress(env: Record<string, string | undefined>, isTty: boolean, options?: import("osc-progress").OscProgressSupportOptions): boolean;

package/dist/types/tty/progress/fetch-html.d.ts

@@ -1,6 +1,6 @@
-import type { LinkPreviewProgressEvent } from '@steipete/summarize-core/content';
-import type { OscProgressController } from '../osc-progress.js';
-import type { ThemeRenderer } from '../theme.js';
+import type { LinkPreviewProgressEvent } from "@steipete/summarize-core/content";
+import type { OscProgressController } from "../osc-progress.js";
+import type { ThemeRenderer } from "../theme.js";
 export declare function createFetchHtmlProgressRenderer({ spinner, oscProgress, theme, }: {
     spinner: {
         setText: (text: string) => void;

package/dist/types/tty/progress/transcript.d.ts

@@ -1,6 +1,6 @@
-import type { LinkPreviewProgressEvent } from '@steipete/summarize-core/content';
-import type { OscProgressController } from '../osc-progress.js';
-import type { ThemeRenderer } from '../theme.js';
+import type { LinkPreviewProgressEvent } from "@steipete/summarize-core/content";
+import type { OscProgressController } from "../osc-progress.js";
+import type { ThemeRenderer } from "../theme.js";
 export declare function createTranscriptProgressRenderer({ spinner, oscProgress, theme, }: {
     spinner: {
         setText: (text: string) => void;

package/dist/types/tty/spinner.d.ts

@@ -1,9 +1,9 @@
-import { type Options as OraOptions } from 'ora';
+import { type Options as OraOptions } from "ora";
 export declare function startSpinner({ text, enabled, stream, color, }: {
     text: string;
     enabled: boolean;
     stream: NodeJS.WritableStream;
-    color?: OraOptions['color'];
+    color?: OraOptions["color"];
 }): {
     stop: () => void;
     clear: () => void;

package/dist/types/tty/theme.d.ts

@@ -1,10 +1,10 @@
 export declare const CLI_THEME_NAMES: readonly ["aurora", "ember", "moss", "mono"];
 export type CliThemeName = (typeof CLI_THEME_NAMES)[number];
-export type ThemeRole = 'heading' | 'accent' | 'accentStrong' | 'muted' | 'dim' | 'success' | 'warning' | 'error' | 'label' | 'value' | 'code';
+export type ThemeRole = "heading" | "accent" | "accentStrong" | "muted" | "dim" | "success" | "warning" | "error" | "label" | "value" | "code";
 type ThemePalette = {
     name: CliThemeName;
     roles: Record<ThemeRole, string>;
-    spinner: 'cyan' | 'magenta' | 'yellow' | 'green' | 'gray' | 'blue';
+    spinner: "cyan" | "magenta" | "yellow" | "green" | "gray" | "blue";
 };
 export declare const DEFAULT_CLI_THEME: CliThemeName;
 export declare function listCliThemes(): CliThemeName[];

package/dist/types/tty/website-progress.d.ts

@@ -1,6 +1,6 @@
-import type { LinkPreviewProgressEvent } from '@steipete/summarize-core/content';
-import type { OscProgressController } from './osc-progress.js';
-import type { ThemeRenderer } from './theme.js';
+import type { LinkPreviewProgressEvent } from "@steipete/summarize-core/content";
+import type { OscProgressController } from "./osc-progress.js";
+import type { ThemeRenderer } from "./theme.js";
 export declare function createWebsiteProgress({ enabled, spinner, oscProgress, theme, }: {
     enabled: boolean;
     spinner: {

package/dist/types/version.d.ts

@@ -1,4 +1,4 @@
-export declare const FALLBACK_VERSION = "0.10.0";
+export declare const FALLBACK_VERSION = "0.11.1";
 export declare function resolvePackageVersion(importMetaUrl?: string): string;
 export declare function resolveGitSha(importMetaUrl?: string): string | null;
 export declare function formatVersionLine(importMetaUrl?: string): string;

package/docs/agent.md

@@ -9,6 +9,7 @@ read_when:
 Summarize can run as a **website automation agent** inside the Chrome side panel. This is **optional** and **gated by a checkbox** in Options.
 
 Scope:
+
 - **Off (default):** chat is Q&A only (no tools).
 - **On:** chat runs a tool-capable agent for web automation.
 
@@ -16,10 +17,10 @@ Explicit exclusions (per product direction): **no update checker**, **no tutoria
 
 ## Architecture (High Level)
 
-1) **Side panel** maintains the agent loop + chat UI.
-2) **Background** handles tab data, extraction, and tool execution.
-3) **Content scripts** handle element picking and native-input bridge.
-4) **Daemon** provides `/v1/agent` (SSE stream of chunks + final assistant message).
+1. **Side panel** maintains the agent loop + chat UI.
+2. **Background** handles tab data, extraction, and tool execution.
+3. **Content scripts** handle element picking and native-input bridge.
+4. **Daemon** provides `/v1/agent` (SSE stream of chunks + final assistant message).
 
 ### Data Flow (Agent Loop)
 
@@ -63,10 +64,12 @@ Defined in `apps/chrome-extension/wxt.config.ts` and requested via Options:
 ### `POST /v1/agent` (SSE)
 
 **Headers**
+
 - `Authorization: Bearer <token>`
 - `Content-Type: application/json`
 
 **Body**
+
 ```
 {
   "url": "https://...",
@@ -83,6 +86,7 @@ Defined in `apps/chrome-extension/wxt.config.ts` and requested via Options:
 ```
 
 **Response (SSE, default)**
+
 ```
 event: chunk
 data: { "text": "..." }
@@ -99,6 +103,7 @@ data: { "message": "..." }
 
 **Response (JSON)**
 Use `Accept: application/json` or `?format=json`.
+
 ```
 { "ok": true, "assistant": { /* AssistantMessage */ } }
 ```
@@ -108,6 +113,7 @@ Use `Accept: application/json` or `?format=json`.
 Returns cached chat history for the same cache key as `/v1/agent`.
 
 **Body**
+
 ```
 {
   "url": "https://...",
@@ -121,6 +127,7 @@ Returns cached chat history for the same cache key as `/v1/agent`.
 ```
 
 **Response**
+
 ```
 { "ok": true, "messages": [/* Message[] */] }
 ```
@@ -146,36 +153,44 @@ See `buildChatPageContent()` usage in `apps/chrome-extension/src/entrypoints/bac
 ## Tools
 
 ### 1) `navigate`
+
 Navigate the active tab.
 
 Params:
+
 ```
 { "url": "https://...", "newTab": false }
 ```
 
 Result:
+
 ```
 { "finalUrl": "https://...", "title": "...", "tabId": 123 }
 ```
 
 Notes:
+
 - Uses `chrome.tabs.update` or `chrome.tabs.create`.
 - Waits for tab status `complete` (15s timeout).
 
 ### 2) `repl`
+
 Execute JavaScript in a sandbox, with `browserjs()` to run in the page context.
 
 Params:
+
 ```
 { "title": "...", "code": "..." }
 ```
 
 Result:
+
 ```
 { "output": "console/return output", "files": [{ "fileName": "...", "mimeType": "...", "contentBase64": "..." }] }
 ```
 
 REPL environment:
+
 - Runs in a **sandboxed iframe** (no DOM access to the panel).
 - `browserjs(fn, ...args)` runs the function **in the page context**.
   - Uses `chrome.userScripts.execute` (main world) when available.
@@ -186,9 +201,11 @@ REPL environment:
 - `returnFile(name, content, mimeType)` or `returnFile({ fileName, content, mimeType })` attaches files to the tool result.
 
 Safety:
+
 - Navigation inside REPL code (`window.location`, `history`, etc.) is rejected. Use `navigate()` instead.
 
 Page-context helpers (via `browserjs()`):
+
 - Skills libraries are auto-injected when domain patterns match the active URL.
 - If `debugger` permission is granted, native helpers are exposed:
   - `nativeClick(selector)`
@@ -197,14 +214,17 @@ Page-context helpers (via `browserjs()`):
   - `nativeKeyDown(key)` / `nativeKeyUp(key)`
 
 ### 3) `ask_user_which_element`
+
 Shows a click-to-select overlay and returns element metadata.
 
 Params:
+
 ```
 { "message": "Optional guidance" }
 ```
 
 Result (example):
+
 ```
 {
   "selector": "#submit",
@@ -218,19 +238,23 @@ Result (example):
 ```
 
 Overlay UX:
+
 - Hover highlights element under cursor.
 - Click selects.
 - ↑ / ↓ moves up or down the DOM tree.
 - Esc cancels.
 
 ### 4) `skill`
+
 CRUD for domain-specific libraries (stored in `chrome.storage.local`).
 
 Storage keys:
+
 - `automation.skills` (map of name → skill)
 - `automation.skillsSeeded` (one-time default seed)
 
 Actions:
+
 - `list` (optionally filtered by URL)
 - `get` (optionally includes library code)
 - `create` / `rewrite`
@@ -240,30 +264,37 @@ Actions:
 Default skills seed from `apps/chrome-extension/src/automation/default-skills.json`.
 
 Matching:
+
 - Glob-like domain patterns (supports `*` and `**`).
 - Match is done against hostname + path (e.g. `github.com/*/issues`).
 
 Notes:
+
 - `update` is intended for in-place string replacements; use `rewrite` to rename.
 - Skills libraries run inside `browserjs()` and must avoid navigation.
 
 ### 5) `debugger` (optional)
+
 Runs JavaScript in the **main world** via the Chrome debugger. **Last resort** (shows Chrome debug banner).
 
 Params:
+
 ```
 { "action": "eval", "code": "..." }
 ```
 
 Result:
+
 ```
 { "text": "...", "details": { ... } }
 ```
 
 ### 6) `summarize`
+
 Run the Summarize pipeline against a URL (summary or extract-only).
 
 Params:
+
 ```
 {
   "url": "https://...",
@@ -287,16 +318,19 @@ Params:
 ```
 
 Result (summary):
+
 ```
 { "output": "..." }
 ```
 
 Result (extract-only):
+
 ```
 { "output": "...", "details": { "content": "...", "title": "...", "wordCount": 123, ... } }
 ```
 
 Notes:
+
 - URL-only (uses daemon URL pipeline).
 - Use `extractOnly: true` + `format: "markdown"` to return extracted Markdown.
 - When `format: "markdown"`, `markdownMode` defaults to `readability`.

package/docs/assets/site.js

@@ -1,72 +1,72 @@
-const canonicalHost = 'summarize.sh'
-const redirectHostnames = new Set(['summarize.is', 'www.summarize.is'])
+const canonicalHost = "summarize.sh";
+const redirectHostnames = new Set(["summarize.is", "www.summarize.is"]);
 
 const maybeRedirect = () => {
   try {
-    const { hostname, pathname, search, hash } = window.location
-    if (!redirectHostnames.has(hostname)) return
-    const target = `https://${canonicalHost}${pathname}${search}${hash}`
-    window.location.replace(target)
+    const { hostname, pathname, search, hash } = window.location;
+    if (!redirectHostnames.has(hostname)) return;
+    const target = `https://${canonicalHost}${pathname}${search}${hash}`;
+    window.location.replace(target);
   } catch {
     // ignore
   }
-}
+};
 
 const highlightNav = () => {
-  const path = window.location.pathname
-  const isDocs = path.includes('/docs/')
-  const navDocs = document.querySelector('a[data-nav="docs"]')
-  const navHome = document.querySelector('a[data-nav="home"]')
-  if (navDocs && isDocs) navDocs.setAttribute('aria-current', 'page')
-  if (navHome && !isDocs) navHome.setAttribute('aria-current', 'page')
+  const path = window.location.pathname;
+  const isDocs = path.includes("/docs/");
+  const navDocs = document.querySelector('a[data-nav="docs"]');
+  const navHome = document.querySelector('a[data-nav="home"]');
+  if (navDocs && isDocs) navDocs.setAttribute("aria-current", "page");
+  if (navHome && !isDocs) navHome.setAttribute("aria-current", "page");
 
-  const sideLinks = document.querySelectorAll('.side a[href]')
+  const sideLinks = document.querySelectorAll(".side a[href]");
   for (const a of sideLinks) {
-    const href = a.getAttribute('href') ?? ''
-    if (!href) continue
-    const normalized = href.replace(/^\.\//, '')
-    if (path.endsWith(normalized)) a.setAttribute('aria-current', 'page')
+    const href = a.getAttribute("href") ?? "";
+    if (!href) continue;
+    const normalized = href.replace(/^\.\//, "");
+    if (path.endsWith(normalized)) a.setAttribute("aria-current", "page");
   }
-}
+};
 
 const wireCopyButtons = () => {
-  const buttons = document.querySelectorAll('[data-copy]')
+  const buttons = document.querySelectorAll("[data-copy]");
   const handleCopyClick = async (button) => {
-    const selector = button.getAttribute('data-copy')
-    const target = selector ? document.querySelector(selector) : null
-    const text = target?.textContent?.trim() ?? ''
-    if (!text) return
+    const selector = button.getAttribute("data-copy");
+    const target = selector ? document.querySelector(selector) : null;
+    const text = target?.textContent?.trim() ?? "";
+    if (!text) return;
     try {
-      await navigator.clipboard.writeText(text)
-      const prev = button.textContent ?? ''
-      button.textContent = 'Copied'
-      button.setAttribute('data-copied', '1')
+      await navigator.clipboard.writeText(text);
+      const prev = button.textContent ?? "";
+      button.textContent = "Copied";
+      button.setAttribute("data-copied", "1");
       window.setTimeout(() => {
-        button.textContent = prev
-        button.removeAttribute('data-copied')
-      }, 900)
+        button.textContent = prev;
+        button.removeAttribute("data-copied");
+      }, 900);
     } catch {
       // ignore
     }
-  }
+  };
   for (const button of buttons) {
-    button.addEventListener('click', () => {
-      void handleCopyClick(button)
-    })
+    button.addEventListener("click", () => {
+      void handleCopyClick(button);
+    });
   }
-}
+};
 
 const reveal = () => {
-  const items = document.querySelectorAll('.reveal')
-  let i = 0
+  const items = document.querySelectorAll(".reveal");
+  let i = 0;
   for (const el of items) {
-    const delay = Math.min(380, i * 70)
-    window.setTimeout(() => el.classList.add('is-on'), delay)
-    i++
+    const delay = Math.min(380, i * 70);
+    window.setTimeout(() => el.classList.add("is-on"), delay);
+    i++;
   }
-}
+};
 
-maybeRedirect()
-highlightNav()
-wireCopyButtons()
-reveal()
+maybeRedirect();
+highlightNav();
+wireCopyButtons();
+reveal();

package/docs/chrome-extension.md

@@ -22,6 +22,7 @@ Quickstart:
   - Restart (if needed): `summarize daemon restart`
 
 Firefox notes:
+
 - Sidebar UX differs from Chrome’s side panel (persistent sidebar instead of slide-in panel).
 - Firefox testing is limited in Playwright; see `apps/chrome-extension/tests/README-firefox.md`.
 - Compatibility details: `apps/chrome-extension/docs/firefox.md`.
@@ -38,6 +39,10 @@ Dev (repo checkout):
 - “Daemon not reachable”:
   - `summarize daemon status`
   - Logs: `~/.summarize/logs/daemon.err.log`
+- macOS `launchctl bootstrap` errors (`Input/output error`, `Domain does not support specified action`):
+  - `summarize daemon install` now tries both launchd domains (`gui/<uid>` then `user/<uid>`).
+  - Install as your normal user (not root) so HOME + launchd domain match.
+  - Re-run: `summarize daemon install --token <TOKEN>`.
 - “Need extension-side traces”:
   - Options → Logs → `extension.log` (panel/background events).
   - Enable “Extended logging” in Advanced settings for full pipeline traces.
@@ -70,11 +75,11 @@ Dev (repo checkout):
 
 ## Data Flow
 
-1) User opens side panel (click extension icon).
-2) Panel sends a “ready” message to the background (plus periodic “ping” heartbeats while open).
-3) On nav/tab change (and auto enabled): background asks the content script to extract `{ url, title, text }` (best-effort).
-4) Background `POST`s payload to daemon `/v1/summarize` with `Authorization: Bearer <token>`.
-5) Panel opens `/v1/summarize/<id>/events` (SSE) and renders streamed Markdown.
+1. User opens side panel (click extension icon).
+2. Panel sends a “ready” message to the background (plus periodic “ping” heartbeats while open).
+3. On nav/tab change (and auto enabled): background asks the content script to extract `{ url, title, text }` (best-effort).
+4. Background `POST`s payload to daemon `/v1/summarize` with `Authorization: Bearer <token>`.
+5. Panel opens `/v1/summarize/<id>/events` (SSE) and renders streamed Markdown.
 
 ## Auto Mode (URL + Page Text)
 
@@ -225,6 +230,7 @@ Problem: daemon must be secured; extension must discover and pair with it.
   - `event: error` `data: { message }`
 
 Notes:
+
 - SSE keeps the extension simple + streaming-friendly.
 - Requests keyed by `id`; daemon keeps a small in-memory map while streaming.