argus-aml 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,15 @@
-# Temporary Holding Version
+# argus-aml
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Add the Argus API's compliance tools to your AI agent.
+
+```bash
+npx argus-aml init
+```
+
+This creates a sandbox key, then adds Argus to Claude Code and Cursor if it finds them. Sandbox results are invented and
+cost nothing.
+
+Use your live key with `npx argus-aml init --key ak_...`.
+
+Your key is saved to `~/.config/argus/key`, readable only by you. For any other MCP client, point it at
+`https://argus.unbackoffice.com/mcp` and send your key in the `X-API-Key` header.

package/bin/init.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+"use strict";
+// npx argus-aml init: get a sandbox key (or take --key) and add the Argus MCP server to the agents on this machine.
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const { spawnSync } = require("child_process");
+
+const API = (process.env.ARGUS_API_URL || "https://argus.unbackoffice.com").replace(/\/$/, "");
+const MCP = API + "/mcp";
+const ok = (s) => console.log("✓ " + s);
+const fail = (s) => { console.error("✗ " + s); process.exit(1); };
+
+function argValue(args, name) {
+  const i = args.indexOf(name);
+  if (i < 0) return "";
+  if (!args[i + 1]) fail(name + " needs a value");
+  return args[i + 1];
+}
+
+async function sandboxKey() {
+  let r;
+  try {
+    r = await fetch(API + "/v1/founder/sandbox-key", { method: "POST" });
+  } catch (e) {
+    fail("Couldn't reach " + API + ". Check your connection and try again.");
+  }
+  const d = await r.json().catch(() => ({}));
+  if (!r.ok || !d.api_key) fail(d.detail || "Couldn't create a sandbox key. Try again shortly.");
+  return d.api_key;
+}
+
+function savedKey() {
+  try {
+    return fs.readFileSync(path.join(os.homedir(), ".config", "argus", "key"), "utf8").trim();
+  } catch (e) {
+    return "";
+  }
+}
+
+function saveKey(key) {
+  const dir = path.join(os.homedir(), ".config", "argus");
+  fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+  const file = path.join(dir, "key");
+  fs.writeFileSync(file, key + "\n", { mode: 0o600 });
+  fs.chmodSync(file, 0o600);
+  return file;
+}
+
+function onPath(cmd) {
+  return spawnSync(process.platform === "win32" ? "where" : "which", [cmd], { stdio: "ignore" }).status === 0;
+}
+
+function addToClaude(key) {
+  if (!onPath("claude")) return false;
+  spawnSync("claude", ["mcp", "remove", "argus", "--scope", "user"], { stdio: "ignore" });
+  const r = spawnSync("claude", ["mcp", "add", "--transport", "http", "--scope", "user", "argus", MCP,
+    "--header", "X-API-Key: " + key], { encoding: "utf8" });
+  if (r.status !== 0) {
+    console.error("✗ Couldn't add Argus to Claude Code: " + ((r.stderr || "").replace(key, "***").trim() || "unknown error"));
+    return false;
+  }
+  return true;
+}
+
+function addToCursor(key) {
+  const dir = path.join(os.homedir(), ".cursor");
+  if (!fs.existsSync(dir)) return false;
+  const file = path.join(dir, "mcp.json");
+  let cfg = {};
+  if (fs.existsSync(file)) {
+    try {
+      cfg = JSON.parse(fs.readFileSync(file, "utf8"));
+    } catch (e) {
+      console.error("✗ Left " + file + " alone: it isn't valid JSON.");
+      return false;
+    }
+  }
+  cfg.mcpServers = { ...(cfg.mcpServers || {}), argus: { url: MCP, headers: { "X-API-Key": key } } };
+  fs.writeFileSync(file, JSON.stringify(cfg, null, 2) + "\n", { mode: 0o600 });
+  fs.chmodSync(file, 0o600);
+  return true;
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  if (args[0] !== "init") {
+    console.log("Usage: npx argus-aml init [--key ak_...]");
+    process.exit(args.length && !["-h", "--help"].includes(args[0]) ? 1 : 0);
+  }
+  // a key saved by an earlier run is kept: running init again must never swap a live key for a sandbox one
+  const given = argValue(args, "--key") || process.env.ARGUS_API_KEY || savedKey();
+  const key = given || (await sandboxKey());
+  ok(given ? "Using your API key" : "Sandbox key created");
+  const file = saveKey(key);
+  ok("Key saved to " + file);
+
+  const added = [];
+  if (addToClaude(key)) added.push("Claude Code");
+  if (addToCursor(key)) added.push("Cursor");
+  if (added.length) {
+    ok("Argus tools added to " + added.join(" and "));
+  } else {
+    console.log("\nNo supported agent found. Add this to any MCP client:");
+    console.log("  URL:    " + MCP);
+    console.log("  Header: X-API-Key: (the key in " + file + ")");
+  }
+  if (added.length) console.log("\nRestart your agent, then try:");
+  else console.log("\nThen try:");
+  console.log("  Screen Sandbox Sanctioned and tell me what happens next.");
+  if (!given) console.log("\nSandbox results are invented. Ask for a live key at " + API + "/developers");
+}
+
+main().catch(() => fail("Something went wrong. Try again."));

package/package.json

@@ -1,6 +1,9 @@
 {
   "name": "argus-aml",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Add the Argus API's compliance tools to your AI agent.",
+  "bin": { "argus-aml": "bin/init.js" },
+  "files": ["bin", "README.md"],
+  "engines": { "node": ">=18" },
+  "license": "UNLICENSED"
+}