@deepseek-harness-tui/dsh-tui 0.11.0 → 0.11.2

package/lib/types/ui.d.ts

@@ -22,7 +22,7 @@ export { default as useStdin } from './ink/hooks/use-stdin.js';
 export { default as useApp } from './ink/hooks/use-app.js';
 export { useAnimationFrame } from './ink/hooks/use-animation-frame.js';
 export { useTerminalSize } from './ink/hooks/use-terminal-size.js';
-export { useTerminalImages, useTerminalImageCellSize } from './ink/hooks/use-terminal-images.js';
+export { useTerminalImages, useTerminalImageCellSize, useTerminalImageProtocol } from './ink/hooks/use-terminal-images.js';
 export { useBlink } from './hooks/useBlink.js';
 export { Ansi } from './ink/Ansi.js';
 export type { Key } from './ink/events/input-event.js';

package/lib/types/ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/ui.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AACzE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAA;AACrF,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,0CAA0C,CAAA;AAC1E,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,KAAK,KAAK,IAAI,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC5F,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AACvD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC7E,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AACrE,OAAO,EACL,OAAO,IAAI,SAAS,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AACnE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAA;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAA;AAChG,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,YAAY,EAAE,GAAG,EAAE,MAAM,6BAA6B,CAAA"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/ui.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AACzE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAA;AACrF,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,0CAA0C,CAAA;AAC1E,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,KAAK,KAAK,IAAI,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC5F,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AACvD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC7E,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AACrE,OAAO,EACL,OAAO,IAAI,SAAS,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AACnE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAA;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAA;AAC1H,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,YAAY,EAAE,GAAG,EAAE,MAAM,6BAA6B,CAAA"}

package/lib/types/ui.js

@@ -20,6 +20,6 @@ export { default as useStdin } from './ink/hooks/use-stdin.js';
 export { default as useApp } from './ink/hooks/use-app.js';
 export { useAnimationFrame } from './ink/hooks/use-animation-frame.js';
 export { useTerminalSize } from './ink/hooks/use-terminal-size.js';
-export { useTerminalImages, useTerminalImageCellSize } from './ink/hooks/use-terminal-images.js';
+export { useTerminalImages, useTerminalImageCellSize, useTerminalImageProtocol } from './ink/hooks/use-terminal-images.js';
 export { useBlink } from './hooks/useBlink.js';
 export { Ansi } from './ink/Ansi.js';

package/lib/types/usageStats.d.ts

