agentcn 0.1.0

package/dist/tests/add.integration.test.js

@@ -0,0 +1,190 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = __importDefault(require("node:path"));
+const node_test_1 = __importDefault(require("node:test"));
+const add_js_1 = require("../commands/add.js");
+function createRegistry(registryDir) {
+    (0, node_fs_1.mkdirSync)(registryDir, { recursive: true });
+    (0, node_fs_1.writeFileSync)(node_path_1.default.join(registryDir, "index.json"), JSON.stringify({
+        schemaVersion: 1,
+        name: "agentcn",
+        items: [{ name: "file-agent", description: "File agent" }],
+    }, null, 2), "utf-8");
+    (0, node_fs_1.writeFileSync)(node_path_1.default.join(registryDir, "file-agent.json"), JSON.stringify({
+        schemaVersion: 1,
+        name: "file-agent",
+        type: "registry:agent",
+        description: "File agent",
+        dependencies: [],
+        envVars: { ANTHROPIC_API_KEY: "" },
+        files: [
+            {
+                path: "ai/agents/file-agent/index.ts",
+                type: "registry:agent",
+                content: "export const ok = true;\n",
+            },
+        ],
+    }, null, 2), "utf-8");
+}
+(0, node_test_1.default)("runAddCommand applies files for local path registry", async () => {
+    const root = (0, node_fs_1.mkdtempSync)(node_path_1.default.join((0, node_os_1.tmpdir)(), "agentcn-add-local-"));
+    const projectDir = node_path_1.default.join(root, "project");
+    const registryDir = node_path_1.default.join(root, "registry");
+    (0, node_fs_1.mkdirSync)(projectDir, { recursive: true });
+    createRegistry(registryDir);
+    (0, node_fs_1.writeFileSync)(node_path_1.default.join(projectDir, "tsconfig.json"), "{}", "utf-8");
+    try {
+        await (0, add_js_1.runAddCommand)("file-agent", {
+            registry: registryDir,
+            cwd: projectDir,
+            yes: true,
+        });
+        const target = node_path_1.default.join(projectDir, "ai/agents/file-agent/index.ts");
+        const content = (0, node_fs_1.readFileSync)(target, "utf-8");
+        strict_1.default.equal(content.includes("ok = true"), true);
+    }
+    finally {
+        (0, node_fs_1.rmSync)(root, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)("runAddCommand dry-run does not write files", async () => {
+    const root = (0, node_fs_1.mkdtempSync)(node_path_1.default.join((0, node_os_1.tmpdir)(), "agentcn-add-dry-"));
+    const projectDir = node_path_1.default.join(root, "project");
+    const registryDir = node_path_1.default.join(root, "registry");
+    (0, node_fs_1.mkdirSync)(projectDir, { recursive: true });
+    createRegistry(registryDir);
+    (0, node_fs_1.writeFileSync)(node_path_1.default.join(projectDir, "tsconfig.json"), "{}", "utf-8");
+    try {
+        await (0, add_js_1.runAddCommand)("file-agent", {
+            registry: registryDir,
+            cwd: projectDir,
+            dryRun: true,
+            yes: true,
+        });
+        const target = node_path_1.default.join(projectDir, "ai/agents/file-agent/index.ts");
+        strict_1.default.equal((() => {
+            try {
+                (0, node_fs_1.readFileSync)(target, "utf-8");
+                return true;
+            }
+            catch {
+                return false;
+            }
+        })(), false);
+    }
+    finally {
+        (0, node_fs_1.rmSync)(root, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)("runAddCommand supports alias agent name", async () => {
+    const root = (0, node_fs_1.mkdtempSync)(node_path_1.default.join((0, node_os_1.tmpdir)(), "agentcn-add-alias-"));
+    const projectDir = node_path_1.default.join(root, "project");
+    const registryDir = node_path_1.default.join(root, "registry");
+    (0, node_fs_1.mkdirSync)(projectDir, { recursive: true });
+    createRegistry(registryDir);
+    (0, node_fs_1.writeFileSync)(node_path_1.default.join(projectDir, "tsconfig.json"), "{}", "utf-8");
+    try {
+        await (0, add_js_1.runAddCommand)("fileagent", {
+            registry: registryDir,
+            cwd: projectDir,
+            yes: true,
+        });
+        const target = node_path_1.default.join(projectDir, "ai/agents/file-agent/index.ts");
+        const content = (0, node_fs_1.readFileSync)(target, "utf-8");
+        strict_1.default.equal(content.includes("ok = true"), true);
+    }
+    finally {
+        (0, node_fs_1.rmSync)(root, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)("runAddCommand in --yes mode skips interactive prompts", async () => {
+    const root = (0, node_fs_1.mkdtempSync)(node_path_1.default.join((0, node_os_1.tmpdir)(), "agentcn-add-yes-"));
+    const projectDir = node_path_1.default.join(root, "project");
+    const registryDir = node_path_1.default.join(root, "registry");
+    (0, node_fs_1.mkdirSync)(projectDir, { recursive: true });
+    createRegistry(registryDir);
+    (0, node_fs_1.writeFileSync)(node_path_1.default.join(projectDir, "tsconfig.json"), "{}", "utf-8");
+    const existingTarget = node_path_1.default.join(projectDir, "ai/agents/file-agent/index.ts");
+    (0, node_fs_1.mkdirSync)(node_path_1.default.dirname(existingTarget), { recursive: true });
+    (0, node_fs_1.writeFileSync)(existingTarget, "export const existing = true;\n", "utf-8");
+    let promptCalls = 0;
+    const confirm = async () => {
+        promptCalls += 1;
+        return false;
+    };
+    try {
+        await (0, add_js_1.runAddCommand)("file-agent", {
+            registry: registryDir,
+            cwd: projectDir,
+            dryRun: true,
+            yes: true,
+        }, { confirm });
+        strict_1.default.equal(promptCalls, 0);
+    }
+    finally {
+        (0, node_fs_1.rmSync)(root, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)("runAddCommand prompts for overwrite when conflicts exist", async () => {
+    const root = (0, node_fs_1.mkdtempSync)(node_path_1.default.join((0, node_os_1.tmpdir)(), "agentcn-add-prompt-"));
+    const projectDir = node_path_1.default.join(root, "project");
+    const registryDir = node_path_1.default.join(root, "registry");
+    (0, node_fs_1.mkdirSync)(projectDir, { recursive: true });
+    createRegistry(registryDir);
+    (0, node_fs_1.writeFileSync)(node_path_1.default.join(projectDir, "tsconfig.json"), "{}", "utf-8");
+    const existingTarget = node_path_1.default.join(projectDir, "ai/agents/file-agent/index.ts");
+    (0, node_fs_1.mkdirSync)(node_path_1.default.dirname(existingTarget), { recursive: true });
+    (0, node_fs_1.writeFileSync)(existingTarget, "export const existing = true;\n", "utf-8");
+    const prompts = [];
+    const confirm = async (message) => {
+        prompts.push(message);
+        return false;
+    };
+    try {
+        await (0, add_js_1.runAddCommand)("file-agent", {
+            registry: registryDir,
+            cwd: projectDir,
+        }, { confirm });
+        strict_1.default.equal(prompts.some((message) => message.includes("Overwrite")), true);
+    }
+    finally {
+        (0, node_fs_1.rmSync)(root, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)("runAddCommand prints structured output sections", async () => {
+    const root = (0, node_fs_1.mkdtempSync)(node_path_1.default.join((0, node_os_1.tmpdir)(), "agentcn-add-output-"));
+    const projectDir = node_path_1.default.join(root, "project");
+    const registryDir = node_path_1.default.join(root, "registry");
+    (0, node_fs_1.mkdirSync)(projectDir, { recursive: true });
+    createRegistry(registryDir);
+    (0, node_fs_1.writeFileSync)(node_path_1.default.join(projectDir, "tsconfig.json"), "{}", "utf-8");
+    const logs = [];
+    const originalLog = console.log;
+    console.log = (...args) => {
+        logs.push(args.map(String).join(" "));
+    };
+    try {
+        await (0, add_js_1.runAddCommand)("file-agent", {
+            registry: registryDir,
+            cwd: projectDir,
+            dryRun: true,
+            yes: true,
+        });
+        const output = logs.join("\n");
+        strict_1.default.equal(output.includes("Resolving registry"), true);
+        strict_1.default.equal(output.includes("Plan summary"), true);
+        strict_1.default.equal(output.includes("Config updates"), true);
+        strict_1.default.equal(output.includes("Installing dependencies"), true);
+        strict_1.default.equal(output.includes("Next steps:"), true);
+    }
+    finally {
+        console.log = originalLog;
+        (0, node_fs_1.rmSync)(root, { recursive: true, force: true });
+    }
+});

package/dist/tests/config.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/config.test.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = __importDefault(require("node:path"));
+const node_test_1 = __importDefault(require("node:test"));
+const config_js_1 = require("../lib/config.js");
+(0, node_test_1.default)("mergeEnvContent appends only missing env keys", () => {
+    const existing = "EXISTING_KEY=value\nANTHROPIC_API_KEY=already";
+    const { content, added } = (0, config_js_1.mergeEnvContent)(existing, {
+        ANTHROPIC_API_KEY: "",
+        NEW_KEY: "abc",
+    });
+    strict_1.default.deepEqual(added, ["NEW_KEY"]);
+    strict_1.default.equal(content.includes("NEW_KEY=abc"), true);
+    strict_1.default.equal(content.includes("ANTHROPIC_API_KEY=already"), true);
+});
+(0, node_test_1.default)("updateTsconfigPaths adds ai aliases", () => {
+    const dir = (0, node_fs_1.mkdtempSync)(node_path_1.default.join((0, node_os_1.tmpdir)(), "agentcn-tsconfig-"));
+    try {
+        const tsconfigPath = node_path_1.default.join(dir, "tsconfig.json");
+        (0, node_fs_1.writeFileSync)(tsconfigPath, JSON.stringify({ compilerOptions: { strict: true } }, null, 2), "utf-8");
+        const changed = (0, config_js_1.updateTsconfigPaths)(dir, { dryRun: false });
+        strict_1.default.equal(changed, true);
+        const updated = JSON.parse((0, node_fs_1.readFileSync)(tsconfigPath, "utf-8"));
+        strict_1.default.deepEqual(updated.compilerOptions.paths["@/agents/*"], [
+            "./ai/agents/*",
+        ]);
+        strict_1.default.deepEqual(updated.compilerOptions.paths["@/tools/*"], [
+            "./ai/tools/*",
+        ]);
+    }
+    finally {
+        (0, node_fs_1.rmSync)(dir, { recursive: true, force: true });
+    }
+});

package/dist/tests/deps.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/deps.test.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_test_1 = __importDefault(require("node:test"));
+const deps_js_1 = require("../lib/deps.js");
+(0, node_test_1.default)("getExecErrorOutput includes stdout and stderr", () => {
+    const message = (0, deps_js_1.getExecErrorOutput)({
+        message: "Command failed",
+        stdout: "ERR_PNPM_ADDING_TO_ROOT",
+        stderr: "",
+    });
+    strict_1.default.equal(message.includes("Command failed"), true);
+    strict_1.default.equal(message.includes("ERR_PNPM_ADDING_TO_ROOT"), true);
+});

package/dist/tests/registry-url.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/registry-url.test.js

@@ -0,0 +1,143 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_fs_1 = require("node:fs");
+const node_http_1 = require("node:http");
+const node_os_1 = require("node:os");
+const node_path_1 = __importDefault(require("node:path"));
+const node_test_1 = __importDefault(require("node:test"));
+const registry_js_1 = require("../lib/registry.js");
+(0, node_test_1.default)("loads registry index and item from URL", async () => {
+    const index = {
+        schemaVersion: 1,
+        name: "agentcn",
+        items: [{ name: "file-agent", description: "File agent" }],
+    };
+    const item = {
+        schemaVersion: 1,
+        name: "file-agent",
+        type: "registry:agent",
+        description: "File agent",
+        files: [],
+    };
+    const server = (0, node_http_1.createServer)((req, res) => {
+        res.setHeader("Content-Type", "application/json");
+        if (req.url === "/index.json") {
+            res.end(JSON.stringify(index));
+            return;
+        }
+        if (req.url === "/file-agent.json") {
+            res.end(JSON.stringify(item));
+            return;
+        }
+        res.statusCode = 404;
+        res.end("{}");
+    });
+    await new Promise((resolve) => server.listen(0, resolve));
+    const address = server.address();
+    if (!address || typeof address === "string") {
+        server.close();
+        throw new Error("Failed to get server port");
+    }
+    const baseUrl = `http://127.0.0.1:${address.port}`;
+    try {
+        const loadedIndex = await (0, registry_js_1.loadRegistryIndex)(baseUrl);
+        const loadedItem = await (0, registry_js_1.loadRegistryItem)("file-agent", baseUrl);
+        strict_1.default.equal(loadedIndex.items.length, 1);
+        strict_1.default.equal(loadedItem.name, "file-agent");
+    }
+    finally {
+        server.close();
+    }
+});
+(0, node_test_1.default)("uses env registry URL when provided", () => {
+    const previous = process.env.AGENTCN_REGISTRY_URL;
+    process.env.AGENTCN_REGISTRY_URL = "http://localhost:3000/r";
+    try {
+        const source = (0, registry_js_1.resolveRegistrySource)(undefined, process.cwd());
+        strict_1.default.equal(source, "http://localhost:3000/r");
+    }
+    finally {
+        if (previous === undefined) {
+            delete process.env.AGENTCN_REGISTRY_URL;
+        }
+        else {
+            process.env.AGENTCN_REGISTRY_URL = previous;
+        }
+    }
+});
+(0, node_test_1.default)("registry arg path takes precedence over env", () => {
+    const previous = process.env.AGENTCN_REGISTRY_URL;
+    const tempDir = (0, node_fs_1.mkdtempSync)(node_path_1.default.join((0, node_os_1.tmpdir)(), "agentcn-registry-"));
+    process.env.AGENTCN_REGISTRY_URL = "https://agentcn.dev/r";
+    try {
+        const source = (0, registry_js_1.resolveRegistrySource)(tempDir, process.cwd());
+        strict_1.default.equal(source, tempDir);
+    }
+    finally {
+        (0, node_fs_1.rmSync)(tempDir, { recursive: true, force: true });
+        if (previous === undefined) {
+            delete process.env.AGENTCN_REGISTRY_URL;
+        }
+        else {
+            process.env.AGENTCN_REGISTRY_URL = previous;
+        }
+    }
+});
+(0, node_test_1.default)("uses local bundled registry path or production fallback", () => {
+    const previous = process.env.AGENTCN_REGISTRY_URL;
+    delete process.env.AGENTCN_REGISTRY_URL;
+    try {
+        const source = (0, registry_js_1.resolveRegistrySource)(undefined, process.cwd());
+        strict_1.default.ok(source === "https://agentcn.dev/r" ||
+            source.endsWith("/apps/web/public/r"));
+    }
+    finally {
+        if (previous !== undefined) {
+            process.env.AGENTCN_REGISTRY_URL = previous;
+        }
+    }
+});
+(0, node_test_1.default)("throws on schema mismatch", async () => {
+    const server = (0, node_http_1.createServer)((_req, res) => {
+        res.setHeader("Content-Type", "application/json");
+        res.end(JSON.stringify({
+            schemaVersion: 2,
+            name: "agentcn",
+            items: [],
+        }));
+    });
+    await new Promise((resolve) => server.listen(0, resolve));
+    const address = server.address();
+    if (!address || typeof address === "string") {
+        server.close();
+        throw new Error("Failed to get server port");
+    }
+    try {
+        await strict_1.default.rejects(() => (0, registry_js_1.loadRegistryIndex)(`http://127.0.0.1:${address.port}`), /Registry schema mismatch/);
+    }
+    finally {
+        server.close();
+    }
+});
+(0, node_test_1.default)("throws on malformed index payload", async () => {
+    const server = (0, node_http_1.createServer)((_req, res) => {
+        res.setHeader("Content-Type", "application/json");
+        res.end(JSON.stringify({ schemaVersion: 1 }));
+    });
+    await new Promise((resolve) => server.listen(0, resolve));
+    const address = server.address();
+    if (!address || typeof address === "string") {
+        server.close();
+        throw new Error("Failed to get server port");
+    }
+    try {
+        await strict_1.default.rejects(() => (0, registry_js_1.loadRegistryIndex)(`http://127.0.0.1:${address.port}`), /name|items/);
+    }
+    finally {
+        server.close();
+    }
+});

package/dist/types.d.ts

@@ -0,0 +1,51 @@
+export type RegistryFile = {
+    path: string;
+    type: string;
+    target?: string;
+    content: string;
+};
+export type RegistryItem = {
+    schemaVersion: number;
+    name: string;
+    type: string;
+    description: string;
+    title?: string;
+    categories?: string[];
+    dependencies?: string[];
+    envVars?: Record<string, string>;
+    files: RegistryFile[];
+};
+export type RegistryIndexItem = {
+    name: string;
+    description: string;
+    categories?: string[];
+};
+export type RegistryIndex = {
+    schemaVersion: number;
+    name: string;
+    homepage?: string;
+    items: RegistryIndexItem[];
+};
+export type AddOptionsInput = {
+    registry?: string;
+    dryRun?: boolean;
+    overwrite?: boolean;
+    yes?: boolean;
+    verbose?: boolean;
+    cwd?: string;
+};
+export type AddOptions = {
+    registry?: string;
+    dryRun: boolean;
+    overwrite: boolean;
+    yes: boolean;
+    verbose: boolean;
+    cwd: string;
+};
+export type PlannedFileAction = {
+    sourcePath: string;
+    targetPath: string;
+    absoluteTargetPath: string;
+    content: string;
+    action: "create" | "update" | "skip";
+};

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/logger.d.ts

@@ -0,0 +1,7 @@
+export declare const logger: {
+    error(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    success(...args: unknown[]): void;
+    break(): void;
+};

package/dist/utils/logger.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+exports.logger = {
+    error(...args) {
+        console.error(args.join(" "));
+    },
+    warn(...args) {
+        console.warn(args.join(" "));
+    },
+    info(...args) {
+        console.log(args.join(" "));
+    },
+    success(...args) {
+        console.log(args.join(" "));
+    },
+    break() {
+        console.log("");
+    },
+};

package/dist/utils/prompt.d.ts

@@ -0,0 +1 @@
+export declare function confirmAction(message: string, defaultValue?: boolean): Promise<boolean>;

package/dist/utils/prompt.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confirmAction = confirmAction;
+const promises_1 = require("node:readline/promises");
+const node_process_1 = require("node:process");
+async function confirmAction(message, defaultValue = true) {
+    const suffix = defaultValue ? "Y/n" : "y/N";
+    const rl = (0, promises_1.createInterface)({ input: node_process_1.stdin, output: node_process_1.stdout });
+    try {
+        const answer = (await rl.question(`${message} (${suffix}) `))
+            .trim()
+            .toLowerCase();
+        if (!answer)
+            return defaultValue;
+        return answer === "y" || answer === "yes";
+    }
+    finally {
+        rl.close();
+    }
+}

package/dist/utils/spinner.d.ts

@@ -0,0 +1,2 @@
+import { type Options } from "ora";
+export declare function spinner(text: Options["text"]): import("ora", { with: { "resolution-mode": "import" } }).Ora;

package/dist/utils/spinner.js

@@ -0,0 +1,10 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spinner = spinner;
+const ora_1 = __importDefault(require("ora"));
+function spinner(text) {
+    return (0, ora_1.default)({ text });
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "agentcn",
+  "version": "0.1.0",
+  "description": "CLI to install AI agents into your project",
+  "bin": {
+    "agentcn": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "commander": "^12.1.0",
+    "ora": "^8.2.0",
+    "path-exists": "^5.0.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.0",
+    "typescript": "~5.9.2"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "pnpm run build && node --test dist/tests/**/*.test.js",
+    "pack:smoke": "pnpm run build && pnpm pack --pack-destination ./.artifacts"
+  }
+}