@an-sdk/cli 0.0.2 → 0.0.4

package/README.md

@@ -0,0 +1,96 @@
+# @an-sdk/cli
+
+Deploy AI agents to [AN](https://an.dev) from your terminal.
+
+## Quick Start
+
+```bash
+# 1. Login with your API key (get one at an.dev)
+npx @an-sdk/cli login
+
+# 2. Create your agent
+npm init -y && npm install @an-sdk/agent zod
+```
+
+Create `src/agent.ts`:
+
+```ts
+import { agent, tool } from "@an-sdk/agent"
+import { z } from "zod"
+
+export default agent({
+  model: "claude-sonnet-4-6",
+  systemPrompt: "You are a helpful assistant.",
+  tools: {
+    add: tool({
+      description: "Add two numbers",
+      inputSchema: z.object({ a: z.number(), b: z.number() }),
+      execute: async ({ a, b }) => ({
+        content: [{ type: "text", text: `${a + b}` }],
+      }),
+    }),
+  },
+})
+```
+
+```bash
+# 3. Deploy
+npx @an-sdk/cli deploy
+```
+
+That's it. Your agent is live.
+
+## Commands
+
+### `an login`
+
+Authenticate with the AN platform.
+
+```bash
+npx @an-sdk/cli login
+# Enter your API key: an_sk_...
+# Authenticated as John (team: my-team)
+```
+
+Your key is saved to `~/.an/credentials`.
+
+### `an deploy`
+
+Bundle and deploy your agent.
+
+```bash
+npx @an-sdk/cli deploy
+# Bundling src/agent.ts...
+# Bundled (12.3kb)
+# Deploying my-agent...
+# https://api.an.dev/v1/chat/my-agent
+```
+
+The CLI:
+1. Finds your entry point (`src/agent.ts`, `src/index.ts`, `agent.ts`, or `index.ts`)
+2. Bundles your code + dependencies with esbuild
+3. Deploys to a secure cloud sandbox
+4. Returns your agent's URL
+
+## How It Works
+
+```
+Your code  -->  an deploy  -->  Cloud Sandbox  -->  Clients
+                                (E2B + Claude)
+```
+
+- Your agent runs in an isolated cloud sandbox with Node.js, git, and system tools
+- The Claude Agent SDK executes your agent with the model and tools you defined
+- Clients connect via SSE streaming at the returned URL
+
+## Project Linking
+
+After first deploy, the CLI saves `.an/project.json` in your project directory. Subsequent deploys to the same project update the existing agent.
+
+## Environment Variables
+
+`AN_API_URL` — Override the API endpoint (default: `https://an.dev/api/v1`)
+
+## License
+
+MIT

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/login.ts
-import { createInterface } from "readline/promises";
+import * as p from "@clack/prompts";
 
 // src/config.ts
 import { readFileSync, writeFileSync, mkdirSync } from "fs";
@@ -11,6 +11,7 @@ var AN_DIR = join(homedir(), ".an");
 var CREDENTIALS_PATH = join(AN_DIR, "credentials");
 var PROJECT_PATH = join(process.cwd(), ".an", "project.json");
 function getApiKey() {
+  if (process.env.AN_API_KEY) return process.env.AN_API_KEY;
   try {
     const data = JSON.parse(readFileSync(CREDENTIALS_PATH, "utf-8"));
     return data.apiKey || null;
@@ -24,7 +25,10 @@ function saveApiKey(apiKey) {
 }
 function getProject() {
   try {
-    return JSON.parse(readFileSync(PROJECT_PATH, "utf-8"));
+    const data = JSON.parse(readFileSync(PROJECT_PATH, "utf-8"));
+    if (data.projectId && data.projectSlug) return data;
+    if (data.slug) return { projectId: data.agentId ?? "", projectSlug: data.slug };
+    return null;
   } catch {
     return null;
   }
@@ -37,51 +41,71 @@ function saveProject(data) {
 // src/login.ts
 var API_BASE = process.env.AN_API_URL || "https://an.dev/api/v1";
 async function login() {
+  p.intro("an login");
   const existing = getApiKey();
   if (existing) {
-    console.log(
-      "Already logged in. Run `an login` again to re-authenticate.\n"
-    );
+    p.log.info("Already logged in. Continuing will re-authenticate.");
   }
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  const apiKey = await rl.question("Enter your API key: ");
-  rl.close();
-  if (!apiKey.trim()) {
-    console.error("Error: API key cannot be empty");
-    process.exit(1);
+  const apiKey = await p.text({
+    message: "Enter your API key",
+    validate: (val) => {
+      if (!val.trim()) return "API key cannot be empty";
+    }
+  });
+  if (p.isCancel(apiKey)) {
+    p.cancel("Login cancelled.");
+    process.exit(0);
   }
+  const s = p.spinner();
+  s.start("Verifying API key...");
   const res = await fetch(`${API_BASE}/me`, {
     headers: { Authorization: `Bearer ${apiKey.trim()}` }
   });
   if (!res.ok) {
-    console.error("Error: Invalid API key");
+    s.stop("Invalid API key");
+    p.log.error("The API key could not be verified. Check it and try again.");
     process.exit(1);
   }
   const { user, team } = await res.json();
   saveApiKey(apiKey.trim());
-  console.log(
-    `
-\u2713 Authenticated as ${user.displayName || user.email} (team: ${team.name})`
-  );
-  console.log("  Key saved to ~/.an/credentials\n");
+  s.stop("Verified");
+  p.log.success(`Authenticated as ${user.displayName || user.email} (team: ${team.name})`);
+  p.log.info("Key saved to ~/.an/credentials");
+  p.outro("Done");
 }
 
 // src/bundler.ts
 import esbuild from "esbuild";
-var ENTRY_CANDIDATES = [
-  "src/agent.ts",
-  "src/index.ts",
-  "agent.ts",
-  "index.ts"
-];
-async function findEntryPoint() {
-  const { existsSync } = await import("fs");
-  for (const candidate of ENTRY_CANDIDATES) {
-    if (existsSync(candidate)) return candidate;
-  }
-  throw new Error(
-    "Cannot find agent entry point. Expected one of:\n" + ENTRY_CANDIDATES.map((c) => `  ${c}`).join("\n")
-  );
+async function findAgentEntryPoints() {
+  const { existsSync, readdirSync, statSync } = await import("fs");
+  const { join: join2, basename: basename2, extname } = await import("path");
+  if (!existsSync("agents") || !statSync("agents").isDirectory()) {
+    throw new Error("No agents found. Create agents in the `agents/` directory.");
+  }
+  const entries = [];
+  const items = readdirSync("agents");
+  for (const item of items) {
+    const fullPath = join2("agents", item);
+    const stat = statSync(fullPath);
+    if (stat.isDirectory()) {
+      for (const indexFile of ["index.ts", "index.js"]) {
+        const indexPath = join2(fullPath, indexFile);
+        if (existsSync(indexPath)) {
+          entries.push({ slug: item, entryPoint: indexPath });
+          break;
+        }
+      }
+    } else if (stat.isFile()) {
+      const ext = extname(item);
+      if (ext === ".ts" || ext === ".js") {
+        entries.push({ slug: basename2(item, ext), entryPoint: fullPath });
+      }
+    }
+  }
+  if (entries.length === 0) {
+    throw new Error("No agents found. Create agents in the `agents/` directory.");
+  }
+  return entries;
 }
 async function bundleAgent(entryPoint) {
   const result = await esbuild.build({
@@ -106,44 +130,138 @@ ${result.errors.map((e) => e.text).join("\n")}`
 
 // src/deploy.ts
 import { basename } from "path";
+import * as p2 from "@clack/prompts";
+function slugify(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
 var API_BASE2 = process.env.AN_API_URL || "https://an.dev/api/v1";
+var AN_BASE = process.env.AN_URL || "https://an.dev";
+async function fetchProjects(apiKey) {
+  const res = await fetch(`${API_BASE2}/projects`, {
+    headers: { Authorization: `Bearer ${apiKey}` }
+  });
+  if (!res.ok) return [];
+  const data = await res.json();
+  return data.projects ?? [];
+}
+async function linkProject(apiKey) {
+  const projects = await fetchProjects(apiKey);
+  if (projects.length === 0) {
+    const name = await p2.text({
+      message: "Project name",
+      defaultValue: basename(process.cwd()),
+      placeholder: basename(process.cwd())
+    });
+    if (p2.isCancel(name)) {
+      p2.cancel("Deploy cancelled.");
+      process.exit(0);
+    }
+    return { projectId: "", projectSlug: slugify(name) };
+  }
+  const options = [
+    { value: "__new__", label: "Create a new project" },
+    ...projects.map((proj) => ({ value: proj.slug, label: proj.name || proj.slug }))
+  ];
+  const choice = await p2.select({
+    message: "Link to a project",
+    options
+  });
+  if (p2.isCancel(choice)) {
+    p2.cancel("Deploy cancelled.");
+    process.exit(0);
+  }
+  if (choice === "__new__") {
+    const name = await p2.text({
+      message: "Project name",
+      defaultValue: basename(process.cwd()),
+      placeholder: basename(process.cwd())
+    });
+    if (p2.isCancel(name)) {
+      p2.cancel("Deploy cancelled.");
+      process.exit(0);
+    }
+    return { projectId: "", projectSlug: slugify(name) };
+  }
+  const selected = projects.find((proj) => proj.slug === choice);
+  return { projectId: selected.id, projectSlug: selected.slug };
+}
 async function deploy() {
+  p2.intro("an deploy");
   const apiKey = getApiKey();
   if (!apiKey) {
-    console.error("Not logged in. Run `an login` first.");
+    p2.log.error("Not logged in. Run `an login` first, or set AN_API_KEY env var.");
     process.exit(1);
   }
-  const entryPoint = await findEntryPoint();
-  console.log(`  Bundling ${entryPoint}...`);
-  const bundle = await bundleAgent(entryPoint);
-  console.log(`  Bundled (${(bundle.length / 1024).toFixed(1)}kb)`);
-  const project = getProject();
-  const slug = project?.slug || basename(process.cwd());
-  console.log(`  Deploying ${slug}...`);
-  const res = await fetch(`${API_BASE2}/agents/deploy`, {
-    method: "POST",
-    headers: {
-      Authorization: `Bearer ${apiKey}`,
-      "Content-Type": "application/json"
-    },
-    body: JSON.stringify({
-      slug,
-      bundle: bundle.toString("base64")
-    })
-  });
-  if (!res.ok) {
-    const err = await res.json().catch(() => ({}));
-    console.error(`
-  Error: ${err.message || "Deploy failed"}`);
+  let agents;
+  try {
+    agents = await findAgentEntryPoints();
+  } catch (err) {
+    p2.log.error(err.message);
     process.exit(1);
   }
-  const result = await res.json();
-  saveProject({ agentId: result.agentId, slug: result.slug });
-  console.log(`
-  \u2713 ${result.url}
-`);
-  console.log(`  Agent: ${result.slug}`);
-  console.log(`  Sandbox: ${result.sandboxId}`);
+  p2.log.info(`Found ${agents.length} agent${agents.length > 1 ? "s" : ""}`);
+  let project = getProject();
+  let projectSlug;
+  let projectId;
+  if (project) {
+    projectSlug = project.projectSlug;
+    projectId = project.projectId;
+  } else if (process.stdin.isTTY) {
+    const linked = await linkProject(apiKey);
+    projectSlug = linked.projectSlug;
+    projectId = linked.projectId;
+  } else {
+    projectSlug = slugify(basename(process.cwd()));
+    projectId = "";
+  }
+  const deployed = [];
+  for (const agent of agents) {
+    const s = p2.spinner();
+    s.start(`Bundling ${agent.slug}...`);
+    const bundle = await bundleAgent(agent.entryPoint);
+    s.stop(`Bundled ${agent.slug} (${(bundle.length / 1024).toFixed(1)}kb)`);
+    const s2 = p2.spinner();
+    s2.start(`Deploying ${agent.slug}...`);
+    const res = await fetch(`${API_BASE2}/agents/deploy`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        projectSlug,
+        slug: agent.slug,
+        bundle: bundle.toString("base64")
+      })
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      s2.stop(`Failed to deploy ${agent.slug}`);
+      p2.log.error(err.message || "Deploy failed");
+      if (deployed.length > 0) {
+        p2.log.info(`
+Deployed before failure:`);
+        for (const a of deployed) {
+          p2.log.info(`  ${a.slug}  \u2192  ${AN_BASE}/a/${projectSlug}/${a.slug}`);
+        }
+      }
+      process.exit(1);
+    }
+    const result = await res.json();
+    projectId = result.projectId;
+    projectSlug = result.projectSlug;
+    deployed.push({ slug: agent.slug });
+    s2.stop(`${agent.slug} deployed`);
+  }
+  saveProject({ projectId, projectSlug });
+  p2.log.success(`Deployed ${deployed.length} agent${deployed.length > 1 ? "s" : ""} to ${projectSlug}`);
+  console.log();
+  for (const agent of deployed) {
+    console.log(`  ${agent.slug}  \u2192  ${AN_BASE}/a/${projectSlug}/${agent.slug}`);
+  }
+  console.log();
+  console.log(`  Dashboard  \u2192  ${AN_BASE}/an/deployments`);
+  p2.outro("Done");
 }
 
 // src/index.ts

package/package.json

@@ -1,19 +1,21 @@
 {
   "name": "@an-sdk/cli",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "AN CLI — deploy AI agents",
   "type": "module",
   "bin": {
     "an": "dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "scripts": {
     "build": "tsup",
     "dev": "tsx src/index.ts"
   },
   "dependencies": {
+    "@clack/prompts": "^1.0.1",
     "esbuild": "^0.24.0"
   },
   "devDependencies": {