aos-harness 0.8.0 → 0.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aos-harness",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Agentic Orchestration System — assemble AI agents into deliberation and execution teams",
   "license": "MIT",
   "publishConfig": {
@@ -38,18 +38,18 @@
     "test": "bun run src/index.ts validate"
   },
   "dependencies": {
-    "@aos-harness/adapter-shared": "0.8.0",
-    "@aos-harness/runtime": "0.8.0",
+    "@aos-harness/adapter-shared": "0.8.1",
+    "@aos-harness/runtime": "0.8.1",
     "@clack/prompts": "^1.2.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "js-yaml": "^4.1.0",
     "yaml": "^2.8.3"
   },
   "peerDependencies": {
-    "@aos-harness/claude-code-adapter": ">=0.8.0 <1.0.0",
-    "@aos-harness/codex-adapter": ">=0.8.0 <1.0.0",
-    "@aos-harness/gemini-adapter": ">=0.8.0 <1.0.0",
-    "@aos-harness/pi-adapter": ">=0.8.0 <1.0.0"
+    "@aos-harness/claude-code-adapter": ">=0.8.1 <1.0.0",
+    "@aos-harness/codex-adapter": ">=0.8.1 <1.0.0",
+    "@aos-harness/gemini-adapter": ">=0.8.1 <1.0.0",
+    "@aos-harness/pi-adapter": ">=0.8.1 <1.0.0"
   },
   "peerDependenciesMeta": {
     "@aos-harness/claude-code-adapter": {

package/src/adapter-session.ts

@@ -14,6 +14,7 @@
 
 import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
+import { pathToFileURL } from "node:url";
 import { tmpdir } from "node:os";
 import { readFileSync } from "node:fs";
 import readline from "node:readline";
@@ -31,6 +32,7 @@ import { loadAgent } from "@aos-harness/runtime/config-loader";
 import { resolveTemplate } from "@aos-harness/runtime/template-resolver";
 import { startBridgeServer } from "./bridge-server";
 import { renderTextGauge, renderRoundOneLiner } from "./gauges";
+import { getAdapterDir } from "./utils";
 
 export interface AdapterSessionConfig {
   platform: string; // "claude-code" | "gemini" | "codex"
@@ -147,29 +149,30 @@ async function loadAdapterRuntime(platform: string): Promise<any> {
   const entry = ADAPTER_MAP[platform];
   if (!entry) throw new Error(`Unknown adapter: ${platform}`);
 
-  async function readAdapterVersion(fromPath: string): Promise<string> {
-    try {
-      const pkgUrl = new URL("../package.json", fromPath).href;
-      const { readFile } = await import("node:fs/promises");
-      const raw = await readFile(new URL(pkgUrl), "utf-8");
-      return (JSON.parse(raw) as { version: string }).version ?? "unknown";
-    } catch {
-      return "unknown";
-    }
+  const adapterDir = getAdapterDir(platform);
+  if (!adapterDir) {
+    printMissingAdapterError(entry.package);
+    process.exit(2);
   }
 
   let mod: any;
   try {
-    mod = await import(entry.package);
+    mod = await import(pathToFileURL(join(adapterDir, "src", "index.ts")).href);
   } catch (err) {
     if (isModuleNotFound(err)) {
       printMissingAdapterError(entry.package);
       process.exit(2);
     }
-    throw err; // real load error — surface it
+    throw err;
+  }
+
+  let version = "unknown";
+  try {
+    const raw = readFileSync(join(adapterDir, "package.json"), "utf-8");
+    version = (JSON.parse(raw) as { version?: string }).version ?? "unknown";
+  } catch {
+    version = "unknown";
   }
-  const resolved = (import.meta as any).resolve?.(entry.package) ?? entry.package;
-  const version = await readAdapterVersion(resolved);
   console.error(`[adapter] loaded ${entry.package}@${version}`);
   maybeWarnVersionMismatch(entry.package, version);
   return mod[entry.className];

package/src/env-scanner.ts

@@ -63,6 +63,7 @@ export interface ScanEnvironmentOptions {
   npmGlobalDir?: string | null;
   probeVendorCli?: (adapter: AdapterName, meta: AdapterMetadata) => Promise<VendorCliReadiness>;
   resolveAdapterDir?: (adapter: AdapterName) => string | null;
+  findBinary?: (name: string) => string | null;
 }
 
 function detectPackageManager(): PackageManager {
@@ -310,6 +311,7 @@ export async function scanEnvironment(options: ScanEnvironmentOptions = {}): Pro
   const resolveAdapterDir = options.resolveAdapterDir ?? getAdapterDir;
   const bunGlobalDir = getBunGlobalDir(env, options.bunGlobalDir);
   const npmGlobalDir = getNpmGlobalDir(env, options.npmGlobalDir);
+  const findBinary = options.findBinary ?? ((name: string) => Bun.which(name) ?? null);
 
   const adapters = {} as Record<AdapterName, AdapterReadiness>;
   const notes: string[] = [];
@@ -341,6 +343,10 @@ export async function scanEnvironment(options: ScanEnvironmentOptions = {}): Pro
   }
 
   const socketPath = getMempalaceSocket(env);
+  const mempalaceBinary = findBinary("mempalace");
+  if (mempalaceBinary && !existsSync(socketPath)) {
+    notes.push(`mempalace: binary found at ${mempalaceBinary}, but socket ${socketPath} was not detected. Set MEMPALACE_SOCKET if MemPalace uses a custom socket path.`);
+  }
 
   return {
     packageManager: detectPackageManager(),
@@ -349,6 +355,8 @@ export async function scanEnvironment(options: ScanEnvironmentOptions = {}): Pro
       mempalace: {
         available: existsSync(socketPath),
         socketPath,
+        binaryInstalled: !!mempalaceBinary,
+        binaryPath: mempalaceBinary ?? undefined,
       },
     },
     notes,

package/src/init-types.ts

@@ -39,6 +39,8 @@ export interface AdapterReadiness {
 export interface MemoryBackendScan {
   available: boolean;
   socketPath: string;
+  binaryInstalled: boolean;
+  binaryPath?: string;
 }
 
 export interface ScanReport {

package/src/prompts.ts

@@ -38,6 +38,11 @@ function formatAdapterLine(adapter: AdapterName, readiness: AdapterReadiness): s
 }
 
 export function renderScanReport(scan: ScanReport): string {
+  const memorySummary = scan.memory.mempalace.available
+    ? `available (${scan.memory.mempalace.socketPath})`
+    : scan.memory.mempalace.binaryInstalled
+      ? `installed at ${scan.memory.mempalace.binaryPath}; socket not detected at ${scan.memory.mempalace.socketPath}`
+      : `not-detected (${scan.memory.mempalace.socketPath})`;
   const lines = [
     `Package manager: ${scan.packageManager}`,
     "",
@@ -49,9 +54,7 @@ export function renderScanReport(scan: ScanReport): string {
   }
 
   lines.push("");
-  lines.push(
-    `Memory: mempalace ${scan.memory.mempalace.available ? "available" : "not-detected"} (${scan.memory.mempalace.socketPath})`,
-  );
+  lines.push(`Memory: mempalace ${memorySummary}`);
 
   if (scan.notes.length > 0) {
     lines.push("");

package/src/utils.ts

@@ -5,6 +5,7 @@
 import { join, normalize, resolve, sep, dirname } from "node:path";
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
 
 
 /**
@@ -129,7 +130,65 @@ export function detectProject(startDir: string): string | null {
  *    (via import.meta.resolve). Post-0.6.0 this is the primary path —
  *    the CLI no longer bundles adapter source.
  */
-export function getAdapterDir(adapterName: string): string | null {
+function resolvePackageRootFromEntry(pkgName: string, entryRef: string): string | null {
+  const pathRef = entryRef.startsWith("file://") ? fileURLToPath(entryRef) : entryRef;
+  let dir = resolve(pathRef, "..");
+  const fsRoot = resolve("/");
+
+  while (dir !== fsRoot) {
+    const pkgJson = join(dir, "package.json");
+    if (existsSync(pkgJson)) {
+      try {
+        const contents = JSON.parse(readFileSync(pkgJson, "utf-8")) as { name?: string };
+        if (contents.name === pkgName) {
+          return dir;
+        }
+      } catch {
+        // Keep walking up.
+      }
+    }
+    const parent = resolve(dir, "..");
+    if (parent === dir) break;
+    dir = parent;
+  }
+
+  return null;
+}
+
+function getGlobalPackageDir(pkgName: string, env: Record<string, string | undefined> = process.env): string | null {
+  const searchRoots = [
+    env.AOS_BUN_GLOBAL_DIR,
+    join(homedir(), ".bun", "install", "global", "node_modules"),
+    env.AOS_NPM_GLOBAL_DIR,
+    env.npm_config_prefix ? join(env.npm_config_prefix, "lib", "node_modules") : null,
+  ].filter((value): value is string => typeof value === "string" && value.length > 0);
+
+  if (!env.AOS_NPM_GLOBAL_DIR && !env.npm_config_prefix) {
+    const npmPrefix = Bun.spawnSync(["npm", "prefix", "-g"], {
+      stdin: "ignore",
+      stdout: "pipe",
+      stderr: "ignore",
+    });
+    const out = npmPrefix.stdout.toString().trim();
+    if (out) {
+      searchRoots.push(join(out, "lib", "node_modules"));
+    }
+  }
+
+  const seen = new Set<string>();
+  for (const root of searchRoots) {
+    if (seen.has(root)) continue;
+    seen.add(root);
+    const candidate = join(root, pkgName);
+    if (existsSync(join(candidate, "package.json"))) {
+      return candidate;
+    }
+  }
+
+  return null;
+}
+
+export function getAdapterDir(adapterName: string, env: Record<string, string | undefined> = process.env): string | null {
   // 1. Monorepo dev layout
   const monorepoDir = resolve(import.meta.dir, "../..", "adapters", adapterName);
   if (existsSync(join(monorepoDir, "src", "index.ts"))) {
@@ -137,42 +196,24 @@ export function getAdapterDir(adapterName: string): string | null {
   }
 
   // 2. Installed @aos-harness/<name>-adapter package
+  const pkgName = `@aos-harness/${adapterName}-adapter`;
   try {
-    const pkgName = `@aos-harness/${adapterName}-adapter`;
     const resolver = (import.meta as any).resolve;
-    if (typeof resolver !== "function") return null;
-    // import.meta.resolve returns a file:// URL to the package's main entry
-    // (e.g., .../node_modules/@aos-harness/pi-adapter/src/index.ts). Strip
-    // to the package root.
-    const mainUrl: string = resolver(pkgName);
-    if (!mainUrl.startsWith("file://")) return null;
-    const mainPath = mainUrl.slice("file://".length);
-    // Walk up until we find a package.json with the matching name
-    let dir = resolve(mainPath, "..");
-    const fsRoot = resolve("/");
-    while (dir !== fsRoot) {
-      const pkgJson = join(dir, "package.json");
-      if (existsSync(pkgJson)) {
-        try {
-          // Confirm it's the right package; if so, return dir.
-          const contents = JSON.parse(
-            require("node:fs").readFileSync(pkgJson, "utf-8"),
-          ) as { name?: string };
-          if (contents.name === pkgName) {
-            if (existsSync(join(dir, "src", "index.ts"))) return dir;
-          }
-        } catch {
-          // Fall through — keep walking up.
-        }
+    if (typeof resolver === "function") {
+      const resolvedDir = resolvePackageRootFromEntry(pkgName, resolver(pkgName));
+      if (resolvedDir && existsSync(join(resolvedDir, "src", "index.ts"))) {
+        return resolvedDir;
       }
-      const parent = resolve(dir, "..");
-      if (parent === dir) break;
-      dir = parent;
     }
   } catch {
-    // import.meta.resolve throws if the package isn't installed.
-    return null;
+    // Fall through to explicit global package directory detection.
   }
+
+  const globalDir = getGlobalPackageDir(pkgName, env);
+  if (globalDir && existsSync(join(globalDir, "src", "index.ts"))) {
+    return globalDir;
+  }
+
   return null;
 }