@khorsheed/dsh-reader 0.3.0 → 0.3.2

package/lib/types/ytdlp.js

@@ -0,0 +1,269 @@
+/**
+ * yt-dlp on the host: video metadata and platform captions, never the video.
+ *
+ * Measured 2026-10-20: a 2023 yt-dlp (and the 2025 one pip can still install
+ * on a Python 3.9 environment) can no longer read YouTube — captions now need
+ * the current extractor and a JavaScript runtime. So the reader keeps its own
+ * copy of the official STANDALONE release (bundled Python) under its state
+ * root, fetched on first use and self-updated (`-U`) when it is two weeks old;
+ * a path configured by the deployment wins over it. Node — the host's own
+ * runtime — is handed to yt-dlp as its JavaScript runtime.
+ *
+ * Metadata (`--dump-single-json`) and captions (`--write-subs`) are requested
+ * with `--skip-download`; the only download is an AUDIO track, for local
+ * transcription of a video without captions, deleted once transcribed.
+ *
+ * @module @khorsheed/dsh-reader/ytdlp
+ */
+import { execFile, spawn } from 'node:child_process';
+import { chmodSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, rmSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseCaptions } from "./captions.js";
+/** The release asset for this platform, or `undefined` where none is published. */
+export function releaseAsset(platform = process.platform, arch = process.arch) {
+    if (platform === 'darwin')
+        return 'yt-dlp_macos';
+    if (platform === 'linux')
+        return arch === 'arm64' ? 'yt-dlp_linux_aarch64' : 'yt-dlp_linux';
+    if (platform === 'win32')
+        return 'yt-dlp.exe';
+    return undefined;
+}
+/** How old the managed binary may get before a self-update (ms). */
+const UPDATE_AFTER_MS = 14 * 24 * 60 * 60 * 1000;
+/** Tracks that are not speech captions. */
+const NOT_CAPTIONS = new Set(['live_chat', 'danmaku', 'rechat']);
+/** Caption formats, best first (json3 is YouTube's cleanest; json is Bilibili's). */
+const FORMATS = ['json3', 'vtt', 'srt', 'json'];
+/** The best format a track offers, among the ones the parser reads. */
+function bestFormat(formats) {
+    const offered = new Set((formats ?? []).map(format => format.ext));
+    return FORMATS.find(format => offered.has(format));
+}
+/**
+ * Choose the caption track: the uploader's own captions in the video's
+ * language first, then any uploaded track, then the platform's automatic
+ * captions in the ORIGINAL language (YouTube marks it `<lang>-orig`; the other
+ * auto tracks are machine translations, which are also what trips its rate
+ * limit). Manual and automatic tracks are equally "captions" to the reader
+ * (2026-10-20); the choice only prefers the better one.
+ *
+ * @param info - the video's info JSON.
+ */
+export function chooseCaptionTrack(info) {
+    const language = (info.language ?? '').toLowerCase();
+    const manual = Object.entries(info.subtitles ?? {}).filter(([lang]) => !NOT_CAPTIONS.has(lang));
+    const pick = (entries, auto, preferred) => {
+        for (const want of preferred) {
+            const hit = entries.find(([lang]) => lang.toLowerCase() === want) ?? entries.find(([lang]) => want !== '' && lang.toLowerCase().startsWith(want));
+            const ext = hit === undefined ? undefined : bestFormat(hit[1]);
+            if (hit !== undefined && ext !== undefined)
+                return { lang: hit[0], auto, ext };
+        }
+        for (const [lang, formats] of entries) {
+            const ext = bestFormat(formats);
+            if (ext !== undefined)
+                return { lang, auto, ext };
+        }
+        return undefined;
+    };
+    const fromManual = pick(manual, false, [language, 'zh', 'en', 'ai-zh'].filter(item => item !== ''));
+    if (fromManual !== undefined)
+        return fromManual;
+    const auto = Object.entries(info.automatic_captions ?? {}).filter(([lang]) => !NOT_CAPTIONS.has(lang));
+    const originals = auto.filter(([lang]) => lang.endsWith('-orig'));
+    const fromOriginal = pick(originals, true, language === '' ? [] : [`${language}-orig`]);
+    if (fromOriginal !== undefined)
+        return fromOriginal;
+    return language === '' ? undefined : pick(auto.filter(([lang]) => lang.toLowerCase() === language), true, [language]);
+}
+/** Run a process, resolving its stdout. */
+function run(file, args, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        execFile(file, [...args], { timeout: timeoutMs, maxBuffer: 64 * 1024 * 1024, env: process.env }, (error, stdout, stderr) => {
+            if (error !== null) {
+                const tail = String(stderr).trim().split('\n').filter(line => /ERROR|error:/i.test(line)).slice(-1)[0];
+                reject(new Error(tail ?? error.message));
+                return;
+            }
+            resolve(String(stdout));
+        });
+    });
+}
+/**
+ * Run a process to completion, honoring an abort signal and reporting stdout
+ * lines as they come.
+ */
+export function runStreaming(file, args, options) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(file, [...args], { stdio: ['ignore', 'pipe', 'pipe'], env: process.env, ...(options.signal === undefined ? {} : { signal: options.signal }) });
+        const timer = setTimeout(() => { child.kill('SIGTERM'); }, options.timeoutMs);
+        let buffered = '';
+        let stderr = '';
+        child.stdout.on('data', (chunk) => {
+            buffered += chunk.toString('utf8');
+            const lines = buffered.split(/\r?\n|\r/);
+            buffered = lines.pop() ?? '';
+            for (const line of lines)
+                options.onLine?.(line);
+        });
+        child.stderr.on('data', (chunk) => { stderr = (stderr + chunk.toString('utf8')).slice(-4000); });
+        child.on('error', (error) => { clearTimeout(timer); reject(error); });
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(stderr.trim().split('\n').filter(line => /ERROR|error:/i.test(line)).slice(-1)[0] ?? `${file.split('/').pop() ?? file} exited with ${String(code)}`));
+        });
+    });
+}
+/** The yt-dlp manager. */
+export class YtDlp {
+    configured;
+    binDir;
+    tmpRoot;
+    ensuring;
+    /**
+     * @param stateRoot - the reader's state root (the managed binary lives under `bin/`).
+     * @param configured - a deployment-configured binary path, which wins.
+     */
+    constructor(stateRoot, configured) {
+        this.configured = configured;
+        this.binDir = join(stateRoot, 'bin');
+        this.tmpRoot = join(stateRoot, 'tmp');
+    }
+    /** The binary to run: the configured one, else the managed one (fetched / updated as needed). */
+    binary() {
+        if (this.configured !== undefined && this.configured !== '')
+            return Promise.resolve(this.configured);
+        this.ensuring ??= this.ensureManaged().finally(() => { this.ensuring = undefined; });
+        return this.ensuring;
+    }
+    /** Fetch the standalone release on first use; self-update it when stale. */
+    async ensureManaged() {
+        const asset = releaseAsset();
+        if (asset === undefined)
+            throw new Error(`yt-dlp: no standalone release for ${process.platform}/${process.arch}`);
+        const target = join(this.binDir, asset);
+        if (!existsSync(target)) {
+            mkdirSync(this.binDir, { recursive: true });
+            const partial = `${target}.download`;
+            // curl honors the deployment's proxy environment the way Node's fetch
+            // does not, and is present on every platform that has a release asset.
+            await run('curl', ['-fsSL', '--retry', '2', '-o', partial, `https://github.com/yt-dlp/yt-dlp/releases/latest/download/${asset}`], 300_000);
+            chmodSync(partial, 0o755);
+            renameSync(partial, target);
+            return target;
+        }
+        if (Date.now() - statSync(target).mtimeMs > UPDATE_AFTER_MS) {
+            // Best effort: a failed update leaves the working binary in place.
+            await run(target, ['-U'], 120_000).catch(() => undefined);
+        }
+        return target;
+    }
+    /** The version of the binary in use. */
+    async version() {
+        return (await run(await this.binary(), ['--version'], 30_000)).trim();
+    }
+    /** The common flags: no download, no formats needed, Node as the JS runtime. */
+    base() {
+        return ['--skip-download', '--ignore-no-formats-error', '--no-playlist', '--no-warnings', '--js-runtimes', `node:${process.execPath}`];
+    }
+    /**
+     * A video's metadata.
+     *
+     * @param url - the video page URL.
+     */
+    async info(url) {
+        const out = await run(await this.binary(), [...this.base(), '--dump-single-json', url], 120_000);
+        const line = out.trim().split('\n').filter(item => item.startsWith('{')).pop();
+        if (line === undefined)
+            throw new Error('yt-dlp: no metadata');
+        return JSON.parse(line);
+    }
+    /**
+     * A channel's newest videos (a flat listing: no video is opened).
+     *
+     * YouTube's own channel feed (`feeds/videos.xml`) answers 404 (measured
+     * 2026-10-20), so the listing is yt-dlp's; `approximate_date` gives each
+     * entry a day-precision date.
+     *
+     * @param url - the channel URL.
+     * @param limit - how many of the newest videos.
+     */
+    async channel(url, limit = 15) {
+        const listing = /\/(videos|streams|shorts)\/?$/.test(url) ? url : `${url.replace(/\/+$/, '')}/videos`;
+        const out = await run(await this.binary(), [
+            '--flat-playlist', '--dump-single-json', '--playlist-end', String(limit), '--no-warnings',
+            '--extractor-args', 'youtubetab:approximate_date', '--js-runtimes', `node:${process.execPath}`, listing,
+        ], 180_000);
+        const line = out.trim().split('\n').filter(item => item.startsWith('{')).pop();
+        if (line === undefined)
+            throw new Error('yt-dlp: no channel listing');
+        const data = JSON.parse(line);
+        const title = data.channel ?? data.uploader ?? data.title?.replace(/ - Videos$/, '');
+        return {
+            ...(title === undefined ? {} : { title }),
+            entries: (data.entries ?? []).map(entry => {
+                const { thumbnails, ...rest } = entry;
+                const thumbnail = entry.thumbnail ?? thumbnails?.[thumbnails.length - 1]?.url;
+                return thumbnail === undefined ? rest : { ...rest, thumbnail };
+            }),
+        };
+    }
+    /**
+     * A video's audio track, downloaded for local transcription (the smallest
+     * audio-only format; the platform's combined stream when there is none).
+     *
+     * @param url - the video page URL.
+     * @param dir - an empty directory the file lands in.
+     * @param options - abort, and download progress 0–1.
+     * @returns the downloaded file.
+     */
+    async audio(url, dir, options = {}) {
+        await runStreaming(await this.binary(), [
+            '-f', 'wa[acodec!=none]/ba/b', '--no-playlist', '--no-warnings', '--newline', '--no-part',
+            '--js-runtimes', `node:${process.execPath}`, '-o', join(dir, 'audio.%(ext)s'), url,
+        ], {
+            timeoutMs: 30 * 60_000,
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+            onLine: (line) => {
+                const percent = /^\[download\]\s+([\d.]+)%/.exec(line)?.[1];
+                if (percent !== undefined)
+                    options.onProgress?.(Number(percent) / 100);
+            },
+        });
+        const file = readdirSync(dir).find(name => name.startsWith('audio.'));
+        if (file === undefined)
+            throw new Error('yt-dlp: no audio downloaded');
+        return join(dir, file);
+    }
+    /**
+     * One caption track's cues.
+     *
+     * @param url - the video page URL.
+     * @param track - the chosen track.
+     */
+    async captions(url, track) {
+        mkdirSync(this.tmpRoot, { recursive: true });
+        const dir = mkdtempSync(join(this.tmpRoot, 'subs-'));
+        try {
+            await run(await this.binary(), [
+                ...this.base(),
+                track.auto ? '--write-auto-subs' : '--write-subs',
+                '--sub-langs', track.lang,
+                '--sub-format', track.ext,
+                '-o', join(dir, 'captions.%(ext)s'),
+                url,
+            ], 180_000);
+            const file = readdirSync(dir).find(name => name.startsWith('captions.') && !name.endsWith('.part'));
+            if (file === undefined)
+                return [];
+            return parseCaptions(readFileSync(join(dir, file), 'utf8'), file.split('.').pop() ?? '');
+        }
+        finally {
+            rmSync(dir, { recursive: true, force: true });
+        }
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@khorsheed/dsh-reader",
   "description": "Link reader tab: RSS/Atom subscriptions plus pasted article links, a card feed with a readable detail view, host-side fetch and daily refresh over a Typert Remote data face",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -10,10 +10,6 @@
       "types": "./lib/types/index.d.ts",
       "default": "./lib/index.js"
     },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "default": "./lib/invariant.js"
-    },
     "./types": {
       "types": "./lib/types/types.d.ts",
       "default": "./lib/types.js"
@@ -22,6 +18,10 @@
       "types": "./lib/types/client/index.d.ts",
       "default": "./lib/client.js"
     },
