@steipete/summarize 0.4.0 → 0.5.0

package/dist/types/llm/generate-text.d.ts

@@ -14,7 +14,13 @@ export type LlmTokenUsage = {
     completionTokens: number | null;
     totalTokens: number | null;
 };
-export declare function generateTextWithModelId({ modelId, apiKeys, system, prompt, temperature, maxOutputTokens, timeoutMs, fetchImpl, openrouter, }: {
+type RetryNotice = {
+    attempt: number;
+    maxRetries: number;
+    delayMs: number;
+    error: unknown;
+};
+export declare function generateTextWithModelId({ modelId, apiKeys, system, prompt, temperature, maxOutputTokens, timeoutMs, fetchImpl, forceOpenRouter, retries, onRetry, }: {
     modelId: string;
     apiKeys: LlmApiKeys;
     system?: string;
@@ -23,14 +29,16 @@ export declare function generateTextWithModelId({ modelId, apiKeys, system, prom
     maxOutputTokens?: number;
     timeoutMs: number;
     fetchImpl: typeof fetch;
-    openrouter?: OpenRouterOptions;
+    forceOpenRouter?: boolean;
+    retries?: number;
+    onRetry?: (notice: RetryNotice) => void;
 }): Promise<{
     text: string;
     canonicalModelId: string;
     provider: 'xai' | 'openai' | 'google' | 'anthropic';
     usage: LlmTokenUsage | null;
 }>;
-export declare function streamTextWithModelId({ modelId, apiKeys, system, prompt, temperature, maxOutputTokens, timeoutMs, fetchImpl, openrouter, }: {
+export declare function streamTextWithModelId({ modelId, apiKeys, system, prompt, temperature, maxOutputTokens, timeoutMs, fetchImpl, forceOpenRouter, }: {
     modelId: string;
     apiKeys: LlmApiKeys;
     system?: string;
@@ -39,7 +47,7 @@ export declare function streamTextWithModelId({ modelId, apiKeys, system, prompt
     maxOutputTokens?: number;
     timeoutMs: number;
     fetchImpl: typeof fetch;
-    openrouter?: OpenRouterOptions;
+    forceOpenRouter?: boolean;
 }): Promise<{
     textStream: AsyncIterable<string>;
     canonicalModelId: string;
@@ -47,3 +55,4 @@ export declare function streamTextWithModelId({ modelId, apiKeys, system, prompt
     usage: Promise<LlmTokenUsage | null>;
     lastError: () => unknown;
 }>;
+export {};

package/dist/types/llm/html-to-markdown.d.ts

@@ -1,15 +1,21 @@
 import type { ConvertHtmlToMarkdown } from '../content/link-preview/deps.js';
 import type { LlmTokenUsage } from './generate-text.js';
-import { type OpenRouterOptions } from './generate-text.js';
-export declare function createHtmlToMarkdownConverter({ modelId, xaiApiKey, googleApiKey, openaiApiKey, anthropicApiKey, openrouterApiKey, openrouter, fetchImpl, onUsage, }: {
+export declare function createHtmlToMarkdownConverter({ modelId, forceOpenRouter, xaiApiKey, googleApiKey, openaiApiKey, anthropicApiKey, openrouterApiKey, fetchImpl, retries, onRetry, onUsage, }: {
     modelId: string;
+    forceOpenRouter?: boolean;
     xaiApiKey: string | null;
     googleApiKey: string | null;
     openaiApiKey: string | null;
     fetchImpl: typeof fetch;
     anthropicApiKey: string | null;
     openrouterApiKey: string | null;
-    openrouter?: OpenRouterOptions;
+    retries?: number;
+    onRetry?: (notice: {
+        attempt: number;
+        maxRetries: number;
+        delayMs: number;
+        error: unknown;
+    }) => void;
     onUsage?: (usage: {
         model: string;
         provider: 'xai' | 'openai' | 'google' | 'anthropic';

package/dist/types/model-auto.d.ts

@@ -0,0 +1,23 @@
+import type { AutoRuleKind, CliProvider, SummarizeConfig } from './config.js';
+import type { LiteLlmCatalog } from './pricing/litellm.js';
+export type AutoSelectionInput = {
+    kind: AutoRuleKind;
+    promptTokens: number | null;
+    desiredOutputTokens: number | null;
+    requiresVideoUnderstanding: boolean;
+    env: Record<string, string | undefined>;
+    config: SummarizeConfig | null;
+    catalog: LiteLlmCatalog | null;
+    openrouterProvidersFromEnv: string[] | null;
+    cliAvailability?: Partial<Record<CliProvider, boolean>>;
+};
+export type AutoModelAttempt = {
+    transport: 'native' | 'openrouter' | 'cli';
+    userModelId: string;
+    llmModelId: string | null;
+    openrouterProviders: string[] | null;
+    forceOpenRouter: boolean;
+    requiredEnv: 'XAI_API_KEY' | 'OPENAI_API_KEY' | 'GEMINI_API_KEY' | 'ANTHROPIC_API_KEY' | 'OPENROUTER_API_KEY' | 'CLI_CLAUDE' | 'CLI_CODEX' | 'CLI_GEMINI';
+    debug: string;
+};
+export declare function buildAutoModelAttempts(input: AutoSelectionInput): AutoModelAttempt[];

package/dist/types/model-spec.d.ts

@@ -0,0 +1,33 @@
+import type { CliProvider } from './config.js';
+export type FixedModelSpec = {
+    transport: 'native';
+    userModelId: string;
+    llmModelId: string;
+    provider: 'xai' | 'openai' | 'google' | 'anthropic';
+    openrouterProviders: string[] | null;
+    forceOpenRouter: false;
+    requiredEnv: 'XAI_API_KEY' | 'OPENAI_API_KEY' | 'GEMINI_API_KEY' | 'ANTHROPIC_API_KEY';
+} | {
+    transport: 'openrouter';
+    userModelId: string;
+    openrouterModelId: string;
+    llmModelId: string;
+    openrouterProviders: string[] | null;
+    forceOpenRouter: true;
+    requiredEnv: 'OPENROUTER_API_KEY';
+} | {
+    transport: 'cli';
+    userModelId: string;
+    llmModelId: null;
+    openrouterProviders: null;
+    forceOpenRouter: false;
+    requiredEnv: 'CLI_CLAUDE' | 'CLI_CODEX' | 'CLI_GEMINI';
+    cliProvider: CliProvider;
+    cliModel: string | null;
+};
+export type RequestedModel = {
+    kind: 'auto';
+} | ({
+    kind: 'fixed';
+} & FixedModelSpec);
+export declare function parseRequestedModelId(raw: string): RequestedModel;

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

@@ -0,0 +1,8 @@
+import type { SummaryLengthTarget } from './link-summary.js';
+export declare function buildPathSummaryPrompt({ kindLabel, filePath, filename, mediaType, summaryLength, }: {
+    kindLabel: 'file' | 'image';
+    filePath: string;
+    filename: string | null;
+    mediaType: string | null;
+    summaryLength: SummaryLengthTarget;
+}): string;

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

@@ -1,3 +1,4 @@
 export type { SummaryLength } from '../shared/contracts.js';
+export { buildPathSummaryPrompt } from './cli.js';
 export { buildFileSummaryPrompt, buildFileTextSummaryPrompt } from './file.js';
 export { buildLinkSummaryPrompt, estimateMaxCompletionTokensForCharacters, pickSummaryLengthForCharacters, type ShareContextEntry, SUMMARY_LENGTH_TO_TOKENS, type SummaryLengthTarget, } from './link-summary.js';

package/dist/types/refresh-free.d.ts

@@ -0,0 +1,19 @@
+type GenerateFreeOptions = {
+    runs: number;
+    smart: number;
+    maxCandidates: number;
+    concurrency: number;
+    timeoutMs: number;
+    minParamB: number;
+    maxAgeDays: number;
+    setDefault: boolean;
+};
+export declare function refreshFree({ env, fetchImpl, stdout, stderr, verbose, options, }: {
+    env: Record<string, string | undefined>;
+    fetchImpl: typeof fetch;
+    stdout: NodeJS.WritableStream;
+    stderr: NodeJS.WritableStream;
+    verbose?: boolean;
+    options?: Partial<GenerateFreeOptions>;
+}): Promise<void>;
+export {};

package/dist/types/version.d.ts

@@ -1,2 +1,2 @@
-export declare const FALLBACK_VERSION = "0.4.0";
+export declare const FALLBACK_VERSION = "0.5.0";
 export declare function resolvePackageVersion(importMetaUrl?: string): string;

package/docs/README.md

@@ -4,6 +4,9 @@
 - `docs/youtube.md` — YouTube transcript extraction (youtubei / captionTracks / Apify)
 - `docs/firecrawl.md` — Firecrawl mode + API key
 - `docs/llm.md` — LLM summarization + model config (Gateway/OpenAI)
+- `docs/cli.md` — CLI models (Claude/Codex/Gemini)
+- `docs/model-auto.md` — automatic model selection (`--model auto`)
+- `docs/manual-tests.md` — manual end-to-end test checklist
 - `docs/extract-only.md` — extract mode (no summary LLM call)
 
 ## Website

package/docs/cli.md

@@ -0,0 +1,95 @@
+# CLI models
+
+Summarize can use installed CLIs (Claude, Codex, Gemini) as local model backends.
+
+## Model ids
+
+- `cli/claude/<model>` (e.g. `cli/claude/sonnet`)
+- `cli/codex/<model>` (e.g. `cli/codex/gpt-5.2`)
+- `cli/gemini/<model>` (e.g. `cli/gemini/gemini-3-flash-preview`)
+
+Use `--cli [provider]` (case-insensitive) for the provider default, or `--model cli/<provider>/<model>` to pin a model.
+If `--cli` is provided without a provider, auto selection is used with CLI enabled.
+
+## Auto mode
+
+Auto mode does **not** use CLIs unless you set `cli.enabled` in config.
+
+Why: CLI adds ~4s latency per attempt and higher variance.
+Recommendation: enable only Gemini unless you have a reason to add others.
+
+Gemini CLI performance: summarize sets `GEMINI_CLI_NO_RELAUNCH=true` for Gemini CLI runs to avoid a costly self-relaunch (can be overridden by setting it yourself).
+
+When enabled, auto prepends CLI attempts in the order listed in `cli.enabled`
+(recommended: `["gemini"]`).
+
+Enable CLI attempts:
+
+```json
+{
+  "cli": { "enabled": ["gemini"] }
+}
+```
+
+Disable CLI attempts:
+
+```json
+{
+  "cli": { "enabled": [] }
+}
+```
+
+Note: when `cli.enabled` is set, it also acts as an allowlist for explicit `--cli` / `--model cli/...`.
+
+## CLI discovery
+
+Binary lookup:
+
+- `CLAUDE_PATH`, `CODEX_PATH`, `GEMINI_PATH` (optional overrides)
+- Otherwise uses `PATH`
+
+## Attachments (images/files)
+
+When a CLI attempt is used for an image or non-text file, Summarize switches to a
+path-based prompt and enables the required tool flags:
+
+- Claude: `--tools Read --dangerously-skip-permissions`
+- Gemini: `--yolo` and `--include-directories <dir>`
+- Codex: `codex exec --output-last-message ...` and `-i <image>` for images
+
+## Config
+
+```json
+{
+  "cli": {
+    "enabled": ["claude", "gemini", "codex"],
+    "codex": { "model": "gpt-5.2" },
+    "gemini": { "model": "gemini-3-flash-preview", "extraArgs": ["--verbose"] },
+    "claude": {
+      "model": "sonnet",
+      "binary": "/usr/local/bin/claude",
+      "extraArgs": ["--verbose"]
+    }
+  }
+}
+```
+
+Notes:
+
+- CLI output is treated as text only (no token accounting).
+- If a CLI call fails, auto mode falls back to the next candidate.
+
+## Generate free preset (OpenRouter)
+
+`summarize` ships with a built-in preset `free`, backed by OpenRouter `:free` models.
+To regenerate the candidate list (and persist it in your config):
+
+```bash
+summarize refresh-free
+```
+
+Options:
+
+- `--runs 2` (default): extra timing runs per selected model (total runs = 1 + runs)
+- `--smart 3` (default): number of “smart-first” picks (rest filled by fastest)
+- `--set-default`: also sets `"model": "free"` in `~/.summarize/config.json`

package/docs/config.md

@@ -15,14 +15,136 @@ For `model`:
 1. CLI flag `--model`
 2. Env `SUMMARIZE_MODEL`
 3. Config file `model`
-4. Built-in default (`google/gemini-3-flash-preview`)
+4. Built-in default (`auto`)
 
 ## Format
 
 `~/.summarize/config.json`:
 
+```json
+{
+  "model": { "id": "google/gemini-3-flash-preview" }
+}
+```
+
+Shorthand (equivalent):
+
 ```json
 {
   "model": "google/gemini-3-flash-preview"
 }
 ```
+
+`model` can also be auto:
+
+```json
+{
+  "model": { "mode": "auto" }
+}
+```
+
+Shorthand (equivalent):
+
+```json
+{
+  "model": "auto"
+}
+```
+
+## Presets
+
+Define presets you can select via `--model <preset>`:
+
+```json
+{
+  "models": {
+    "fast": { "id": "openai/gpt-5-mini" },
+    "or-free": {
+      "rules": [
+        {
+          "candidates": [
+            "openrouter/google/gemini-2.0-flash-exp:free",
+            "openrouter/meta-llama/llama-3.3-70b-instruct:free"
+          ]
+        }
+      ]
+    }
+  }
+}
+```
+
+Notes:
+
+- `auto` is reserved and can’t be defined as a preset.
+- `free` is built-in (OpenRouter `:free` candidates). Override it by defining `models.free` in your config, or regenerate it via `summarize refresh-free`.
+
+Use a preset as your default `model`:
+
+```json
+{
+  "model": "fast"
+}
+```
+
+Notes:
+
+- For presets, `"mode": "auto"` is optional when `"rules"` is present.
+
+For auto selection with rules:
+
+```json
+{
+  "model": {
+    "mode": "auto",
+    "rules": [
+      {
+        "when": ["video"],
+        "candidates": ["google/gemini-3-flash-preview"]
+      },
+      {
+        "when": ["website", "youtube"],
+        "bands": [
+          {
+            "token": { "max": 8000 },
+            "candidates": ["openai/gpt-5-mini"]
+          },
+          {
+            "candidates": ["xai/grok-4-fast-non-reasoning"]
+          }
+        ]
+      },
+      {
+        "candidates": ["openai/gpt-5-mini", "openrouter/openai/gpt-5-mini"]
+      }
+    ]
+  },
+  "media": { "videoMode": "auto" }
+}
+```
+
+Notes:
+
+- Parsed leniently (JSON5), but **comments are not allowed**.
+- Unknown keys are ignored.
+- `model.rules` is optional. If omitted, built-in defaults apply.
+- `model.rules[].when` (optional) must be an array (e.g. `["video","youtube"]`).
+- `model.rules[]` must use either `candidates` or `bands`.
+
+## CLI config
+
+```json
+{
+  "cli": {
+    "enabled": ["gemini"],
+    "codex": { "model": "gpt-5.2" },
+    "claude": { "binary": "/usr/local/bin/claude", "extraArgs": ["--verbose"] }
+  }
+}
+```
+
+Notes:
+
+- `cli.enabled` is an allowlist (auto uses CLIs only when set; explicit `--cli` / `--model cli/...` must be included).
+- Recommendation: keep `cli.enabled` to `["gemini"]` unless you have a reason to add others (extra latency/variance).
+- `cli.<provider>.binary` overrides CLI binary discovery.
+- `cli.<provider>.extraArgs` appends extra CLI args.

package/docs/llm.md

@@ -1,37 +1,57 @@
 # LLM / summarization mode
 
-By default `summarize` will call an LLM using **direct provider API keys**.
+By default `summarize` will call an LLM using **direct provider API keys**. When CLI tools are
+installed, auto mode can use local CLI models when `cli.enabled` is set (see `docs/cli.md`).
 
 ## Defaults
 
-- Default model: `google/gemini-3-flash-preview`
+- Default model: `auto`
 - Override with `SUMMARIZE_MODEL`, config file (`model`), or `--model`.
 
 ## Env
 
+- `.env` (optional): when running the CLI, `summarize` also reads `.env` in the current working directory and merges it into the environment (real env vars win).
 - `XAI_API_KEY` (required for `xai/...` models)
 - `OPENAI_API_KEY` (required for `openai/...` models)
 - `OPENAI_BASE_URL` (optional; OpenAI-compatible API endpoint, e.g. OpenRouter)
-- `OPENROUTER_API_KEY` (optional; used when `OPENAI_BASE_URL` points to OpenRouter)
+- `OPENROUTER_API_KEY` (optional; required for `openrouter/...` models; also used when `OPENAI_BASE_URL` points to OpenRouter)
 - `GEMINI_API_KEY` (required for `google/...` models; also accepts `GOOGLE_GENERATIVE_AI_API_KEY` / `GOOGLE_API_KEY`)
 - `ANTHROPIC_API_KEY` (required for `anthropic/...` models)
 - `SUMMARIZE_MODEL` (optional; overrides default model selection)
+- `CLAUDE_PATH` / `CODEX_PATH` / `GEMINI_PATH` (optional; override CLI binary paths)
 
 ## Flags
 
 - `--model <model>`
   - Examples:
+    - `cli/codex/gpt-5.2`
+    - `cli/claude/sonnet`
+    - `cli/gemini/gemini-3-flash-preview`
     - `google/gemini-3-flash-preview`
-    - `openai/gpt-5.2`
+    - `openai/gpt-5-mini`
     - `xai/grok-4-fast-non-reasoning`
     - `google/gemini-2.0-flash`
     - `anthropic/claude-sonnet-4-5`
+    - `openrouter/meta-llama/llama-3.3-70b-instruct:free` (force OpenRouter)
+- `--cli [provider]`
+  - Examples: `--cli claude`, `--cli Gemini`, `--cli codex` (equivalent to `--model cli/<provider>`); `--cli` alone uses auto selection with CLI enabled.
+- `--model auto`
+  - See `docs/model-auto.md`
+- `--model <preset>`
+  - Uses a config-defined preset (see `docs/config.md` → “Presets”).
+- `--video-mode auto|transcript|understand`
+  - Only relevant for video inputs / video-only pages.
 - `--length short|medium|long|xl|xxl|<chars>`
   - This is *soft guidance* to the model (no hard truncation).
   - Minimum numeric value: 50 chars.
+  - Default: `long`.
 - `--max-output-tokens <count>`
   - Hard cap for output tokens (optional).
+  - If omitted, no max token parameter is sent (provider default).
   - Minimum numeric value: 16.
+  - Recommendation: prefer `--length` unless you need a hard cap (some providers count “reasoning” into the cap).
+- `--retries <count>`
+  - LLM retry attempts on timeout (default: 1).
 - `--json` (includes prompt + summary in one JSON object)
 
 ## Input limits

package/docs/manual-tests.md

@@ -0,0 +1,40 @@
+# Manual tests
+
+Goal: sanity-check auto selection + presets end-to-end.
+
+## Setup
+
+- `OPENAI_API_KEY=...` (optional)
+- `GEMINI_API_KEY=...` (optional)
+- `ANTHROPIC_API_KEY=...` (optional)
+- `XAI_API_KEY=...` (optional)
+- `OPENROUTER_API_KEY=...` (optional)
+
+Tip: use `--verbose` to see model attempts + the chosen model.
+
+## Auto (default)
+
+- Website summary (should pick a model, show it in spinner):
+  - `summarize --max-output-tokens 200 https://example.com`
+- No-model-needed shortcut (should print extracted text; no footer “no model needed”):
+  - `summarize --max-output-tokens 99999 https://example.com`
+- Missing-key skip (configure only one key; should skip other providers, still succeed):
+  - Set only `OPENAI_API_KEY`, then run a website summary; should not try Gemini/Anthropic/XAI.
+
+## Presets
+
+- Define a preset in `~/.summarize/config.json` (see `docs/config.md` → “Presets”), then:
+  - `summarize --model <preset> --max-output-tokens 200 https://example.com`
+  - If the preset contains OpenRouter models, ensure `OPENROUTER_API_KEY` is set.
+
+## Images
+
+- Local image (auto uses API models by default; enable CLI via `cli.enabled` to test CLIs):
+  - `summarize ./path/to/image.png --max-output-tokens 200`
+
+## Video
+
+- YouTube:
+  - `summarize https://www.youtube.com/watch?v=dQw4w9WgXcQ --max-output-tokens 200`
+- Local video understanding (requires Gemini video-capable model; otherwise expect an error or transcript-only behavior depending on input):
+  - `summarize ./path/to/video.mp4 --max-output-tokens 200`

package/docs/model-auto.md

@@ -0,0 +1,92 @@
+# Auto model selection (`--model auto`)
+
+`--model auto` picks a model based on input kind + token size, and retries with fallbacks when something fails.
+
+This is also the built-in default when you don’t specify a model.
+
+## What it does
+
+- Builds an ordered list of model “attempts” from `candidates[]` (native first, optional OpenRouter fallback).
+- Skips attempts that don’t have the required API key configured.
+- On any request error, tries the next attempt.
+- If no model is usable, prints the extracted text (no LLM summary). Use `--extract` if you want the raw extracted content even when models are available.
+- Auto prepends CLI attempts only when `cli.enabled` is set (see `docs/cli.md`).
+  - Order follows `cli.enabled`.
+
+## OpenRouter vs native
+
+Model ids:
+
+- Native: `<provider>/<model>` (e.g. `openai/gpt-5-mini`, `google/gemini-3-flash-preview`)
+- Forced OpenRouter: `openrouter/<author>/<slug>` (e.g. `openrouter/meta-llama/llama-3.3-70b-instruct:free`)
+
+Behavior:
+
+- If you pass an `openrouter/...` model id, the request uses OpenRouter (and requires `OPENROUTER_API_KEY`).
+- If you pass a native model id, the CLI prefers the native provider SDK when its key is available, and can fall back to OpenRouter when no native key exists (and `OPENROUTER_API_KEY` is set).
+
+## How selection works
+
+- Uses the order you provide in `model.rules[].candidates[]` (or `bands[].candidates[]`).
+- Filters out candidates that can’t fit the prompt (max input tokens, LiteLLM catalog).
+- For a native candidate, auto mode may add an OpenRouter fallback attempt right after it (when `OPENROUTER_API_KEY` is set and video understanding isn’t required).
+
+Notes:
+
+- Auto mode is non-streaming (so a failed attempt won’t partially print output).
+- Video understanding is only attempted when `--video-mode` is `auto` or `understand`, and a video-capable model is selected.
+
+## Config
+
+Default config file: `~/.summarize/config.json`
+
+This file is parsed leniently (JSON5), but **comments are not allowed**.
+
+`model.rules` is optional; when omitted, built-in defaults apply.
+
+`model.rules[].when` is optional, and when present must be an array (e.g. `["video","youtube"]`).
+
+Rules can be either:
+
+- `candidates: string[]`
+- `bands: [{ token?: { min?: number; max?: number }, candidates: string[] }]`
+
+Example:
+
+```json
+{
+  "model": {
+    "mode": "auto",
+    "rules": [
+      {
+        "when": ["video"],
+        "candidates": ["google/gemini-3-flash-preview"]
+      },
+      {
+        "when": ["website", "youtube"],
+        "bands": [
+          {
+            "token": { "max": 8000 },
+            "candidates": ["openai/gpt-5-mini"]
+          },
+          {
+            "candidates": ["xai/grok-4-fast-non-reasoning"]
+          }
+        ]
+      },
+      {
+        "candidates": ["openai/gpt-5-mini", "openrouter/openai/gpt-5-mini"]
+      }
+    ]
+  },
+  "media": { "videoMode": "auto" }
+}
+```
+
+Minimal shorthand:
+
+```json
+{
+  "model": "auto"
+}
+```

package/docs/site/assets/site.js

@@ -31,24 +31,27 @@ const highlightNav = () => {
 
 const wireCopyButtons = () => {
   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
+    try {
+      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)
+    } catch {
+      // ignore
+    }
+  }
   for (const button of buttons) {
-    button.addEventListener('click', async () => {
-      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')
-        window.setTimeout(() => {
-          button.textContent = prev
-          button.removeAttribute('data-copied')
-        }, 900)
-      } catch {
-        // ignore
-      }
+    button.addEventListener('click', () => {
+      void handleCopyClick(button)
     })
   }
 }