@@ -0,0 +1,98 @@
+/**
+ * 本机使用统计（`~/.dsh-tui/usage.json`）：累计启动次数与累计在线时长，只服务
+ * 开屏那句"里程碑求 star"。三条硬约束：
+ *
+ * 1. **绝不影响开屏**：文件缺失/损坏/字段类型不对一律当 0，读不到就重写；
+ * 2. **一次进程只记一次**：`recordLaunch()` 有模块级闸门，LogoV2 反复挂载也只 +1；
+ * 3. **崩溃不丢太多**：启动时记 `startedAt`，每 5 分钟兜底落盘一次，退出时再补最后一段
+ *    （定时器 `unref()`，不拖着进程不退）。
+ *
+ * 里程碑是**一条有序阶梯**（次数与时长按"1 次 ≈ 1 小时"的体感交错），跨档时只报
+ * 最高那一档，且每档只报一次——所以 `celebrated` 记的是"已报到第几档"。
+ */
+/** 一档里程碑：次数或时长（小时）二者取一。 */
+export interface StarMilestone {
+    /** 累计启动次数门槛。 */
+    readonly launches?: number;
+    /** 累计在线小时门槛。 */
+    readonly hours?: number;
+    /**
+     * 这一档配不配"弹一次窗"。给**值得停下来看一眼**的档用（`24h` / `99h` /
+     * `999 次`）——其余档只在开屏出那行标语 + 一条非阻塞提示，绝不拦路。
+     * 弹窗一次只弹一档、只弹一次。（24h 是"第一次陪你一整天"，比 99h 早得多，
+     * 用户实机反馈 99h 等太久。）
+     */
+    readonly modal?: boolean;
+}
+/**
+ * 求 star 的里程碑阶梯（有序）。次数档：100 / 500 / **999** / 5000 / 10000；
+ * 时长档：**24 / 50 / 99 / 200 / 500** 小时。两套按体感交错成一条线；
+ * 其中 `24h`、`99h` 与 `999 次` 会**弹一次窗**（可关，只在开屏）。
+ */
+export declare const STAR_MILESTONES: readonly StarMilestone[];
+/**
+ * 这一档是不是"历史性时刻"（值得弹窗）。
+ * @param index - `STAR_MILESTONES` 的下标。
+ * @returns 该档是否配弹窗（未知下标一律 false）。
+ */
+export declare const isHistoricMilestone: (index: number) => boolean;
+/** 本机累计用量。 */
+export interface UsageStats {
+    /** 累计启动次数。 */
+    readonly launches: number;
+    /** 累计在线毫秒。 */
+    readonly totalMs: number;
+    /** 已报到第几档里程碑（`STAR_MILESTONES` 的下标 +1；0 = 从没报过）。 */
+    readonly celebrated: number;
+}
+/** 空账本（文件缺失/损坏时的回落）。 */
+export declare const EMPTY_USAGE: UsageStats;
+/**
+ * 读取本机用量；任何异常与非法形状都回落成 0（开屏不许因为统计文件挂掉）。
+ * @param dir - 数据目录（测试可注入）。
+ * @returns 归一化后的用量。
+ */
+export declare function readUsage(dir?: string): UsageStats;
+/**
+ * 写回本机用量（先写临时文件再改名，避免半截文件）。
+ * @param stats - 要落盘的用量。
+ * @param dir - 数据目录（测试可注入）。
+ * @returns 是否写成功（失败只是不记账，不影响任何功能）。
+ */
+export declare function writeUsage(stats: UsageStats, dir?: string): boolean;
+/**
+ * 该不该在这台机器上求一次 star，以及报到第几档。
+ * @param stats - 当前用量。
+ * @returns 未报过的、已达成的**最高**那一档的下标；没有则 `null`。
+ */
+export declare function pendingStarMilestone(stats: UsageStats): number | null;
+/**
+ * 开屏弹窗判定：启动时由 Chat 调一次——账本文件里未报过的最高一档若
+ * 配弹窗（`99h` / `999 次`），返回其下标；其余情况（没有待报档、或待报档
+ * 是只出标语行的普通档）一律 `null`。读**文件**而不是进程缓存：LogoV2
+ * 的 `recordLaunch` 与本函数分属不同挂载层，文件是两者一致的真相源。
+ * 弹窗真正展示时由调用方 `markStarAsked` 记账，本函数只读不写。
+ * @param dir - 数据目录（测试可注入）。
+ * @returns 配弹窗且已达成的档位下标；没有则 `null`。
+ */
+export declare function dueStarModal(dir?: string): number | null;
+/**
+ * 记一次启动：累计次数 +1、开始计时，并挂上兜底落盘与退出补记。
+ * 同一进程里对同一目录重复调用只生效一次（LogoV2 反复挂载也只 +1）。
+ * @param dir - 数据目录（测试可注入）。
+ * @returns 记完之后的用量（开屏拿它判里程碑）。
+ */
+export declare function recordLaunch(dir?: string): UsageStats;
+/**
+ * 当前缓存的用量（没记过启动就是空账本）。
+ * @param dir - 数据目录（测试可注入）。
+ * @returns 该目录下的用量。
+ */
+export declare function usageSnapshot(dir?: string): UsageStats;
+/**
+ * 把某一档标记为"已求过"（开屏决定显示之后调用一次）。
+ * @param index - `STAR_MILESTONES` 的下标。
+ * @param dir - 数据目录（测试可注入）。
+ */
+export declare function markStarAsked(index: number, dir?: string): void;
+//# sourceMappingURL=usageStats.d.ts.map

