archymedes-cli 2.6.0 → 3.1.0

package/bin/archymedes.mjs

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+// The `archymedes` command, as npm installs it.
+//
+// The interface is a Go binary, shipped per platform as an optional dependency
+// (@archymedes/cli-<platform>-<arch>); launcher.mjs decides whether it is usable. The agent behind
+// it is the bundled dist/archymedes.mjs, run with this same Node: the binary is told where it is
+// through ARCHYMEDES_AGENT, as a JSON array so an install path with spaces survives.
+//
+// Where the binary cannot be used, the bundled agent runs alone: every non-interactive mode works as
+// before, and asked for the interface it says why there is none and how to get it.
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { missingInterfaceNotice, resolveInterface } from "./launcher.mjs";
+
+const require = createRequire(import.meta.url);
+const agentEntry = path.join(import.meta.dirname, "..", "dist", "archymedes.mjs");
+const { platform, arch } = process;
+
+function packageDirectory(name) {
+  try {
+    return path.dirname(require.resolve(`${name}/package.json`));
+  } catch {
+    return undefined;
+  }
+}
+
+async function runAgentAlone(resolution) {
+  // Read by the agent when it is asked for an interface it does not have (src/archymedes.ts).
+  process.env.ARCHYMEDES_INTERFACE_MISSING = missingInterfaceNotice(resolution, platform, arch).join("\n");
+  await import(agentEntry);
+}
+
+const resolution = resolveInterface({
+  platform, arch, override: process.env.ARCHYMEDES_GO_BINARY,
+  resolvePackage: packageDirectory, exists: existsSync, join: path.join,
+});
+
+if (!("binary" in resolution)) {
+  await runAgentAlone(resolution);
+} else {
+  const env = { ...process.env, ARCHYMEDES_AGENT: process.env.ARCHYMEDES_AGENT || JSON.stringify([process.execPath, agentEntry]) };
+  const child = spawn(resolution.binary, process.argv.slice(2), { stdio: "inherit", env });
+
+  // The terminal sends Ctrl+C and Ctrl+\ to the whole process group, so the interface already has
+  // them and decides what they mean (stop a turn, not quit). This process only waits. A signal
+  // aimed at this process alone is passed on.
+  for (const signal of ["SIGINT", "SIGQUIT"]) process.on(signal, () => {});
+  for (const signal of ["SIGTERM", "SIGHUP"]) process.on(signal, () => child.kill(signal));
+
+  child.on("error", (error) => {
+    // Present but not runnable: a stripped executable bit, a foreign architecture under emulation.
+    void runAgentAlone({ reason: "start-failed", detail: error.code ?? error.message });
+  });
+  child.on("exit", (code, signal) => {
+    if (signal) {
+      process.removeAllListeners(signal);
+      process.kill(process.pid, signal);
+      return;
+    }
+    process.exit(code ?? 1);
+  });
+}

package/bin/launcher.d.mts

@@ -0,0 +1,21 @@
+export declare const PUBLISHED_PLATFORMS: readonly string[];
+export declare function interfacePackage(platform: string, arch: string): string;
+
+export type Resolution =
+  | { binary: string }
+  | { reason: "unsupported" | "not-installed" | "missing-binary"; packageName: string };
+
+export declare function resolveInterface(options: {
+  platform: string;
+  arch: string;
+  override?: string;
+  resolvePackage: (name: string) => string | undefined;
+  exists: (path: string) => boolean;
+  join: (...parts: string[]) => string;
+}): Resolution;
+
+export declare function missingInterfaceNotice(
+  resolution: Resolution | { reason: "start-failed"; detail: string },
+  platform: string,
+  arch: string,
+): string[];

package/bin/launcher.mjs

