cc-vision-hook 0.1.0

package/dist/pasteScanner.js

@@ -0,0 +1,68 @@
+/**
+ * 用户粘贴图片场景的扫描器：复用 Claude Code 官方在用户粘贴图片时会提前落盘的旁路事实。
+ *
+ * 依赖的实现细节（非官方承诺的稳定 API，best-effort，不做版本防御）：
+ * `~/.claude/image-cache/<session_id>/<pasteId>.<ext>`
+ * 该路径已通过泄露源码 `src/utils/imageStore.ts` 的 `getImageStoreDir()` 源码级确认，
+ * `session_id` 与 hook input 里的顶层 `session_id` 字段是同一个值。
+ */
+import { readFile, readdir, stat } from "node:fs/promises";
+import { join, extname } from "node:path";
+import { getClaudeHomeDir } from "./config.js";
+const EXT_TO_MIME = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".webp": "image/webp",
+    ".gif": "image/gif",
+};
+/**
+ * 拼出指定 session 的 image-cache 目录路径。
+ *
+ * @param sessionId - Claude Code hook input 里的 `session_id` 字段
+ * @returns 该 session 对应的图片缓存目录绝对路径
+ */
+export const getImageCacheDir = (sessionId) => join(getClaudeHomeDir(), "image-cache", sessionId);
+/**
+ * 扫描指定 session 的 image-cache 目录，列出所有图片文件（按修改时间升序）。
+ * 目录不存在时（如该 session 从未粘贴过图片）静默返回空数组，不抛错——
+ * 这是预期中的常见情况，不是异常。
+ *
+ * @param sessionId - Claude Code hook input 里的 `session_id` 字段
+ * @returns 该 session 目录下所有可识别的图片文件列表
+ */
+export const scanPastedImages = async (sessionId) => {
+    const dir = getImageCacheDir(sessionId);
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        return [];
+    }
+    const results = [];
+    for (const name of entries) {
+        const ext = extname(name).toLowerCase();
+        const mimeType = EXT_TO_MIME[ext];
+        if (!mimeType)
+            continue;
+        const fullPath = join(dir, name);
+        try {
+            const s = await stat(fullPath);
+            results.push({ path: fullPath, mimeType, mtimeMs: s.mtimeMs });
+        }
+        catch {
+            // 文件可能在扫描过程中被清理，忽略
+        }
+    }
+    results.sort((a, b) => a.mtimeMs - b.mtimeMs);
+    return results;
+};
+/**
+ * 读取指定图片文件的字节内容。
+ *
+ * @param path - 图片文件绝对路径
+ * @returns 图片二进制数据
+ */
+export const readPastedImageBytes = async (path) => readFile(path);
+//# sourceMappingURL=pasteScanner.js.map

package/dist/pasteScanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pasteScanner.js","sourceRoot":"","sources":["../src/pasteScanner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,GAA2B;IAC1C,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;CACpB,CAAC;AASF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,SAAiB,EAAU,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;AAElH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,SAAiB,EAA8B,EAAE;IACtF,MAAM,GAAG,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACjE,CAAC;QAAC,MAAM,CAAC;YACP,mBAAmB;QACrB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,IAAY,EAAmB,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC"}

package/dist/sdk/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * cvh SDK 导出：供其他 Node/Bun 项目直接内置调用（不需要 shell 调 CLI）。
+ * 例如某个上层 CLI/Agent 工具若要集成 cvh 的能力判断/内置调用，可以直接 import 这里的函数。
+ */
+export type { CvhConfig, CvhProvider } from "../config.js";
+export { DEFAULT_CONFIG, loadConfig, saveConfig, resolveConfig } from "../config.js";
+export { installHooks, uninstallHooks, checkHooksInstalled } from "../claudeSettings.js";
+export { extractImages, type ExtractedImage } from "../extract.js";
+export { describeImage } from "../vision.js";
+export { computeImageId, findCacheByBytes, putCacheEntry, getCacheEntry, getCachedImageBytes, type CacheEntry } from "../cache.js";
+export { handleUserPromptSubmit, type UserPromptSubmitInput, type HookOutput } from "../hooks/userPromptSubmit.js";
+export { handlePostToolUse, type PostToolUseInput } from "../hooks/postToolUse.js";

