@agent-play/cli 0.0.1

package/dist/cli.js

@@ -0,0 +1,353 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { mkdir, readFile, unlink, writeFile } from "fs/promises";
+import { homedir } from "os";
+import { join } from "path";
+import { createInterface } from "readline/promises";
+import { stdin as input, stdout as output } from "process";
+function credentialsPath() {
+  return join(homedir(), ".agent-play", "credentials.json");
+}
+async function loadCredentials() {
+  try {
+    const raw = await readFile(credentialsPath(), "utf8");
+    const json = JSON.parse(raw);
+    if (typeof json !== "object" || json === null) return null;
+    const o = json;
+    if (typeof o.serverUrl !== "string" || typeof o.token !== "string") {
+      return null;
+    }
+    return { serverUrl: o.serverUrl.replace(/\/$/, ""), token: o.token };
+  } catch {
+    return null;
+  }
+}
+async function saveCredentials(c) {
+  const dir = join(homedir(), ".agent-play");
+  await mkdir(dir, { recursive: true });
+  await writeFile(
+    credentialsPath(),
+    JSON.stringify({ serverUrl: c.serverUrl, token: c.token }, null, 2),
+    "utf8"
+  );
+}
+function defaultServerUrl() {
+  return process.env.AGENT_PLAY_SERVER_URL ?? "http://127.0.0.1:3000";
+}
+async function cmdLogin() {
+  const rl = createInterface({ input, output });
+  const serverUrl = ((await rl.question(
+    `Server URL [${defaultServerUrl()}]: `
+  )).trim() || defaultServerUrl()).replace(/\/$/, "");
+  const email = (await rl.question("Email: ")).trim();
+  if (email.length === 0) {
+    rl.close();
+    console.error("Email is required.");
+    process.exitCode = 1;
+    return;
+  }
+  const lookupRes = await fetch(`${serverUrl}/api/auth/lookup`, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ email })
+  });
+  const lookupText = await lookupRes.text();
+  if (!lookupRes.ok) {
+    rl.close();
+    console.error(`Lookup failed (${lookupRes.status}): ${lookupText}`);
+    process.exitCode = 1;
+    return;
+  }
+  let lookupJson;
+  try {
+    lookupJson = JSON.parse(lookupText);
+  } catch {
+    rl.close();
+    console.error("Invalid JSON from server.");
+    process.exitCode = 1;
+    return;
+  }
+  const exists = typeof lookupJson === "object" && lookupJson !== null && lookupJson.exists === true;
+  let token;
+  if (exists) {
+    const password = (await rl.question("Password: ")).trim();
+    rl.close();
+    const loginRes = await fetch(`${serverUrl}/api/auth/login`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ email, password })
+    });
+    const loginText = await loginRes.text();
+    if (!loginRes.ok) {
+      console.error(`Login failed (${loginRes.status}): ${loginText}`);
+      process.exitCode = 1;
+      return;
+    }
+    const loginJson = JSON.parse(loginText);
+    if (typeof loginJson.token !== "string") {
+      console.error("Missing token in response.");
+      process.exitCode = 1;
+      return;
+    }
+    token = loginJson.token;
+  } else {
+    const name = (await rl.question("Your name: ")).trim() || "User";
+    const password = (await rl.question("Choose a password (min 8 chars): ")).trim();
+    if (password.length < 8) {
+      rl.close();
+      console.error("Password must be at least 8 characters.");
+      process.exitCode = 1;
+      return;
+    }
+    rl.close();
+    const regRes = await fetch(`${serverUrl}/api/auth/register`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ email, name, password })
+    });
+    const regText = await regRes.text();
+    if (!regRes.ok) {
+      console.error(`Sign up failed (${regRes.status}): ${regText}`);
+      process.exitCode = 1;
+      return;
+    }
+    const regJson = JSON.parse(regText);
+    if (typeof regJson.token !== "string") {
+      console.error("Missing token in response.");
+      process.exitCode = 1;
+      return;
+    }
+    token = regJson.token;
+  }
+  await saveCredentials({ serverUrl, token });
+  console.log(`Signed in. Credentials saved to ${credentialsPath()}`);
+}
+async function cmdLogout() {
+  try {
+    await unlink(credentialsPath());
+    console.log("Logged out.");
+  } catch {
+    console.log("No saved session.");
+  }
+}
+function printAgentPlayIntegrationGuide() {
+  console.log("");
+  console.log("How your agent appears on the play world");
+  console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  console.log(
+    "  \u2022 One account API key: run `agent-play create-key` (after login) if you do not have one yet."
+  );
+  console.log(
+    "  \u2022 LangChain: use langchainRegistration(agent) and pass agent.toolNames to addPlayer."
+  );
+  console.log(
+    '  \u2022 The tool contract requires a tool named "chat_tool" in that list (add it if missing).'
+  );
+  console.log(
+    "  \u2022 Structures on the map are derived from those tool names \u2014 keep them aligned with your real tools."
+  );
+  console.log(
+    "  \u2022 RemotePlayWorld({ apiKey: <account key> }) and addPlayer({ ..., agentId: <id below> })."
+  );
+  console.log("");
+}
+async function cmdCreateKey() {
+  const cred = await loadCredentials();
+  if (cred === null) {
+    console.error("Run `agent-play login` first.");
+    process.exitCode = 1;
+    return;
+  }
+  const res = await fetch(`${cred.serverUrl}/api/agents/api-key`, {
+    method: "POST",
+    headers: {
+      authorization: `Bearer ${cred.token}`
+    }
+  });
+  const text = await res.text();
+  if (!res.ok) {
+    let msg = text;
+    try {
+      const err = JSON.parse(text);
+      if (typeof err.error === "string") msg = err.error;
+    } catch {
+    }
+    console.error(`create-key failed (${res.status}): ${msg}`);
+    process.exitCode = 1;
+    return;
+  }
+  const json = JSON.parse(text);
+  if (typeof json.plainApiKey !== "string") {
+    console.error("Invalid response from server.");
+    process.exitCode = 1;
+    return;
+  }
+  console.log("API key (store securely; shown once):");
+  console.log(json.plainApiKey);
+  console.log("");
+}
+async function cmdViewKeys() {
+  const cred = await loadCredentials();
+  if (cred === null) {
+    console.error("Run `agent-play login` first.");
+    process.exitCode = 1;
+    return;
+  }
+  const res = await fetch(`${cred.serverUrl}/api/agents/api-key`, {
+    headers: { authorization: `Bearer ${cred.token}` }
+  });
+  const text = await res.text();
+  if (!res.ok) {
+    console.error(`view-keys failed (${res.status}): ${text}`);
+    process.exitCode = 1;
+    return;
+  }
+  const json = JSON.parse(text);
+  if (json.hasKey === true) {
+    const when = typeof json.createdAt === "string" ? json.createdAt : "unknown time";
+    console.log(`Account API key: active (created ${when}).`);
+    console.log(
+      "The secret value cannot be shown again. Use the key you saved when you ran `agent-play create-key`."
+    );
+  } else {
+    console.log("No API key for this account.");
+    console.log("Run `agent-play create-key` to generate one (shown once).");
+  }
+}
+async function cmdCreate() {
+  const cred = await loadCredentials();
+  if (cred === null) {
+    console.error("Run `agent-play login` first.");
+    process.exitCode = 1;
+    return;
+  }
+  const rl = createInterface({ input, output });
+  const name = (await rl.question("Agent name: ")).trim() || "agent";
+  rl.close();
+  const res = await fetch(`${cred.serverUrl}/api/agents`, {
+    method: "POST",
+    headers: {
+      "content-type": "application/json",
+      authorization: `Bearer ${cred.token}`
+    },
+    body: JSON.stringify({ name })
+  });
+  const text = await res.text();
+  if (!res.ok) {
+    let msg = text;
+    try {
+      const err = JSON.parse(text);
+      if (typeof err.error === "string") msg = err.error;
+    } catch {
+    }
+    console.error(`Create failed (${res.status}): ${msg}`);
+    process.exitCode = 1;
+    return;
+  }
+  const json = JSON.parse(text);
+  if (typeof json.agentId !== "string") {
+    console.error("Invalid response from server.");
+    process.exitCode = 1;
+    return;
+  }
+  printAgentPlayIntegrationGuide();
+  console.log(`Created agent id: ${json.agentId}`);
+  console.log("");
+}
+async function cmdDelete() {
+  const cred = await loadCredentials();
+  if (cred === null) {
+    console.error("Run `agent-play login` first.");
+    process.exitCode = 1;
+    return;
+  }
+  const listRes = await fetch(`${cred.serverUrl}/api/agents`, {
+    headers: { authorization: `Bearer ${cred.token}` }
+  });
+  const listText = await listRes.text();
+  if (!listRes.ok) {
+    console.error(`List failed (${listRes.status}): ${listText}`);
+    process.exitCode = 1;
+    return;
+  }
+  const listJson = JSON.parse(listText);
+  const agentsRaw = listJson.agents;
+  if (!Array.isArray(agentsRaw)) {
+    console.error("Invalid list response.");
+    process.exitCode = 1;
+    return;
+  }
+  const agents = [];
+  for (const a of agentsRaw) {
+    if (typeof a !== "object" || a === null) continue;
+    const o = a;
+    if (typeof o.agentId === "string" && typeof o.name === "string") {
+      agents.push({ agentId: o.agentId, name: o.name });
+    }
+  }
+  if (agents.length === 0) {
+    console.log("No agents.");
+    return;
+  }
+  agents.forEach((a, i) => {
+    console.log(`${i + 1}. ${a.agentId} (${a.name})`);
+  });
+  const rl = createInterface({ input, output });
+  const pick = (await rl.question("Agent id to delete (empty = cancel): ")).trim();
+  rl.close();
+  if (pick.length === 0) {
+    console.log("Cancelled.");
+    return;
+  }
+  const delRes = await fetch(
+    `${cred.serverUrl}/api/agents?id=${encodeURIComponent(pick)}`,
+    {
+      method: "DELETE",
+      headers: { authorization: `Bearer ${cred.token}` }
+    }
+  );
+  const delText = await delRes.text();
+  if (!delRes.ok) {
+    console.error(`Delete failed (${delRes.status}): ${delText}`);
+    process.exitCode = 1;
+    return;
+  }
+  const delJson = JSON.parse(delText);
+  console.log(delJson.ok === true ? "Deleted." : "Not found.");
+}
+async function main() {
+  const cmd = process.argv[2];
+  if (cmd === "login") {
+    await cmdLogin();
+    return;
+  }
+  if (cmd === "logout") {
+    await cmdLogout();
+    return;
+  }
+  if (cmd === "create") {
+    await cmdCreate();
+    return;
+  }
+  if (cmd === "create-key" || cmd === "generate-key") {
+    await cmdCreateKey();
+    return;
+  }
+  if (cmd === "view-keys") {
+    await cmdViewKeys();
+    return;
+  }
+  if (cmd === "delete" || cmd === "remove") {
+    await cmdDelete();
+    return;
+  }
+  console.error(
+    "Usage: agent-play login | logout | create-key | view-keys | create | delete"
+  );
+  process.exitCode = 1;
+}
+void main().catch((e) => {
+  console.error(e);
+  process.exitCode = 1;
+});

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@agent-play/cli",
+  "version": "0.0.1",
+  "description": "Command-line tool for Agent Play: login, API keys, and agent registration against the web UI.",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "agent-play": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wilforlan/agent-play.git",
+    "directory": "packages/cli"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/cli.ts --format esm --platform node --target node20 --out-dir dist --clean"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsup": "^8.5.1",
+    "typescript": "~5.9.3"
+  }
+}