@genui-a3/create 0.1.3 → 0.1.4

package/README.md

@@ -73,6 +73,23 @@ Inside a generated project you can run:
 | `npm run build` | Create a production build |
 | `npm start` | Run the production server |
 
+## Local Development
+
+Test the CLI locally before publishing by packing it into a tarball.
+
+```bash
+# 1. Build a local tarball
+npm pack
+
+# This will create a file named genui-a3-create-0.x.x.tgz at the root of this package
+
+# 2. Switch to your desired test directory
+cd ../my-test-workspace
+
+# 3. Scaffold a new project using the tarball
+npx --package=/absolute/path/to/genui-a3-create-0.x.x.tgz create-genui-a3
+```
+
 ## Prerequisites
 
 - Node.js 20.19.0 or later

package/dist/index.js

@@ -2,97 +2,374 @@
 
 // src/index.ts
 import { execSync } from "child_process";
-import path from "path";
+import path3 from "path";
 import { fileURLToPath } from "url";
+import * as p2 from "@clack/prompts";
 import chalk from "chalk";
-import fsExtra from "fs-extra";
-import prompts from "prompts";
-var __filename = fileURLToPath(import.meta.url);
-var __dirname = path.dirname(__filename);
-var banner = `
-  ${chalk.cyan("\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 ")}
-  ${chalk.cyan("\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2557")}
-  ${chalk.cyan("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551 \u2588\u2588\u2588\u2588\u2588\u2554\u255D")}
-  ${chalk.cyan("\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551 \u255A\u2550\u2550\u2550\u2588\u2588\u2557")}
-  ${chalk.cyan("\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D")}
-  ${chalk.cyan("\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u255D ")}
+import fs3 from "fs-extra";
 
-  ${chalk.white.bold("A3")} ${chalk.dim("\u2014 Agentic App Architecture")}
-`;
-async function main() {
-  console.log(banner);
-  let projectName = process.argv[2];
-  if (!projectName) {
-    const response = await prompts(
-      {
-        type: "text",
-        name: "projectName",
-        message: "What is your project named?",
-        initial: "my-a3-quickstart"
-      },
-      {
-        onCancel: () => {
-          console.log(chalk.red("\nSetup cancelled."));
-          process.exit(1);
-        }
-      }
-    );
-    projectName = response.projectName;
+// src/utils/generators.ts
+import path from "path";
+import fs from "fs-extra";
+
+// src/utils/providers.ts
+var PROVIDER_META = {
+  openai: {
+    label: "OpenAI",
+    importPath: "@genui-a3/providers/openai",
+    factory: "createOpenAIProvider",
+    models: ["gpt-4o", "gpt-4o-mini"]
+  },
+  bedrock: {
+    label: "AWS Bedrock",
+    importPath: "@genui-a3/providers/bedrock",
+    factory: "createBedrockProvider",
+    models: ["us.anthropic.claude-sonnet-4-5-20250929-v1:0", "us.anthropic.claude-haiku-4-5-20251001-v1:0"]
   }
-  if (!projectName) {
-    console.error(chalk.red("Project name is required."));
-    process.exit(1);
+};
+
+// src/utils/generators.ts
+function generateProviderFile(targetDir, primaryProvider) {
+  const { importPath, factory, models } = PROVIDER_META[primaryProvider];
+  const modelsLiteral = models.map((m) => `'${m}'`).join(", ");
+  const content = `import { ${factory} } from '${importPath}'
+import type { Provider } from '@genui-a3/core'
+
+let _provider: Provider
+
+export function getProvider(): Provider {
+  if (!_provider) {
+    _provider = ${factory}({
+      models: [${modelsLiteral}],
+    })
   }
-  const targetDir = path.resolve(process.cwd(), projectName);
-  if (fsExtra.existsSync(targetDir)) {
-    const contents = fsExtra.readdirSync(targetDir);
-    if (contents.length > 0) {
-      console.error(chalk.red(`
-Directory "${projectName}" already exists and is not empty.`));
-      process.exit(1);
-    }
+  return _provider
+}
+`;
+  fs.outputFileSync(path.join(targetDir, "app", "lib", "provider.ts"), content);
+}
+function generateEnvFile(targetDir, config) {
+  const lines = ["# Generated by create-genui-a3", "# This file is git-ignored. Do not commit credentials.", ""];
+  if (config.providers.includes("openai")) {
+    lines.push("# OpenAI", `OPENAI_API_KEY=${config.openaiApiKey || ""}`, "");
   }
-  const templateDir = path.resolve(__dirname, "..", "template");
-  if (!fsExtra.existsSync(templateDir)) {
-    console.error(chalk.red("\nTemplate directory not found. The package may not have been built correctly."));
-    process.exit(1);
+  if (config.providers.includes("bedrock")) {
+    if (config.bedrockAuthMode === "profile") {
+      lines.push("# AWS Bedrock (profile mode)", `AWS_PROFILE=${config.awsProfile || "default"}`);
+    } else {
+      lines.push("# AWS Bedrock (access keys)", `AWS_ACCESS_KEY_ID=${config.awsAccessKeyId || ""}`, `AWS_SECRET_ACCESS_KEY=${config.awsSecretAccessKey || ""}`);
+    }
+    lines.push(`AWS_REGION=${config.awsRegion || "us-east-1"}`, "");
   }
-  console.log(chalk.dim(`
-Creating a new A3 app in ${chalk.bold(targetDir)}...
-`));
-  fsExtra.copySync(templateDir, targetDir);
+  fs.writeFileSync(path.join(targetDir, ".env"), lines.join("\n"));
+}
+function scaffoldProject(templateDir, targetDir, projectName) {
+  fs.copySync(templateDir, targetDir);
   const pkgJsonPath = path.join(targetDir, "package.json");
-  if (fsExtra.existsSync(pkgJsonPath)) {
-    const pkg = fsExtra.readJsonSync(pkgJsonPath);
+  if (fs.existsSync(pkgJsonPath)) {
+    const pkg = fs.readJsonSync(pkgJsonPath);
     pkg.name = projectName;
     delete pkg.private;
-    fsExtra.writeJsonSync(pkgJsonPath, pkg, { spaces: 2 });
+    fs.writeJsonSync(pkgJsonPath, pkg, { spaces: 2 });
   }
   const gitignoreSrc = path.join(targetDir, "_gitignore");
-  const gitignoreDest = path.join(targetDir, ".gitignore");
-  if (fsExtra.existsSync(gitignoreSrc)) {
-    fsExtra.renameSync(gitignoreSrc, gitignoreDest);
+  if (fs.existsSync(gitignoreSrc)) {
+    fs.renameSync(gitignoreSrc, path.join(targetDir, ".gitignore"));
+  }
+}
+
+// src/utils/prompts.ts
+import * as p from "@clack/prompts";
+
+// src/utils/aws.ts
+import fs2 from "fs";
+import os from "os";
+import path2 from "path";
+function detectAwsProfiles() {
+  try {
+    const credentialsPath = process.env.AWS_SHARED_CREDENTIALS_FILE || path2.join(os.homedir(), ".aws", "credentials");
+    const content = fs2.readFileSync(credentialsPath, "utf-8");
+    const profiles = [];
+    const regex = /^\[([^\]]+)\]$/gm;
+    let match;
+    while ((match = regex.exec(content)) !== null) {
+      profiles.push(match[1]);
+    }
+    return profiles;
+  } catch {
+    return [];
+  }
+}
+function detectAwsProfileRegion(profileName) {
+  try {
+    const credentialsPath = process.env.AWS_SHARED_CREDENTIALS_FILE || path2.join(os.homedir(), ".aws", "credentials");
+    const content = fs2.readFileSync(credentialsPath, "utf-8");
+    const region = extractRegionFromIni(content, profileName);
+    if (region) return region;
+  } catch {
   }
-  console.log(chalk.cyan("Installing dependencies...\n"));
   try {
-    execSync("npm install", {
-      cwd: targetDir,
-      stdio: "inherit"
+    const configPath = process.env.AWS_CONFIG_FILE || path2.join(os.homedir(), ".aws", "config");
+    const content = fs2.readFileSync(configPath, "utf-8");
+    const sectionName = profileName === "default" ? profileName : `profile ${profileName}`;
+    const region = extractRegionFromIni(content, sectionName);
+    if (region) return region;
+  } catch {
+  }
+  return void 0;
+}
+function extractRegionFromIni(content, sectionName) {
+  const lines = content.split("\n");
+  let inSection = false;
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (trimmed.startsWith("[")) {
+      const name = trimmed.slice(1, -1);
+      inSection = name === sectionName;
+      continue;
+    }
+    if (inSection && trimmed.startsWith("region")) {
+      const match = /^region\s*=\s*(.+)$/.exec(trimmed);
+      if (match) return match[1].trim();
+    }
+  }
+  return void 0;
+}
+
+// src/utils/prompts.ts
+function handleCancel(value) {
+  if (p.isCancel(value)) {
+    p.cancel("Setup cancelled.");
+    process.exit(1);
+  }
+}
+async function promptProjectName() {
+  let projectName = process.argv[2];
+  if (!projectName) {
+    const value = await p.text({
+      message: "What is your project named?",
+      placeholder: "my-a3-quickstart",
+      defaultValue: "my-a3-quickstart"
     });
+    handleCancel(value);
+    projectName = value;
+  }
+  return projectName;
+}
+async function promptAccessKeys(config) {
+  p.log.info("You'll need AWS access keys to authenticate with Bedrock.\n  Create or manage keys at: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html");
+  const awsAccessKeyId = await p.text({
+    message: "AWS_ACCESS_KEY_ID:",
+    validate(input) {
+      if (!input) return "Access key ID is required.";
+    }
+  });
+  handleCancel(awsAccessKeyId);
+  config.awsAccessKeyId = awsAccessKeyId;
+  const awsSecretAccessKey = await p.password({
+    message: "AWS_SECRET_ACCESS_KEY:",
+    validate(input) {
+      if (!input) return "Secret access key is required.";
+    }
+  });
+  handleCancel(awsSecretAccessKey);
+  config.awsSecretAccessKey = awsSecretAccessKey;
+}
+async function promptOpenAIConfig(config) {
+  p.log.step(PROVIDER_META.openai.label);
+  const openaiApiKey = await p.text({
+    message: "OpenAI API key:",
+    placeholder: "sk-...",
+    validate(input) {
+      if (!input) return "API key is required. Get one at https://platform.openai.com/api-keys";
+    }
+  });
+  handleCancel(openaiApiKey);
+  config.openaiApiKey = openaiApiKey;
+}
+async function promptBedrockConfig(config) {
+  p.log.step(PROVIDER_META.bedrock.label);
+  const authMode = await p.select({
+    message: "How do you want to authenticate with AWS Bedrock?",
+    options: [
+      { label: "AWS Profile (recommended)", value: "profile", hint: "Uses ~/.aws/credentials" },
+      { label: "Access Keys", value: "keys", hint: "Provide key ID + secret directly" }
+    ]
+  });
+  handleCancel(authMode);
+  config.bedrockAuthMode = authMode;
+  if (authMode === "profile") {
+    const detectedProfiles = detectAwsProfiles();
+    let selectedProfile = "";
+    if (detectedProfiles.length > 0) {
+      const MANUAL_ENTRY = "__manual__";
+      const awsProfile = await p.select({
+        message: "AWS profile",
+        options: [
+          ...detectedProfiles.map((prof) => ({ label: prof, value: prof })),
+          { label: "Enter manually", value: MANUAL_ENTRY }
+        ]
+      });
+      handleCancel(awsProfile);
+      if (awsProfile === MANUAL_ENTRY) {
+        const manualProfile = await p.text({
+          message: "AWS profile name:",
+          placeholder: "default",
+          defaultValue: "default",
+          validate(input) {
+            if (!input) return "Profile name is required.";
+          }
+        });
+        handleCancel(manualProfile);
+        selectedProfile = manualProfile;
+      } else {
+        selectedProfile = awsProfile;
+      }
+    } else {
+      p.log.warn("No AWS profiles found in ~/.aws/credentials");
+      const noProfileAction = await p.select({
+        message: "How would you like to proceed?",
+        options: [
+          { label: "Enter a profile name", value: "manual", hint: "Configure the profile later with: aws configure --profile <name>" },
+          { label: "Use access keys instead", value: "keys", hint: "Provide key ID + secret directly" }
+        ]
+      });
+      handleCancel(noProfileAction);
+      if (noProfileAction === "manual") {
+        const awsProfile = await p.text({
+          message: "AWS profile name:",
+          placeholder: "default",
+          defaultValue: "default",
+          validate(input) {
+            if (!input) return "Profile name is required.";
+          }
+        });
+        handleCancel(awsProfile);
+        selectedProfile = awsProfile;
+      } else {
+        config.bedrockAuthMode = "keys";
+        await promptAccessKeys(config);
+      }
+    }
+    if (config.bedrockAuthMode === "profile") {
+      config.awsProfile = selectedProfile;
+    }
+  } else {
+    await promptAccessKeys(config);
+  }
+  const detectedRegion = config.bedrockAuthMode === "profile" ? detectAwsProfileRegion(config.awsProfile) : void 0;
+  const awsRegion = await p.text({
+    message: "AWS region:",
+    ...detectedRegion ? { initialValue: detectedRegion } : { placeholder: "us-east-1" },
+    validate(input) {
+      if (!input) return "AWS region is required.";
+    }
+  });
+  handleCancel(awsRegion);
+  config.awsRegion = awsRegion;
+}
+async function promptPrimaryProvider(providers, config) {
+  const primaryProvider = await p.select({
+    message: "Which provider should the app use by default?",
+    options: providers.map((prov) => ({ label: PROVIDER_META[prov].label, value: prov }))
+  });
+  handleCancel(primaryProvider);
+  config.primaryProvider = primaryProvider;
+}
+async function promptProviders() {
+  const providers = await p.multiselect({
+    message: "Which LLM provider(s) do you want to configure?",
+    options: [
+      { label: "OpenAI", value: "openai" },
+      { label: "AWS Bedrock", value: "bedrock" }
+    ],
+    required: true
+  });
+  handleCancel(providers);
+  const config = {
+    providers,
+    primaryProvider: providers[0]
+  };
+  if (providers.includes("openai")) {
+    await promptOpenAIConfig(config);
+  }
+  if (providers.includes("bedrock")) {
+    await promptBedrockConfig(config);
+  }
+  if (providers.length > 1) {
+    await promptPrimaryProvider(providers, config);
+  }
+  return config;
+}
+
+// src/index.ts
+var __dirname = path3.dirname(fileURLToPath(import.meta.url));
+var BANNER = `
+  ${chalk.cyan("\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 ")}
+  ${chalk.cyan("\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2557")}
+  ${chalk.cyan("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551 \u2588\u2588\u2588\u2588\u2588\u2554\u255D")}
+  ${chalk.cyan("\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551 \u255A\u2550\u2550\u2550\u2588\u2588\u2557")}
+  ${chalk.cyan("\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D")}
+  ${chalk.cyan("\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u255D ")}
+
+  ${chalk.white.bold("A3")} ${chalk.dim("\u2014 Agentic App Architecture")}
+`;
+function installDependencies(targetDir, projectName) {
+  try {
+    execSync("npm install", { cwd: targetDir, stdio: "inherit" });
   } catch {
-    console.error(chalk.red("\nFailed to install dependencies. You can try manually:"));
-    console.log(`  cd ${projectName}`);
-    console.log("  npm install\n");
+    p2.log.error("Failed to install dependencies. You can try manually:");
+    p2.log.info(`  cd ${projectName}
+  npm install`);
+    process.exit(1);
+  }
+}
+function printSuccess(projectName, targetDir, config) {
+  const { label } = PROVIDER_META[config.primaryProvider];
+  p2.note(
+    [
+      `Primary provider: ${label}`,
+      "Check .env for credentials configuration",
+      "",
+      "Get started:",
+      "",
+      `  cd ${projectName}`,
+      "  npm run dev"
+    ].join("\n"),
+    `Created ${projectName} at ${targetDir}`
+  );
+  p2.outro("Happy building!");
+}
+async function main() {
+  console.log(BANNER);
+  p2.intro("Create a new A3 app");
+  const projectName = await promptProjectName();
+  const targetDir = path3.resolve(process.cwd(), projectName);
+  if (fs3.existsSync(targetDir) && fs3.readdirSync(targetDir).length > 0) {
+    p2.cancel(`Directory "${projectName}" already exists and is not empty.`);
+    process.exit(1);
+  }
+  const templateDir = path3.resolve(__dirname, "..", "template");
+  if (!fs3.existsSync(templateDir)) {
+    p2.cancel("Template directory not found. The package may not have been built correctly.");
     process.exit(1);
   }
-  console.log(`
-${chalk.green.bold("Success!")} Created ${chalk.bold(projectName)} at ${chalk.dim(targetDir)}
-`);
-  console.log("Get started:\n");
-  console.log(chalk.cyan(`  cd ${projectName}`));
-  console.log(chalk.cyan("  npm run dev\n"));
+  const providerConfig = await promptProviders();
+  p2.log.info(`Creating a new A3 app in ${targetDir}`);
+  const spin = p2.spinner();
+  spin.start("Scaffolding project files");
+  scaffoldProject(templateDir, targetDir, projectName);
+  spin.message("Configuring provider");
+  generateProviderFile(targetDir, providerConfig.primaryProvider);
+  spin.message("Generating .env file");
+  generateEnvFile(targetDir, providerConfig);
+  spin.stop("Project scaffolded");
+  p2.log.step("Installing dependencies...");
+  installDependencies(targetDir, projectName);
+  printSuccess(projectName, targetDir, providerConfig);
 }
 main().catch((err) => {
-  console.error(chalk.red("Unexpected error:"), err);
+  p2.cancel("Unexpected error");
+  console.error(err);
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genui-a3/create",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "CLI scaffolding tool for A3 agentic apps",
   "keywords": [
     "genui",
@@ -33,14 +33,13 @@
     "access": "public"
   },
   "dependencies": {
+    "@clack/prompts": "1.1.0",
     "chalk": "5.4.1",
-    "fs-extra": "11.3.0",
-    "prompts": "2.4.2"
+    "fs-extra": "11.3.0"
   },
   "devDependencies": {
     "@types/fs-extra": "11.0.4",
     "@types/node": "20.19.0",
-    "@types/prompts": "2.4.9",
     "tsup": "8.5.1",
     "typescript": "5.9.3"
   }

package/template/_gitignore

@@ -25,6 +25,7 @@ yarn-debug.log*
 yarn-error.log*
 
 # local env files
+.env
 .env*.local
 
 # vercel

package/template/app/api/agui/route.ts

@@ -2,6 +2,7 @@ import { NextRequest } from 'next/server'
 import { EventType, type RunAgentInput } from '@ag-ui/client'
 import { EventEncoder } from '@ag-ui/encoder'
 import { AgentRegistry, ChatSession, MemorySessionStore, AGUIAgent } from '@genui-a3/core'
+import { getProvider } from '../../lib/provider'
 import { greetingAgent, State } from '../../agents/greeting'
 import { ageAgent } from '../../agents/age'
 
@@ -22,6 +23,7 @@ const a3Agent = new AGUIAgent({
       sessionId: input.threadId,
       store,
       initialAgentId: 'greeting',
+      provider: getProvider(),
     }),
 })
 

package/template/app/api/chat/route.ts

@@ -5,6 +5,7 @@
  */
 import { NextRequest, NextResponse } from 'next/server'
 import { AgentRegistry, ChatSession, MemorySessionStore } from '@genui-a3/core'
+import { getProvider } from '../../lib/provider'
 import { greetingAgent, State } from '../../agents/greeting'
 import { ageAgent } from '../../agents/age'
 
@@ -35,9 +36,10 @@ export async function POST(request: NextRequest) {
       store,
       initialAgentId: 'greeting',
       initialState: { userName: undefined },
+      provider: getProvider(),
     })
 
-    const result = await session.send(message)
+    const result = await session.send({ message })
 
     return NextResponse.json({
       response: result.responseMessage,

package/template/app/api/stream/route.ts

@@ -1,5 +1,6 @@
 import { NextRequest } from 'next/server'
 import { AgentRegistry, ChatSession, MemorySessionStore } from '@genui-a3/core'
+import { getProvider } from '../../lib/provider'
 import { greetingAgent, State } from '../../agents/greeting'
 import { ageAgent } from '../../agents/age'
 
@@ -30,6 +31,7 @@ export async function POST(request: NextRequest) {
     store,
     initialAgentId: 'greeting',
     initialState: { userName: undefined },
+    provider: getProvider(),
   })
 
   const encoder = new TextEncoder()
@@ -37,7 +39,7 @@ export async function POST(request: NextRequest) {
   const stream = new ReadableStream({
     async start(controller) {
       try {
-        for await (const event of session.sendStream(message)) {
+        for await (const event of session.send({ message, stream: true })) {
           controller.enqueue(encoder.encode(`data: ${JSON.stringify(event)}\n\n`))
         }
         controller.enqueue(encoder.encode('data: [DONE]\n\n'))

package/template/app/components/molecules/ChatInput.tsx

@@ -49,6 +49,7 @@ export function ChatInput({ onSubmit, disabled, placeholder = 'Type a message...
           disabled={disabled}
           variant="outlined"
           size="small"
+          autoComplete="off"
           data-testid="chat-input"
         />
         <Button

package/template/next.config.mjs

@@ -1,6 +1,15 @@
+import fs from 'node:fs'
+import path from 'node:path'
+
+// Check if we are running in the GenUI A3 monorepo
+const isMonorepo = fs.existsSync(path.join(import.meta.dirname, '..', 'a3.code-workspace'))
+
 /** @type {import('next').NextConfig} */
 const nextConfig = {
   reactStrictMode: true,
+  turbopack: {
+    root: isMonorepo ? path.join(import.meta.dirname, '..') : import.meta.dirname,
+  },
 }
 
 export default nextConfig

package/template/package.json

@@ -11,7 +11,8 @@
     "@ag-ui/encoder": "0.0.45",
     "@emotion/react": "11.14.0",
     "@emotion/styled": "11.14.1",
-    "@genui-a3/core": "^0.1.4",
+    "@genui-a3/core": "^0.1.8",
+    "@genui-a3/providers": "^0.0.1",
     "@mui/icons-material": "7.3.7",
     "@mui/material": "7.3.7",
     "next": "16.1.6",