package/lib/types/usageStats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usageStats.d.ts","sourceRoot":"","sources":["../../src/usageStats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,2BAA2B;AAC3B,MAAM,WAAW,aAAa;IAC5B,gBAAgB;IAChB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,gBAAgB;IAChB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAWnD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,KAAG,OAAiD,CAAA;AAErG,cAAc;AACd,MAAM,WAAW,UAAU;IACzB,cAAc;IACd,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,cAAc;IACd,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,wBAAwB;AACxB,eAAO,MAAM,WAAW,EAAE,UAAuD,CAAA;AAKjF;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,GAAE,MAAiB,GAAG,UAAU,CAS5D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,GAAE,MAAiB,GAAG,OAAO,CAW7E;AAOD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAKrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAiB,GAAG,MAAM,GAAG,IAAI,CAGlE;AAwBD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAiB,GAAG,UAAU,CAe/D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAiB,GAAG,UAAU,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAiB,GAAG,IAAI,CAKzE"}

package/lib/types/usageStats.js

@@ -0,0 +1,169 @@
+/**
+ * 本机使用统计（`~/.dsh-tui/usage.json`）：累计启动次数与累计在线时长，只服务
+ * 开屏那句"里程碑求 star"。三条硬约束：
+ *
+ * 1. **绝不影响开屏**：文件缺失/损坏/字段类型不对一律当 0，读不到就重写；
+ * 2. **一次进程只记一次**：`recordLaunch()` 有模块级闸门，LogoV2 反复挂载也只 +1；
+ * 3. **崩溃不丢太多**：启动时记 `startedAt`，每 5 分钟兜底落盘一次，退出时再补最后一段
+ *    （定时器 `unref()`，不拖着进程不退）。
+ *
+ * 里程碑是**一条有序阶梯**（次数与时长按"1 次 ≈ 1 小时"的体感交错），跨档时只报
+ * 最高那一档，且每档只报一次——所以 `celebrated` 记的是"已报到第几档"。
+ */
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { DATA_DIR } from './utils/paths.js';
+/** 兜底落盘间隔（毫秒）：被杀进程最多丢这么久。 */
+const FLUSH_MS = 5 * 60 * 1000;
+/**
+ * 求 star 的里程碑阶梯（有序）。次数档：100 / 500 / **999** / 5000 / 10000；
+ * 时长档：**24 / 50 / 99 / 200 / 500** 小时。两套按体感交错成一条线；
+ * 其中 `24h`、`99h` 与 `999 次` 会**弹一次窗**（可关，只在开屏）。
+ */
+export const STAR_MILESTONES = [
+    { hours: 24, modal: true },
+    { hours: 50 },
+    { hours: 99, modal: true },
+    { launches: 100 },
+    { hours: 200 },
+    { hours: 500 },
+    { launches: 500 },
+    { launches: 999, modal: true },
+    { launches: 5000 },
+    { launches: 10000 },
+];
+/**
+ * 这一档是不是"历史性时刻"（值得弹窗）。
+ * @param index - `STAR_MILESTONES` 的下标。
+ * @returns 该档是否配弹窗（未知下标一律 false）。
+ */
+export const isHistoricMilestone = (index) => STAR_MILESTONES[index]?.modal === true;
+/** 空账本（文件缺失/损坏时的回落）。 */
+export const EMPTY_USAGE = { launches: 0, totalMs: 0, celebrated: 0 };
+const positive = (value) => typeof value === 'number' && Number.isFinite(value) && value > 0 ? Math.floor(value) : 0;
+/**
+ * 读取本机用量；任何异常与非法形状都回落成 0（开屏不许因为统计文件挂掉）。
+ * @param dir - 数据目录（测试可注入）。
+ * @returns 归一化后的用量。
+ */
+export function readUsage(dir = DATA_DIR) {
+    try {
+        const parsed = JSON.parse(readFileSync(join(dir, 'usage.json'), 'utf8'));
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
+            return EMPTY_USAGE;
+        const raw = parsed;
+        return { launches: positive(raw.launches), totalMs: positive(raw.totalMs), celebrated: positive(raw.celebrated) };
+    }
+    catch {
+        return EMPTY_USAGE;
+    }
+}
+/**
+ * 写回本机用量（先写临时文件再改名，避免半截文件）。
+ * @param stats - 要落盘的用量。
+ * @param dir - 数据目录（测试可注入）。
+ * @returns 是否写成功（失败只是不记账，不影响任何功能）。
+ */
+export function writeUsage(stats, dir = DATA_DIR) {
+    try {
+        mkdirSync(dir, { recursive: true });
+        const target = join(dir, 'usage.json');
+        const temp = `${target}.tmp`;
+        writeFileSync(temp, JSON.stringify(stats, null, 2));
+        renameSync(temp, target);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 一档里程碑是否已经达到。 */
+const reached = (milestone, stats) => (milestone.launches !== undefined && stats.launches >= milestone.launches) ||
+    (milestone.hours !== undefined && stats.totalMs >= milestone.hours * 3_600_000);
+/**
+ * 该不该在这台机器上求一次 star，以及报到第几档。
+ * @param stats - 当前用量。
+ * @returns 未报过的、已达成的**最高**那一档的下标；没有则 `null`。
+ */
+export function pendingStarMilestone(stats) {
+    for (let index = STAR_MILESTONES.length - 1; index >= Math.max(0, stats.celebrated); index--) {
+        if (reached(STAR_MILESTONES[index], stats))
+            return index;
+    }
+    return null;
+}
+/**
+ * 开屏弹窗判定：启动时由 Chat 调一次——账本文件里未报过的最高一档若
+ * 配弹窗（`99h` / `999 次`），返回其下标；其余情况（没有待报档、或待报档
+ * 是只出标语行的普通档）一律 `null`。读**文件**而不是进程缓存：LogoV2
+ * 的 `recordLaunch` 与本函数分属不同挂载层，文件是两者一致的真相源。
+ * 弹窗真正展示时由调用方 `markStarAsked` 记账，本函数只读不写。
+ * @param dir - 数据目录（测试可注入）。
+ * @returns 配弹窗且已达成的档位下标；没有则 `null`。
+ */
+export function dueStarModal(dir = DATA_DIR) {
+    const pending = pendingStarMilestone(readUsage(dir));
+    return pending !== null && isHistoricMilestone(pending) ? pending : null;
+}
+/** 进程内闸门：一次进程、一个数据目录只记一次启动。 */ const recorded = new Set();
+/** 进程内缓存的账本（按目录分开存，生产只有一个目录；测试可注入不同目录）。 */
+const caches = new Map();
+/** 本次进程开始计时的时刻（按目录）。 */
+const startedAt = new Map();
+/** 把"本段时长"并进账本并落盘（幂等：`startedAt` 会被推进）。 */
+const flush = (dir, extraIndex) => {
+    const cached = caches.get(dir);
+    if (cached === undefined)
+        return;
+    const now = Date.now();
+    const since = startedAt.get(dir) ?? now;
+    startedAt.set(dir, now);
+    const next = {
+        ...cached,
+        totalMs: cached.totalMs + Math.max(0, now - since),
+        celebrated: extraIndex === undefined ? cached.celebrated : extraIndex + 1,
+    };
+    caches.set(dir, next);
+    writeUsage(next, dir);
+};
+/**
+ * 记一次启动：累计次数 +1、开始计时，并挂上兜底落盘与退出补记。
+ * 同一进程里对同一目录重复调用只生效一次（LogoV2 反复挂载也只 +1）。
+ * @param dir - 数据目录（测试可注入）。
+ * @returns 记完之后的用量（开屏拿它判里程碑）。
+ */
+export function recordLaunch(dir = DATA_DIR) {
+    const cached = caches.get(dir);
+    if (recorded.has(dir) && cached !== undefined)
+        return cached;
+    recorded.add(dir);
+    startedAt.set(dir, Date.now());
+    const previous = readUsage(dir);
+    const next = { ...previous, launches: previous.launches + 1 };
+    caches.set(dir, next);
+    writeUsage(next, dir);
+    const timer = setInterval(() => flush(dir), FLUSH_MS);
+    // 定时器不拖着进程：TUI 退出时不该因为统计而多活 5 分钟。
+    timer.unref?.();
+    process.once('exit', () => flush(dir));
+    return next;
+}
+/**
+ * 当前缓存的用量（没记过启动就是空账本）。
+ * @param dir - 数据目录（测试可注入）。
+ * @returns 该目录下的用量。
+ */
+export function usageSnapshot(dir = DATA_DIR) {
+    return caches.get(dir) ?? EMPTY_USAGE;
+}
+/**
+ * 把某一档标记为"已求过"（开屏决定显示之后调用一次）。
+ * @param index - `STAR_MILESTONES` 的下标。
+ * @param dir - 数据目录（测试可注入）。
+ */
+export function markStarAsked(index, dir = DATA_DIR) {
+    const cached = caches.get(dir) ?? readUsage(dir);
+    const next = { ...cached, celebrated: Math.max(cached.celebrated, index + 1) };
+    caches.set(dir, next);
+    writeUsage(next, dir);
+}

package/lib/types/utils/bmp.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Dependency-free BMP → PNG conversion for clipboard screenshots. WSLg (and
+ * some X11 owners) expose a Windows bitmap copy as `image/bmp`, a format the
+ * attachment profile does not accept and that `sharp`'s prebuilt libvips
+ * cannot decode. Only the shapes a screenshot tool produces are handled:
+ * uncompressed 24/32-bit pixels (BI_RGB, BI_BITFIELDS, BI_ALPHABITFIELDS),
+ * bottom-up or top-down. Anything else returns null and the caller keeps its
+ * "format unsupported" path.
+ */
+/**
+ * Convert BMP bytes (a `BM` file, or a headerless DIB) to PNG.
+ * @param bmp - Raw clipboard bytes.
+ * @returns PNG bytes, or null when the bitmap is malformed or uses an
+ *   unsupported layout (palettes, RLE, 16-bit, OS/2 core header).
+ */
+export declare function bmpToPng(bmp: Buffer): Promise<Buffer | null>;
+//# sourceMappingURL=bmp.d.ts.map

package/lib/types/utils/bmp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bmp.d.ts","sourceRoot":"","sources":["../../../src/utils/bmp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA8DH;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuFlE"}

package/lib/types/utils/bmp.js

@@ -0,0 +1,154 @@
+/**
+ * Dependency-free BMP → PNG conversion for clipboard screenshots. WSLg (and
+ * some X11 owners) expose a Windows bitmap copy as `image/bmp`, a format the
+ * attachment profile does not accept and that `sharp`'s prebuilt libvips
+ * cannot decode. Only the shapes a screenshot tool produces are handled:
+ * uncompressed 24/32-bit pixels (BI_RGB, BI_BITFIELDS, BI_ALPHABITFIELDS),
+ * bottom-up or top-down. Anything else returns null and the caller keeps its
+ * "format unsupported" path.
+ */
+import { crc32, deflate, constants } from 'node:zlib';
+import { promisify } from 'node:util';
+const deflateAsync = promisify(deflate);
+/** Refuse absurd dimensions before allocating the pixel buffer. */
+const MAX_PIXELS = 100_000_000;
+const BI_RGB = 0;
+const BI_BITFIELDS = 3;
+const BI_ALPHABITFIELDS = 6;
+function channel(mask) {
+    if (mask === 0)
+        return { mask: 0, shift: 0, max: 0 };
+    let shift = 0;
+    while (((mask >>> shift) & 1) === 0)
+        shift += 1;
+    return { mask, shift, max: mask >>> shift };
+}
+function scale(px, c) {
+    if (c.max === 0)
+        return 0;
+    const v = (px & c.mask) >>> c.shift;
+    return c.max === 255 ? v : Math.round((v * 255) / c.max);
+}
+function pngChunk(type, data) {
+    const out = Buffer.alloc(12 + data.length);
+    out.writeUInt32BE(data.length, 0);
+    out.write(type, 4, 'ascii');
+    data.copy(out, 8);
+    out.writeUInt32BE(crc32(out.subarray(4, 8 + data.length)), 8 + data.length);
+    return out;
+}
+async function encodePng(width, height, channels, pixels) {
+    const ihdr = Buffer.alloc(13);
+    ihdr.writeUInt32BE(width, 0);
+    ihdr.writeUInt32BE(height, 4);
+    ihdr[8] = 8;
+    ihdr[9] = channels === 4 ? 6 : 2;
+    const idat = await deflateAsync(pixels, { level: constants.Z_BEST_SPEED });
+    return Buffer.concat([
+        Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]),
+        pngChunk('IHDR', ihdr),
+        pngChunk('IDAT', idat),
+        pngChunk('IEND', Buffer.alloc(0)),
+    ]);
+}
+/**
+ * Convert BMP bytes (a `BM` file, or a headerless DIB) to PNG.
+ * @param bmp - Raw clipboard bytes.
+ * @returns PNG bytes, or null when the bitmap is malformed or uses an
+ *   unsupported layout (palettes, RLE, 16-bit, OS/2 core header).
+ */
+export async function bmpToPng(bmp) {
+    const hasFileHeader = bmp.length >= 14 && bmp[0] === 0x42 && bmp[1] === 0x4d;
+    const dib = hasFileHeader ? 14 : 0;
+    if (bmp.length < dib + 40)
+        return null;
+    const headerSize = bmp.readUInt32LE(dib);
+    if (headerSize < 40 || bmp.length < dib + headerSize)
+        return null;
+    const width = bmp.readInt32LE(dib + 4);
+    const rawHeight = bmp.readInt32LE(dib + 8);
+    const bpp = bmp.readUInt16LE(dib + 14);
+    const compression = bmp.readUInt32LE(dib + 16);
+    const height = Math.abs(rawHeight);
+    if (width <= 0 || height === 0 || width * height > MAX_PIXELS)
+        return null;
+    if (bpp !== 24 && bpp !== 32)
+        return null;
+    if (compression !== BI_RGB && compression !== BI_BITFIELDS && compression !== BI_ALPHABITFIELDS)
+        return null;
+    if (bpp === 24 && compression !== BI_RGB)
+        return null;
+    // Channel masks: defaults for BI_RGB, else the three (or four) DWORDs that
+    // follow a 40-byte header or sit inside V4/V5 headers at the same offset.
+    let redMask = 0x00ff0000;
+    let greenMask = 0x0000ff00;
+    let blueMask = 0x000000ff;
+    let alphaMask = 0;
+    let maskBytes = 0;
+    if (bpp === 32 && compression !== BI_RGB) {
+        const masksEnd = dib + 40 + (compression === BI_ALPHABITFIELDS ? 16 : 12);
+        if (bmp.length < masksEnd)
+            return null;
+        redMask = bmp.readUInt32LE(dib + 40);
+        greenMask = bmp.readUInt32LE(dib + 44);
+        blueMask = bmp.readUInt32LE(dib + 48);
+        if (headerSize >= 56 || compression === BI_ALPHABITFIELDS)
+            alphaMask = bmp.readUInt32LE(dib + 52);
+        if (headerSize === 40)
+            maskBytes = compression === BI_ALPHABITFIELDS ? 16 : 12;
+    }
+    if (bpp === 32 && (redMask === 0 || greenMask === 0 || blueMask === 0))
+        return null;
+    const declaredOffset = hasFileHeader ? bmp.readUInt32LE(10) : 0;
+    const pixelOffset = declaredOffset > 0 ? declaredOffset : dib + headerSize + maskBytes;
+    const stride = Math.floor((bpp * width + 31) / 32) * 4;
+    if (pixelOffset + stride * height > bmp.length)
+        return null;
+    const red = channel(redMask);
+    const green = channel(greenMask);
+    const blue = channel(blueMask);
+    const alpha = channel(alphaMask);
+    const bottomUp = rawHeight > 0;
+    // Alpha only counts when the mask exists AND at least one pixel uses it:
+    // clipboard DIBs routinely carry a dead alpha byte of 0 that would turn the
+    // whole screenshot transparent.
+    let useAlpha = false;
+    if (bpp === 32 && alpha.max !== 0) {
+        scan: for (let y = 0; y < height; y += 1) {
+            const row = pixelOffset + y * stride;
+            for (let x = 0; x < width; x += 1) {
+                if (scale(bmp.readUInt32LE(row + x * 4), alpha) !== 0) {
+                    useAlpha = true;
+                    break scan;
+                }
+            }
+        }
+    }
+    const channels = useAlpha ? 4 : 3;
+    const rowBytes = width * channels;
+    const out = Buffer.alloc((rowBytes + 1) * height);
+    for (let y = 0; y < height; y += 1) {
+        const src = pixelOffset + (bottomUp ? height - 1 - y : y) * stride;
+        let dst = y * (rowBytes + 1);
+        out[dst++] = 0;
+        if (bpp === 24) {
+            for (let x = 0; x < width; x += 1) {
+                const p = src + x * 3;
+                out[dst++] = bmp[p + 2];
+                out[dst++] = bmp[p + 1];
+                out[dst++] = bmp[p];
+            }
+        }
+        else {
+            for (let x = 0; x < width; x += 1) {
+                const px = bmp.readUInt32LE(src + x * 4);
+                out[dst++] = scale(px, red);
+                out[dst++] = scale(px, green);
+                out[dst++] = scale(px, blue);
+                if (useAlpha)
+                    out[dst++] = scale(px, alpha);
+            }
+        }
+    }
+    return encodePng(width, height, channels, out);
+}

