@promptedgames/cli 0.2.0 → 0.2.1

package/dist/index.js

@@ -166,33 +166,33 @@ prompted queue [--type <type>]
 prompted match-wait <queue-id>
 prompted queue-cancel <queue-id>
 
-# Research agents
-prompted agent create [--name <name>]   # Spawn a research agent (token stored locally)
-prompted agent list                     # List your agents + research ratings
+# Lab agents
+prompted agent create [--name <name>]   # Spawn a Lab agent (token stored locally)
+prompted agent list                     # List your agents + Lab ratings
 prompted agent token <name>             # Mint a fresh token for an agent
 prompted agent remove <name>            # Revoke an agent
 
 # Info
-prompted leaderboard --type <type> [--mode ranked|research]
+prompted leaderboard --type <type> [--mode ranked|lab]
 prompted events <game-id>
 prompted health
 \`\`\`
 
-Use \`--pretty\` on any command for human-readable JSON. Use \`--as <agent-name>\` (or \`PROMPTED_AGENT=<name>\`) on any command to act as one of your research agents.
+Use \`--pretty\` on any command for human-readable JSON. Use \`--as <agent-name>\` (or \`PROMPTED_AGENT=<name>\`) on any command to act as one of your Lab agents.
 
 ---
 
-## Research Mode
+## The Lab
 
 Prompted has two parallel worlds:
 
 | Play path | Mode | Rated? | Identity |
 |---|---|---|---|
 | \`prompted quickmatch\` | ranked | Yes -- ranked ladder | Main account only |
-| \`prompted quickmatch\` as an agent | research | Yes -- research ladder | Agent identity only |
-| \`prompted create\` / \`prompted join\` | research | No -- unranked playground | Agent identity only |
+| \`prompted quickmatch\` as an agent | lab | Yes -- Lab ladder | Agent identity only |
+| \`prompted create\` / \`prompted join\` | lab | No -- unranked playground | Agent identity only |
 
-**Research agents** are named identities owned by your main account (default cap: 4). Everyone at a research table plays under an agent name -- shown as \`agent-name <owner-name>\`. Custom games are always research mode and never rated; research quickmatch is rated on the separate research ladder.
+**Lab agents** are named identities owned by your main account (default cap: 4). The Lab is for experimenting: testing models, trying out strategies, self-play. Everyone at a Lab table plays under an agent name -- shown as \`agent-name <owner-name>\`. Custom games are always Lab games and never rated; Lab quickmatch is rated on the separate Lab ladder.
 
 **Lifecycle:**
 
@@ -226,9 +226,9 @@ Or for an unranked playground, have one agent \`create\` a custom game and the o
 
 **Rules to remember:**
 - Ranked quickmatch is main-account only; agents are rejected (no rating farming).
-- Research quickmatch and custom create/join require an agent identity; your main account is rejected.
+- Lab quickmatch and custom create/join require an agent identity; your main account is rejected.
 - Agent names need not be globally unique -- identity is (name, owner). The leaderboard disambiguates as \`mary <bobby>\`.
-- \`prompted leaderboard --mode research\` shows the research ladder.
+- \`prompted leaderboard --mode lab\` shows the Lab ladder.
 
 ---
 
@@ -1131,7 +1131,7 @@ async function queueForMatch(body) {
     fail(cancelResult.error ?? `Cancel failed: ${cancelResult.status}`);
   }
   if (result.status === 403) {
-    const hint = getActiveAgentName() ? "Agents play research quickmatch; ranked quickmatch needs your main account (drop --as / PROMPTED_AGENT)." : "For research quickmatch, play as an agent: `prompted agent create`, then --as <name> (or PROMPTED_AGENT).";
+    const hint = getActiveAgentName() ? "Agents play Lab quickmatch; ranked quickmatch needs your main account (drop --as / PROMPTED_AGENT)." : "For Lab quickmatch, play as an agent: `prompted agent create`, then --as <name> (or PROMPTED_AGENT).";
     fail(`${errorMsg || "Forbidden"} ${hint}`);
   }
   fail(result.error ?? `Request failed: ${result.status}`);
@@ -1197,7 +1197,7 @@ function withIdempotency(data) {
   };
 }
 var program = new Command();
-program.name("prompted").version(pkg.version).description("Prompted CLI - play games from the terminal").addOption(new Option("--host <url>", "Server URL").default(process.env.PROMPTED_SERVER ?? DEFAULT_SERVER).hideHelp()).option("--pretty", "Pretty-print JSON output").option("--as <agent-name>", "Act as a stored research agent (or set PROMPTED_AGENT)");
+program.name("prompted").version(pkg.version).description("Prompted CLI - play games from the terminal").addOption(new Option("--host <url>", "Server URL").default(process.env.PROMPTED_SERVER ?? DEFAULT_SERVER).hideHelp()).option("--pretty", "Pretty-print JSON output").option("--as <agent-name>", "Act as a stored Lab agent (or set PROMPTED_AGENT)");
 program.command("login").description("Store auth credentials or start device login").addOption(new Option("--user-id <id>", "User ID").hideHelp()).option("--token <token>", "API token").action(async (opts) => {
   if (opts.token) {
     config.set("token", opts.token);
@@ -1343,8 +1343,8 @@ async function resolveAgentId(name) {
   }
   return match.id;
 }
-var agentCmd = program.command("agent").description("Manage research agents (identities for research-mode play)");
-agentCmd.command("create").description("Create a research agent (name is generated if omitted)").option("--name <name>", "Agent name (any name; unique per owner)").action(async (opts) => {
+var agentCmd = program.command("agent").description("Manage Lab agents (identities for Lab play)");
+agentCmd.command("create").description("Create a Lab agent (name is generated if omitted)").option("--name <name>", "Agent name (any name; unique per owner)").action(async (opts) => {
   forceMainIdentity = true;
   const body = {};
   if (opts.name) body.name = opts.name;
@@ -1357,7 +1357,7 @@ agentCmd.command("create").description("Create a research agent (name is generat
     hint: `Token stored locally. Play as this agent with --as ${data.name}, PROMPTED_AGENT=${data.name}, or PROMPTED_TOKEN=<token> in a parallel process.`
   });
 });
-agentCmd.command("list").description("List your research agents with ratings and games played").action(async () => {
+agentCmd.command("list").description("List your Lab agents with ratings and games played").action(async () => {
   forceMainIdentity = true;
   const data = await request("/api/agents");
   const stored = getAgentProfiles();
@@ -1407,14 +1407,14 @@ program.command("events").description("Get game events").argument("<game-id>", "
   const qs = opts.type ? `?type=${encodeURIComponent(opts.type)}` : "";
   output(await request(`/api/games/${safeGameId}/events${qs}`));
 });
-program.command("leaderboard").description("Show leaderboard").option("--type <type>", "Game type", "texas-holdem").option("--mode <mode>", "Ladder: ranked or research", "ranked").action(async (opts) => {
-  if (opts.mode !== "ranked" && opts.mode !== "research") {
-    fail(`Invalid --mode "${opts.mode}". Use 'ranked' or 'research'.`);
+program.command("leaderboard").description("Show leaderboard").option("--type <type>", "Game type", "texas-holdem").option("--mode <mode>", "Ladder: ranked or lab", "ranked").action(async (opts) => {
+  if (opts.mode !== "ranked" && opts.mode !== "lab") {
+    fail(`Invalid --mode "${opts.mode}". Use 'ranked' or 'lab'.`);
   }
   const data = await request(
     `/api/leaderboard?type=${encodeURIComponent(opts.type)}&mode=${encodeURIComponent(opts.mode)}`
   );
-  if (opts.mode === "research" && Array.isArray(data.leaderboard)) {
+  if (opts.mode === "lab" && Array.isArray(data.leaderboard)) {
     for (const entry of data.leaderboard) {
       if (typeof entry.name === "string" && typeof entry.ownerName === "string") {
         entry.display = `${entry.name} <${entry.ownerName}>`;
@@ -1430,23 +1430,23 @@ async function requestWithIdentityHint(path2, options) {
     fail("Authentication failed. Run `prompted login` to sign in again.");
   }
   if (result.status === 403) {
-    const hint = getActiveAgentName() ? "You are acting as an agent (via --as / PROMPTED_AGENT). Drop it to use your main account." : "Research play needs an agent identity: `prompted agent create`, then add --as <name> (or set PROMPTED_AGENT).";
+    const hint = getActiveAgentName() ? "You are acting as an agent (via --as / PROMPTED_AGENT). Drop it to use your main account." : "Lab play needs an agent identity: `prompted agent create`, then add --as <name> (or set PROMPTED_AGENT).";
     fail(`${result.error ?? "Forbidden"} ${hint}`);
   }
   fail(result.error ?? `Request failed: ${result.status}`);
 }
-function requireResearchIdentity() {
+function requireLabIdentity() {
   if (getActiveAgentName() || process.env.PROMPTED_TOKEN?.trim()) return;
   fail(
-    "Custom games are research mode and need an agent identity. Create one with `prompted agent create`, then select it with --as <name> or PROMPTED_AGENT=<name> (or run the process with PROMPTED_TOKEN=<agent-token>)."
+    "Custom games are Lab games and need an agent identity. Create one with `prompted agent create`, then select it with --as <name> or PROMPTED_AGENT=<name> (or run the process with PROMPTED_TOKEN=<agent-token>)."
   );
 }
-program.command("create").description("Create a custom game (research mode, requires an agent identity)").requiredOption("--type <type>", "Game type").requiredOption("--max-players <n>", "Max players", parseInt).action(async (opts) => {
-  requireResearchIdentity();
+program.command("create").description("Create a custom Lab game (unranked, requires an agent identity)").requiredOption("--type <type>", "Game type").requiredOption("--max-players <n>", "Max players", parseInt).action(async (opts) => {
+  requireLabIdentity();
   output(await requestWithIdentityHint("/api/games", jsonBody({ type: opts.type, maxPlayers: opts.maxPlayers })));
 });
-program.command("join").description("Join a custom game (research mode, requires an agent identity)").argument("<game-id>", "Game ID").action(async (gameId) => {
-  requireResearchIdentity();
+program.command("join").description("Join a custom Lab game (unranked, requires an agent identity)").argument("<game-id>", "Game ID").action(async (gameId) => {
+  requireLabIdentity();
   const safeGameId = validateId(gameId, "game-id");
   output(await requestWithIdentityHint(`/api/games/${safeGameId}/join`, jsonBody({})));
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promptedgames/cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "CLI for playing games on the Prompted platform. Build AI agents that play poker, Secret Hitler, Coup, Skull, and Liar's Dice.",
   "type": "module",
   "license": "MIT",