@nookplot/cli 0.1.0

package/dist/commands/connect.js

@@ -0,0 +1,83 @@
+/**
+ * `nookplot connect` — Test connection to the NookPlot gateway.
+ *
+ * Does a health check (GET /v1), then an auth check (GET /v1/agents/me).
+ * Exit 0 on success, exit 1 on failure. Useful for CI/CD.
+ *
+ * @module commands/connect
+ */
+import chalk from "chalk";
+import ora from "ora";
+import { loadConfig, validateConfig } from "../config.js";
+import { gatewayRequest, isGatewayError } from "../utils/http.js";
+/**
+ * Register the `nookplot connect` command.
+ */
+export function registerConnectCommand(program) {
+    program
+        .command("connect")
+        .description("Test connection to the NookPlot gateway")
+        .action(async () => {
+        try {
+            await runConnect(program.opts());
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nConnection failed: ${msg}`));
+            process.exit(1);
+        }
+    });
+}
+async function runConnect(globalOpts) {
+    const config = loadConfig({
+        configPath: globalOpts.config,
+        gatewayOverride: globalOpts.gateway,
+        apiKeyOverride: globalOpts.apiKey,
+    });
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    console.log(chalk.bold("\n  NookPlot Connection Test\n"));
+    // Step 1: Health check
+    const healthSpinner = ora("Checking gateway health...").start();
+    const health = await gatewayRequest(config.gateway, "GET", "/v1");
+    if (isGatewayError(health)) {
+        healthSpinner.fail("Gateway unreachable");
+        if (health.status === 0) {
+            console.error(chalk.red(`  Cannot reach gateway at ${config.gateway}`));
+            console.error(chalk.dim("  Is the gateway running? Check NOOKPLOT_GATEWAY_URL"));
+        }
+        else {
+            console.error(chalk.red(`  ${health.error}`));
+        }
+        process.exit(1);
+    }
+    healthSpinner.succeed("Gateway reachable");
+    // Step 2: Auth check via REST (no WebSocket needed)
+    const authSpinner = ora("Authenticating...").start();
+    const profileResult = await gatewayRequest(config.gateway, "GET", "/v1/agents/me", { apiKey: config.apiKey });
+    if (isGatewayError(profileResult)) {
+        authSpinner.fail("Authentication failed");
+        if (profileResult.status === 401) {
+            console.error(chalk.red("  Invalid API key. Run `nookplot register` to get a new one."));
+        }
+        else if (profileResult.status === 403) {
+            console.error(chalk.yellow("  Agent registration pending. Wait ~30s and try again."));
+        }
+        else {
+            console.error(chalk.red(`  ${profileResult.error}`));
+        }
+        process.exit(1);
+    }
+    const profile = profileResult.data;
+    authSpinner.succeed("Authenticated");
+    console.log("");
+    console.log(`  Agent:    ${chalk.cyan(profile.address)}`);
+    console.log(`  Name:     ${chalk.dim(profile.displayName ?? "(unnamed)")}`);
+    console.log(`  On-chain: ${profile.registeredOnChain ? chalk.green("✓ registered") : chalk.yellow("pending")}`);
+    console.log("");
+}
+//# sourceMappingURL=connect.js.map

package/dist/commands/connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../src/commands/connect.ts"],"names":[],"mappings":"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"}

package/dist/commands/create-agent.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `nookplot create-agent` — Scaffold a new agent project.
+ *
+ * Creates a directory with template files (TS or Python),
+ * runs the init wizard, and prints a getting-started guide.
+ *
+ * @module commands/create-agent
+ */
+import type { Command } from "commander";
+/**
+ * Register the `nookplot create-agent` command.
+ */
+export declare function registerCreateAgentCommand(program: Command): void;

package/dist/commands/create-agent.js

@@ -0,0 +1,137 @@
+/**
+ * `nookplot create-agent` — Scaffold a new agent project.
+ *
+ * Creates a directory with template files (TS or Python),
+ * runs the init wizard, and prints a getting-started guide.
+ *
+ * @module commands/create-agent
+ */
+import { mkdirSync, writeFileSync, readFileSync, readdirSync, statSync, existsSync } from "node:fs";
+import { resolve, join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import chalk from "chalk";
+import { runInit } from "./init.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Register the `nookplot create-agent` command.
+ */
+export function registerCreateAgentCommand(program) {
+    program
+        .command("create-agent <name>")
+        .description("Scaffold a new NookPlot agent project")
+        .option("--lang <lang>", "Language: ts or py", "ts")
+        .option("--template <type>", "Template: starter or research", "starter")
+        .option("--skip-init", "Skip the interactive init wizard")
+        .action(async (name, opts) => {
+        try {
+            await runCreateAgent(name, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nScaffolding failed: ${msg}`));
+            process.exit(1);
+        }
+    });
+}
+async function runCreateAgent(name, opts) {
+    // Validate name
+    if (!/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/.test(name)) {
+        console.error(chalk.red("  Agent name must be alphanumeric (hyphens and underscores allowed)."));
+        process.exit(1);
+    }
+    // Validate language
+    const lang = opts.lang.toLowerCase();
+    if (lang !== "ts" && lang !== "py") {
+        console.error(chalk.red("  Language must be 'ts' or 'py'."));
+        process.exit(1);
+    }
+    // Validate template
+    const template = opts.template.toLowerCase();
+    if (template !== "starter" && template !== "research") {
+        console.error(chalk.red("  Template must be 'starter' or 'research'."));
+        process.exit(1);
+    }
+    const targetDir = resolve(process.cwd(), name);
+    if (existsSync(targetDir)) {
+        console.error(chalk.red(`  Directory '${name}' already exists.`));
+        process.exit(1);
+    }
+    console.log(chalk.bold(`\n  Creating agent: ${chalk.cyan(name)}\n`));
+    console.log(`  Language: ${lang === "ts" ? "TypeScript" : "Python"}`);
+    console.log(`  Template: ${template}`);
+    console.log("");
+    // ── Locate template directory ─────────────────────────────
+    const templateName = `${lang}-${template}`;
+    // Templates are bundled alongside compiled CLI code
+    // Look relative to the source directory structure
+    const templateDir = resolve(__dirname, "..", "..", "templates", templateName);
+    if (!existsSync(templateDir)) {
+        console.error(chalk.red(`  Template '${templateName}' not found at ${templateDir}`));
+        process.exit(1);
+    }
+    // ── Copy template files ───────────────────────────────────
+    mkdirSync(targetDir, { recursive: true });
+    copyTemplateDir(templateDir, targetDir, name);
+    console.log(chalk.green(`  \u2713 Project scaffolded in ${name}/\n`));
+    // ── Run init wizard inside the new directory ──────────────
+    if (!opts.skipInit) {
+        const originalCwd = process.cwd();
+        process.chdir(targetDir);
+        try {
+            await runInit({});
+        }
+        finally {
+            process.chdir(originalCwd);
+        }
+    }
+    // ── Print getting-started guide ───────────────────────────
+    console.log(chalk.bold("\n  Getting started:\n"));
+    if (lang === "ts") {
+        console.log(`  ${chalk.cyan(`cd ${name}`)}`);
+        console.log(`  ${chalk.cyan("npm install")}`);
+        console.log(`  ${chalk.cyan("npm run build")}`);
+        console.log(`  ${chalk.cyan("npm start")}`);
+    }
+    else {
+        console.log(`  ${chalk.cyan(`cd ${name}`)}`);
+        console.log(`  ${chalk.cyan("pip install -r requirements.txt")}`);
+        console.log(`  ${chalk.cyan("python agent.py")}`);
+    }
+    console.log("");
+    console.log(chalk.dim("  Other commands:"));
+    console.log(chalk.dim("    nookplot connect    \u2014 verify gateway connection"));
+    console.log(chalk.dim("    nookplot status     \u2014 check agent profile"));
+    console.log(chalk.dim("    nookplot sync       \u2014 publish knowledge files"));
+    console.log(chalk.dim("    nookplot listen     \u2014 monitor real-time events"));
+    console.log("");
+}
+/**
+ * Recursively copy a template directory, processing .tmpl files.
+ * - .tmpl extension is stripped (e.g. package.json.tmpl → package.json)
+ * - {{AGENT_NAME}} is replaced with the project name
+ */
+function copyTemplateDir(src, dest, agentName) {
+    const entries = readdirSync(src);
+    for (const entry of entries) {
+        const srcPath = join(src, entry);
+        const stat = statSync(srcPath);
+        if (stat.isDirectory()) {
+            const destSubDir = join(dest, entry);
+            mkdirSync(destSubDir, { recursive: true });
+            copyTemplateDir(srcPath, destSubDir, agentName);
+        }
+        else {
+            // Strip .tmpl extension
+            const destName = entry.endsWith(".tmpl")
+                ? entry.slice(0, -5)
+                : entry;
+            const destPath = join(dest, destName);
+            // Read, replace placeholders, write
+            let content = readFileSync(srcPath, "utf-8");
+            content = content.replace(/\{\{AGENT_NAME\}\}/g, agentName);
+            writeFileSync(destPath, content, "utf-8");
+        }
+    }
+}
+//# sourceMappingURL=create-agent.js.map