+    "./tool": {
+      "types": "./lib/types/tool.d.ts",
+      "default": "./lib/types/tool.js"
+    },
     "./typert": {
       "types": "./lib/typert.host.d.ts",
       "default": "./lib/typert.host.js"
@@ -32,7 +32,8 @@
     },
     "./src/*": "./src/*",
     "./locale/*.json": "./locale/*.json",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./tool/locale/*.json": "./locale/*.json"
   },
   "files": [
     "lib",
@@ -45,23 +46,31 @@
     "CHANGELOG.md"
   ],
   "license": "MIT",
+  "engines": {
+    "dsh": ">=0.1.5-rc.1 <0.3.0-0"
+  },
   "dependencies": {
     "zod": "^4.4.3"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.0-rc.6 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.0-rc.6 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-sidebar-right": "^0.1.7-rc.1 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-session": "^0.1.0-rc.6 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.0-rc.6 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": "^0.1.7-rc.1 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-web-fetch-http": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
     "react": "^18.2.0"
   },
   "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-agent": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-api-remotes": {
       "optional": true
     },
@@ -80,10 +89,13 @@
     "@deepseek-ai/dsh-client-ui-slots": {
       "optional": true
     },
-    "@deepseek-ai/dsh-invariants": {
+    "@deepseek-ai/dsh-session": {
       "optional": true
     },
-    "@deepseek-ai/dsh-session": {
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-web-fetch-http": {
       "optional": true
     },
     "react": {
@@ -118,12 +130,13 @@
     },
     "compat": {
       "minHost": "0.1.5-rc.1",
-      "notes": "A page-type right-Sidebar tab (minted kind `reader`) over a Typert Remote data face. Fetching runs on the HOST through the sanctioned `ctx.web` seam; state is written with plain `node:fs` (atomic temp+rename) under `$DSH_HOME/state/dsh-reader`, NOT through `ctx.fs` — that service is the session-fenced sandboxed filesystem, so a workspace-write session refuses a write to the state root (observed on the acceptance instance). Every optional capability is probed at apply time and degrades (no `web` → domain refusals; no `sideChat` → the side-chat gesture hides; no `quote` → selection quoting is unavailable while the entry-level quote button still works). KNOWN LIMIT: the host fetch seam caps a decoded body at 100,000 chars and truncates silently, so articles larger than that cannot be extracted — the detail view falls back to a 「受限篇幅，内容未完整呈现」 notice with a 「阅读原文」 button (measured: Anthropic research pages, theverge.com, newyorker.com). On-device translation (0.2.0) runs the page's own Translator API (Chrome 138+/Edge 148+, desktop): the model never leaves the device and no model quota is spent, while the derived sentence pairs persist on the host (a global memory file plus per-entry segment maps under the state root, one shared budget, no TTL) so a reload re-paints instead of re-translating. Where that API is absent or the pair is unavailable, the globe is simply not rendered — the pane keeps working exactly as before. Source bodies that are already Chinese are not offered translation at all. On host 0.1.6-alpha.2+ the spots that want a real browser (the script-figure notice, a bot-wall card's action) open the in-app Sidebar Browser tab, probed through the `browser` tab kind; on older hosts they are the ordinary external link. Pages that inline real figures as base64 data URIs are now kept whole (substantive payloads over a 512-char threshold; 1px placeholders still yield to lazy-loading attributes), so a figure-heavy paper on a cap-raised deployment becomes a multi-MB cached body by design — bodies are bounded by entry count + TTL, not by a char budget.",
-      "verifiedHost": "0.1.5-rc.1"
+      "notes": "A page-type right-Sidebar tab (minted kind `reader`) over a Typert Remote data face. Fetching runs on the HOST, gated on the `ctx.web` seam: on the official web service feeds and pages go through the reader's own instance of the official HTTP fetch provider (`@deepseek-ai/dsh-web-fetch-http`, optional peer), because from 0.2.1-rc.2 the web-search settings switch can move `ctx.web` fetching to the DeepSeek Fetch API, which answers Markdown instead of the document (seam registry S22); without that package fetches go through `ctx.web.fetch`; state is written with plain `node:fs` (atomic temp+rename) under `$DSH_HOME/state/dsh-reader`, NOT through `ctx.fs` — that service is the session-fenced sandboxed filesystem, so a workspace-write session refuses a write to the state root (observed on the acceptance instance). Every optional capability is probed at apply time and degrades (no `web` → domain refusals; no `sideChat` → the side-chat gesture hides; no `quote` → selection quoting is unavailable while the entry-level quote button still works). KNOWN LIMIT: the fetch caps a decoded body at 2,000,000 chars by default (100,000 before 2026-10-27; the reader row's `fetchLimits` changes it; limits on the `web-fetch-http` row no longer reach the reader) and truncates silently, so articles larger than that cannot be extracted — the detail view falls back to a 「受限篇幅，内容未完整呈现」 notice with a 「阅读原文」 button (measured: Anthropic research pages, theverge.com, newyorker.com). On-device translation (0.2.0) runs the page's own Translator API (Chrome 138+/Edge 148+, desktop): the model never leaves the device and no model quota is spent, while the derived sentence pairs persist on the host (a global memory file plus per-entry segment maps under the state root, one shared budget, no TTL) so a reload re-paints instead of re-translating. Where that API is absent or the pair is unavailable, the globe is simply not rendered — the pane keeps working exactly as before — except that a browser without the API (iOS, Safari, Firefox) still offers the globe on a body whose stored per-entry map matches its hash, to VIEW that stored translation (no model, no retranslate). Source bodies that are already Chinese are not offered translation at all. On host 0.1.6-alpha.2+ the spots that want a real browser (the script-figure notice, a bot-wall card's action) open the in-app Sidebar Browser tab, probed through the `browser` tab kind; on older hosts they are the ordinary external link. Pages that inline real figures as base64 data URIs are now kept whole (substantive payloads over a 512-char threshold; 1px placeholders still yield to lazy-loading attributes), so a figure-heavy paper on a cap-raised deployment becomes a multi-MB cached body by design — bodies are bounded by entry count + TTL, not by a char budget. Notes (unreleased): the body highlight uses the CSS Custom Highlight API (no highlight without it, notes still work); the quote-menu 「记笔记」 row needs quote applied first, otherwise the detail foot button is the way in; 「回到会话」 needs ui-workspace's openSession; the ./tool row's reader_read / reader_note need the host tools registry and its reader skill the skills registry. The right-Sidebar tab self-hides on the ./tool row (2026-10-19, the canvas's dual check through the official pluginInventory Remote, probed): a root-mounted reader-tool row shows it everywhere, otherwise only sessions whose preset grants it (the learning and writing mode packs); every unreadable path fails open. Video and audio (unreleased): captions and channel listings run the plugin's own standalone yt-dlp on the host (fetched with curl on first use into the state root's bin/, self-updated after two weeks; ytdlpPath overrides); the YouTube embed is a frame of the plugin's own (allow-scripts allow-same-origin allow-presentation) driven over postMessage; Bilibili's player reports no time (seek = reload with t); Bilibili uploader spaces and most captions need a login. Local transcription of caption-less videos and audio probes the optional `transcribe` service (@khorsheed/dsh-transcribe) per start and states its absence; the audio is fetched through yt-dlp or curl into the state root's tmp/ and deleted once transcribed.",
+      "verifiedHost": "0.2.1-rc.3"
     },
     "references": [
       "@khorsheed/dsh-quote",
-      "@khorsheed/dsh-sidechat"
+      "@khorsheed/dsh-sidechat",
+      "@khorsheed/dsh-transcribe"
     ]
   }
 }

package/lib/invariant.js

@@ -1,38 +0,0 @@
-//#region lib/types/invariant.js
-/**
-* Package-owned invariant companion for `@khorsheed/dsh-reader`.
-* @module @khorsheed/dsh-reader/invariant
-*/
-/** The identity the package publishes under (the manifest's `name`). */
-const PACKAGE_NAME = "@khorsheed/dsh-reader";
-/** Cordis companion plugin name. */
-const name = "reader-invariant";
-/** Service required before the companion can reserve package ownership. */
-const inject = ["invariants"];
-/**
-* Capability probe for the reader: the host half fetches and persists, so it
-* needs a runtime that has `URL` (for the source-URL policy) and a timer (for
-* the daily refresh). Both are standard in a dsh host, so this is a
-* low-value check — registered for package-ownership consistency, and kept
-* pure (no network, no filesystem, no session) so a broken deployment is never
-* reported as a healthy one and vice versa.
-*
-* @param _ctx - host context (unused; the probe touches process globals only).
-* @param fail - invariant failure reporter.
-*/
-const install = async (_ctx, fail) => {
-	try {
-		if (typeof globalThis.URL !== "function") fail("reader requires a runtime with URL");
-		if (typeof globalThis.setTimeout !== "function") fail("reader requires a runtime with timers");
-	} catch {
-		fail("reader requires a standard node runtime");
-	}
-};
-/**
-* Register this package's invariant companion.
-* @param ctx - Cordis context carrying the invariant service.
-* @returns the installed registration's disposer after setup succeeds.
-*/
-const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-//#endregion
-export { apply, inject, install, name };

