agent-stage 0.2.14 → 0.2.17

package/dist/commands/guide.js

@@ -17,9 +17,9 @@ const guides = {
                 explanation: 'Creates a page with UI and initial state'
             },
             {
-                scenario: '3. Start dev server',
-                command: 'agentstage dev start',
-                explanation: 'Starts the development server'
+                scenario: '3. Start page runtime',
+                command: 'agentstage serve mypage',
+                explanation: 'Starts the page runtime process'
             }
         ],
         commonErrors: [
@@ -160,8 +160,8 @@ push/pop: Navigate forward/back`
             },
             {
                 error: 'Runtime is not running',
-                cause: 'Dev server is not started',
-                fix: 'Run: agentstage dev start'
+                cause: 'Page runtime is not started',
+                fix: 'Run: agentstage serve <pageId>'
             }
         ]
     },

package/dist/commands/init.d.ts

@@ -1,2 +1,2 @@
-import { Command } from 'commander';
+import { Command } from "commander";
 export declare const initCommand: Command;

package/dist/commands/init.js

@@ -1,146 +1,156 @@
-import { Command } from 'commander';
-import * as p from '@clack/prompts';
-import consola from 'consola';
-import c from 'picocolors';
-import { execa } from 'execa';
-import { mkdir, writeFile, readdir, readFile, cp } from 'fs/promises';
-import { existsSync } from 'fs';
-import { resolve, join, dirname } from 'pathe';
-import { homedir } from 'os';
-import { fileURLToPath } from 'url';
-import { setWorkspaceDir } from '../utils/paths.js';
-const PROJECT_NAME = 'webapp';
-// Get the template directory path (works in both dev and prod)
-function getTemplateDir() {
-    const currentFilePath = fileURLToPath(import.meta.url);
-    const currentDir = dirname(currentFilePath);
-    // Production: template is next to dist
-    const prodPath = join(currentDir, '..', '..', 'template');
-    // Development: template is in the source
-    const devPath = join(currentDir, '..', '..', '..', 'template');
-    if (existsSync(prodPath)) {
-        return prodPath;
+import { Command } from "commander";
+import * as p from "@clack/prompts";
+import consola from "consola";
+import c from "picocolors";
+import { execa } from "execa";
+import { mkdir, readdir, writeFile } from "fs/promises";
+import { existsSync } from "fs";
+import { resolve, join } from "pathe";
+import { homedir } from "os";
+import { setWorkspaceDir } from "../utils/paths.js";
+import { checkCloudflared, printInstallInstructions, } from "../utils/cloudflared.js";
+const PROJECT_NAME = "webapp";
+const workspaceDependencies = {
+    "@agentstage/render": "^0.2.2",
+    "@agentstage/bridge": "^0.1.2",
+    react: "^19.0.0",
+    "react-dom": "^19.0.0",
+    zod: "^3.23.0",
+};
+export const initCommand = new Command("init")
+    .description("Initialize a new Agentstage runtime workspace")
+    .option("-y, --yes", "Use default settings (non-interactive)", false)
+    .option("--skip-cloudflared-check", "Skip cloudflared installation check", false)
+    .action(async (options) => {
+    const useDefault = options.yes;
+    try {
+        await execa("bun", ["--version"], { stdio: "pipe" });
     }
-    if (existsSync(devPath)) {
-        return devPath;
+    catch {
+        consola.error("Bun is required to initialize workspace.");
+        consola.info("Install Bun: https://bun.sh/docs/installation");
+        process.exit(1);
     }
-    // Fallback: try current working directory relative paths
-    const cwdProdPath = join(process.cwd(), 'packages', 'cli', 'template');
-    if (existsSync(cwdProdPath)) {
-        return cwdProdPath;
+    if (!options.skipCloudflaredCheck) {
+        const cloudflaredInfo = await checkCloudflared();
+        if (!cloudflaredInfo.installed) {
+            printInstallInstructions(cloudflaredInfo);
+            const shouldContinue = await p.confirm({
+                message: "Continue with initialization? (You can install cloudflared later)",
+                initialValue: true,
+            });
+            if (p.isCancel(shouldContinue) || !shouldContinue) {
+                consola.info("Cancelled");
+                process.exit(0);
+            }
+        }
+        else {
+            consola.success(`Cloudflare Tunnel available: ${c.dim(cloudflaredInfo.version)}`);
+        }
     }
-    throw new Error('Template directory not found. Please ensure the CLI is properly installed.');
-}
-export const initCommand = new Command('init')
-    .description('Initialize a new Agentstage project')
-    .option('-y, --yes', 'Use default settings (non-interactive)', false)
-    .action(async (options) => {
-    const name = PROJECT_NAME;
-    const useDefault = options.yes;
-    // 1. 选择工作目录模式
     let locationMode;
     if (useDefault) {
-        locationMode = 'default';
+        locationMode = "default";
     }
     else {
         const result = await p.select({
-            message: 'Where to store the project?',
+            message: "Where to store the workspace?",
             options: [
                 {
-                    value: 'default',
-                    label: `Default (~/.agentstage/${name})`,
-                    hint: 'Recommended'
+                    value: "default",
+                    label: `Default (~/.agentstage/${PROJECT_NAME})`,
+                    hint: "Recommended",
                 },
                 {
-                    value: 'current',
-                    label: 'Current directory (./.agentstage)'
+                    value: "current",
+                    label: "Current directory (./.agentstage)",
                 },
                 {
-                    value: 'custom',
-                    label: 'Custom path'
+                    value: "custom",
+                    label: "Custom path",
                 },
             ],
         });
         if (p.isCancel(result)) {
-            consola.info('Cancelled');
+            consola.info("Cancelled");
             return;
         }
         locationMode = result;
     }
-    // 2. 确定目标目录
     let targetDir;
     switch (locationMode) {
-        case 'default':
-            targetDir = join(homedir(), '.agentstage', name);
+        case "default":
+            targetDir = join(homedir(), ".agentstage", PROJECT_NAME);
             break;
-        case 'current':
-            targetDir = join(process.cwd(), '.agentstage');
+        case "current":
+            targetDir = join(process.cwd(), ".agentstage");
             break;
-        case 'custom':
+        case "custom": {
             const customPath = await p.text({
-                message: 'Enter custom path:',
-                placeholder: '/path/to/project',
+                message: "Enter custom path:",
+                placeholder: "/path/to/workspace",
                 validate: (value) => {
-                    if (!value || value.trim() === '') {
-                        return 'Path is required';
+                    if (!value || value.trim() === "") {
+                        return "Path is required";
                     }
                 },
             });
             if (p.isCancel(customPath)) {
-                consola.info('Cancelled');
+                consola.info("Cancelled");
                 return;
             }
             targetDir = resolve(customPath);
             break;
+        }
         default:
-            targetDir = join(homedir(), '.agentstage', name);
+            targetDir = join(homedir(), ".agentstage", PROJECT_NAME);
     }
-    // 3. 检查目录
     if (existsSync(targetDir)) {
         const files = await readdirSafe(targetDir);
         if (files.length > 0) {
-            // 项目已存在，提示并退出
             console.log();
-            consola.info('Project already initialized!');
+            consola.info("Workspace already initialized!");
             console.log(`  Location: ${c.cyan(targetDir)}`);
             console.log();
             console.log(`  cd ${c.cyan(targetDir)}`);
-            console.log(`  ${c.cyan('agentstage start')}`);
+            console.log(`  ${c.cyan("agentstage serve <pageId>")}`);
             console.log();
+            await setWorkspaceDir(targetDir);
             return;
         }
     }
-    // 4. 保存工作目录配置
     await setWorkspaceDir(targetDir);
     const s = p.spinner();
     try {
-        // 5. 复制模板文件
-        s.start('Creating project from template...');
-        const templateDir = getTemplateDir();
-        await mkdir(targetDir, { recursive: true });
-        await copyTemplateFiles(templateDir, targetDir);
-        s.stop('Project template copied');
-        // 6. 更新 package.json 中的 workspace 依赖
-        s.start('Configuring project...');
-        await configurePackageJson(targetDir);
-        s.stop('Project configured');
-        // 7. 安装依赖
-        s.start('Installing dependencies...');
-        await installDependencies(targetDir);
-        s.stop('Dependencies installed');
-        // 完成
-        console.log();
-        consola.success('Project created successfully!');
+        s.start("Creating workspace structure...");
+        await mkdir(join(targetDir, "pages"), { recursive: true });
+        await mkdir(join(targetDir, ".agentstage"), { recursive: true });
+        const packageJson = {
+            name: "agentstage-workspace",
+            private: true,
+            version: "0.0.0",
+            type: "module",
+            dependencies: workspaceDependencies,
+        };
+        await writeFile(join(targetDir, "package.json"), JSON.stringify(packageJson, null, 2));
+        s.stop("Workspace created");
+        s.start("Installing dependencies with Bun...");
+        await execa("bun", ["install"], { cwd: targetDir, stdio: "pipe" });
+        s.stop("Dependencies installed");
         console.log();
+        consola.success("Workspace initialized successfully");
         console.log(`  Location: ${c.cyan(targetDir)}`);
+        console.log(`  Pages:    ${c.cyan("pages/<pageId>/ui.json")}`);
         console.log();
         console.log(`  cd ${c.cyan(targetDir)}`);
-        console.log(`  ${c.cyan('agentstage start')}`);
+        console.log(`  ${c.cyan("agentstage page add counter")}`);
+        console.log(`  ${c.cyan("agentstage serve counter")}`);
         console.log();
     }
     catch (error) {
-        s.stop('Failed to create project');
-        consola.error(error.message);
+        s.stop("Failed to initialize workspace");
+        const message = error instanceof Error ? error.message : "Unknown initialization error";
+        consola.error(message);
         process.exit(1);
     }
 });
@@ -152,57 +162,3 @@ async function readdirSafe(dir) {
         return [];
     }
 }
-async function copyTemplateFiles(templateDir, targetDir) {
-    const entries = await readdir(templateDir, { withFileTypes: true });
-    for (const entry of entries) {
-        const srcPath = join(templateDir, entry.name);
-        const destPath = join(targetDir, entry.name);
-        if (entry.isDirectory()) {
-            await mkdir(destPath, { recursive: true });
-            await copyTemplateFiles(srcPath, destPath);
-        }
-        else {
-            await cp(srcPath, destPath);
-        }
-    }
-}
-async function configurePackageJson(targetDir) {
-    const packageJsonPath = join(targetDir, 'package.json');
-    const packageJson = JSON.parse(await readFile(packageJsonPath, 'utf-8'));
-    // Check if we're in the monorepo by looking for packages from the CLI location
-    const currentFilePath = fileURLToPath(import.meta.url);
-    const localBridgePath = resolve(join(dirname(currentFilePath), '..', '..', '..', 'bridge'));
-    const localRenderPath = resolve(join(dirname(currentFilePath), '..', '..', '..', 'render'));
-    const isDev = existsSync(localBridgePath) && existsSync(localRenderPath);
-    if (isDev) {
-        // In dev mode, use file: protocol to reference the local packages
-        packageJson.dependencies['@agentstage/bridge'] = `file:${localBridgePath}`;
-        packageJson.dependencies['@agentstage/render'] = `file:${localRenderPath}`;
-    }
-    else {
-        // Use npm version for production
-        packageJson.dependencies['@agentstage/bridge'] = '^0.1.0';
-        packageJson.dependencies['@agentstage/render'] = '^0.2.0';
-    }
-    await writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2));
-}
-async function installDependencies(targetDir) {
-    // Check if we're in the monorepo
-    const currentFilePath = fileURLToPath(import.meta.url);
-    const localBridgePath = resolve(join(dirname(currentFilePath), '..', '..', '..', 'bridge'));
-    const isDev = existsSync(localBridgePath);
-    if (isDev) {
-        // In development mode (monorepo), use pnpm
-        try {
-            await execa('pnpm', ['install'], { cwd: targetDir, stdio: 'pipe' });
-        }
-        catch {
-            // Fallback to npm if pnpm is not available
-            await execa('npm', ['install'], { cwd: targetDir, stdio: 'pipe' });
-        }
-    }
-    else {
-        // In production, use npm
-        await execa('npm', ['install'], { cwd: targetDir, stdio: 'pipe' });
-    }
-}

package/dist/commands/page/add.js

@@ -2,7 +2,6 @@ import { Command } from 'commander';
 import consola from 'consola';
 import c from 'picocolors';
 import { writeFile, mkdir } from 'fs/promises';
-import { existsSync } from 'fs';
 import { join } from 'pathe';
 import { getWorkspaceDir, isInitialized, readRuntimeConfig, getPagesDir } from '../../utils/paths.js';
 import { FileStore } from '@agentstage/bridge';
@@ -35,19 +34,9 @@ export const pageAddCommand = new Command('add')
     try {
         const workspaceDir = await getWorkspaceDir();
         const config = await readRuntimeConfig();
-        const routesDir = join(workspaceDir, 'src', 'routes');
-        const pagesDir = join(workspaceDir, 'src', 'pages', name);
-        const pageFile = join(routesDir, `${name}.tsx`);
+        const pagesDir = join(workspaceDir, 'pages', name);
         // 确保目录存在
-        await mkdir(routesDir, { recursive: true });
         await mkdir(pagesDir, { recursive: true });
-        if (existsSync(pageFile)) {
-            printAgentErrorHelp(`Page "${name}" already exists`);
-            process.exit(1);
-        }
-        // 生成 .tsx 路由文件
-        const pageContent = generateTsxContent(name);
-        await writeFile(pageFile, pageContent);
         // 处理 UI
         let uiContent;
         if (options.uiStdin) {
@@ -122,17 +111,16 @@ export const pageAddCommand = new Command('add')
         if (options.ui) {
             // 提供了完整 UI
             printAgentSuccess(`Page "${name}" created with custom UI and state`, [
-                `Start dev server: agentstage dev start`,
-                `Open http://localhost:${port}/${name} to see your page`,
+                `Start runtime: agentstage serve ${name}`,
+                `Open http://localhost:${port} to see your page`,
                 `Update state: agentstage run set-state ${name} '{"key": "value"}'`
             ]);
         }
         else {
             // 默认 UI，输出 prompts
             consola.success(`Page "${name}" created`);
-            console.log(`  Route: ${c.cyan(`src/routes/${name}.tsx`)}`);
-            console.log(`  UI:    ${c.cyan(`src/pages/${name}/ui.json`)}`);
-            console.log(`  Store: ${c.cyan(`src/pages/${name}/store.json`)}`);
+            console.log(`  UI:    ${c.cyan(`pages/${name}/ui.json`)}`);
+            console.log(`  Store: ${c.cyan(`pages/${name}/store.json`)}`);
             console.log(`  URL:   ${c.cyan(`http://localhost:${port}/${name}`)}`);
             console.log();
             console.log(c.bold('─'.repeat(60)));
@@ -152,26 +140,6 @@ export const pageAddCommand = new Command('add')
         process.exit(1);
     }
 });
