feral-agent 2026.6.31 → 2026.7.19

package/bin/feral.js

@@ -1,2 +1,72 @@
-#!/usr/bin/env bun
-import '../dist/feral-agent.js';
+#!/usr/bin/env node
+// Feral launcher — cross-platform. npm guarantees node (not bun), so this thin
+// shim (node) locates the bundled Rust `feral` binary for the host platform and
+// execs it; the Rust binary in turn spawns the TS sidecar sitting NEXT TO it in
+// the same package. The user only ever types `feral ...`; Rust/Bun/sidecar/
+// gateway are internal.
+//
+// Distribution model (esbuild/swc-style): the platform binaries do NOT ship in
+// this package. They live in per-platform packages — `feral-agent-<os>-<arch>`
+// — declared as optionalDependencies. npm installs only the one whose `os`/`cpu`
+// matches the host and skips the rest, so a mac user never downloads the Windows
+// binary. This shim resolves whichever one got installed.
+//
+// ESM (package.json has "type": "module").
+import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+import { join, dirname } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const ext = process.platform === "win32" ? ".exe" : "";
+
+// 1. Production: the matching per-platform package (an optionalDependency).
+const platformPkg = `@bloommedia/feral-agent-${process.platform}-${process.arch}`;
+let exe = null;
+try {
+  exe = require.resolve(`${platformPkg}/feral-cli${ext}`);
+} catch {
+  /* package not installed for this platform — fall through to the dev path */
+}
+
+// 2. Dev / manual build: binaries staged in ./vendor next to this shim
+//    (what `node scripts/package-win.mjs` produces for a local Windows build).
+if (!exe || !existsSync(exe)) {
+  const local = join(here, "..", "vendor", `feral-cli${ext}`);
+  if (existsSync(local)) exe = local;
+}
+
+if (!exe || !existsSync(exe)) {
+  process.stderr.write(
+    `Feral could not find its runtime for ${process.platform}-${process.arch}.\n` +
+      `The matching package \`${platformPkg}\` may have failed to install ` +
+      "(a blocked optional dependency, an unsupported platform, or " +
+      "`--ignore-optional`).\n" +
+      "Reinstall with: npm install -g feral-agent\n" +
+      "Report: https://github.com/bloom500/feral/issues\n",
+  );
+  process.exit(1);
+}
+
+// Report a single coherent version: the npm package version is the source of
+// truth. The Rust `version` command prefers FERAL_VERSION when set.
+let version = "";
+try {
+  const pkg = JSON.parse(readFileSync(join(here, "..", "package.json"), "utf8"));
+  version = pkg.version || "";
+} catch {
+  /* keep empty — Rust falls back to its compiled version */
+}
+
+const res = spawnSync(exe, process.argv.slice(2), {
+  stdio: "inherit",
+  env: version ? { ...process.env, FERAL_VERSION: version } : process.env,
+});
+
+if (res.error) {
+  process.stderr.write(`Feral failed to launch: ${res.error.message}\n`);
+  process.exit(1);
+}
+process.exit(res.status == null ? 1 : res.status);

package/brain.example.json

