@agentvalet/register 0.4.0 → 0.4.2

package/dist/index.js

@@ -193,7 +193,7 @@ async function saveOutput(opts) {
 // src/commands/refresh.ts
 import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync2, mkdirSync, statSync } from "fs";
 import { createSign, createPrivateKey } from "crypto";
-import { dirname as dirname2, resolve as resolve2 } from "path";
+import { dirname as dirname2, resolve as resolve2, join } from "path";
 
 // src/lib/skill-writer.ts
 import { existsSync, writeFileSync } from "fs";
@@ -277,6 +277,84 @@ Dashboard: https://app.agentvalet.ai
   console.log(chalk2.green("  \u2713 SKILL.md created in current directory"));
   console.log(chalk2.dim("    Commit this file to your repo"));
 }
+function writeQuickstartDoc(opts) {
+  const dest = path.join(process.cwd(), "AGENTVALET.md");
+  if (existsSync(dest)) {
+    console.log(chalk2.dim("  AGENTVALET.md already exists \u2014 skipping"));
+    return;
+  }
+  const { agentId, ownerId, proxyUrl, keyPath, detected } = opts;
+  const ideSection = (() => {
+    const lines = [];
+    if (detected.cursor) {
+      lines.push(`### Cursor
+The \`.mcp.json\` in this directory has been configured. Restart Cursor and the AgentValet MCP server will start automatically.`);
+    }
+    if (detected.claudeCode) {
+      lines.push(`### Claude Code
+The \`.mcp.json\` in this directory has been configured. Run \`/mcp\` in Claude Code to verify \`agentvalet\` appears in the list.`);
+    }
+    if (detected.codex) {
+      lines.push(`### Codex
+\`~/.codex/config.toml\` has been updated with the MCP server block. See \`AGENTS.md\` for platform call instructions.`);
+    }
+    if (detected.openclaw) {
+      lines.push(`### OpenClaw
+See \`SKILL.md\` for platform call instructions.`);
+    }
+    if (lines.length === 0) {
+      lines.push(`Add the MCP server to your IDE manually. See: https://docs.agentvalet.ai/setup`);
+    }
+    return lines.join("\n\n");
+  })();
+  const content = `# AgentValet \u2014 Quick Reference
+
+## This agent
+
+| | |
+|---|---|
+| Agent ID | \`${agentId}\` |
+| Owner ID | \`${ownerId}\` |
+| Proxy URL | \`${proxyUrl}\` |
+| Private key | \`${keyPath}\` |
+
+Dashboard: https://app.agentvalet.ai
+Activate or manage this agent at: https://app.agentvalet.ai/agents
+
+---
+
+## CLI commands
+
+| Command | What it does |
+|---|---|
+| \`npx @agentvalet/register\` | Register a new agent or re-run setup |
+| \`npx @agentvalet/register refresh\` | Refresh approved platform permissions |
+
+> These commands use \`npx\` \u2014 you do not need to install the package globally.
+
+---
+
+## IDE setup
+
+${ideSection}
+
+---
+
+## Environment variables
+
+Set these wherever your IDE agent reads environment from:
+
+\`\`\`
+AGENT_ID=${agentId}
+OWNER_ID=${ownerId}
+PROXY_URL=${proxyUrl}
+AGENT_PRIVATE_KEY_PATH=${keyPath}
+\`\`\`
+`;
+  writeFileSync(dest, content, "utf8");
+  console.log(chalk2.green("  \u2713 AGENTVALET.md created \u2014 quick reference for this agent"));
+  console.log(chalk2.dim("    Add to .gitignore if it contains sensitive paths"));
+}
 function ensureMcpServer() {
   try {
     execSync("npx --yes @agentvalet/mcp-server --version", {
@@ -328,10 +406,28 @@ mcp__agent-authority__use_platform({
 })
 \`\`\`
 
-To refresh this file: \`agentvalet-register refresh\`
+To refresh this file: \`npx @agentvalet/register refresh\`
 `;
 }
 
+// src/config/store.ts
+import Conf from "conf";
+var store = new Conf({
+  projectName: "agentvalet"
+});
+function getStoredConfig() {
+  return store.store;
+}
+function saveConfig(config) {
+  store.set(config);
+}
+function clearConfig() {
+  store.clear();
+}
+function isAuthenticated() {
+  return !!store.get("apiKey");
+}
+
 // src/commands/refresh.ts
 var CLAUDE_START = "<!-- agentvalet:start -->";
 var CLAUDE_END = "<!-- agentvalet:end -->";
@@ -385,20 +481,44 @@ async function runRefresh(options) {
     } catch {
     }
   }
+  let agentId;
+  let ownerId;
+  let apiUrl = "https://api.agentvalet.ai";
+  let keyPath;
   const envPath = resolve2(options.envFile);
-  let envVars;
-  try {
-    envVars = parseEnvFile(readFileSync2(envPath, "utf-8"));
-  } catch {
-    throw new Error(`Cannot read env file: ${envPath}
-Run 'agentvalet-register' first to create it.`);
+  if (existsSync2(envPath)) {
+    try {
+      const envVars = parseEnvFile(readFileSync2(envPath, "utf-8"));
+      agentId = envVars["AGENTVALET_AGENT_ID"];
+      ownerId = envVars["AGENTVALET_OWNER_ID"];
+      apiUrl = envVars["AGENTVALET_API_URL"] ?? apiUrl;
+      keyPath = envVars["AGENTVALET_PRIVATE_KEY_PATH"];
+    } catch {
+    }
+  }
+  if (!agentId || !ownerId || !keyPath) {
+    const localConfigPath = join(process.cwd(), ".agentvalet", "config.json");
+    if (existsSync2(localConfigPath)) {
+      try {
+        const local = JSON.parse(readFileSync2(localConfigPath, "utf-8"));
+        agentId = agentId ?? local["agent_id"];
+        apiUrl = local["proxy_url"] ?? apiUrl;
+        keyPath = keyPath ?? join(process.cwd(), ".agentvalet", "agent.key");
+      } catch {
+      }
+    }
+    if (!ownerId) {
+      try {
+        ownerId = getStoredConfig().ownerId ?? void 0;
+      } catch {
+      }
+    }
   }
-  const agentId = envVars["AGENTVALET_AGENT_ID"];
-  const ownerId = envVars["AGENTVALET_OWNER_ID"];
-  const apiUrl = envVars["AGENTVALET_API_URL"] ?? "https://api.agentvalet.ai";
-  const keyPath = envVars["AGENTVALET_PRIVATE_KEY_PATH"];
   if (!agentId || !ownerId || !keyPath) {
-    throw new Error(`Env file is missing required keys (AGENTVALET_AGENT_ID, AGENTVALET_OWNER_ID, AGENTVALET_PRIVATE_KEY_PATH)`);
+    throw new Error(
+      `Cannot find agent credentials.
+Run 'npx @agentvalet/register' in this directory first.`
+    );
   }
   let privateKeyPem;
   try {
@@ -498,22 +618,43 @@ function ensureMcpJson() {
   }
   const servers = mcpConfig.mcpServers ?? {};
   if (servers["agent-authority"]) return;
+  let agentId;
+  let ownerId;
+  let apiUrl = "https://api.agentvalet.ai";
+  let keyPath;
   const envPath = resolve2(".env.agentvalet");
-  if (!existsSync2(envPath)) return;
-  let envVars;
-  try {
-    envVars = parseEnvFile(readFileSync2(envPath, "utf-8"));
-  } catch {
-    return;
+  if (existsSync2(envPath)) {
+    try {
+      const envVars = parseEnvFile(readFileSync2(envPath, "utf-8"));
+      agentId = envVars["AGENTVALET_AGENT_ID"];
+      ownerId = envVars["AGENTVALET_OWNER_ID"];
+      apiUrl = envVars["AGENTVALET_API_URL"] ?? apiUrl;
+      keyPath = envVars["AGENTVALET_PRIVATE_KEY_PATH"];
+    } catch {
+    }
+  }
+  if (!agentId || !keyPath) {
+    const localConfigPath = join(process.cwd(), ".agentvalet", "config.json");
+    if (existsSync2(localConfigPath)) {
+      try {
+        const local = JSON.parse(readFileSync2(localConfigPath, "utf-8"));
+        agentId = agentId ?? local["agent_id"];
+        apiUrl = local["proxy_url"] ?? apiUrl;
+        keyPath = keyPath ?? join(process.cwd(), ".agentvalet", "agent.key");
+      } catch {
+      }
+    }
+    if (!ownerId) {
+      try {
+        ownerId = getStoredConfig().ownerId ?? void 0;
+      } catch {
+      }
+    }
   }
-  const agentId = envVars["AGENTVALET_AGENT_ID"];
-  const ownerId = envVars["AGENTVALET_OWNER_ID"];
-  const apiUrl = envVars["AGENTVALET_API_URL"] ?? "https://api.agentvalet.ai";
-  const keyPath = envVars["AGENTVALET_PRIVATE_KEY_PATH"];
   if (!agentId || !ownerId || !keyPath) return;
   servers["agent-authority"] = {
     command: "npx",
-    args: ["-y", "@agentvalet/register@0.2.2", "mcp-server"],
+    args: ["-y", "@agentvalet/register", "mcp-server"],
     env: {
       AGENT_ID: agentId,
       OWNER_ID: ownerId,
@@ -667,24 +808,6 @@ async function getAccount(apiKey) {
   }
 }
 
-// src/config/store.ts
-import Conf from "conf";
-var store = new Conf({
-  projectName: "agentvalet"
-});
-function getStoredConfig() {
-  return store.store;
-}
-function saveConfig(config) {
-  store.set(config);
-}
-function clearConfig() {
-  store.clear();
-}
-function isAuthenticated() {
-  return !!store.get("apiKey");
-}
-
 // src/config/local.ts
 import { mkdir as mkdir2, writeFile as writeFile2, appendFile, readFile } from "fs/promises";
 import path2 from "path";
@@ -1164,6 +1287,13 @@ async function registerAgentFlow(apiKey, ownerId) {
     if (detected.openclaw) {
       writeSkillMd();
     }
+    writeQuickstartDoc({
+      agentId: agent.agent_id,
+      ownerId,
+      proxyUrl,
+      keyPath,
+      detected
+    });
     ensureMcpServer();
   } else if (shouldSetup === false) {
     console.log("");
@@ -1190,6 +1320,10 @@ async function registerAgentFlow(apiKey, ownerId) {
   );
   console.log(chalk6.dim("  Approve this agent in your dashboard to activate it."));
   console.log("");
+  console.log("  Useful commands:");
+  console.log(chalk6.dim("    npx @agentvalet/register          \u2014 register another agent"));
+  console.log(chalk6.dim("    npx @agentvalet/register refresh  \u2014 refresh approved permissions"));
+  console.log("");
 }
 function showCredentials(config) {
   console.log("");
@@ -1206,7 +1340,7 @@ function collectScope(value, previous) {
   return [...previous, value];
 }
 var program = new Command();
-program.name("agentvalet-register").description("Self-register an AI agent with AgentValet").version("0.4.0").option("--owner <uuid>", "Owner ID (or set AGENTVALET_OWNER env var)").option("--name <name>", "Agent name").option("--description <desc>", "Agent description").option("--scope <platform:scope>", "Requested scope, repeatable", collectScope, []).option("--api-url <url>", "AgentValet API base URL", "https://api.agentvalet.ai").option("--output <path>", "Path to write .env file", "./.env.agentvalet").option("--key-path <path>", "Path to write private key", "./agentvalet.key").option("--json", "Machine-readable JSON output").option("--no-wait", "Register only, do not wait for approval").option("--timeout <seconds>", "Approval wait timeout in seconds", "300").action(async (opts) => {
+program.name("agentvalet-register").description("Self-register an AI agent with AgentValet").version("0.4.1").option("--owner <uuid>", "Owner ID (or set AGENTVALET_OWNER env var)").option("--name <name>", "Agent name").option("--description <desc>", "Agent description").option("--scope <platform:scope>", "Requested scope, repeatable", collectScope, []).option("--api-url <url>", "AgentValet API base URL", "https://api.agentvalet.ai").option("--output <path>", "Path to write .env file", "./.env.agentvalet").option("--key-path <path>", "Path to write private key", "./agentvalet.key").option("--json", "Machine-readable JSON output").option("--no-wait", "Register only, do not wait for approval").option("--timeout <seconds>", "Approval wait timeout in seconds", "300").action(async (opts) => {
   const isJson = !!opts.json;
   let ownerId = opts.owner ?? process.env.AGENTVALET_OWNER ?? "";
   let agentName = opts.name ?? "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentvalet/register",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Self-register AI agents with AgentValet",
   "type": "module",
   "bin": {