feat(coding-agent): added read CLI command for inspecting tool output

- Registered a new `read` command in the CLI command registry so `omp read` can be invoked. - Implemented `runReadCommand` to execute the read tool, wrap it with meta notices, and print text or image-result blocks. - Added a `read` command class with required path input, optional timeout flag, and usage examples.
2026-05-04 04:27:47 +02:00
parent a019994091
commit 4087e69e70
3 changed files with 99 additions and 0 deletions
@@ -0,0 +1,58 @@
+/**
+ * Read CLI command handler.
+ *
+ * Handles `omp read` — invokes the `read` agent tool against a path/URL and
+ * prints the resulting content blocks exactly as the model would receive them
+ * (including truncation/limit notices appended by the meta-notice wrapper).
+ */
+import { getProjectDir } from "@oh-my-pi/pi-utils";
+import chalk from "chalk";
+import { Settings } from "../config/settings";
+import type { ToolSession } from "../tools";
+import { wrapToolWithMetaNotice } from "../tools/output-meta";
+import { ReadTool } from "../tools/read";
+import { renderError } from "../tools/tool-errors";
+
+export interface ReadCommandArgs {
+	path: string;
+	timeout?: number;
+}
+
+export async function runReadCommand(cmd: ReadCommandArgs): Promise<void> {
+	if (!cmd.path) {
+		process.stderr.write(chalk.red("error: path is required\n"));
+		process.exit(1);
+	}
+
+	const cwd = getProjectDir();
+	const settings = await Settings.init({ cwd });
+
+	const session: ToolSession = {
+		cwd,
+		hasUI: false,
+		settings,
+		getSessionFile: () => null,
+		getSessionSpawns: () => "*",
+	};
+
+	const tool = wrapToolWithMetaNotice(new ReadTool(session));
+
+	try {
+		const result = await tool.execute("omp-read", { path: cmd.path, timeout: cmd.timeout });
+
+		for (const block of result.content) {
+			if (block.type === "text") {
+				process.stdout.write(block.text);
+				if (!block.text.endsWith("\n")) process.stdout.write("\n");
+			} else if (block.type === "image") {
+				const decodedBytes = Buffer.from(block.data, "base64").byteLength;
+				process.stdout.write(
+					chalk.dim(`[image content: ${block.mimeType}, ${decodedBytes} bytes base64-decoded]\n`),
+				);
+			}
+		}
+	} catch (err) {
+		process.stderr.write(`${chalk.red(renderError(err))}\n`);
+		process.exit(1);
+	}
+}