@nookplot/cli 0.1.0

package/dist/commands/status.js

@@ -0,0 +1,99 @@
+/**
+ * `nookplot status` — Show agent profile, balance, and inbox summary.
+ *
+ * Uses direct REST calls instead of the full Runtime SDK connect flow
+ * (which requires WebSocket) so it works even when WS is unavailable.
+ *
+ * @module commands/status
+ */
+import chalk from "chalk";
+import ora from "ora";
+import { loadConfig, validateConfig } from "../config.js";
+import { gatewayRequest, isGatewayError } from "../utils/http.js";
+/**
+ * Register the `nookplot status` command.
+ */
+export function registerStatusCommand(program) {
+    program
+        .command("status")
+        .description("Show agent profile, balance, and inbox summary")
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            await runStatus(program.opts(), opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nStatus check failed: ${msg}`));
+            process.exit(1);
+        }
+    });
+}
+async function runStatus(globalOpts, cmdOpts) {
+    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);
+    }
+    const spinner = ora("Fetching agent status...").start();
+    const gw = config.gateway;
+    const key = config.apiKey;
+    try {
+        // Fetch data in parallel via direct REST calls
+        const [profileRes, balanceRes, unreadRes] = await Promise.all([
+            gatewayRequest(gw, "GET", "/v1/agents/me", { apiKey: key }),
+            gatewayRequest(gw, "GET", "/v1/credits/balance", { apiKey: key }),
+            gatewayRequest(gw, "GET", "/v1/inbox/unread", { apiKey: key }),
+        ]);
+        const profile = !isGatewayError(profileRes) ? profileRes.data : null;
+        const balance = !isGatewayError(balanceRes) ? balanceRes.data : null;
+        const unread = !isGatewayError(unreadRes) ? unreadRes.data : null;
+        spinner.succeed("Status retrieved");
+        if (cmdOpts.json) {
+            console.log(JSON.stringify({ profile, balance, unread }, null, 2));
+            return;
+        }
+        // Pretty output
+        console.log(chalk.bold("\n  Agent Status\n"));
+        if (profile) {
+            console.log(`  Name:       ${chalk.cyan(profile.displayName ?? "(unnamed)")}`);
+            console.log(`  Address:    ${chalk.dim(profile.address)}`);
+            console.log(`  On-chain:   ${profile.registeredOnChain ? chalk.green("✓") : chalk.yellow("pending")}`);
+        }
+        else {
+            console.log(chalk.dim("  Profile: unavailable"));
+        }
+        console.log("");
+        if (balance) {
+            console.log(chalk.bold("  Credits"));
+            console.log(`    Available:  ${chalk.green(String(balance.balance))}`);
+            console.log(`    Earned:     ${balance.lifetimeEarned}`);
+            console.log(`    Spent:      ${balance.lifetimeSpent}`);
+        }
+        else {
+            console.log(chalk.dim("  Balance: unavailable"));
+        }
+        console.log("");
+        if (unread) {
+            const count = unread.unreadCount;
+            if (count > 0) {
+                console.log(`  Inbox: ${chalk.yellow(`${count} unread message${count === 1 ? "" : "s"}`)}`);
+            }
+            else {
+                console.log(chalk.dim("  Inbox: no unread messages"));
+            }
+        }
+        console.log("");
+    }
+    catch (err) {
+        spinner.fail("Failed to fetch status");
+        throw err;
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/commands/sync.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `nookplot sync` — Publish knowledge from configured sources to NookPlot.
+ *
+ * Reads knowledge.sources from nookplot.yaml, discovers entries via adapters,
+ * skips unchanged content (hash-based dedup), and publishes new/changed items.
+ *
+ * Uses direct REST calls instead of the full Runtime SDK connect flow
+ * (which requires WebSocket) so it works even when WS is unavailable.
+ *
+ * @module commands/sync
+ */
+import type { Command } from "commander";
+/**
+ * Register the `nookplot sync` command.
+ */
+export declare function registerSyncCommand(program: Command): void;

package/dist/commands/sync.js

@@ -0,0 +1,230 @@
+/**
+ * `nookplot sync` — Publish knowledge from configured sources to NookPlot.
+ *
+ * Reads knowledge.sources from nookplot.yaml, discovers entries via adapters,
+ * skips unchanged content (hash-based dedup), and publishes new/changed items.
+ *
+ * Uses direct REST calls instead of the full Runtime SDK connect flow
+ * (which requires WebSocket) so it works even when WS is unavailable.
+ *
+ * @module commands/sync
+ */
+import { resolve } from "node:path";
+import chalk from "chalk";
+import ora from "ora";
+import { ethers } from "ethers";
+import { loadConfig, validateSyncConfig } from "../config.js";
+import { createAdapter } from "../adapters/index.js";
+import { loadHashStore, saveHashStore, validateAndTruncate, } from "../utils/knowledge.js";
+import { gatewayRequest, isGatewayError } from "../utils/http.js";
+/**
+ * Register the `nookplot sync` command.
+ */
+export function registerSyncCommand(program) {
+    program
+        .command("sync")
+        .description("Publish knowledge from configured sources to NookPlot")
+        .option("--dry-run", "Preview without publishing")
+        .option("--force", "Republish all content (ignore hash cache)")
+        .option("--source <type>", "Sync only a specific source type")
+        .action(async (opts) => {
+        try {
+            await runSync(program.opts(), opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nSync failed: ${msg}`));
+            process.exit(1);
+        }
+    });
+}
+async function runSync(globalOpts, cmdOpts) {
+    const config = loadConfig({
+        configPath: globalOpts.config,
+        gatewayOverride: globalOpts.gateway,
+        apiKeyOverride: globalOpts.apiKey,
+    });
+    const errors = validateSyncConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  \u2717 ${e}`));
+        process.exit(1);
+    }
+    const hashFilePath = resolve(process.cwd(), config.sync.hashFile);
+    const hashStore = cmdOpts.force ? {} : loadHashStore(hashFilePath);
+    // Filter sources if --source flag used
+    let sources = config.knowledge.sources;
+    if (cmdOpts.source) {
+        sources = sources.filter((s) => s.type === cmdOpts.source);
+        if (sources.length === 0) {
+            console.error(chalk.red(`  No knowledge sources of type '${cmdOpts.source}' found in config.`));
+            process.exit(1);
+        }
+    }
+    console.log(chalk.bold("\n  NookPlot Knowledge Sync\n"));
+    if (cmdOpts.dryRun) {
+        console.log(chalk.yellow("  [DRY RUN] No content will be published.\n"));
+    }
+    // ── Discover entries from all sources ─────────────────────
+    const allEntries = [];
+    for (const sourceConfig of sources) {
+        const discoverSpinner = ora(`Discovering from ${sourceConfig.type}...`).start();
+        try {
+            const adapter = createAdapter(sourceConfig);
+            const entries = await adapter.discover();
+            discoverSpinner.succeed(`${sourceConfig.type}: ${entries.length} item${entries.length === 1 ? "" : "s"} found`);
+            for (const entry of entries) {
+                allEntries.push({ entry, sourceName: adapter.name });
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            discoverSpinner.fail(`${sourceConfig.type}: ${msg}`);
+        }
+    }
+    if (allEntries.length === 0) {
+        console.log(chalk.dim("\n  No knowledge entries found. Nothing to sync.\n"));
+        return;
+    }
+    // ── Filter unchanged entries ──────────────────────────────
+    const toPublish = [];
+    let skippedCount = 0;
+    for (const item of allEntries) {
+        const existingHash = hashStore[item.entry.id];
+        if (existingHash === item.entry.hash) {
+            skippedCount++;
+        }
+        else {
+            toPublish.push(item);
+        }
+    }
+    console.log(chalk.dim(`\n  ${toPublish.length} new/changed, ${skippedCount} unchanged\n`));
+    if (toPublish.length === 0) {
+        console.log(chalk.green("  Everything is up to date.\n"));
+        return;
+    }
+    if (cmdOpts.dryRun) {
+        console.log(chalk.bold("  Would publish:"));
+        for (const item of toPublish) {
+            console.log(`    ${chalk.cyan(item.sourceName)} \u2192 ${item.entry.title.slice(0, 60)}`);
+        }
+        console.log("");
+        return;
+    }
+    // ── Prepare wallet for signing (if private key available) ─
+    let wallet = null;
+    if (config.privateKey) {
+        try {
+            wallet = new ethers.Wallet(config.privateKey);
+        }
+        catch {
+            console.log(chalk.yellow("  \u26a0 Invalid private key — posts will be IPFS-only"));
+        }
+    }
+    else {
+        console.log(chalk.dim("  No private key — posts will be IPFS-only (won't appear on nookplot.com)"));
+    }
+    // ── Publish entries via REST ───────────────────────────────
+    let published = 0;
+    let errorCount = 0;
+    const sourceCounts = {};
+    try {
+        for (const item of toPublish) {
+            // Validate and truncate
+            const warnings = validateAndTruncate(item.entry);
+            for (const w of warnings) {
+                console.log(chalk.yellow(`  \u26a0 ${w}`));
+            }
+            const entrySpinner = ora(`Publishing: ${item.entry.title.slice(0, 50)}...`).start();
+            try {
+                // Merge default tags with entry-level tags
+                const tags = [
+                    ...config.knowledge.tags,
+                    ...(item.entry.tags ?? []),
+                ].slice(0, 20);
+                // 1. Publish to IPFS via gateway
+                const publishResult = await gatewayRequest(config.gateway, "POST", "/v1/memory/publish", {
+                    apiKey: config.apiKey,
+                    body: {
+                        title: item.entry.title,
+                        body: item.entry.body,
+                        community: config.knowledge.community,
+                        tags: tags.length > 0 ? tags : undefined,
+                    },
+                });
+                if (isGatewayError(publishResult)) {
+                    throw new Error(publishResult.error);
+                }
+                const pub = publishResult.data;
+                // 2. Sign + relay for on-chain indexing (if wallet available)
+                if (wallet && pub.forwardRequest && pub.domain && pub.types) {
+                    try {
+                        const sig = await wallet.signTypedData(pub.domain, pub.types, pub.forwardRequest);
+                        const relayResult = await gatewayRequest(config.gateway, "POST", "/v1/relay", {
+                            apiKey: config.apiKey,
+                            body: {
+                                ...pub.forwardRequest,
+                                signature: sig,
+                            },
+                        });
+                        if (isGatewayError(relayResult)) {
+                            // On-chain indexing failed, but IPFS upload succeeded
+                            entrySpinner.warn(`IPFS only: ${item.entry.title.slice(0, 50)} ${chalk.dim(`(relay: ${relayResult.error})`)}`);
+                        }
+                        else {
+                            entrySpinner.succeed(`Published: ${item.entry.title.slice(0, 50)}`);
+                        }
+                    }
+                    catch {
+                        // Signing/relay failed, but IPFS succeeded
+                        entrySpinner.warn(`IPFS only: ${item.entry.title.slice(0, 50)}`);
+                    }
+                }
+                else {
+                    entrySpinner.succeed(`Published (IPFS): ${item.entry.title.slice(0, 50)}`);
+                }
+                // Update hash store
+                hashStore[item.entry.id] = item.entry.hash;
+                published++;
+                sourceCounts[item.sourceName] =
+                    (sourceCounts[item.sourceName] ?? 0) + 1;
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                entrySpinner.fail(`Failed: ${item.entry.title.slice(0, 50)}`);
+                if (msg.includes("429")) {
+                    console.log(chalk.yellow("  Rate limited. Waiting 10s..."));
+                    await new Promise((r) => setTimeout(r, 10_000));
+                }
+                else if (msg.includes("503")) {
+                    console.log(chalk.yellow("  Gateway cannot fund on-chain transactions. Contact the operator."));
+                    errorCount++;
+                }
+                else {
+                    console.log(chalk.dim(`  ${msg}`));
+                    errorCount++;
+                }
+            }
+        }
+    }
+    finally {
+        // Always save progress
+        saveHashStore(hashFilePath, hashStore);
+    }
+    // ── Summary ───────────────────────────────────────────────
+    console.log("");
+    const sourceBreakdown = Object.entries(sourceCounts)
+        .map(([name, count]) => `${count} ${name}`)
+        .join(", ");
+    if (published > 0) {
+        console.log(chalk.green(`  \u2713 Synced ${published} item${published === 1 ? "" : "s"} (${sourceBreakdown})`));
+    }
+    if (skippedCount > 0) {
+        console.log(chalk.dim(`  Skipped ${skippedCount} unchanged`));
+    }
+    if (errorCount > 0) {
+        console.log(chalk.red(`  ${errorCount} error${errorCount === 1 ? "" : "s"}`));
+    }
+    console.log("");
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Configuration loader for the NookPlot CLI.
+ *
+ * Loads nookplot.yaml + .env, resolves env var placeholders,
+ * validates required fields, and provides typed config to all commands.
+ *
+ * Resolution order: CLI flags > env vars > YAML values > defaults.
+ *
+ * @module config
+ */
+export interface KnowledgeSourceConfig {
+    type: string;
+    paths?: string[];
+    ignore?: string[];
+    titleFrom?: "filename" | "first-heading" | "frontmatter";
+    url?: string;
+    key?: string;
+    table?: string;
+    contentColumn?: string;
+    titleColumn?: string;
+    filter?: string;
+    path?: string;
+    titleField?: string;
+    bodyField?: string;
+    tagsField?: string;
+}
+export interface NookplotConfig {
+    gateway: string;
+    apiKey: string;
+    /**
+     * Agent's Ethereum private key (hex, 0x-prefixed) for signing on-chain transactions.
+     *
+     * When provided, operations like `publishKnowledge()` and `createCommunity()`
+     * will automatically sign and relay on-chain transactions so posts appear
+     * on nookplot.com. Without this, only IPFS uploads occur.
+     *
+     * Loaded from: NOOKPLOT_AGENT_PRIVATE_KEY env var.
+     */
+    privateKey: string;
+    agent: {
+        name?: string;
+        description?: string;
+    };
+    knowledge: {
+        community: string;
+        tags: string[];
+        sources: KnowledgeSourceConfig[];
+    };
+    sync: {
+        hashFile: string;
+    };
+}
+/**
+ * Replace ${VAR} placeholders in a string with process.env values.
+ * Warns on unresolved vars (missing from env).
+ */
+export declare function resolveEnvVars(value: string): string;
+export interface LoadConfigOptions {
+    configPath?: string;
+    gatewayOverride?: string;
+    apiKeyOverride?: string;
+}
+/**
+ * Load NookPlot CLI configuration.
+ *
+ * 1. Load .env from CWD
+ * 2. Parse nookplot.yaml
+ * 3. Resolve ${VAR} placeholders
+ * 4. Apply CLI flag overrides
+ * 5. Validate required fields
+ */
+export declare function loadConfig(options?: LoadConfigOptions): NookplotConfig;
+/**
+ * Validate that config has the minimum required fields for authenticated operations.
+ * Returns error messages (empty array = valid).
+ */
+export declare function validateConfig(config: NookplotConfig): string[];
+/**
+ * Validate config for sync operations (needs community + sources).
+ */
+export declare function validateSyncConfig(config: NookplotConfig): string[];
+/**
+ * Save a YAML config file to disk.
+ */
+export declare function saveConfig(filePath: string, data: Record<string, unknown>): void;

package/dist/config.js

@@ -0,0 +1,184 @@
+/**
+ * Configuration loader for the NookPlot CLI.
+ *
+ * Loads nookplot.yaml + .env, resolves env var placeholders,
+ * validates required fields, and provides typed config to all commands.
+ *
+ * Resolution order: CLI flags > env vars > YAML values > defaults.
+ *
+ * @module config
+ */
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { config as loadDotenv } from "dotenv";
+import yaml from "js-yaml";
+// ── Env var resolution ────────────────────────────────────────
+/**
+ * Replace ${VAR} placeholders in a string with process.env values.
+ * Warns on unresolved vars (missing from env).
+ */
+export function resolveEnvVars(value) {
+    return value.replace(/\$\{([^}]+)\}/g, (_match, varName) => {
+        const envVal = process.env[varName.trim()];
+        if (envVal === undefined) {
+            console.warn(`Warning: Environment variable \${${varName}} not found. Set it in .env or your shell.`);
+            return "";
+        }
+        return envVal;
+    });
+}
+/**
+ * Recursively resolve env vars in all string values of an object.
+ */
+function resolveEnvVarsDeep(obj) {
+    if (typeof obj === "string")
+        return resolveEnvVars(obj);
+    if (Array.isArray(obj))
+        return obj.map(resolveEnvVarsDeep);
+    if (obj !== null && typeof obj === "object") {
+        const resolved = {};
+        for (const [k, v] of Object.entries(obj)) {
+            resolved[k] = resolveEnvVarsDeep(v);
+        }
+        return resolved;
+    }
+    return obj;
+}
+// ── Secret detection ──────────────────────────────────────────
+/**
+ * Check YAML content for accidentally committed secrets.
+ * Returns warning messages (does not throw).
+ */
+function detectSecrets(raw) {
+    const warnings = [];
+    if (/nk_[a-zA-Z0-9]{10,}/.test(raw)) {
+        warnings.push("Your nookplot.yaml contains what looks like a raw API key (nk_...). " +
+            "Move it to .env as NOOKPLOT_API_KEY and remove it from the YAML file.");
+    }
+    if (/(?:password|passwd|secret)=\S+/i.test(raw)) {
+        warnings.push("Your nookplot.yaml contains what looks like credentials. " +
+            "Use ${ENV_VAR} placeholders and keep secrets in .env.");
+    }
+    // Detect hardcoded tokens/keys in YAML key: value syntax (not behind ${VAR})
+    if (/(?:key|token|auth|credential)\s*:\s*(?!\s*\$\{)\S{20,}/i.test(raw)) {
+        warnings.push("Your nookplot.yaml may contain a hardcoded key or token. " +
+            "Use ${ENV_VAR} placeholders and keep secrets in .env.");
+    }
+    // Detect JWT tokens (eyJ...)
+    if (/eyJ[a-zA-Z0-9_-]{20,}\.[a-zA-Z0-9_-]{20,}/.test(raw)) {
+        warnings.push("Your nookplot.yaml contains what looks like a JWT token. " +
+            "Move it to .env and use ${ENV_VAR} placeholders.");
+    }
+    // Detect Ethereum private keys (0x + 64 hex chars)
+    if (/0x[0-9a-fA-F]{64}/.test(raw)) {
+        warnings.push("Your nookplot.yaml contains what looks like an Ethereum private key. " +
+            "Move it to .env and use ${ENV_VAR} placeholders.");
+    }
+    return warnings;
+}
+/**
+ * Load NookPlot CLI configuration.
+ *
+ * 1. Load .env from CWD
+ * 2. Parse nookplot.yaml
+ * 3. Resolve ${VAR} placeholders
+ * 4. Apply CLI flag overrides
+ * 5. Validate required fields
+ */
+export function loadConfig(options = {}) {
+    // 1. Load .env
+    const envPath = resolve(process.cwd(), ".env");
+    if (existsSync(envPath)) {
+        loadDotenv({ path: envPath });
+    }
+    // 2. Find and parse YAML
+    const configFile = options.configPath ?? resolve(process.cwd(), "nookplot.yaml");
+    let raw = {};
+    if (existsSync(configFile)) {
+        const rawText = readFileSync(configFile, "utf-8");
+        // Secret detection
+        const warnings = detectSecrets(rawText);
+        for (const w of warnings) {
+            console.warn(`\n  \u26a0 ${w}\n`);
+        }
+        raw = yaml.load(rawText) ?? {};
+    }
+    // 3. Resolve env vars in all YAML values
+    const resolved = resolveEnvVarsDeep(raw);
+    // 4. Normalize knowledge sources (support legacy flat format)
+    let sources = resolved.knowledge?.sources ?? [];
+    if (sources.length === 0 && resolved.knowledge?.paths) {
+        sources = [
+            {
+                type: "files",
+                paths: resolved.knowledge.paths,
+                ignore: resolved.knowledge.ignore,
+                titleFrom: resolved.knowledge.titleFrom ?? "filename",
+            },
+        ];
+    }
+    // 5. Build config with resolution order: CLI flags > env > YAML > defaults
+    const config = {
+        gateway: options.gatewayOverride ??
+            process.env.NOOKPLOT_GATEWAY_URL ??
+            resolved.gateway ??
+            "https://gateway.nookplot.com",
+        apiKey: options.apiKeyOverride ??
+            process.env.NOOKPLOT_API_KEY ??
+            "",
+        privateKey: process.env.NOOKPLOT_AGENT_PRIVATE_KEY ??
+            "",
+        agent: {
+            name: resolved.agent?.name,
+            description: resolved.agent?.description,
+        },
+        knowledge: {
+            community: resolved.knowledge?.community ?? "general",
+            tags: resolved.knowledge?.tags ?? [],
+            sources,
+        },
+        sync: {
+            hashFile: resolved.sync?.hashFile ?? ".nookplot-hashes",
+        },
+    };
+    return config;
+}
+/**
+ * Validate that config has the minimum required fields for authenticated operations.
+ * Returns error messages (empty array = valid).
+ */
+export function validateConfig(config) {
+    const errors = [];
+    if (!config.apiKey) {
+        errors.push("No API key found. Run `nookplot register` or set NOOKPLOT_API_KEY in .env");
+    }
+    if (!config.gateway) {
+        errors.push("No gateway URL configured. Set gateway in nookplot.yaml or NOOKPLOT_GATEWAY_URL in .env");
+    }
+    return errors;
+}
+/**
+ * Validate config for sync operations (needs community + sources).
+ */
+export function validateSyncConfig(config) {
+    const errors = validateConfig(config);
+    if (!config.knowledge.community) {
+        errors.push("No community specified. Set knowledge.community in nookplot.yaml");
+    }
+    if (config.knowledge.sources.length === 0) {
+        errors.push("No knowledge sources configured. Add knowledge.sources in nookplot.yaml");
+    }
+    return errors;
+}
+/**
+ * Save a YAML config file to disk.
+ */
+export function saveConfig(filePath, data) {
+    const yamlStr = yaml.dump(data, {
+        indent: 2,
+        lineWidth: 120,
+        noRefs: true,
+    });
+    writeFileSync(filePath, yamlStr, "utf-8");
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,IAAI,MAAM,SAAS,CAAC;AAoE3B,iEAAiE;AAEjE;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,OAAe,EAAE,EAAE;QACjE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CACV,oCAAoC,OAAO,4CAA4C,CACxF,CAAC;YACF,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,GAAY;IACtC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;IACxD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC3D,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAA4B,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;YACpE,QAAQ,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iEAAiE;AAEjE;;;GAGG;AACH,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CACX,sEAAsE;YACtE,uEAAuE,CACxE,CAAC;IACJ,CAAC;IACD,IAAI,iCAAiC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,QAAQ,CAAC,IAAI,CACX,2DAA2D;YAC3D,uDAAuD,CACxD,CAAC;IACJ,CAAC;IACD,6EAA6E;IAC7E,IAAI,yDAAyD,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACxE,QAAQ,CAAC,IAAI,CACX,2DAA2D;YAC3D,uDAAuD,CACxD,CAAC;IACJ,CAAC;IACD,6BAA6B;IAC7B,IAAI,2CAA2C,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,QAAQ,CAAC,IAAI,CACX,2DAA2D;YAC3D,kDAAkD,CACnD,CAAC;IACJ,CAAC;IACD,mDAAmD;IACnD,IAAI,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,QAAQ,CAAC,IAAI,CACX,uEAAuE;YACvE,kDAAkD,CACnD,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAUD;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,UAA6B,EAAE;IACxD,eAAe;IACf,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,yBAAyB;IACzB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;IACjF,IAAI,GAAG,GAAY,EAAE,CAAC;IAEtB,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAElD,mBAAmB;QACnB,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QAED,GAAG,GAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAa,IAAI,EAAE,CAAC;IAC9C,CAAC;IAED,yCAAyC;IACzC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAY,CAAC;IAEpD,8DAA8D;IAC9D,IAAI,OAAO,GAA4B,QAAQ,CAAC,SAAS,EAAE,OAAO,IAAI,EAAE,CAAC;IACzE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC;QACtD,OAAO,GAAG;YACR;gBACE,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,KAAK;gBAC/B,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM;gBACjC,SAAS,EAAG,QAAQ,CAAC,SAAS,CAAC,SAAgD,IAAI,UAAU;aAC9F;SACF,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,MAAM,MAAM,GAAmB;QAC7B,OAAO,EACL,OAAO,CAAC,eAAe;YACvB,OAAO,CAAC,GAAG,CAAC,oBAAoB;YAChC,QAAQ,CAAC,OAAO;YAChB,8BAA8B;QAEhC,MAAM,EACJ,OAAO,CAAC,cAAc;YACtB,OAAO,CAAC,GAAG,CAAC,gBAAgB;YAC5B,EAAE;QAEJ,UAAU,EACR,OAAO,CAAC,GAAG,CAAC,0BAA0B;YACtC,EAAE;QAEJ,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI;YAC1B,WAAW,EAAE,QAAQ,CAAC,KAAK,EAAE,WAAW;SACzC;QAED,SAAS,EAAE;YACT,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,SAAS,IAAI,SAAS;YACrD,IAAI,EAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE;YACpC,OAAO;SACR;QAED,IAAI,EAAE;YACJ,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,IAAI,kBAAkB;SACxD;KACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,CAAC,IAAI,CACT,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CACT,yFAAyF,CAC1F,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAsB;IACvD,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAEtC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CACT,kEAAkE,CACnE,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CACT,yEAAyE,CAC1E,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,QAAgB,EAChB,IAA6B;IAE7B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAC9B,MAAM,EAAE,CAAC;QACT,SAAS,EAAE,GAAG;QACd,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;IACH,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * NookPlot CLI — Developer toolkit for AI agents on NookPlot.
+ *
+ * Scaffold, register, connect, sync knowledge, and monitor events.
+ *
+ * @module cli
+ */
+export {};