@@ -0,0 +1,54 @@
+// What `archymedes` runs, decided before anything is drawn: the Go interface for this platform, or
+// — where it cannot be used — the bundled agent alone, which still serves every non-interactive mode. Pure apart from the lookups passed in, so
+// every outcome is testable without installing anything (tooling/build/launcher.test.ts).
+
+/** The platforms a Go interface is published for, as `${process.platform}-${process.arch}`. */
+export const PUBLISHED_PLATFORMS = ["darwin-arm64", "darwin-x64", "linux-arm64", "linux-x64", "win32-arm64", "win32-x64"];
+
+export const interfacePackage = (platform, arch) => `@archymedes/cli-${platform}-${arch}`;
+
+/**
+ * @param {{ platform: string, arch: string, override?: string,
+ *           resolvePackage: (name: string) => string | undefined,
+ *           exists: (path: string) => boolean,
+ *           join: (...parts: string[]) => string }} options
+ * @returns {{ binary: string } | { reason: "unsupported" | "not-installed" | "missing-binary", packageName: string }}
+ */
+export function resolveInterface({ platform, arch, override, resolvePackage, exists, join }) {
+  if (override) return { binary: override };
+  const packageName = interfacePackage(platform, arch);
+  if (!PUBLISHED_PLATFORMS.includes(`${platform}-${arch}`)) return { reason: "unsupported", packageName };
+  // resolvePackage returns the package's directory, or undefined when npm did not install it.
+  const directory = resolvePackage(packageName);
+  if (!directory) return { reason: "not-installed", packageName };
+  const binary = join(directory, "bin", platform === "win32" ? "archymedes.exe" : "archymedes");
+  return exists(binary) ? { binary } : { reason: "missing-binary", packageName };
+}
+
+/**
+ * Why there is no interactive interface, the one command that fixes it, and what still works.
+ *
+ * The bundled agent shows it only when someone asks it for the interface (no request): a one-shot
+ * run, `--json` or `settings` work the same with or without the binary, so they say nothing.
+ */
+export function missingInterfaceNotice(resolution, platform, arch) {
+  const reinstall = "npm install -g archymedes-cli@latest";
+  const works = `  Without it, only non-interactive modes work: archymedes "your request", --json, settings, history, doctor, update.`;
+  switch (resolution.reason) {
+    case "unsupported":
+      return [`archymedes: no interactive interface is published for ${platform}-${arch}.`, works];
+    case "not-installed":
+      return [
+        `archymedes: the interactive interface (${resolution.packageName}) was not installed.`,
+        `  npm skips it when optional dependencies are off, or when the install ran before it reached the registry.`,
+        `  Fix: ${reinstall}`,
+        works,
+      ];
+    case "missing-binary":
+      return [`archymedes: ${resolution.packageName} is installed without its binary.`, `  Fix: ${reinstall}`, works];
+    case "start-failed":
+      return [`archymedes: the interactive interface could not start (${resolution.detail}).`, `  Fix: ${reinstall}`, works];
+    default:
+      return [];
+  }
+}

package/dist/{archymedes-06fh0z84.mjs → archymedes-95xvcvww.mjs}

@@ -8995,9 +8995,6 @@ function isWanderObjective(objective) {
 function isWanderRandomScheduleObjective(objective) {
   return /^\[Wander\]\s+cadence=(daily|weekly)\s+topic=random\s*$/i.test(objective.trim());
 }
-function buildWanderScheduleObjective(cadence) {
-  return `${WANDER_MARKER} cadence=${cadence} topic=random`;
-}
 function pickWanderTopic(seed = `${Date.now()}`) {
   let hash = 2166136261;
   for (let index2 = 0;index2 < seed.length; index2 += 1) {
@@ -9071,4 +9068,4 @@ function wanderGradeCounts(results) {
   return WANDER_GRADES.map((grade) => ({ grade, count: results.claims.filter((claim) => claim.grade === grade).length }));
 }
 
-export { approximateInputTokens, newPartTotals, addPart, tokenEstimateFrom, affordableOutputTokensFor, affordableOutputTokens, priceActualModelUsage, modelPricesFromEnvironment, TASK_KINDS, buildTaskProfile, mergeRoutingReceipts, capabilitiesFor, DEFAULT_OUTPUT_CEILING, PROTOCOL_MAX_OUTPUT_TOKENS, DEFAULT_TOTAL_TIMEOUT_MS, StreamTimeoutError, streamTimeoutsFor, createStreamDeadline, APIConnectionError, makeParseableTextFormat, OpenAI, toWireMessages, withOpenRouterCacheControl, turnFromChatResponse, collectChatStream, OpenAIAgentTurnProvider, WANDER_MARKER, WANDER_LAB_FILES, isWanderObjective, isWanderRandomScheduleObjective, buildWanderScheduleObjective, pickWanderTopic, buildWanderObjective, wanderPlannerInstructions, WANDER_GRADES, parseWanderResults, wanderGradeCounts };
+export { approximateInputTokens, newPartTotals, addPart, tokenEstimateFrom, affordableOutputTokensFor, affordableOutputTokens, priceActualModelUsage, modelPricesFromEnvironment, TASK_KINDS, buildTaskProfile, mergeRoutingReceipts, capabilitiesFor, DEFAULT_OUTPUT_CEILING, PROTOCOL_MAX_OUTPUT_TOKENS, DEFAULT_TOTAL_TIMEOUT_MS, StreamTimeoutError, streamTimeoutsFor, createStreamDeadline, APIConnectionError, makeParseableTextFormat, OpenAI, toWireMessages, withOpenRouterCacheControl, turnFromChatResponse, collectChatStream, OpenAIAgentTurnProvider, WANDER_MARKER, WANDER_LAB_FILES, isWanderObjective, isWanderRandomScheduleObjective, pickWanderTopic, buildWanderObjective, wanderPlannerInstructions, WANDER_GRADES, parseWanderResults, wanderGradeCounts };