@samy-clivolt/create-pi-ag-ui 0.1.2

package/README.md

@@ -0,0 +1,50 @@
+# @samy-clivolt/create-pi-ag-ui
+
+Scaffold a new **Pi AG-UI** project — an AG-UI protocol bridge with a CopilotKit-powered frontend.
+
+## Usage
+
+```bash
+npx @samy-clivolt/create-pi-ag-ui my-app
+```
+
+Then follow the prompts.
+
+### Options
+
+```bash
+npx @samy-clivolt/create-pi-ag-ui my-app --pm pnpm       # Use pnpm
+npx @samy-clivolt/create-pi-ag-ui my-app --skip-install   # Don't install deps
+npx @samy-clivolt/create-pi-ag-ui --help                  # Show help
+```
+
+### What you get
+
+A fully-featured AG-UI project with:
+
+- 🔌 **24/24 AG-UI events** — full protocol coverage
+- 💬 **CopilotKit chat** — streaming, reasoning, tool calls
+- 🛠️ **Frontend tools** — 7 example tools with generative UI
+- 🧠 **Thinking/Reasoning** — collapsible reasoning blocks
+- 📊 **Agent state panel** — live status, metrics, activities
+- 🔄 **Multi-thread** — isolated sessions per conversation
+- 💾 **Persistence** — optional JSONL session storage
+- 📱 **Responsive** — mobile-friendly layout
+
+### Quick start after scaffolding
+
+```bash
+cd my-app
+
+# Add your API key
+echo "ANTHROPIC_API_KEY=sk-ant-..." >> .env.local
+
+# Start
+npm run dev
+```
+
+Open http://localhost:3000.
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,236 @@
+#!/usr/bin/env node
+import { existsSync } from "fs";
+import { cp, mkdir, readdir, readFile, writeFile } from "fs/promises";
+import { resolve, join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { createInterface } from "readline";
+import { execSync } from "child_process";
+// ── ANSI helpers ──────────────────────────────────────────────
+const bold = (s) => `\x1b[1m${s}\x1b[0m`;
+const green = (s) => `\x1b[32m${s}\x1b[0m`;
+const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
+const red = (s) => `\x1b[31m${s}\x1b[0m`;
+const dim = (s) => `\x1b[2m${s}\x1b[0m`;
+const yellow = (s) => `\x1b[33m${s}\x1b[0m`;
+function parseArgs(argv) {
+    const args = argv.slice(2);
+    let projectName = "";
+    let pm = "";
+    let skipInstall = false;
+    let help = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--help" || arg === "-h") {
+            help = true;
+        }
+        else if (arg === "--skip-install") {
+            skipInstall = true;
+        }
+        else if (arg === "--pm" && i + 1 < args.length) {
+            pm = args[++i];
+        }
+        else if (!arg.startsWith("-")) {
+            projectName = arg;
+        }
+    }
+    return { projectName, pm, skipInstall, help };
+}
+// ── Interactive prompts (zero deps) ──────────────────────────
+function ask(message, fallback) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const hint = fallback ? dim(` (${fallback})`) : "";
+    return new Promise((resolve) => {
+        rl.question(`  ${message}${hint}: `, (answer) => {
+            rl.close();
+            resolve(answer.trim() || fallback || "");
+        });
+    });
+}
+function choose(message, options, defaultIdx = 0) {
+    return new Promise(async (res) => {
+        console.log(`\n  ${message}`);
+        for (let i = 0; i < options.length; i++) {
+            const marker = i === defaultIdx ? green("❯") : " ";
+            console.log(`    ${marker} ${i + 1}. ${options[i]}`);
+        }
+        const answer = await ask(`  Choose [1-${options.length}]`, String(defaultIdx + 1));
+        const idx = parseInt(answer) - 1;
+        res(options[idx] ?? options[defaultIdx]);
+    });
+}
+// ── Package manager detection ────────────────────────────────
+const VALID_PMS = ["npm", "pnpm", "yarn", "bun"];
+function detectPM() {
+    for (const pm of ["pnpm", "yarn", "bun"]) {
+        try {
+            execSync(`${pm} --version`, { stdio: "ignore" });
+            return pm;
+        }
+        catch {
+            /* not installed */
+        }
+    }
+    return "npm";
+}
+function installCmd(pm) {
+    return pm === "yarn" ? "yarn" : `${pm} install`;
+}
+function runCmd(pm, script) {
+    if (pm === "yarn")
+        return `yarn ${script}`;
+    if (pm === "bun")
+        return `bun run ${script}`;
+    return `${pm} run ${script}`;
+}
+// ── Template copy with _dotfile → .dotfile renaming ──────────
+async function copyDir(src, dest) {
+    await mkdir(dest, { recursive: true });
+    const entries = await readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = join(src, entry.name);
+        // _gitignore → .gitignore, _env.example → .env.example
+        // But keep __tests__, __mocks__, etc. (double underscore = convention)
+        const destName = entry.name.startsWith("_") && !entry.name.startsWith("__")
+            ? `.${entry.name.slice(1)}`
+            : entry.name;
+        const destPath = join(dest, destName);
+        if (entry.isDirectory()) {
+            await copyDir(srcPath, destPath);
+        }
+        else {
+            await cp(srcPath, destPath);
+        }
+    }
+}
+// ── Main ─────────────────────────────────────────────────────
+async function main() {
+    const { projectName: argName, pm: argPM, skipInstall, help } = parseArgs(process.argv);
+    // ── Help ──
+    if (help) {
+        console.log(`
+${bold("@samy-clivolt/create-pi-ag-ui")} — Scaffold a new Pi AG-UI project
+
+${bold("Usage:")}
+  npx @samy-clivolt/create-pi-ag-ui ${dim("[project-name]")} ${dim("[options]")}
+
+${bold("Options:")}
+  --pm ${dim("<npm|pnpm|yarn|bun>")}  Package manager (default: auto-detect)
+  --skip-install             Skip dependency installation
+  -h, --help                 Show this help
+
+${bold("Examples:")}
+  npx @samy-clivolt/create-pi-ag-ui my-app
+  npx @samy-clivolt/create-pi-ag-ui my-app --pm pnpm
+  npx @samy-clivolt/create-pi-ag-ui my-app --skip-install
+`);
+        process.exit(0);
+    }
+    // ── Banner ──
+    console.log(`
+${bold("🚀 @samy-clivolt/create-pi-ag-ui")}
+${dim("AG-UI protocol bridge with CopilotKit frontend")}
+`);
+    // ── 1. Project name ──
+    let projectName = argName;
+    if (!projectName) {
+        if (!process.stdin.isTTY) {
+            console.error(red("  ✖ Project name is required in non-interactive mode."));
+            console.error(dim("    Usage: npx @samy-clivolt/create-pi-ag-ui <project-name>"));
+            process.exit(1);
+        }
+        projectName = await ask("Project name", "my-pi-ag-ui-app");
+    }
+    if (!projectName) {
+        console.error(red("  ✖ Project name is required."));
+        process.exit(1);
+    }
+    // Validate name
+    if (!/^[a-zA-Z0-9_@][a-zA-Z0-9._@/-]*$/.test(projectName)) {
+        console.error(red(`  ✖ Invalid project name: "${projectName}"`));
+        process.exit(1);
+    }
+    const projectDir = resolve(process.cwd(), projectName);
+    if (existsSync(projectDir)) {
+        console.error(red(`  ✖ Directory "${projectName}" already exists.`));
+        process.exit(1);
+    }
+    // ── 2. Package manager ──
+    let pm;
+    if (argPM && VALID_PMS.includes(argPM)) {
+        pm = argPM;
+    }
+    else if (process.stdin.isTTY) {
+        const detected = detectPM();
+        const choice = await choose("Package manager:", [...VALID_PMS], VALID_PMS.indexOf(detected));
+        pm = choice;
+    }
+    else {
+        pm = detectPM();
+    }
+    // ── 3. Scaffolding ──
+    console.log(`\n  ${dim("Scaffolding")} ${bold(projectName)} ${dim("...")}`);
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const templateDir = resolve(__dirname, "..", "template");
+    if (!existsSync(templateDir)) {
+        console.error(red("  ✖ Template directory not found. Package may be corrupted."));
+        process.exit(1);
+    }
+    await copyDir(templateDir, projectDir);
+    // ── 4. Patch package.json ──
+    const pkgPath = join(projectDir, "package.json");
+    const pkg = JSON.parse(await readFile(pkgPath, "utf-8"));
+    pkg.name = projectName;
+    await writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+    // ── 5. Create .env.local ──
+    const envExamplePath = join(projectDir, ".env.example");
+    const envLocalPath = join(projectDir, ".env.local");
+    if (existsSync(envExamplePath)) {
+        const envContent = await readFile(envExamplePath, "utf-8");
+        await writeFile(envLocalPath, envContent);
+    }
+    // ── 6. Init git repo ──
+    try {
+        execSync("git init", { cwd: projectDir, stdio: "ignore" });
+        execSync("git add -A", { cwd: projectDir, stdio: "ignore" });
+        execSync('git commit -m "Initial commit from @samy-clivolt/create-pi-ag-ui"', {
+            cwd: projectDir,
+            stdio: "ignore",
+        });
+    }
+    catch {
+        // git not available — skip silently
+    }
+    // ── 7. Install deps ──
+    if (!skipInstall) {
+        console.log(`  ${dim(`Installing dependencies with ${pm}...`)}\n`);
+        try {
+            execSync(installCmd(pm), { cwd: projectDir, stdio: "inherit" });
+        }
+        catch {
+            console.warn(`\n  ${yellow("⚠")} Failed to install dependencies. Run manually:`);
+            console.warn(`    cd ${projectName} && ${installCmd(pm)}\n`);
+        }
+    }
+    // ── 8. Done ──
+    console.log(`
+  ${green("✅ Project created successfully!")}
+
+  ${bold("Next steps:")}
+
+    ${cyan(`cd ${projectName}`)}
+${skipInstall ? `    ${cyan(installCmd(pm))}\n` : ""}    ${dim("# Add your API key to .env.local")}
+    ${yellow("ANTHROPIC_API_KEY=sk-ant-...")}
+
+    ${cyan(runCmd(pm, "dev"))}
+
+  ${dim("Then open")} ${cyan("http://localhost:3000")}
+
+  ${dim("─────────────────────────────────────────")}
+  ${dim("Docs: https://github.com/samy-clivolt/pi-ag-ui")}
+`);
+}
+main().catch((err) => {
+    console.error(red(`\n  ✖ ${err.message}`));
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@samy-clivolt/create-pi-ag-ui",
+  "version": "0.1.2",
+  "description": "Scaffold a Pi AG-UI project — AG-UI protocol bridge with CopilotKit frontend",
+  "type": "module",
+  "bin": {
+    "create-pi-ag-ui": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "template"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ag-ui",
+    "copilotkit",
+    "pi",
+    "agent",
+    "scaffold",
+    "create",
+    "template"
+  ],
+  "author": "",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  }
+}