package/lib/types/invariant.d.ts

@@ -1,29 +0,0 @@
-/**
- * Package-owned invariant companion for `@khorsheed/dsh-reader`.
- * @module @khorsheed/dsh-reader/invariant
- */
-import type { Context } from '@deepseek-ai/cordis';
-import type { InvariantInstaller } from '@deepseek-ai/dsh-invariants';
-/** Cordis companion plugin name. */
-export declare const name = "reader-invariant";
-/** Service required before the companion can reserve package ownership. */
-export declare const inject: string[];
-/**
- * Capability probe for the reader: the host half fetches and persists, so it
- * needs a runtime that has `URL` (for the source-URL policy) and a timer (for
- * the daily refresh). Both are standard in a dsh host, so this is a
- * low-value check — registered for package-ownership consistency, and kept
- * pure (no network, no filesystem, no session) so a broken deployment is never
- * reported as a healthy one and vice versa.
- *
- * @param _ctx - host context (unused; the probe touches process globals only).
- * @param fail - invariant failure reporter.
- */
-export declare const install: InvariantInstaller;
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export declare const apply: (ctx: Context) => Promise<() => void>;
-//# sourceMappingURL=invariant.d.ts.map

package/lib/types/invariant.js

@@ -1,38 +0,0 @@
-/**
- * Package-owned invariant companion for `@khorsheed/dsh-reader`.
- * @module @khorsheed/dsh-reader/invariant
- */
-/** The identity the package publishes under (the manifest's `name`). */
-const PACKAGE_NAME = '@khorsheed/dsh-reader';
-/** Cordis companion plugin name. */
-export const name = 'reader-invariant';
-/** Service required before the companion can reserve package ownership. */
-export const inject = ['invariants'];
-/**
- * Capability probe for the reader: the host half fetches and persists, so it
- * needs a runtime that has `URL` (for the source-URL policy) and a timer (for
- * the daily refresh). Both are standard in a dsh host, so this is a
- * low-value check — registered for package-ownership consistency, and kept
- * pure (no network, no filesystem, no session) so a broken deployment is never
- * reported as a healthy one and vice versa.
- *
- * @param _ctx - host context (unused; the probe touches process globals only).
- * @param fail - invariant failure reporter.
- */
-export const install = async (_ctx, fail) => {
-    try {
-        if (typeof globalThis.URL !== 'function')
-            fail('reader requires a runtime with URL');
-        if (typeof globalThis.setTimeout !== 'function')
-            fail('reader requires a runtime with timers');
-    }
-    catch {
-        fail('reader requires a standard node runtime');
-    }
-};
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));