package/dist/sdk/index.js

@@ -0,0 +1,12 @@
+/**
+ * cvh SDK 导出：供其他 Node/Bun 项目直接内置调用（不需要 shell 调 CLI）。
+ * 例如某个上层 CLI/Agent 工具若要集成 cvh 的能力判断/内置调用，可以直接 import 这里的函数。
+ */
+export { DEFAULT_CONFIG, loadConfig, saveConfig, resolveConfig } from "../config.js";
+export { installHooks, uninstallHooks, checkHooksInstalled } from "../claudeSettings.js";
+export { extractImages } from "../extract.js";
+export { describeImage } from "../vision.js";
+export { computeImageId, findCacheByBytes, putCacheEntry, getCacheEntry, getCachedImageBytes } from "../cache.js";
+export { handleUserPromptSubmit } from "../hooks/userPromptSubmit.js";
+export { handlePostToolUse } from "../hooks/postToolUse.js";
+//# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEzF,OAAO,EAAE,aAAa,EAAuB,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAmB,MAAM,aAAa,CAAC;AAEnI,OAAO,EAAE,sBAAsB,EAA+C,MAAM,8BAA8B,CAAC;AACnH,OAAO,EAAE,iBAAiB,EAAyB,MAAM,yBAAyB,CAAC"}

package/dist/seenTracker.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Session 级"已展示过的图片"标记，避免 `UserPromptSubmit` 在同一 session 内每次提交
+ * 都把之前已经处理过的粘贴图片重新塞进 `additionalContext`（图片本身走全局内容 hash 缓存，
+ * 不需要重新调视觉模型，但如果不做这层过滤，上下文会随对话轮数不断膨胀重复信息）。
+ *
+ * 存储位置：`~/.claude/cc-vision-hook/seen/<session_id>.json`，内容是已展示过的 image_id 数组。
+ * 不设 TTL——生命周期跟随 session，session 目录本身很小（几十个 id 字符串），无需主动清理，
+ * 后续如需要可以在 doctor/cleanup 命令里一并按 mtime 清掉太旧的标记文件。
+ */
+/**
+ * 读取指定 session 已经展示过的 image_id 集合。
+ *
+ * @param sessionId - Claude Code session id
+ * @returns 已展示过的 image_id 集合，文件不存在时返回空集合
+ */
+export declare const loadSeenImageIds: (sessionId: string) => Promise<Set<string>>;
+/**
+ * 把一批新的 image_id 追加写入 session 的"已展示"标记文件。
+ *
+ * @param sessionId - Claude Code session id
+ * @param newIds - 本次新展示的 image_id 列表
+ */
+export declare const markImagesSeen: (sessionId: string, newIds: string[]) => Promise<void>;

package/dist/seenTracker.js

