feat(cli): add guided local onboarding

src/application/DirectAnalysis.ts

@@ -0,0 +1,47 @@
+import { fileURLToPath } from "node:url";
+
+import { parseConfig } from "../config.js";
+import { HopperApplicationLauncher } from "../hopper/BridgeLauncher.js";
+import { HopperClient } from "../hopper/HopperClient.js";
+import type { JsonValue } from "../hopper/protocol.js";
+import { BinarySession } from "./BinarySession.js";
+
+/** Open one binary, execute one tool, and always release the target session. */
+export const runDirectAnalysis = async (
+  path: string,
+  tool: "binary_overview" | "procedure_pseudo_code",
+  arguments_: Readonly<Record<string, JsonValue>>,
+): Promise<JsonValue> => {
+  const config = parseConfig(process.env);
+  if (!config.ok)
+    return { error: config.error._tag, message: config.error.message };
+  const bridgeScriptPath = fileURLToPath(
+    new URL("../../bridge/hopper_bridge.py", import.meta.url),
+  );
+  const session = new BinarySession(
+    (target) =>
+      new HopperClient({
+        launcher: new HopperApplicationLauncher({
+          launcherPath: config.value.hopperLauncherPath,
+          targetPath: target.path,
+          targetKind: target.kind,
+          loaderArgs:
+            config.value.hopperLoaderArgs.length > 0
+              ? config.value.hopperLoaderArgs
+              : target.loaderArgs,
+          bridgeScriptPath,
+        }),
+      }),
+  );
+  try {
+    const opened = await session.open(path);
+    if (!opened.ok)
+      return { error: opened.error._tag, message: opened.error.message };
+    const result = await session.callTool(tool, arguments_);
+    return result.ok
+      ? result.value
+      : { error: result.error._tag, message: result.error.message };
+  } finally {
+    await session.close();
+  }
+};