-function generateTsxContent(name) {
-    const pascalName = toPascalCase(name);
-    return `import { createFileRoute } from '@tanstack/react-router'
-import { useMemo } from 'react'
-import { PageRenderer } from '../components/PageRenderer'
-import { createPageBridge } from '../lib/bridge'
-
-export const Route = createFileRoute('/${name}')({
-  component: ${pascalName}Page,
-})
-
-function ${pascalName}Page() {
-  const bridge = useMemo(() => createPageBridge({
-    pageId: '${name}',
-  }), [])
-
-  return <PageRenderer pageId="${name}" bridge={bridge} />
-}
-`;
-}
 function generateDefaultUi(name) {
     const titleName = toTitleCase(name);
     return {
@@ -211,9 +179,6 @@ function generateDefaultState(name) {
         pageId: name,
     };
 }
-function toPascalCase(str) {
-    return str.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join('');
-}
 function toTitleCase(str) {
     return str.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ');
 }

package/dist/commands/run/exec.js

@@ -16,7 +16,7 @@ export const runExecCommand = new Command('exec')
     }
     const config = await readRuntimeConfig();
     if (!config) {
-        consola.error('Runtime is not running. Start it first with `agentstage dev start`.');
+        consola.error('Runtime is not running. Start it first with `agentstage serve <pageId>`.');
         process.exit(1);
     }
     // Parse payload

package/dist/commands/run/inspect.js

@@ -13,7 +13,7 @@ export const runInspectCommand = new Command('inspect')
     }
     const config = await readRuntimeConfig();
     if (!config) {
-        consola.error('Runtime is not running. Start it first with `agentstage dev start`.');
+        consola.error('Runtime is not running. Start it first with `agentstage serve <pageId>`.');
         process.exit(1);
     }
     const client = new BridgeClient(`ws://localhost:${config.port}/_bridge`);

package/dist/commands/run/watch.js

@@ -14,7 +14,7 @@ export const runWatchCommand = new Command('watch')
     }
     const config = await readRuntimeConfig();
     if (!config) {
-        consola.error('Runtime is not running. Start it first with `agentstage dev start`.');
+        consola.error('Runtime is not running. Start it first with `agentstage serve <pageId>`.');
         process.exit(1);
     }
     const client = new BridgeClient(`ws://localhost:${config.port}/_bridge`);

package/dist/commands/serve.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const serveCommand: Command;