@@ -0,0 +1,46 @@
+/**
+ * Session 级"已展示过的图片"标记，避免 `UserPromptSubmit` 在同一 session 内每次提交
+ * 都把之前已经处理过的粘贴图片重新塞进 `additionalContext`（图片本身走全局内容 hash 缓存，
+ * 不需要重新调视觉模型，但如果不做这层过滤，上下文会随对话轮数不断膨胀重复信息）。
+ *
+ * 存储位置：`~/.claude/cc-vision-hook/seen/<session_id>.json`，内容是已展示过的 image_id 数组。
+ * 不设 TTL——生命周期跟随 session，session 目录本身很小（几十个 id 字符串），无需主动清理，
+ * 后续如需要可以在 doctor/cleanup 命令里一并按 mtime 清掉太旧的标记文件。
+ */
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { getCvhHomeDir } from "./config.js";
+const getSeenPath = (sessionId) => join(getCvhHomeDir(), "seen", `${sessionId}.json`);
+/**
+ * 读取指定 session 已经展示过的 image_id 集合。
+ *
+ * @param sessionId - Claude Code session id
+ * @returns 已展示过的 image_id 集合，文件不存在时返回空集合
+ */
+export const loadSeenImageIds = async (sessionId) => {
+    try {
+        const raw = await readFile(getSeenPath(sessionId), "utf8");
+        const ids = JSON.parse(raw);
+        return new Set(ids);
+    }
+    catch {
+        return new Set();
+    }
+};
+/**
+ * 把一批新的 image_id 追加写入 session 的"已展示"标记文件。
+ *
+ * @param sessionId - Claude Code session id
+ * @param newIds - 本次新展示的 image_id 列表
+ */
+export const markImagesSeen = async (sessionId, newIds) => {
+    if (newIds.length === 0)
+        return;
+    const existing = await loadSeenImageIds(sessionId);
+    for (const id of newIds)
+        existing.add(id);
+    const path = getSeenPath(sessionId);
+    await mkdir(join(getCvhHomeDir(), "seen"), { recursive: true });
+    await writeFile(path, JSON.stringify([...existing]));
+};
+//# sourceMappingURL=seenTracker.js.map

package/dist/seenTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seenTracker.js","sourceRoot":"","sources":["../src/seenTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,GAAG,CAAC,SAAiB,EAAU,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,GAAG,SAAS,OAAO,CAAC,CAAC;AAEtG;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,SAAiB,EAAwB,EAAE;IAChF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAa,CAAC;QACxC,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,SAAiB,EAAE,MAAgB,EAAiB,EAAE;IACzF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAChC,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACnD,KAAK,MAAM,EAAE,IAAI,MAAM;QAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC,CAAC"}

package/dist/vision.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 视觉解析层：统一通过 Vercel AI SDK 对接四个上游 provider，屏蔽各家协议格式差异。
+ *
+ * Provider 映射：
+ *   - "oai"        -> @ai-sdk/openai 的 Chat Completions 模型（显式 openai.chat(modelId)）
+ *   - "responses"  -> @ai-sdk/openai 的 Responses API 模型（openai.responses(modelId)）
+ *   - "anthropic"  -> @ai-sdk/anthropic
+ *   - "gemini"     -> @ai-sdk/google
+ * 保留 cvh 自定义的 provider 命名（不直接暴露 AI SDK 包名），降低用户配置心智负担。
+ *
+ * ⚠️ 实测踩坑记录：当前 `ai`/`@ai-sdk/openai`
+ * 版本下，`openai(modelId)` 这种默认调用方式解析出的 provider 字符串是 `"openai.responses"`
+ * （即默认就是 Responses API，不是 Chat Completions）。如果 "oai" 分支直接写
+ * `openai(config.model)`，会导致 "oai" 和 "responses" 两个配置项实际调用的是同一个 API，
+ * "oai" 选项形同虚设。必须显式调用 `openai.chat(modelId)` 才能真正拿到 Chat Completions 模型。
+ */
+import type { CvhConfig } from "./config.js";
+/**
+ * 按配置解析出对应的 AI SDK 语言模型实例。
+ *
+ * 导出（而非模块内部私有）是为了支持单测：AI SDK 的模型实例暴露 `.modelId`/`.provider`
+ * 等只读字段，可以在不发起真实网络请求的前提下验证 provider 映射是否正确
+ * （见 tests/vision.test.ts），避免每次跑测试都要真实调用视觉模型 API。
+ *
+ * @param config - 当前生效的 cvh 配置（含 provider/model/baseUrl/apiKey）
+ * @returns AI SDK 的 LanguageModel 实例，供 generateText 使用
+ * @throws 当 provider 是未知值时抛出错误
+ */
+export declare const resolveModel: (config: CvhConfig) => import("@ai-sdk/provider").LanguageModelV3;
+/**
+ * 调用视觉模型解析一张图片，返回文字描述（或针对具体问题的回答）。
+ *
+ * @param base64 - 图片的 base64 编码数据（不含 data URI 前缀）
+ * @param mimeType - 图片 MIME 类型，如 "image/png"
+ * @param config - 当前生效的 cvh 配置
+ * @param question - 可选的具体提问（用于 vision_ask 追问场景），省略时使用通用描述提示词
+ * @returns 视觉模型的文字回答
+ * @throws 当上游调用失败或超时时抛出错误，调用方需要自行捕获并降级处理
+ */
+export declare const describeImage: (base64: string, mimeType: string, config: CvhConfig, question?: string) => Promise<string>;