@@ -1,20 +1,34 @@
 {
-  "//": "Feral Brain Stack config — S5 example. Drop this into ~/.feral/brain.json",
-  "primary": {
-    "provider": "openai_compatible",
-    "model": "qwen2.5:7b",
-    "baseUrl": "http://127.0.0.1:11435"
-  },
-  "fallback": {
-    "provider": "openai_compatible",
-    "model": "claude-sonnet-4-20250514",
-    "baseUrl": "https://api.anthropic.com/v1",
-    "apiKey": "${ANTHROPIC_API_KEY}"
-  },
-  "capabilities": {
-    "vision": false,
-    "offline": true,
-    "coding": true,
-    "reasoning": false
-  }
+  "//": "Feral Brain Stack config — drop into ~/.feral/brain.json (or $FERAL_HOME/brain.json). Loaded by loadBrainConfig(). `feral setup` writes this shape for you.",
+  "enabled": true,
+  "//mode": "budget = prefer cheap/local, balanced = capability weighted by cost, quality = best capability wins",
+  "mode": "balanced",
+  "//offlineModelId": "forced primary when no cloud is reachable (classifier category 'offline')",
+  "offlineModelId": "local",
+  "//registry": "every model Brain Stack may route to. capabilities are 0..10 per skill; cost 1=local/cheap 2=mid 3=premium.",
+  "registry": [
+    {
+      "id": "local",
+      "target": {
+        "provider": "openai_compatible",
+        "model": "qwen2.5:7b",
+        "baseUrl": "http://127.0.0.1:11435"
+      },
+      "capabilities": { "reasoning": 5, "coding": 6, "vision": 0, "speed": 8, "multilingual": 5 },
+      "cost": 1,
+      "local": true
+    },
+    {
+      "id": "cloud",
+      "target": {
+        "provider": "anthropic",
+        "model": "claude-sonnet-4-20250514",
+        "baseUrl": "https://api.anthropic.com/v1",
+        "apiKey": "sk-ant-..."
+      },
+      "capabilities": { "reasoning": 9, "coding": 9, "vision": 7, "speed": 6, "multilingual": 8 },
+      "cost": 3,
+      "local": false
+    }
+  ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feral-agent",
-  "version": "2026.6.31",
+  "version": "2026.7.19",
   "description": "Feral Agent — proactive, portable AI agent with a native security sandbox",
   "type": "module",
   "module": "src/index.ts",
@@ -9,12 +9,10 @@
   },
   "files": [
     "bin",
-    "src",
-    "dist/feral-agent.js",
     "brain.example.json",
     "README.md"
   ],
-  "license": "MIT",
+  "license": "BUSL-1.1",
   "author": "Bloom Media",
   "homepage": "https://github.com/bloom500/feral#readalme",
   "repository": {
@@ -34,7 +32,7 @@
     "llm"
   ],
   "engines": {
-    "bun": ">=1.0.0"
+    "node": ">=18"
   },
   "publishConfig": {
     "access": "public"
@@ -44,24 +42,26 @@
     "dev": "bun --watch run src/index.ts",
     "typecheck": "bunx tsc --noEmit",
     "build": "bun build src/index.ts --compile --outfile dist/feral-agent",
-    "build:js": "bun build src/index.ts --target=bun --outfile dist/feral-agent.js"
+    "build:js": "bun build src/index.ts --target=bun --outfile dist/feral-agent.js",
+    "package:win": "node scripts/package-win.mjs"
   },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "@types/qrcode-terminal": "^0.12.2",
-    "typescript": "^5.6.0"
-  },
-  "peerDependencies": {
-    "typescript": "^5.6.0"
+  "optionalDependencies": {
+    "@bloommedia/feral-agent-win32-x64": "2026.7.19",
+    "@bloommedia/feral-agent-darwin-arm64": "2026.7.19",
+    "@bloommedia/feral-agent-darwin-x64": "2026.7.19",
+    "@bloommedia/feral-agent-linux-x64": "2026.7.19"
   },
-  "dependencies": {
+  "devDependencies": {
     "@slack/socket-mode": "^2.0.7",
     "@slack/web-api": "^7.17.0",
     "@whiskeysockets/baileys": "^7.0.0-rc13",
+    "@types/bun": "latest",
+    "@types/qrcode-terminal": "^0.12.2",
     "cron-parser": "^5.5.0",
     "discord.js": "^14.26.4",
     "gpt-tokenizer": "^3.4.0",
-    "qrcode-terminal": "^0.12.0"
+    "qrcode-terminal": "^0.12.0",
+    "typescript": "^5.6.0"
   },
   "overrides": {
     "undici": ">=6.27.0"