ollanet 0.6.0 → 0.6.2

package/README.md

@@ -176,7 +176,7 @@ await scanNetwork({
 
 `pullModel({ machine, model })` asks that host to download (or update) a library model. The bits never transit ollanet. `showModel`, `removeModel({ yes: true })`, and `listLoaded` are the inspect / delete / VRAM trio.
 
-Requires **ollanet ≥ 0.4.0** (library). **Model management (`pull` / `show` / `rm` / `ps`) needs ≥ 0.5.0.** **Compare, `lastScan`, and bench `--hot` need ≥ 0.6.0.** Bundlers (Vite / SvelteKit SSR):
+Requires **ollanet ≥ 0.4.0** (library). **Model management (`pull` / `show` / `rm` / `ps`) needs ≥ 0.5.0.** **Compare, `lastScan`, and bench `--hot` need ≥ 0.6.0.** **`resolveTarget` / `listTargets` need ≥ 0.6.1.** Bundlers (Vite / SvelteKit SSR):
 
 ```ts
 // vite.config.ts
@@ -198,6 +198,7 @@ optimizeDeps: { exclude: ["ollanet"] },
 | `ollanet chats` | List or inspect saved transcripts |
 | `ollanet bench …` | Benchmark models for tok/s + lightweight quality checks |
 | `ollanet mcp` | Stdio [MCP](https://modelcontextprotocol.io) server for agents |
+| `ollanet help [command]` | This overview, or one command’s flags (`ollanet help bench`, `ollanet bench help`) |
 
 ### `scan` options
 

package/dist/argv.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared CLI flag helpers. Commands keep their own usage() and unique flags.
+ */
+import type { GenerateSettings } from "./config.js";
+export type UsageFn = () => never;
+export declare function isHelpFlag(arg: string): boolean;
+/** Intentional help: stdout, exit 0. */
+export declare function printHelp(text: string): never;
+/** Usage error: stderr, exit 1. */
+export declare function failUsage(text: string): never;
+export declare function takeValue(args: string[], flag: string, usage: UsageFn): string;
+/** `--name value` or `--name=value`. Returns undefined if `arg` is not this flag. */
+export declare function takeFlag(arg: string, name: string, args: string[], usage: UsageFn): string | undefined;
+export declare function parseNumberFlag(raw: string, flag: string, usage: UsageFn): number;
+export declare function parseKeepAlive(raw: string): string | number;
+export interface SettingsFlagOpts {
+    temperature?: boolean;
+    numPredict?: boolean;
+    system?: boolean;
+}
+/** Shared generate-settings flags. Returns true when `arg` was consumed. */
+export declare function consumeSettingsFlag(arg: string, args: string[], settings: GenerateSettings, usage: UsageFn, opts?: SettingsFlagOpts): boolean;

package/dist/argv.js

@@ -0,0 +1,86 @@
+export function isHelpFlag(arg) {
+    return arg === "--help" || arg === "-h";
+}
+/** Intentional help: stdout, exit 0. */
+export function printHelp(text) {
+    process.stdout.write(text.endsWith("\n") ? text : `${text}\n`);
+    process.exit(0);
+}
+/** Usage error: stderr, exit 1. */
+export function failUsage(text) {
+    console.error(text);
+    process.exit(1);
+}
+export function takeValue(args, flag, usage) {
+    const value = args.shift();
+    if (!value) {
+        console.error(`${flag} requires a value`);
+        usage();
+    }
+    return value;
+}
+/** `--name value` or `--name=value`. Returns undefined if `arg` is not this flag. */
+export function takeFlag(arg, name, args, usage) {
+    if (arg === name)
+        return takeValue(args, name, usage);
+    if (arg.startsWith(`${name}=`))
+        return arg.slice(name.length + 1);
+    return undefined;
+}
+export function parseNumberFlag(raw, flag, usage) {
+    const n = Number(raw);
+    if (!Number.isFinite(n)) {
+        console.error(`${flag} must be a number (got "${raw}")`);
+        usage();
+    }
+    return n;
+}
+export function parseKeepAlive(raw) {
+    const asNum = Number(raw);
+    return raw.trim() !== "" && Number.isFinite(asNum) && String(asNum) === raw ? asNum : raw;
+}
+/** Shared generate-settings flags. Returns true when `arg` was consumed. */
+export function consumeSettingsFlag(arg, args, settings, usage, opts = {}) {
+    if (arg === "--think") {
+        settings.think = true;
+        return true;
+    }
+    if (arg === "--no-think") {
+        settings.think = false;
+        return true;
+    }
+    if (opts.system) {
+        const system = takeFlag(arg, "--system", args, usage);
+        if (system !== undefined) {
+            settings.system = system;
+            return true;
+        }
+    }
+    if (opts.temperature) {
+        if (arg === "-t" || arg === "--temperature" || arg.startsWith("--temperature=")) {
+            const raw = arg === "-t" || arg === "--temperature"
+                ? takeValue(args, "--temperature", usage)
+                : arg.slice("--temperature=".length);
+            settings.temperature = parseNumberFlag(raw, "--temperature", usage);
+            return true;
+        }
+    }
+    if (opts.numPredict) {
+        const raw = takeFlag(arg, "--num-predict", args, usage);
+        if (raw !== undefined) {
+            settings.num_predict = Math.trunc(parseNumberFlag(raw, "--num-predict", usage));
+            return true;
+        }
+    }
+    const numCtx = takeFlag(arg, "--num-ctx", args, usage);
+    if (numCtx !== undefined) {
+        settings.num_ctx = Math.trunc(parseNumberFlag(numCtx, "--num-ctx", usage));
+        return true;
+    }
+    const keepAlive = takeFlag(arg, "--keep-alive", args, usage);
+    if (keepAlive !== undefined) {
+        settings.keep_alive = parseKeepAlive(keepAlive);
+        return true;
+    }
+    return false;
+}

package/dist/bench.d.ts

@@ -1 +1,2 @@
+export declare function helpText(): string;
 export declare function main(): Promise<void>;

package/dist/bench.js

@@ -5,57 +5,51 @@ import { defaultModelForHost, loadConfig, machineSettingsForHost, mergeSettings,
 import { comparabilityKey, getSuiteCases, median, suiteRevision, } from "./bench-suite.js";
 import { benchmarksDir, newBenchId, saveBenchmark } from "./bench-store.js";
 import { readFile } from "node:fs/promises";
-import { discoverHosts, envInt, ollamaBaseUrl, resolveHost, shortName, } from "./hosts.js";
+import { envInt, ollamaBaseUrl, shortName } from "./hosts.js";
+import { consumeSettingsFlag, failUsage, isHelpFlag, parseNumberFlag, printHelp, takeFlag } from "./argv.js";
+import { resolveTarget } from "./target.js";
 import { projectPath } from "./paths.js";
 import { contextLengthForModel, isCompletionCapable, isVisionCapable, ollamaChat, ollamaShow, ollamaTags, ollamaUnload, ollamaVersion, ollamaPs, psHasModel, shouldWarnNoThinking, vramForModel, waitUntilUnloaded, } from "./ollama-chat.js";
 const MODEL_COL = 34;
 const BENCH_TIMEOUT_MS = envInt("OLLAMA_BENCH_TIMEOUT_MS", 60_000);
 const UNLOAD_WAIT_MS = envInt("OLLAMA_BENCH_UNLOAD_WAIT_MS", 60_000);
-function usage() {
-    console.error(`Usage:
+export function helpText() {
+    return `Usage:
   ollanet bench <machine|ip> [model...] [options]
   ollanet bench <machine|ip> --all [options]
 
 Examples:
   ollanet bench studio gemma3:12b --runs 5
   ollanet bench studio gemma3:12b --hot --runs 5
+  ollanet help bench
+
+Fixed suite (not compare). Checks run once; throughput repeats --runs times.
+Median tok/s excludes early-stops. Unload is between models, not between repeats.
 
 Options:
   --all                 Every completion-capable model from /api/tags
   --exclude-vision      With --all, skip models that advertise vision
   --suite quick|full    Prompt suite (default quick)
-  --runs <n>            Throughput repeats (default 3)
+  --runs <n>            Counted throughput repeats (default 3)
   --hot                 Discard first throughput run; keep models loaded
-  --warmup / --no-warmup
+  --warmup              Short discarded call before timed cases (default on)
+  --no-warmup           Skip the short warmup (--hot implies this)
   --cold-load           Measure cold load via unload + /api/ps
   --num-predict <n>     Pin throughput length (default 256)
-  --num-ctx <n>
-  --keep-alive <value>
-  --think / --no-think
-  --judge --judge-model <name>
+  --num-ctx <n>         Context window override
+  --keep-alive <value>  Keep model loaded (e.g. 5m, 0, -1)
+  --think / --no-think  Thinking tokens (default off)
+  --judge               Second pass: score check answers 1–5
+  --judge-model <name>  Required with --judge (no default)
   --json                Machine-readable stdout
-  --save / --no-save
-  --fail-fast
+  --save / --no-save    Persist under benchmarks/ (default on)
+  --fail-fast           Stop remaining models after the first hard error
   --fail-on-error       Exit 2 if any model/case errored
 
-See docs/bench-spec.md for measurement rules.`);
-    process.exit(1);
-}
-function takeValue(args, flag) {
-    const value = args.shift();
-    if (!value) {
-        console.error(`${flag} requires a value`);
-        usage();
-    }
-    return value;
+See docs/bench-spec.md for measurement rules.`;
 }
-function parseNumberFlag(raw, flag) {
-    const n = Number(raw);
-    if (!Number.isFinite(n)) {
-        console.error(`${flag} must be a number (got "${raw}")`);
-        usage();
-    }
-    return n;
+function usage() {
+    failUsage(helpText());
 }
 function isLoopback(host) {
     return (host.source === "localhost" ||
@@ -104,7 +98,9 @@ function parseArgs(argv) {
     const positional = [];
     while (args.length > 0) {
         const arg = args.shift();
-        if (arg === "--" || arg === "--help" || arg === "-h")
+        if (isHelpFlag(arg))
+            printHelp(helpText());
+        if (arg === "--")
             usage();
         if (arg === "--all") {
             all = true;
@@ -157,57 +153,35 @@ function parseArgs(argv) {
             failOnError = true;
             continue;
         }
-        if (arg === "--think") {
-            settings.think = true;
-            continue;
-        }
-        if (arg === "--no-think") {
-            settings.think = false;
-            continue;
-        }
         if (arg === "--judge") {
             judge = true;
             continue;
         }
-        if (arg === "--suite" || arg.startsWith("--suite=")) {
-            const raw = arg.includes("=") ? arg.slice("--suite=".length) : takeValue(args, "--suite");
-            if (raw !== "quick" && raw !== "full") {
-                console.error(`Unknown suite "${raw}" (use quick|full)`);
-                usage();
-            }
-            suite = raw;
+        if (consumeSettingsFlag(arg, args, settings, usage)) {
             continue;
         }
-        if (arg === "--runs" || arg.startsWith("--runs=")) {
-            const raw = arg.includes("=") ? arg.slice("--runs=".length) : takeValue(args, "--runs");
-            runs = Math.max(1, Math.trunc(parseNumberFlag(raw, "--runs")));
-            continue;
-        }
-        if (arg === "--num-predict" || arg.startsWith("--num-predict=")) {
-            const raw = arg.includes("=")
-                ? arg.slice("--num-predict=".length)
-                : takeValue(args, "--num-predict");
-            throughputNumPredict = Math.trunc(parseNumberFlag(raw, "--num-predict"));
+        const suiteRaw = takeFlag(arg, "--suite", args, usage);
+        if (suiteRaw !== undefined) {
+            if (suiteRaw !== "quick" && suiteRaw !== "full") {
+                console.error(`Unknown suite "${suiteRaw}" (use quick|full)`);
+                usage();
+            }
+            suite = suiteRaw;
             continue;
         }
-        if (arg === "--num-ctx" || arg.startsWith("--num-ctx=")) {
-            const raw = arg.includes("=") ? arg.slice("--num-ctx=".length) : takeValue(args, "--num-ctx");
-            settings.num_ctx = Math.trunc(parseNumberFlag(raw, "--num-ctx"));
+        const runsRaw = takeFlag(arg, "--runs", args, usage);
+        if (runsRaw !== undefined) {
+            runs = Math.max(1, Math.trunc(parseNumberFlag(runsRaw, "--runs", usage)));
             continue;
         }
-        if (arg === "--keep-alive" || arg.startsWith("--keep-alive=")) {
-            const raw = arg.includes("=")
-                ? arg.slice("--keep-alive=".length)
-                : takeValue(args, "--keep-alive");
-            const asNum = Number(raw);
-            settings.keep_alive =
-                raw.trim() !== "" && Number.isFinite(asNum) && String(asNum) === raw ? asNum : raw;
+        const predictRaw = takeFlag(arg, "--num-predict", args, usage);
+        if (predictRaw !== undefined) {
+            throughputNumPredict = Math.trunc(parseNumberFlag(predictRaw, "--num-predict", usage));
             continue;
         }
-        if (arg === "--judge-model" || arg.startsWith("--judge-model=")) {
-            judgeModel = arg.includes("=")
-                ? arg.slice("--judge-model=".length)
-                : takeValue(args, "--judge-model");
+        const judgeRaw = takeFlag(arg, "--judge-model", args, usage);
+        if (judgeRaw !== undefined) {
+            judgeModel = judgeRaw;
             continue;
         }
         if (arg.startsWith("-")) {
@@ -527,11 +501,7 @@ function pad(s, n) {
 export async function main() {
     const parsed = parseArgs(process.argv.slice(2));
     const config = await loadConfig();
-    const { hosts: targets } = await discoverHosts({
-        hosts: config.hosts,
-        discovery: config.discovery,
-    });
-    const host = resolveHost(targets, parsed.machine);
+    const host = await resolveTarget(parsed.machine, config);
     const baseUrl = ollamaBaseUrl(host);
     const machineLabel = shortName(host);
     const tags = await ollamaTags(baseUrl, Math.min(BENCH_TIMEOUT_MS, 15_000));

package/dist/chats.d.ts

@@ -6,4 +6,5 @@
  *   ollanet chats --json
  *   ollanet chats --id a1b2c3d4e5f6
  */
+export declare function helpText(): string;
 export declare function main(): Promise<void>;

package/dist/chats.js

@@ -7,15 +7,18 @@
  *   ollanet chats --id a1b2c3d4e5f6
  */
 import { loadChat, listChats, responsesDir, } from "./chat-store.js";
-function usage() {
-    console.error(`Usage: ollanet chats [--json] [--id <hash>]
+import { failUsage, isHelpFlag, printHelp, takeFlag } from "./argv.js";
+export function helpText() {
+    return `Usage: ollanet chats [--json] [--id <hash>]
 
 Lists transcripts in ${responsesDir()}.
 
 Options:
   --json       Machine-readable output
-  --id <hash>  Show one chat (messages included with --json, preview otherwise)`);
-    process.exit(1);
+  --id <hash>  Show one chat (messages included with --json, preview otherwise)`;
+}
+function usage() {
+    failUsage(helpText());
 }
 function parseArgs(argv) {
     const args = [...argv];
@@ -25,18 +28,15 @@ function parseArgs(argv) {
         const arg = args.shift();
         if (arg === "--")
             continue;
-        if (arg === "--help" || arg === "-h")
-            usage();
+        if (isHelpFlag(arg))
+            printHelp(helpText());
         if (arg === "--json") {
             json = true;
             continue;
         }
-        if (arg === "--id" || arg.startsWith("--id=")) {
-            id = arg.includes("=") ? arg.slice("--id=".length) : args.shift();
-            if (!id) {
-                console.error("--id requires a value");
-                usage();
-            }
+        const idFlag = takeFlag(arg, "--id", args, usage);
+        if (idFlag !== undefined) {
+            id = idFlag;
             continue;
         }
         console.error(`Unknown flag: ${arg}`);

package/dist/cli.js

@@ -28,6 +28,7 @@ Usage:
   ollanet chats [--json] [--id <hash>]
   ollanet bench <machine|ip> [model...] [--all] [options]
   ollanet mcp
+  ollanet help [command]
 
 Examples:
   ollanet scan
@@ -46,6 +47,7 @@ Examples:
   ollanet bench localhost --all
   ollanet bench localhost llama3.2:1b --runs 3
   ollanet bench localhost gemma3:12b --hot --runs 5
+  ollanet help bench           # flags for one command (also: ollanet bench help)
   ollanet mcp                  # stdio MCP server for agents
 
 Config: ~/.ollanet/config.json when installed, ./config.json in a checkout
@@ -58,10 +60,36 @@ async function main() {
     // pnpm/npm often forward a bare `--`; ignore it.
     const argv = process.argv.slice(2).filter((arg) => arg !== "--");
     const cmd = argv[0];
-    if (!cmd || cmd === "-h" || cmd === "--help" || cmd === "help") {
+    if (!cmd || cmd === "-h" || cmd === "--help") {
         process.stdout.write(HELP);
         return;
     }
+    if (cmd === "help") {
+        const topic = argv[1];
+        if (!topic || topic === "-h" || topic === "--help") {
+            process.stdout.write(HELP);
+            return;
+        }
+        const { commandHelp, commandNames } = await import("./help.js");
+        const text = await commandHelp(topic);
+        if (!text) {
+            console.error(`Unknown command: ${topic}`);
+            console.error(`Try: ollanet help   (commands: ${commandNames().join(", ")})`);
+            process.exitCode = 1;
+            return;
+        }
+        process.stdout.write(text.endsWith("\n") ? text : `${text}\n`);
+        return;
+    }
+    const rest = argv.slice(1);
+    const { isHelpRequest, commandHelp } = await import("./help.js");
+    if (isHelpRequest(rest)) {
+        const text = await commandHelp(cmd);
+        if (text) {
+            process.stdout.write(text.endsWith("\n") ? text : `${text}\n`);
+            return;
+        }
+    }
     if (cmd === "-v" || cmd === "--version" || cmd === "version") {
         const { readFile } = await import("node:fs/promises");
         const { projectPath } = await import("./paths.js");

package/dist/compare.d.ts

@@ -7,6 +7,7 @@
 import { type AppConfig, type GenerateSettings } from "./config.js";
 /** Used when --prompt, --file, and stdin are all omitted. */
 export declare const DEFAULT_COMPARE_PROMPT: string;
+export declare function helpText(): string;
 export interface CompareModelResult {
     model: string;
     content?: string;

package/dist/compare.js

@@ -5,7 +5,9 @@
  *   ollanet compare studio m1 m2 --file task.md
  */
 import { configFromPartial, loadConfig, machineSettingsForHost, mergeSettings, settingsFromEnv, } from "./config.js";
-import { discoverHosts, envInt, ollamaBaseUrl, resolveHost, shortName } from "./hosts.js";
+import { envInt, ollamaBaseUrl, shortName } from "./hosts.js";
+import { consumeSettingsFlag, failUsage, isHelpFlag, printHelp, takeFlag, takeValue } from "./argv.js";
+import { resolveTarget } from "./target.js";
 import { ollamaChat, ollamaTags, ollamaUnload, waitUntilUnloaded, } from "./ollama-chat.js";
 import { assemblePrompt, readPromptFile } from "./prompt-input.js";
 import { comparesDir, newCompareId, saveCompare } from "./compare-store.js";
@@ -21,8 +23,8 @@ function compareTimeoutMs() {
 function unloadWaitMs() {
     return envInt("OLLAMA_COMPARE_UNLOAD_WAIT_MS", 60_000);
 }
-function usage() {
-    console.error(`Usage:
+export function helpText() {
+    return `Usage:
   ollanet compare <machine> <model> <model> [model...]
   ollanet compare <machine> <model> <model> [model...] --prompt <text>
   ollanet compare <machine> <model> <model> [model...] --file <path.txt|.md>
@@ -47,24 +49,10 @@ Options:
   --think / --no-think
   --unload               Unload each model before the next (fairer tok/s)
   --no-save              Do not write compares/*
-  --json                 Emit the full record on stdout`);
-    process.exit(1);
-}
-function takeValue(args, flag) {
-    const value = args.shift();
-    if (!value) {
-        console.error(`${flag} requires a value`);
-        usage();
-    }
-    return value;
+  --json                 Emit the full record on stdout`;
 }
-function parseNumberFlag(raw, flag) {
-    const n = Number(raw);
-    if (!Number.isFinite(n)) {
-        console.error(`${flag} must be a number (got "${raw}")`);
-        usage();
-    }
-    return n;
+function usage() {
+    failUsage(helpText());
 }
 function parseArgs(argv) {
     const args = [...argv];
@@ -79,8 +67,8 @@ function parseArgs(argv) {
         const arg = args.shift();
         if (arg === "--")
             continue;
-        if (arg === "--help" || arg === "-h")
-            usage();
+        if (isHelpFlag(arg))
+            printHelp(helpText());
         if (arg === "--json") {
             json = true;
             continue;
@@ -93,48 +81,19 @@ function parseArgs(argv) {
             unload = true;
             continue;
         }
-        if (arg === "--think") {
-            settings.think = true;
-            continue;
-        }
-        if (arg === "--no-think") {
-            settings.think = false;
-            continue;
-        }
-        if (arg === "--prompt" || arg === "-p" || arg.startsWith("--prompt=")) {
-            prompt = arg.includes("=") ? arg.slice("--prompt=".length) : takeValue(args, "--prompt");
-            continue;
-        }
-        if (arg === "--file" || arg === "-f" || arg.startsWith("--file=")) {
-            file = arg.includes("=") ? arg.slice("--file=".length) : takeValue(args, "--file");
+        if (consumeSettingsFlag(arg, args, settings, usage, {
+            temperature: true,
+            numPredict: true,
+            system: true,
+        })) {
             continue;
         }
-        if (arg === "--system" || arg.startsWith("--system=")) {
-            settings.system = arg.includes("=")
-                ? arg.slice("--system=".length)
-                : takeValue(args, "--system");
+        if (arg === "-p" || arg === "--prompt" || arg.startsWith("--prompt=")) {
+            prompt = arg === "-p" ? takeValue(args, "--prompt", usage) : takeFlag(arg, "--prompt", args, usage);
             continue;
         }
-        if (arg === "--temperature" || arg === "-t" || arg.startsWith("--temperature=")) {
-            const raw = arg.includes("=") ? arg.slice("--temperature=".length) : takeValue(args, "--temperature");
-            settings.temperature = parseNumberFlag(raw, "--temperature");
-            continue;
-        }
-        if (arg === "--num-predict" || arg.startsWith("--num-predict=")) {
-            const raw = arg.includes("=") ? arg.slice("--num-predict=".length) : takeValue(args, "--num-predict");
-            settings.num_predict = Math.trunc(parseNumberFlag(raw, "--num-predict"));
-            continue;
-        }
-        if (arg === "--num-ctx" || arg.startsWith("--num-ctx=")) {
-            const raw = arg.includes("=") ? arg.slice("--num-ctx=".length) : takeValue(args, "--num-ctx");
-            settings.num_ctx = Math.trunc(parseNumberFlag(raw, "--num-ctx"));
-            continue;
-        }
-        if (arg === "--keep-alive" || arg.startsWith("--keep-alive=")) {
-            const raw = arg.includes("=") ? arg.slice("--keep-alive=".length) : takeValue(args, "--keep-alive");
-            const asNum = Number(raw);
-            settings.keep_alive =
-                raw.trim() !== "" && Number.isFinite(asNum) && String(asNum) === raw ? asNum : raw;
+        if (arg === "-f" || arg === "--file" || arg.startsWith("--file=")) {
+            file = arg === "-f" ? takeValue(args, "--file", usage) : takeFlag(arg, "--file", args, usage);
             continue;
         }
         if (arg.startsWith("-")) {
@@ -189,14 +148,7 @@ export async function runCompare(opts) {
     const defaulted = !assembled;
     const prompt = assembled || DEFAULT_COMPARE_PROMPT;
     const config = opts.config ? configFromPartial(opts.config) : await loadConfig();
-    const { hosts } = await discoverHosts({
-        hosts: config.hosts,
-        discovery: config.discovery,
-    });
-    const host = resolveHost(hosts, opts.machine);
-    if (!host.online && !host.isSelf && host.source === "tailscale") {
-        throw new Error(`Machine "${shortName(host)}" appears offline.`);
-    }
+    const host = await resolveTarget(opts.machine, config);
     const baseUrl = ollamaBaseUrl(host);
     const timeoutMs = opts.timeoutMs ?? compareTimeoutMs();
     let available = null;

package/dist/help.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Per-command help: `ollanet help bench` and `ollanet bench help`.
+ */
+export declare function canonicalCommand(name: string): string | undefined;
+export declare function commandNames(): string[];
+export declare function commandHelp(name: string): Promise<string | undefined>;
+export declare function isHelpRequest(args: string[]): boolean;

package/dist/help.js

@@ -0,0 +1,51 @@
+/**
+ * Per-command help: `ollanet help bench` and `ollanet bench help`.
+ */
+const LOADERS = {
+    scan: () => import("./scan.js"),
+    prompt: () => import("./prompt.js"),
+    chats: () => import("./chats.js"),
+    pull: () => import("./pull.js"),
+    show: () => import("./show.js"),
+    rm: () => import("./rm.js"),
+    ps: () => import("./ps.js"),
+    compare: () => import("./compare.js"),
+    bench: () => import("./bench.js"),
+    mcp: () => import("./mcp.js"),
+};
+const ALIASES = {
+    "ls-servers": "scan",
+    ask: "prompt",
+    chat: "prompt",
+    ls: "chats",
+    history: "chats",
+    download: "pull",
+    inspect: "show",
+    delete: "rm",
+    loaded: "ps",
+    vs: "compare",
+    h2h: "compare",
+    benchmark: "bench",
+};
+export function canonicalCommand(name) {
+    const key = name.trim().toLowerCase();
+    if (LOADERS[key])
+        return key;
+    return ALIASES[key];
+}
+export function commandNames() {
+    return Object.keys(LOADERS);
+}
+export async function commandHelp(name) {
+    const canon = canonicalCommand(name);
+    if (!canon)
+        return undefined;
+    const load = LOADERS[canon];
+    if (!load)
+        return undefined;
+    const mod = await load();
+    return mod.helpText();
+}
+export function isHelpRequest(args) {
+    return args.length === 1 && (args[0] === "help" || args[0] === "--help" || args[0] === "-h");
+}

package/dist/index.d.ts

@@ -29,5 +29,6 @@ export type { RemoveOptions, RemoveResult } from "./rm.js";
 export { listLoaded } from "./ps.js";
 export type { PsOptions, PsResult, LoadedHost, LoadedModel } from "./ps.js";
 export { looksTuned } from "./tuned.js";
+export { resolveTarget, listTargets } from "./target.js";
 export { ollamaChat, ollamaTags, ollamaShow, ollamaPs, ollamaPsRequired, ollamaPull, ollamaDelete, } from "./ollama-chat.js";
 export type { PullChunk, OllamaPullOptions, OllamaPullResult, OllamaShowInfo, } from "./ollama-chat.js";

package/dist/index.js

@@ -19,4 +19,5 @@ export { showModel } from "./show.js";
 export { removeModel } from "./rm.js";
 export { listLoaded } from "./ps.js";
 export { looksTuned } from "./tuned.js";
+export { resolveTarget, listTargets } from "./target.js";
 export { ollamaChat, ollamaTags, ollamaShow, ollamaPs, ollamaPsRequired, ollamaPull, ollamaDelete, } from "./ollama-chat.js";

package/dist/mcp.d.ts

@@ -8,4 +8,5 @@
  *
  * stdout is reserved for JSON-RPC; log only to stderr.
  */
+export declare function helpText(): string;
 export declare function main(): Promise<void>;

package/dist/mcp.js

@@ -21,6 +21,7 @@ import { removeModel } from "./rm.js";
 import { lastScan } from "./scan-store.js";
 import { scanNetwork } from "./scan.js";
 import { showModel } from "./show.js";
+import { isHelpFlag, printHelp } from "./argv.js";
 // Pin to the oldest widely-supported MCP revision. Clients may request a newer
 // date; we still answer with this — legal negotiation, max compatibility.
 const PROTOCOL_VERSION = "2024-11-05";
@@ -487,7 +488,29 @@ async function handleRequest(msg, version) {
             fail(id, -32601, `Method not found: ${method}`);
     }
 }
+export function helpText() {
+    return `Usage:
+  ollanet mcp
+
+Stdio MCP server (no extra npm deps). stdout is JSON-RPC; logs go to stderr.
+
+Tools:
+  ollanet_scan          Discover hosts + models (lan, all, last)
+  ollanet_prompt        Prompt a host or continue with chat_id
+  ollanet_compare       Same prompt on 2–5 models
+  ollanet_pull          Pull / update a model on a host
+  ollanet_show          Inspect a model
+  ollanet_rm            Delete a model (confirm: true)
+  ollanet_ps            Models loaded in VRAM
+  ollanet_list_chats    Saved transcripts
+  ollanet_get_chat      One chat by id
+
+Example Cursor config: { "command": "npx", "args": ["-y", "ollanet", "mcp"] }`;
+}
 export async function main() {
+    if (process.argv.slice(2).some((arg) => isHelpFlag(arg))) {
+        printHelp(helpText());
+    }
     const version = await packageVersion();
     console.error(`ollanet mcp ${version} (stdio) — tools: ${TOOLS.map((t) => t.name).join(", ")}`);
     const rl = createInterface({ input: process.stdin, crlfDelay: Infinity });

package/dist/prompt.d.ts

@@ -12,6 +12,7 @@
  *   ollanet chats
  */
 import { type AppConfig, type GenerateSettings } from "./config.js";
+export declare function helpText(): string;
 export interface PromptRunOptions {
     machine?: string;
     model?: string;

package/dist/prompt.js

@@ -14,15 +14,17 @@
 import { stdin as stdinStream } from "node:process";
 import { appendMessage, cleanTopic, createChat, loadChat, saveChat, toApiMessages, topicFromPrompt, } from "./chat-store.js";
 import { configPath, defaultModelForHost, loadConfig, machineSettingsForHost, mergeSettings, parseFormat, settingsFromEnv, settingsSummary, configFromPartial, } from "./config.js";
-import { discoverHosts, envInt, findDiscoveredHost, ollamaBaseUrl, resolveHost, shortName, } from "./hosts.js";
+import { envInt, findDiscoveredHost, ollamaBaseUrl, resolveHost, shortName, } from "./hosts.js";
 import { ollamaChat } from "./ollama-chat.js";
 import { assemblePrompt, readPromptFile } from "./prompt-input.js";
+import { consumeSettingsFlag, failUsage, isHelpFlag, printHelp, takeFlag, takeValue } from "./argv.js";
+import { listTargets, resolveTarget } from "./target.js";
 /** Prompt/chat HTTP timeout (ms). 0 = no timeout. Separate from scan's OLLAMA_TIMEOUT_MS. */
 function promptTimeoutMs() {
     return envInt("OLLAMA_PROMPT_TIMEOUT_MS", 600_000);
 }
-function usage() {
-    console.error(`Usage:
+export function helpText() {
+    return `Usage:
   ollanet prompt <machine> [model] <prompt...>
   ollanet prompt --chat <hash> <prompt...>
   ollanet prompt <machine> --chat <hash> <prompt...>
@@ -55,8 +57,10 @@ Options:
   --no-think             Disable thinking (default) so tokens go to the reply
   --file <path>          Prompt from a .txt or .md file (joins argv / stdin)
   --no-stream            Wait for the full response
-  --json                 Emit final response JSON (implies --no-stream)`);
-    process.exit(1);
+  --json                 Emit final response JSON (implies --no-stream)`;
+}
+function usage() {
+    failUsage(helpText());
 }
 /**
  * Heuristic for an optional positional model token.
@@ -119,22 +123,6 @@ async function maybePeelModel(host, promptParts, fromStdin) {
     }
     return { promptParts };
 }
-function takeValue(args, flag) {
-    const value = args.shift();
-    if (!value) {
-        console.error(`${flag} requires a value`);
-        usage();
-    }
-    return value;
-}
-function parseNumberFlag(raw, flag) {
-    const n = Number(raw);
-    if (!Number.isFinite(n)) {
-        console.error(`${flag} must be a number (got "${raw}")`);
-        usage();
-    }
-    return n;
-}
 function parseArgs(argv) {
     const args = [...argv];
     let machineFlag;
@@ -150,8 +138,8 @@ function parseArgs(argv) {
         const arg = args.shift();
         if (arg === "--")
             continue;
-        if (arg === "--help" || arg === "-h")
-            usage();
+        if (isHelpFlag(arg))
+            printHelp(helpText());
         if (arg === "--no-stream") {
             stream = false;
             continue;
@@ -165,59 +153,34 @@ function parseArgs(argv) {
             save = false;
             continue;
         }
-        if (arg === "--think") {
-            settings.think = true;
+        if (consumeSettingsFlag(arg, args, settings, usage, {
+            temperature: true,
+            numPredict: true,
+            system: true,
+        })) {
             continue;
         }
-        if (arg === "--no-think") {
-            settings.think = false;
+        const chat = takeFlag(arg, "--chat", args, usage);
+        if (chat !== undefined) {
+            chatId = chat;
             continue;
         }
-        if (arg === "--chat" || arg.startsWith("--chat=")) {
-            chatId = arg.includes("=") ? arg.slice("--chat=".length) : takeValue(args, "--chat");
+        const machine = takeFlag(arg, "--machine", args, usage);
+        if (machine !== undefined) {
+            machineFlag = machine;
             continue;
         }
-        if (arg === "--machine" || arg.startsWith("--machine=")) {
-            machineFlag = arg.includes("=") ? arg.slice("--machine=".length) : takeValue(args, "--machine");
+        const model = takeFlag(arg, "--model", args, usage);
+        if (model !== undefined) {
+            modelFlag = model;
             continue;
         }
-        if (arg === "--model" || arg.startsWith("--model=")) {
-            modelFlag = arg.includes("=") ? arg.slice("--model=".length) : takeValue(args, "--model");
-            continue;
-        }
-        if (arg === "--file" || arg === "-f" || arg.startsWith("--file=")) {
-            file = arg.includes("=") ? arg.slice("--file=".length) : takeValue(args, "--file");
-            continue;
-        }
-        if (arg === "--system" || arg.startsWith("--system=")) {
-            settings.system = arg.includes("=")
-                ? arg.slice("--system=".length)
-                : takeValue(args, "--system");
-            continue;
-        }
-        if (arg === "--temperature" || arg === "-t" || arg.startsWith("--temperature=")) {
-            const raw = arg.includes("=") ? arg.slice("--temperature=".length) : takeValue(args, "--temperature");
-            settings.temperature = parseNumberFlag(raw, "--temperature");
-            continue;
-        }
-        if (arg === "--num-predict" || arg.startsWith("--num-predict=")) {
-            const raw = arg.includes("=") ? arg.slice("--num-predict=".length) : takeValue(args, "--num-predict");
-            settings.num_predict = Math.trunc(parseNumberFlag(raw, "--num-predict"));
-            continue;
-        }
-        if (arg === "--num-ctx" || arg.startsWith("--num-ctx=")) {
-            const raw = arg.includes("=") ? arg.slice("--num-ctx=".length) : takeValue(args, "--num-ctx");
-            settings.num_ctx = Math.trunc(parseNumberFlag(raw, "--num-ctx"));
-            continue;
-        }
-        if (arg === "--keep-alive" || arg.startsWith("--keep-alive=")) {
-            const raw = arg.includes("=") ? arg.slice("--keep-alive=".length) : takeValue(args, "--keep-alive");
-            const asNum = Number(raw);
-            settings.keep_alive = raw.trim() !== "" && Number.isFinite(asNum) && String(asNum) === raw ? asNum : raw;
+        if (arg === "-f" || arg === "--file" || arg.startsWith("--file=")) {
+            file = arg === "-f" ? takeValue(args, "--file", usage) : takeFlag(arg, "--file", args, usage);
             continue;
         }
         if (arg === "--format" || arg.startsWith("--format=")) {
-            const raw = arg.includes("=") ? arg.slice("--format=".length) : takeValue(args, "--format");
+            const raw = takeFlag(arg, "--format", args, usage) ?? "";
             const format = parseFormat(raw);
             if (format !== undefined)
                 settings.format = format;
@@ -325,10 +288,6 @@ export async function runPrompt(opts) {
     const writeStdout = opts.writeStdout !== false;
     let promptParts = opts.prompt ? [opts.prompt] : [];
     const config = opts.config ? configFromPartial(opts.config) : await loadConfig();
-    const { hosts: targets } = await discoverHosts({
-        hosts: config.hosts,
-        discovery: config.discovery,
-    });
     let chat;
     let isNewChat = false;
     let machineQuery = opts.machine;
@@ -339,10 +298,7 @@ export async function runPrompt(opts) {
     if (!machineQuery) {
         throw new Error("Machine is required for a new chat (or pass chatId).");
     }
-    const host = resolveHost(targets, machineQuery);
-    if (!host.online && !host.isSelf && host.source === "tailscale") {
-        throw new Error(`Machine "${shortName(host)}" appears offline.`);
-    }
+    const host = await resolveTarget(machineQuery, config);
     let peeledModel;
     if (!opts.chatId && !opts.model) {
         const peeled = await maybePeelModel(host, promptParts, "");
@@ -456,10 +412,7 @@ export async function main() {
         }
     }
     const config = await loadConfig();
-    const { hosts: targets } = await discoverHosts({
-        hosts: config.hosts,
-        discovery: config.discovery,
-    });
+    const targets = await listTargets(config);
     let machineQuery = parsed.machine;
     if (parsed.chatId) {
         // Allow `ollanet prompt <host> --chat HASH "follow-up"` only when the

package/dist/ps.d.ts

@@ -5,6 +5,7 @@
  *   ollanet ps studio
  */
 import { type AppConfig } from "./config.js";
+export declare function helpText(): string;
 export interface LoadedModel {
     name: string;
     size_vram?: number;

package/dist/ps.js

@@ -7,13 +7,14 @@
 import { configFromPartial, loadConfig } from "./config.js";
 import { discoverHosts, envInt, ollamaBaseUrl, shortName, } from "./hosts.js";
 import { ollamaPs, ollamaPsRequired } from "./ollama-chat.js";
+import { failUsage, isHelpFlag, printHelp, takeFlag } from "./argv.js";
 import { resolveTarget } from "./target.js";
 import { looksTuned } from "./tuned.js";
 function psTimeoutMs() {
     return envInt("OLLAMA_PS_TIMEOUT_MS", 10_000);
 }
-function usage() {
-    console.error(`Usage:
+export function helpText() {
+    return `Usage:
   ollanet ps [machine]
   ollanet ps --machine <name>
 
@@ -26,16 +27,10 @@ scan lists models on disk. ps lists what is loaded in VRAM right now.
 
 Options:
   --machine <name>   One host (default: every discovered host)
-  --json             Emit result JSON on stdout`);
-    process.exit(1);
+  --json             Emit result JSON on stdout`;
 }
-function takeValue(args, flag) {
-    const value = args.shift();
-    if (!value) {
-        console.error(`${flag} requires a value`);
-        usage();
-    }
-    return value;
+function usage() {
+    failUsage(helpText());
 }
 function parseArgs(argv) {
     const args = [...argv];
@@ -46,14 +41,15 @@ function parseArgs(argv) {
         const arg = args.shift();
         if (arg === "--")
             continue;
-        if (arg === "--help" || arg === "-h")
-            usage();
+        if (isHelpFlag(arg))
+            printHelp(helpText());
         if (arg === "--json") {
             json = true;
             continue;
         }
-        if (arg === "--machine") {
-            machineFlag = takeValue(args, "--machine");
+        const machine = takeFlag(arg, "--machine", args, usage);
+        if (machine !== undefined) {
+            machineFlag = machine;
             continue;
         }
         if (arg.startsWith("-")) {

package/dist/pull.d.ts

@@ -8,6 +8,7 @@
  */
 import type { AppConfig } from "./config.js";
 import { type PullChunk } from "./ollama-chat.js";
+export declare function helpText(): string;
 export interface PullOptions {
     machine: string;
     model: string;

package/dist/pull.js

@@ -8,13 +8,14 @@
  */
 import { envInt, ollamaBaseUrl, shortName } from "./hosts.js";
 import { ollamaPull } from "./ollama-chat.js";
+import { failUsage, isHelpFlag, printHelp, takeFlag } from "./argv.js";
 import { resolveTarget } from "./target.js";
 /** Pull HTTP timeout (ms). 0 = none. Large models can take hours. */
 function pullTimeoutMs() {
     return envInt("OLLAMA_PULL_TIMEOUT_MS", 0);
 }
-function usage() {
-    console.error(`Usage:
+export function helpText() {
+    return `Usage:
   ollanet pull <machine> <model>
   ollanet pull --machine <name> --model <name>
 
@@ -32,16 +33,10 @@ Options:
   --model <name>     Model to pull (e.g. gemma3:12b)
   --insecure         Allow HTTP / self-signed model registries
   --no-stream        Wait for a single final response (no progress chunks)
-  --json             Emit result JSON on stdout`);
-    process.exit(1);
+  --json             Emit result JSON on stdout`;
 }
-function takeValue(args, flag) {
-    const value = args.shift();
-    if (!value) {
-        console.error(`${flag} requires a value`);
-        usage();
-    }
-    return value;
+function usage() {
+    failUsage(helpText());
 }
 function parseArgs(argv) {
     const args = [...argv];
@@ -55,8 +50,8 @@ function parseArgs(argv) {
         const arg = args.shift();
         if (arg === "--")
             continue;
-        if (arg === "--help" || arg === "-h")
-            usage();
+        if (isHelpFlag(arg))
+            printHelp(helpText());
         if (arg === "--insecure") {
             insecure = true;
             continue;
@@ -69,12 +64,14 @@ function parseArgs(argv) {
             json = true;
             continue;
         }
-        if (arg === "--machine") {
-            machineFlag = takeValue(args, "--machine");
+        const machine = takeFlag(arg, "--machine", args, usage);
+        if (machine !== undefined) {
+            machineFlag = machine;
             continue;
         }
-        if (arg === "--model") {
-            modelFlag = takeValue(args, "--model");
+        const model = takeFlag(arg, "--model", args, usage);
+        if (model !== undefined) {
+            modelFlag = model;
             continue;
         }
         if (arg.startsWith("-")) {

package/dist/rm.d.ts

@@ -4,6 +4,7 @@
  *   ollanet rm studio llama3.2:1b --yes
  */
 import type { AppConfig } from "./config.js";
+export declare function helpText(): string;
 export interface RemoveOptions {
     machine: string;
     model: string;

package/dist/rm.js

@@ -6,12 +6,13 @@
 import { createInterface } from "node:readline";
 import { envInt, ollamaBaseUrl, shortName } from "./hosts.js";
 import { ollamaDelete } from "./ollama-chat.js";
+import { failUsage, isHelpFlag, printHelp, takeFlag } from "./argv.js";
 import { resolveTarget } from "./target.js";
 function rmTimeoutMs() {
     return envInt("OLLAMA_RM_TIMEOUT_MS", 30_000);
 }
-function usage() {
-    console.error(`Usage:
+export function helpText() {
+    return `Usage:
   ollanet rm <machine> <model> --yes
   ollanet rm --machine <name> --model <name> --yes
 
@@ -26,16 +27,10 @@ Options:
   --machine <name>   Host (discovered name, MagicDNS, hostname, or IP[:port])
   --model <name>     Model to delete
   --yes              Required unless stdin is a TTY and you confirm
-  --json             Emit result JSON on stdout`);
-    process.exit(1);
+  --json             Emit result JSON on stdout`;
 }
-function takeValue(args, flag) {
-    const value = args.shift();
-    if (!value) {
-        console.error(`${flag} requires a value`);
-        usage();
-    }
-    return value;
+function usage() {
+    failUsage(helpText());
 }
 function parseArgs(argv) {
     const args = [...argv];
@@ -48,8 +43,8 @@ function parseArgs(argv) {
         const arg = args.shift();
         if (arg === "--")
             continue;
-        if (arg === "--help" || arg === "-h")
-            usage();
+        if (isHelpFlag(arg))
+            printHelp(helpText());
         if (arg === "--yes" || arg === "-y") {
             yes = true;
             continue;
@@ -58,12 +53,14 @@ function parseArgs(argv) {
             json = true;
             continue;
         }
-        if (arg === "--machine") {
-            machineFlag = takeValue(args, "--machine");
+        const machine = takeFlag(arg, "--machine", args, usage);
+        if (machine !== undefined) {
+            machineFlag = machine;
             continue;
         }
-        if (arg === "--model") {
-            modelFlag = takeValue(args, "--model");
+        const model = takeFlag(arg, "--model", args, usage);
+        if (model !== undefined) {
+            modelFlag = model;
             continue;
         }
         if (arg.startsWith("-")) {

package/dist/scan.d.ts

@@ -54,4 +54,5 @@ export interface ScanPayload {
 }
 /** Programmatic scan used by CLI `--json`, MCP, and `import { scanNetwork } from "ollanet"`. */
 export declare function scanNetwork(options?: ScanOptions): Promise<ScanPayload>;
+export declare function helpText(): string;
 export declare function main(): Promise<void>;

package/dist/scan.js

@@ -7,6 +7,7 @@ import { configFromPartial, loadConfig } from "./config.js";
 import { discoverHosts, envInt, ollamaPort, shortName, } from "./hosts.js";
 import { lastScanPath, loadLastScan, saveLastScan } from "./scan-store.js";
 import { looksTuned } from "./tuned.js";
+import { isHelpFlag, printHelp } from "./argv.js";
 function scanTimeoutMs() {
     return envInt("OLLAMA_TIMEOUT_MS", 2500);
 }
@@ -184,7 +185,30 @@ export async function scanNetwork(options = {}) {
     }
     return payload;
 }
+export function helpText() {
+    return `Usage:
+  ollanet scan [--json] [--all] [--lan] [--last]
+
+Examples:
+  ollanet scan
+  ollanet scan --lan
+  ollanet scan --last
+  ollanet scan --json
+
+Discovers Ollama hosts (localhost, config, OLLANET_HOSTS, Tailscale) and lists
+models. --lan is an opt-in TCP sweep of local /24s on port 11434.
+
+Options:
+  --json     Machine-readable output
+  --all      Also probe offline Tailscale peers
+  --lan      TCP-scan local LAN CIDRs for open Ollama ports
+  --last     Reprint the last saved scan (no network)
+  --cached   Same as --last`;
+}
 export async function main() {
+    if (process.argv.slice(2).some((arg) => isHelpFlag(arg))) {
+        printHelp(helpText());
+    }
     const includeOffline = process.argv.includes("--all");
     const jsonOut = process.argv.includes("--json");
     const lanScan = process.argv.includes("--lan");

package/dist/show.d.ts

@@ -5,6 +5,7 @@
  */
 import { type OllamaShowInfo } from "./ollama-chat.js";
 import type { AppConfig } from "./config.js";
+export declare function helpText(): string;
 export interface ShowOptions {
     machine: string;
     model: string;

package/dist/show.js

@@ -5,13 +5,14 @@
  */
 import { envInt, ollamaBaseUrl, shortName } from "./hosts.js";
 import { ollamaShow } from "./ollama-chat.js";
+import { failUsage, isHelpFlag, printHelp, takeFlag } from "./argv.js";
 import { resolveTarget } from "./target.js";
 import { looksTuned } from "./tuned.js";
 function showTimeoutMs() {
     return envInt("OLLAMA_SHOW_TIMEOUT_MS", 30_000);
 }
-function usage() {
-    console.error(`Usage:
+export function helpText() {
+    return `Usage:
   ollanet show <machine> <model>
   ollanet show --machine <name> --model <name>
 
@@ -25,16 +26,10 @@ Tuned Finetuna-style names are marked [tuned].
 Options:
   --machine <name>   Host (discovered name, MagicDNS, hostname, or IP[:port])
   --model <name>     Model to inspect
-  --json             Emit result JSON on stdout`);
-    process.exit(1);
+  --json             Emit result JSON on stdout`;
 }
-function takeValue(args, flag) {
-    const value = args.shift();
-    if (!value) {
-        console.error(`${flag} requires a value`);
-        usage();
-    }
-    return value;
+function usage() {
+    failUsage(helpText());
 }
 function parseArgs(argv) {
     const args = [...argv];
@@ -46,18 +41,20 @@ function parseArgs(argv) {
         const arg = args.shift();
         if (arg === "--")
             continue;
-        if (arg === "--help" || arg === "-h")
-            usage();
+        if (isHelpFlag(arg))
+            printHelp(helpText());
         if (arg === "--json") {
             json = true;
             continue;
         }
-        if (arg === "--machine") {
-            machineFlag = takeValue(args, "--machine");
+        const machine = takeFlag(arg, "--machine", args, usage);
+        if (machine !== undefined) {
+            machineFlag = machine;
             continue;
         }
-        if (arg === "--model") {
-            modelFlag = takeValue(args, "--model");
+        const model = takeFlag(arg, "--model", args, usage);
+        if (model !== undefined) {
+            modelFlag = model;
             continue;
         }
         if (arg.startsWith("-")) {

package/dist/target.d.ts

@@ -1,4 +1,6 @@
 import { type AppConfig } from "./config.js";
 import { type HostTarget } from "./hosts.js";
+/** Discover hosts the same way every command does (config + Tailscale + …). */
+export declare function listTargets(config?: Partial<AppConfig>): Promise<HostTarget[]>;
 /** Resolve a machine name the same way pull / prompt / bench do. */
 export declare function resolveTarget(machine: string, config?: Partial<AppConfig>): Promise<HostTarget>;

package/dist/target.js

@@ -1,15 +1,20 @@
 import { configFromPartial, loadConfig } from "./config.js";
 import { discoverHosts, resolveHost, shortName } from "./hosts.js";
-/** Resolve a machine name the same way pull / prompt / bench do. */
-export async function resolveTarget(machine, config) {
-    const query = machine.trim();
-    if (!query)
-        throw new Error("Machine is required.");
+/** Discover hosts the same way every command does (config + Tailscale + …). */
+export async function listTargets(config) {
     const app = config ? configFromPartial(config) : await loadConfig();
     const { hosts } = await discoverHosts({
         hosts: app.hosts,
         discovery: app.discovery,
     });
+    return hosts;
+}
+/** Resolve a machine name the same way pull / prompt / bench do. */
+export async function resolveTarget(machine, config) {
+    const query = machine.trim();
+    if (!query)
+        throw new Error("Machine is required.");
+    const hosts = await listTargets(config);
     const host = resolveHost(hosts, query);
     if (!host.online && !host.isSelf && host.source === "tailscale") {
         throw new Error(`Machine "${shortName(host)}" appears offline.`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ollanet",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Discover and talk to Ollama on any reachable network — CLI, MCP, and a Node library",
   "type": "module",
   "bin": {