package/dist/vision.js

@@ -0,0 +1,87 @@
+/**
+ * 视觉解析层：统一通过 Vercel AI SDK 对接四个上游 provider，屏蔽各家协议格式差异。
+ *
+ * Provider 映射：
+ *   - "oai"        -> @ai-sdk/openai 的 Chat Completions 模型（显式 openai.chat(modelId)）
+ *   - "responses"  -> @ai-sdk/openai 的 Responses API 模型（openai.responses(modelId)）
+ *   - "anthropic"  -> @ai-sdk/anthropic
+ *   - "gemini"     -> @ai-sdk/google
+ * 保留 cvh 自定义的 provider 命名（不直接暴露 AI SDK 包名），降低用户配置心智负担。
+ *
+ * ⚠️ 实测踩坑记录：当前 `ai`/`@ai-sdk/openai`
+ * 版本下，`openai(modelId)` 这种默认调用方式解析出的 provider 字符串是 `"openai.responses"`
+ * （即默认就是 Responses API，不是 Chat Completions）。如果 "oai" 分支直接写
+ * `openai(config.model)`，会导致 "oai" 和 "responses" 两个配置项实际调用的是同一个 API，
+ * "oai" 选项形同虚设。必须显式调用 `openai.chat(modelId)` 才能真正拿到 Chat Completions 模型。
+ */
+import { generateText } from "ai";
+import { createOpenAI } from "@ai-sdk/openai";
+import { createAnthropic } from "@ai-sdk/anthropic";
+import { createGoogleGenerativeAI } from "@ai-sdk/google";
+/** 默认的通用图片描述提示词（未指定追问问题时使用）。 */
+const DEFAULT_DESCRIBE_PROMPT = "请简要描述这张图片的内容，包含关键的颜色、文字、布局等信息，控制在 200 字以内。";
+/**
+ * 按配置解析出对应的 AI SDK 语言模型实例。
+ *
+ * 导出（而非模块内部私有）是为了支持单测：AI SDK 的模型实例暴露 `.modelId`/`.provider`
+ * 等只读字段，可以在不发起真实网络请求的前提下验证 provider 映射是否正确
+ * （见 tests/vision.test.ts），避免每次跑测试都要真实调用视觉模型 API。
+ *
+ * @param config - 当前生效的 cvh 配置（含 provider/model/baseUrl/apiKey）
+ * @returns AI SDK 的 LanguageModel 实例，供 generateText 使用
+ * @throws 当 provider 是未知值时抛出错误
+ */
+export const resolveModel = (config) => {
+    switch (config.provider) {
+        case "oai": {
+            const openai = createOpenAI({ apiKey: config.apiKey, baseURL: config.baseUrl });
+            // 显式用 .chat()，不要用 openai(modelId) 默认调用——见上方模块注释，默认调用在当前
+            // AI SDK 版本下实际解析成 Responses API，会让 "oai"/"responses" 两个 provider 选项失去区分度。
+            return openai.chat(config.model);
+        }
+        case "responses": {
+            const openai = createOpenAI({ apiKey: config.apiKey, baseURL: config.baseUrl });
+            return openai.responses(config.model);
+        }
+        case "anthropic": {
+            const anthropic = createAnthropic({ apiKey: config.apiKey, baseURL: config.baseUrl });
+            return anthropic(config.model);
+        }
+        case "gemini": {
+            const google = createGoogleGenerativeAI({ apiKey: config.apiKey, baseURL: config.baseUrl });
+            return google(config.model);
+        }
+        default:
+            throw new Error(`未知的 provider: ${config.provider}`);
+    }
+};
+/**
+ * 调用视觉模型解析一张图片，返回文字描述（或针对具体问题的回答）。
+ *
+ * @param base64 - 图片的 base64 编码数据（不含 data URI 前缀）
+ * @param mimeType - 图片 MIME 类型，如 "image/png"
+ * @param config - 当前生效的 cvh 配置
+ * @param question - 可选的具体提问（用于 vision_ask 追问场景），省略时使用通用描述提示词
+ * @returns 视觉模型的文字回答
+ * @throws 当上游调用失败或超时时抛出错误，调用方需要自行捕获并降级处理
+ */
+export const describeImage = async (base64, mimeType, config, question) => {
+    const model = resolveModel(config);
+    const dataUrl = `data:${mimeType};base64,${base64}`;
+    const { text } = await generateText({
+        model,
+        messages: [
+            {
+                role: "user",
+                content: [
+                    { type: "image", image: dataUrl },
+                    { type: "text", text: question ?? DEFAULT_DESCRIBE_PROMPT },
+                ],
+            },
+        ],
+        maxOutputTokens: config.maxTokens,
+        abortSignal: AbortSignal.timeout(config.timeoutMs),
+    });
+    return text;
+};
+//# sourceMappingURL=vision.js.map

