pi-readseek 0.6.5 → 0.6.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-readseek",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "description": "Pi extension for readseek-backed hash-anchored read/edit/grep, structural code maps, structural search, and file exploration",
   "type": "module",
   "exports": {
@@ -39,7 +39,7 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "@jarkkojs/readseek": "^0.6.5",
+    "@jarkkojs/readseek": "^0.6.6",
     "diff": "^8.0.3",
     "xxhash-wasm": "^1.1.0"
   },

package/src/read.ts

@@ -66,7 +66,7 @@ function hasReadAnchors(result: AgentToolResult<any>): boolean {
 	return Array.isArray(lines) && lines.length > 0;
 }
 
-function formatImageAnalysis(detection: ReadSeekDetection): string | undefined {
+function formatImageAnalysis(detection: ReadSeekDetection, mode: "ocr" | "caption" | "objects"): string | undefined {
 	if (detection.kind !== "image") return undefined;
 	const sections: string[] = [];
 	const ocr = detection.ocr?.trim();
@@ -77,7 +77,10 @@ function formatImageAnalysis(detection: ReadSeekDetection): string | undefined {
 		const lines = detection.objects.map((object) => `- ${object.label} [${object.bbox.join(", ")}]`);
 		sections.push(`Detected objects:\n${lines.join("\n")}`);
 	}
-	return sections.length > 0 ? sections.join("\n\n") : undefined;
+	if (sections.length > 0) return sections.join("\n\n");
+	if (mode === "ocr") return "No OCR text detected in image.";
+	if (mode === "objects") return "No objects detected in image.";
+	return "Image caption returned no text.";
 }
 
 function formatPdfAnalysis(pdf: ReadSeekPdfOutput): string {
@@ -246,7 +249,7 @@ export async function executeRead(opts: ExecuteReadOptions): Promise<AgentToolRe
 					});
 				}
 				const analysis = await readSeekImage(absolutePath, [p.image], { signal });
-				const imageAnalysis = formatImageAnalysis(analysis);
+				const imageAnalysis = formatImageAnalysis(analysis, p.image);
 				if (imageAnalysis) {
 					return succeed({
 						content: [{ type: "text" as const, text: imageAnalysis }],

package/src/readseek-client.ts

@@ -480,6 +480,29 @@ async function runReadSeek(args: string[], options: RunReadSeekOptions = {}): Pr
 	return JSON.parse(stdout) as unknown;
 }
 
+let visionInvocationTail = Promise.resolve();
+
+/**
+ * Serialize local vision-model processes. Concurrent processes each consume all
+ * available CPU cores, which makes every invocation exceed its own timeout.
+ */
+async function runReadSeekVision(args: string[], options: RunReadSeekOptions = {}): Promise<unknown> {
+	let release!: () => void;
+	const gate = new Promise<void>((resolve) => {
+		release = resolve;
+	});
+	const predecessor = visionInvocationTail;
+	visionInvocationTail = predecessor.then(() => gate);
+
+	await predecessor;
+	try {
+		options.signal?.throwIfAborted();
+		return await runReadSeek(args, options);
+	} finally {
+		release();
+	}
+}
+
 function requireNumber(value: unknown, field: string): number {
 	if (typeof value !== "number" || !Number.isSafeInteger(value)) throw new Error(`invalid readseek ${field}: expected safe integer`);
 	return value;
@@ -830,7 +853,7 @@ export async function readSeekImage(
 ): Promise<ReadSeekDetection> {
 	const results = await Promise.allSettled(
 		modes.map(async (mode) =>
-			parseDetectOutput(await runReadSeek(["read", "--image", mode, filePath], { signal: options.signal })),
+			parseDetectOutput(await runReadSeekVision(["read", "--image", mode, filePath], { signal: options.signal })),
 		),
 	);
 
@@ -903,7 +926,8 @@ export async function readSeekPdf(
 	mode: "none" | ReadSeekImageMode,
 	options: { signal?: AbortSignal } = {},
 ): Promise<ReadSeekPdfOutput> {
-	return parsePdfOutput(await runReadSeek(["read", "--image", mode, filePath], { signal: options.signal }));
+	const run = mode === "none" ? runReadSeek : runReadSeekVision;
+	return parsePdfOutput(await run(["read", "--image", mode, filePath], { signal: options.signal }));
 }
 
 // --- Rename ---