create-dynamicagents 0.1.0 → 0.1.1

package/README.md

@@ -7,7 +7,15 @@ Create gates, leaders and agents on
 npm create dynamicagents@latest
 ```
 
-For now it only says hello; scaffolding comes next. Requires Node 24 or later.
+It asks what you want to build — a gate, a leader or an agent. Scaffolding
+them is a work in progress; follow it at
+[dynamicagents.dev](https://dynamicagents.dev). Requires Node 24 or later.
+
+To skip the question, name what to build:
+
+```bash
+npm create dynamicagents@latest agent
+```
 
 ## License
 

package/dist/cli.js

@@ -1,6 +1,40 @@
 #!/usr/bin/env node
 import { readFileSync } from "node:fs";
-import { welcome } from "./welcome.js";
+import { cancel, intro, isCancel, log, note, outro, select } from "@clack/prompts";
+import { KINDS, kindOf } from "./kinds.js";
+import { noTerminal, nothingBuilt, question, title, unknownKind, workInProgress } from "./messages.js";
 // Read at runtime rather than imported: `package.json` sits outside `rootDir`.
 const { version } = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
-console.log(welcome(version));
+async function choose(arg) {
+    if (arg !== undefined) {
+        const kind = kindOf(arg);
+        if (kind === undefined)
+            log.error(unknownKind(arg));
+        return kind;
+    }
+    if (!process.stdin.isTTY) {
+        log.warn(noTerminal());
+        return undefined;
+    }
+    const picked = await select({
+        message: question,
+        options: KINDS.map((kind) => ({
+            value: kind,
+            label: kind.label,
+            hint: kind.hint
+        }))
+    });
+    return isCancel(picked) ? undefined : picked;
+}
+intro(title(version));
+const kind = await choose(process.argv[2]);
+if (kind === undefined) {
+    cancel(nothingBuilt);
+    process.exitCode = 1;
+}
+else {
+    // clack wraps a note with `trim: false`, so a line that breaks at a space
+    // would start with it.
+    note(kind.about, kind.label, { format: (line) => line.trimStart() });
+    outro(workInProgress(kind));
+}

package/dist/kinds.js

@@ -0,0 +1,22 @@
+export const KINDS = [
+    {
+        value: "gate",
+        label: "Gate",
+        hint: "where people and APIs reach your agents",
+        about: "Gates are the interfaces humans or APIs interact with, like a Slack, WhatsApp or API gate."
+    },
+    {
+        value: "leader",
+        label: "Leader",
+        hint: "creates, edits and evaluates a group of agents",
+        about: "A leader is a powerful agent that can create, edit and evaluate a group of agents."
+    },
+    {
+        value: "agent",
+        label: "Agent",
+        hint: "one agent, usually created by a leader",
+        about: "An agent should be created by a leader rather than directly by a developer. It adds a folder with an agent inside a worker and scaffolds it from plugins, significantly cutting the time it takes to deploy a production-ready agent."
+    }
+];
+/** The kind a command-line argument names, in any case. */
+export const kindOf = (arg) => KINDS.find((kind) => kind.value === arg.toLowerCase());

package/dist/messages.js

@@ -0,0 +1,18 @@
+/** What `npm create dynamicagents` prints. Pure, so the spec needs no process. */
+import { KINDS } from "./kinds.js";
+export const WEBSITE = "https://dynamicagents.dev";
+export const title = (version) => `Dynamic Agents · create-dynamicagents v${version}`;
+export const question = "What would you like to build?";
+export const workInProgress = (kind) => `${kind.label} scaffolding is a work in progress. Follow updates at ${WEBSITE}`;
+export const nothingBuilt = "Nothing was built.";
+const width = Math.max(...KINDS.map((kind) => kind.value.length));
+const choices = () => KINDS.map((kind) => `  ${kind.value.padEnd(width)}  ${kind.hint}`).join("\n");
+/** Without a TTY there is no menu, so the kind has to be an argument. */
+export const noTerminal = () => [
+    "No terminal to ask in, so name what to build:",
+    "",
+    choices(),
+    "",
+    "npm create dynamicagents@latest <kind>"
+].join("\n");
+export const unknownKind = (arg) => [`"${arg}" is not something to build. Name one of:`, "", choices()].join("\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-dynamicagents",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Create gates, leaders and agents on Dynamic Agents: npm create dynamicagents@latest",
   "keywords": [
     "create",
@@ -42,6 +42,9 @@
     "prepublishOnly": "npm run check && npm test && npm run verify:package",
     "prepare": "husky"
   },
+  "dependencies": {
+    "@clack/prompts": "^1.8.1"
+  },
   "devDependencies": {
     "@types/node": "^24.13.6",
     "eslint": "^10.10.0",

package/dist/welcome.js

@@ -1,9 +0,0 @@
-/** What `npm create dynamicagents` prints. Pure, so the spec needs no process. */
-export const welcome = (version) => [
-    "",
-    `  Welcome to Dynamic Agents  (create-dynamicagents v${version})`,
-    "",
-    "  Creating gates, leaders and agents is coming soon.",
-    "  https://github.com/dynamicagents",
-    ""
-].join("\n");