package/lib/types/utils/clipboard.d.ts

@@ -13,7 +13,11 @@
  *   connects — an installed tool whose session is unreachable (stale
  *   WAYLAND_DISPLAY/DISPLAY) falls through to the next candidate.
  *   `text/uri-list` offers become file paths, `image/*` offers are
- *   exported to a temp file whose path is inserted.
+ *   exported to a temp file whose path is inserted. A Windows bitmap copy
+ *   offered as `image/bmp` (WSLg) is converted to PNG first.
+ * - **WSL**: when the Linux tools find nothing usable, `powershell.exe`
+ *   reads the Windows clipboard (Explorer files → `wslpath`, bitmaps → PNG
+ *   over stdout, else text).
  *
  * Priority is always files → image → text (a screenshot copy offers only an
  * image; a file-manager copy offers a file list; everything else falls
@@ -53,10 +57,12 @@ export type ClipboardContent = {
  * `null` when the clipboard holds nothing usable (empty or read failure),
  * or `{ kind: 'unavailable' }` when no clipboard backend can be reached at
  * all (Linux/Unix without wl-paste/xclip/xsel, or none of the installed
- * ones connecting to a live session).
+ * ones connecting to a live session). `wsl` marks the WSL flavour, where
+ * the Windows-side PowerShell fallback was also unreachable.
  */
 export type ClipboardRead = ClipboardContent | {
     kind: 'unavailable';
+    wsl?: boolean;
 } | null;
 /**
  * Parse `text/uri-list` clipboard content into local file paths. Lines are
@@ -110,6 +116,12 @@ export declare function readClipboard(): Promise<ClipboardRead>;
  * @internal test-only
  */
 export declare function _resetLinuxPasteCache(): void;
+/**
+ * Force the WSL detection result (undefined restores real detection). Kept
+ * apart from {@link _resetLinuxPasteCache} so a cache reset never drops it.
+ * @internal test-only
+ */
+export declare function _setWslOverride(value: boolean | undefined): void;
 /**
  * Render pasted clipboard content for insertion into the prompt. Image files
  * become `@` references so the send pipeline can attach their bytes; ordinary

package/lib/types/utils/clipboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../../src/utils/clipboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAaH;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAElC;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GAAG,IAAI,CAAA;AAE7E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA6BtD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAIvE;AAWD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAYtE;AAiDD;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAS9C;AA2WD;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC,CAStD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAcvE"}
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../../src/utils/clipboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAeH;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAElC;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAA;AAE5F;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA6BtD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAIvE;AAWD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAYtE;AAiDD;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAS9C;AAoeD;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC,CAStD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAEhE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAcvE"}