orion-super-agent-dev 0.1.38 → 0.1.40

package/bin/launcherName.d.mts

@@ -0,0 +1,2 @@
+// Types for launcherName.mjs — the launcher-name rule bin/orion.js and the app share.
+export function launcherName(argv1: string | undefined): string | null;

package/bin/launcherName.mjs

@@ -0,0 +1,26 @@
+// The name the reader started this app by — `orion`, `orion-dev` or `orion-stage` — read off
+// `process.argv[1]`. Plain ESM on node's own modules alone, so bin/orion.js can answer --help by
+// the right name before the app bundle loads, and the app (services/resumeHint.ts) names the same
+// launcher in the command that reopens a chat. One rule, two readers.
+import { basename } from "node:path";
+
+// The script an installed package runs: `node_modules/orion-super-agent[-<tier>]/bin/orion.js`
+// (the per-tier npm names — scripts/publish-tui.sh). On macOS and Linux npm links the launcher as
+// a symlink named per tier, and that name is what argv[1] holds; on Windows npm writes a `.cmd`
+// shim that runs node on this script, so argv[1] is the script's path and the package directory
+// is what names the tier.
+const INSTALLED_SCRIPT = /[\\/]node_modules[\\/]orion-super-agent(-[a-z]+)?[\\/]bin[\\/]orion\.[cm]?js$/i;
+
+/**
+ * The installed launcher's name, or null for a script run by hand (a checkout's
+ * `node tui/bin/orion.js`), which has no installed name.
+ * @param {string | undefined} argv1 `process.argv[1]`
+ * @returns {string | null}
+ */
+export function launcherName(argv1) {
+  if (!argv1) return null;
+  const name = basename(argv1);
+  if (!/\.[cm]?js$/i.test(name)) return name;
+  const installed = INSTALLED_SCRIPT.exec(argv1);
+  return installed ? `orion${installed[1] ?? ""}` : null;
+}

package/bin/orion.js

@@ -1,11 +1,32 @@
 #!/usr/bin/env node
 // Orion terminal client entry point. Loads the compiled app (out/main.js).
 // During development run `npm run dev` (tsx) instead.
+//
+// The invoked name, not a hardcoded one: this same shim ships as `orion`, `orion-dev`, and
+// `orion-stage` (one bin file, per-tier package.json bin keys), and an error signed by the
+// wrong tier's name would send the user debugging the wrong install.
+import { basename } from "node:path";
+import { createRequire } from "node:module";
+import { launcherName } from "./launcherName.mjs";
+
+const require = createRequire(import.meta.url);
+// The installed name — `orion-dev`, also behind Windows' `.cmd` shim, which runs node on this
+// script — else the script's own name for a run by hand.
+const self = launcherName(process.argv[1]) ?? basename(process.argv[1] || "orion");
+const argv = process.argv.slice(2);
+
+// --help and --version are answered here, before the app bundle loads: neither needs a
+// backend, a config or a terminal, and a reader asking for them should never see the app.
+if (argv.includes("--version") || argv.includes("-v")) {
+  console.log(require("../package.json").version);
+  process.exit(0);
+}
+if (argv.includes("--help") || argv.includes("-h")) {
+  console.log(require("./usage.cjs").usageFor(self));
+  process.exit(0);
+}
+
 import("../out/main.js").catch((err) => {
-  // The invoked name, not a hardcoded one: this same shim ships as `orion`, `orion-dev`, and
-  // `orion-stage` (one bin file, per-tier package.json bin keys), and an error signed by the
-  // wrong tier's name would send the user debugging the wrong install.
-  const self = require("path").basename(process.argv[1] || "orion");
   console.error(self + ": failed to start —", err && err.stack ? err.stack : err);
   process.exit(1);
 });

package/bin/usage.cjs

@@ -0,0 +1,25 @@
+// The launcher's --help text. CommonJS so bin/orion.js can print it before the app bundle
+// loads, and the tests can read the same words.
+
+/** @param {string} name the invoked command name (orion / orion-dev / orion-stage) */
+function usageFor(name) {
+  return [
+    `Usage: ${name} [options] [prompt]`,
+    "",
+    "Start Orion in the current directory. A prompt is sent as the first message.",
+    "",
+    "Options:",
+    "  -c, --continue           Reopen the most recent saved chat",
+    "      --resume <id>        Reopen a saved chat by id (printed when you quit; /resume lists them)",
+    "  -p, --prompt <text>      Send <text> as the first message (same as a bare prompt)",
+    "      --fully-automatic    Turbo: every permission card answered for you — unattended runs only",
+    "      --headless --goal <goal> [--max-turns <n>] [--workspace <dir>] [--model <id>]",
+    "                           Run one goal to completion with no UI; one JSON result line",
+    "  -h, --help               Show this help",
+    "  -v, --version            Show the version",
+    "",
+    "Inside the app: / lists commands, @ mentions a file, ! runs a shell command, ? shows the keys.",
+  ].join("\n");
+}
+
+module.exports = { usageFor };