package/dist/vision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.js","sourceRoot":"","sources":["../src/vision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAG1D,gCAAgC;AAChC,MAAM,uBAAuB,GAAG,4CAA4C,CAAC;AAE7E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAiB,EAAE,EAAE;IAChD,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAChF,wDAAwD;YACxD,0EAA0E;YAC1E,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAChF,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,SAAS,GAAG,eAAe,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YACtF,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,MAAM,GAAG,wBAAwB,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5F,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,MAAc,EACd,QAAgB,EAChB,MAAiB,EACjB,QAAiB,EACA,EAAE;IACnB,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,QAAQ,QAAQ,WAAW,MAAM,EAAE,CAAC;IACpD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,YAAY,CAAC;QAClC,KAAK;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;oBACjC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,IAAI,uBAAuB,EAAE;iBAC5D;aACF;SACF;QACD,eAAe,EAAE,MAAM,CAAC,SAAS;QACjC,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;KACnD,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "cc-vision-hook",
+  "version": "0.1.0",
+  "description": "Claude Code Hook toolkit that lets vision-blind (silently-ignoring) models understand pasted/tool-produced images by appending an AI-generated description as additionalContext.",
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "claude-code",
+    "claude-code-hook",
+    "vision",
+    "image",
+    "multimodal",
+    "ai-sdk"
+  ],
+  "homepage": "https://github.com/RainSunMe/cc-vision-hook#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RainSunMe/cc-vision-hook.git"
+  },
+  "bugs": {
+    "url": "https://github.com/RainSunMe/cc-vision-hook/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "bin": {
+    "cvh": "./dist/cli.js",
+    "cc-vision-hook": "./dist/cli.js"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./sdk": "./dist/sdk/index.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/cli.ts",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "bun test",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "ci": "tsc --noEmit -p tsconfig.json && bun test && bun run build",
+    "smoke": "node dist/cli.js help"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "^3.0.81",
+    "@ai-sdk/google": "^3.0.0",
+    "@ai-sdk/openai": "^3.0.0",
+    "ai": "^6.0.194"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.31.0",
+    "@types/node": "^24.0.0",
+    "typescript": "^6.0.3"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README.zh-CN.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ]
+}