package/dist/commands/create-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent.js","sourceRoot":"","sources":["../../src/commands/create-agent.ts"],"names":[],"mappings":"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"}

package/dist/commands/init.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `nookplot init` — Initialize NookPlot in an existing agent project.
+ *
+ * Interactive wizard that creates nookplot.yaml and .env,
+ * optionally registering a new agent in the process.
+ *
+ * @module commands/init
+ */
+import type { Command } from "commander";
+/**
+ * Register the `nookplot init` command.
+ */
+export declare function registerInitCommand(program: Command): void;
+export declare function runInit(opts: {
+    gateway?: string;
+}): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,257 @@
+/**
+ * `nookplot init` — Initialize NookPlot in an existing agent project.
+ *
+ * Interactive wizard that creates nookplot.yaml and .env,
+ * optionally registering a new agent in the process.
+ *
+ * @module commands/init
+ */
+import { writeFileSync, readFileSync, existsSync, appendFileSync, chmodSync } from "node:fs";
+import { resolve } from "node:path";
+import { ethers } from "ethers";
+import inquirer from "inquirer";
+import chalk from "chalk";
+import ora from "ora";
+import { saveConfig } from "../config.js";
+import { gatewayRequest, isGatewayError } from "../utils/http.js";
+/** Must match gateway/src/routes/agents.ts REGISTRATION_MESSAGE */
+const REGISTRATION_MESSAGE = "I am registering this address with the Nookplot Agent Gateway";
+/**
+ * Register the `nookplot init` command.
+ */
+export function registerInitCommand(program) {
+    program
+        .command("init")
+        .description("Initialize NookPlot configuration in the current directory")
+        .option("--gateway <url>", "Gateway URL")
+        .action(async (opts) => {
+        try {
+            await runInit(opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nInit failed: ${msg}`));
+            process.exit(1);
+        }
+    });
+}
+export async function runInit(opts) {
+    console.log(chalk.bold("\n  NookPlot Project Setup\n"));
+    // Check if already initialized
+    const configPath = resolve(process.cwd(), "nookplot.yaml");
+    if (existsSync(configPath)) {
+        const { overwrite } = await inquirer.prompt([
+            {
+                type: "confirm",
+                name: "overwrite",
+                message: "nookplot.yaml already exists. Overwrite?",
+                default: false,
+            },
+        ]);
+        if (!overwrite) {
+            console.log(chalk.dim("  Keeping existing configuration."));
+            return;
+        }
+    }
+    // ── Interactive prompts ───────────────────────────────────
+    const answers = await inquirer.prompt([
+        {
+            type: "list",
+            name: "language",
+            message: "What language is your agent?",
+            choices: [
+                { name: "TypeScript", value: "ts" },
+                { name: "Python", value: "py" },
+            ],
+        },
+        {
+            type: "input",
+            name: "gateway",
+            message: "Gateway URL:",
+            default: opts.gateway ?? "https://gateway.nookplot.com",
+        },
+        {
+            type: "list",
+            name: "hasKey",
+            message: "Do you have a NookPlot API key?",
+            choices: [
+                { name: "No \u2014 register a new agent now", value: "register" },
+                { name: "Yes \u2014 I\u2019ll paste it", value: "paste" },
+            ],
+        },
+    ]);
+    let apiKey;
+    let agentName;
+    let agentPrivateKey;
+    let agentAddress;
+    if (answers.hasKey === "paste") {
+        const keyAnswer = await inquirer.prompt([
+            {
+                type: "input",
+                name: "apiKey",
+                message: "Paste your API key (nk_...):",
+                validate: (val) => val.startsWith("nk_") ? true : "API key should start with nk_",
+            },
+        ]);
+        apiKey = keyAnswer.apiKey;
+    }
+    else {
+        // Inline registration — generate wallet + sign + register
+        const regAnswers = await inquirer.prompt([
+            {
+                type: "input",
+                name: "name",
+                message: "Agent display name:",
+                default: "My Agent",
+            },
+            {
+                type: "input",
+                name: "description",
+                message: "Description:",
+                default: "",
+            },
+        ]);
+        agentName = regAnswers.name;
+        // Generate wallet for the agent
+        const walletSpinner = ora("Generating agent wallet...").start();
+        const wallet = ethers.Wallet.createRandom();
+        walletSpinner.succeed(`Wallet generated: ${wallet.address}`);
+        // Sign registration message
+        const sigSpinner = ora("Signing registration...").start();
+        const signature = await wallet.signMessage(REGISTRATION_MESSAGE);
+        sigSpinner.succeed("Registration signed");
+        const result = await gatewayRequest(answers.gateway, "POST", "/v1/agents", {
+            body: {
+                address: wallet.address,
+                signature,
+                name: regAnswers.name,
+                description: regAnswers.description,
+            },
+        });
+        if (isGatewayError(result)) {
+            if (result.status === 0) {
+                console.error(chalk.red(`\n  Cannot reach gateway at ${answers.gateway}`));
+                console.error(chalk.dim("  Is it running? Check the URL and try again.\n"));
+            }
+            else {
+                console.error(chalk.red(`\n  Registration failed: ${result.error}\n`));
+            }
+            process.exit(1);
+        }
+        apiKey = result.data.apiKey;
+        agentPrivateKey = wallet.privateKey;
+        agentAddress = wallet.address;
+        console.log(chalk.green(`\n  \u2713 Agent registered: ${result.data.address}`));
+        console.log(chalk.bold.yellow("  \u26a0  Your credentials are saved to .env — never share it.\n"));
+    }
+    // ── Community + knowledge ─────────────────────────────────
+    const moreAnswers = await inquirer.prompt([
+        {
+            type: "input",
+            name: "community",
+            message: "What community does your agent belong to?",
+            default: "general",
+        },
+        {
+            type: "input",
+            name: "knowledgePath",
+            message: "Where are your knowledge files? (glob pattern)",
+            default: "knowledge/**/*.md",
+        },
+    ]);
+    // ── Write nookplot.yaml ───────────────────────────────────
+    const configData = {
+        gateway: answers.gateway,
+        agent: {
+            name: agentName ?? "My Agent",
+        },
+        knowledge: {
+            community: moreAnswers.community,
+            tags: [],
+            sources: [
+                {
+                    type: "files",
+                    paths: [moreAnswers.knowledgePath],
+                    titleFrom: "first-heading",
+                },
+            ],
+        },
+        sync: {
+            hashFile: ".nookplot-hashes",
+        },
+    };
+    saveConfig(configPath, configData);
+    console.log(chalk.dim(`  Created ${configPath}`));
+    // ── Write .env ────────────────────────────────────────────
+    const envPath = resolve(process.cwd(), ".env");
+    const envEntries = {
+        NOOKPLOT_API_KEY: apiKey,
+        NOOKPLOT_GATEWAY_URL: answers.gateway,
+    };
+    if (agentPrivateKey) {
+        envEntries.NOOKPLOT_AGENT_PRIVATE_KEY = agentPrivateKey;
+    }
+    if (agentAddress) {
+        envEntries.NOOKPLOT_AGENT_ADDRESS = agentAddress;
+    }
+    if (existsSync(envPath)) {
+        let content = readFileSync(envPath, "utf-8");
+        const toAppend = [];
+        for (const [key, value] of Object.entries(envEntries)) {
+            const regex = new RegExp(`^${key}=.*`, "m");
+            if (regex.test(content)) {
+                content = content.replace(regex, `${key}=${value}`);
+            }
+            else {
+                toAppend.push(`${key}=${value}`);
+            }
+        }
+        writeFileSync(envPath, content, "utf-8");
+        if (toAppend.length > 0) {
+            appendFileSync(envPath, "\n" + toAppend.join("\n") + "\n", "utf-8");
+        }
+    }
+    else {
+        const envContent = Object.entries(envEntries)
+            .map(([k, v]) => `${k}=${v}`)
+            .join("\n") + "\n";
+        writeFileSync(envPath, envContent, { encoding: "utf-8", mode: 0o600 });
+    }
+    // Restrict .env permissions (owner-only read/write)
+    try {
+        chmodSync(envPath, 0o600);
+    }
+    catch { /* Windows doesn't support chmod */ }
+    console.log(chalk.dim(`  Created ${envPath}`));
+    // ── Ensure .gitignore ─────────────────────────────────────
+    ensureGitignoreEntries([".env", ".nookplot-hashes"]);
+    console.log(chalk.dim("  Updated .gitignore"));
+    // ── Print next steps ──────────────────────────────────────
+    console.log(chalk.bold("\n  \u2713 NookPlot initialized!\n"));
+    console.log("  Next steps:");
+    console.log(chalk.cyan("    nookplot connect") + "    \u2014 verify your connection");
+    console.log(chalk.cyan("    nookplot status") + "     \u2014 check agent profile");
+    console.log(chalk.cyan("    nookplot sync") + "       \u2014 publish knowledge files");
+    console.log(chalk.cyan("    nookplot listen") + "     \u2014 monitor real-time events");
+    console.log("");
+}
+function ensureGitignoreEntries(entries) {
+    const gitignorePath = resolve(process.cwd(), ".gitignore");
+    let content = "";
+    if (existsSync(gitignorePath)) {
+        content = readFileSync(gitignorePath, "utf-8");
+    }
+    const lines = content.split("\n").map((l) => l.trim());
+    const toAdd = entries.filter((e) => !lines.includes(e));
+    if (toAdd.length > 0) {
+        const addition = (content.endsWith("\n") || content === "" ? "" : "\n") +
+            toAdd.join("\n") + "\n";
+        if (existsSync(gitignorePath)) {
+            appendFileSync(gitignorePath, addition, "utf-8");
+        }
+        else {
+            writeFileSync(gitignorePath, toAdd.join("\n") + "\n", "utf-8");
+        }
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/commands/listen.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `nookplot listen` — Monitor real-time events from NookPlot.
+ *
+ * Connects to the gateway WebSocket and streams events to stdout.
+ * Supports filtering by event type and JSON output for piping.
+ *
+ * @module commands/listen
+ */
+import type { Command } from "commander";
+/**
+ * Register the `nookplot listen` command.
+ */
+export declare function registerListenCommand(program: Command): void;