agent-stage 0.2.15 → 0.2.17

package/dist/index.js

@@ -7,7 +7,9 @@ import { dirname, join } from 'pathe';
 // Read version from package.json
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
-import { devCommand } from './commands/dev/index.js';
+import { initCommand } from './commands/init.js';
+import { stopCommand } from './commands/stop.js';
+import { statusCommand } from './commands/status.js';
 import { pageCommand } from './commands/page/index.js';
 import { runCommand } from './commands/run/index.js';
 import { guideCommand } from './commands/guide.js';
@@ -15,13 +17,17 @@ import { cleanupCommand } from './commands/cleanup.js';
 import { componentsCommand } from './commands/components.js';
 import { doctorCommand } from './commands/doctor.js';
 import { verifyCommand } from './commands/verify.js';
+import { serveCommand } from './commands/serve.js';
 const program = new Command();
 program
     .name('agentstage')
     .description('Agent UI Stage CLI - Create interactive UI for AI agents')
     .version(pkg.version);
 // Register commands
-program.addCommand(devCommand); // dev init/start/stop/status
+program.addCommand(initCommand); // init
+program.addCommand(serveCommand); // serve <pageId>
+program.addCommand(stopCommand); // stop
+program.addCommand(statusCommand); // status
 program.addCommand(pageCommand); // page add/rm/ls/manifest
 program.addCommand(runCommand); // run get-state/set-state/exec/inspect/watch
 program.addCommand(guideCommand); // guide

package/dist/utils/agent-helper.js

@@ -53,17 +53,17 @@ const errorGuides = {
     // 运行时相关
     'runtime_not_running': {
         message: 'Runtime is not running',
-        cause: 'The development server is not started',
-        fix: 'Start the dev server in another terminal',
-        example: 'agentstage dev start',
-        relatedCommands: ['dev start', 'dev status']
+        cause: 'The runtime process is not started',
+        fix: 'Start a page runtime in another terminal',
+        example: 'agentstage serve <pageId>',
+        relatedCommands: ['serve', 'status']
     },
     'page_not_connected': {
         message: 'Page is not connected',
         cause: 'Using --live flag but page is not open in browser',
         fix: 'Either remove --live, or open the page in browser first',
         example: '# Option 1: File-only update\nagentstage run set-state mypage \'{...}\'\n\n# Option 2: Open page first\n# Then use --live',
-        relatedCommands: ['run set-state', 'dev start']
+        relatedCommands: ['run set-state', 'serve']
     },
     // 路径遍历（安全）
     'path_traversal_detected': {

package/dist/utils/paths.js

@@ -52,15 +52,15 @@ export async function getPidFile() {
  */
 export async function getPagesDir() {
     const workspace = await getWorkspaceDir();
-    // New Vite template structure (src/routes for TanStack Router)
-    if (existsSync(join(workspace, 'src', 'routes'))) {
-        return join(workspace, 'src', 'pages');
+    // New runtime data structure
+    if (existsSync(join(workspace, 'pages'))) {
+        return join(workspace, 'pages');
     }
-    // Legacy Vite template structure
+    // Legacy template structure fallback
     if (existsSync(join(workspace, 'src', 'pages'))) {
         return join(workspace, 'src', 'pages');
     }
-    throw new Error('Routes directory not found at src/routes');
+    throw new Error('Pages directory not found at pages/');
 }
 // 运行时配置文件路径
 export async function getRuntimeConfigFile() {

package/dist/utils/tunnel.d.ts

@@ -1,5 +1,5 @@
 /**
- * Cloudflare Tunnel management for exposing local dev server
+ * Cloudflare Tunnel management for exposing local runtime server
  */
 export interface Tunnel {
     /** Public URL assigned by Cloudflare */

package/dist/utils/tunnel.js

@@ -1,5 +1,5 @@
 /**
- * Cloudflare Tunnel management for exposing local dev server
+ * Cloudflare Tunnel management for exposing local runtime server
  */
 import { spawn } from 'child_process';
 import { findCloudflared } from './cloudflared.js';

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "agent-stage",
-  "version": "0.2.15",
+  "version": "0.2.17",
   "files": [
-    "dist",
-    "template"
+    "dist"
   ],
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/parkgogogo/agent-stage"
+  },
   "bin": {
     "agent-stage": "./dist/index.js"
   },
@@ -16,8 +19,8 @@
     "execa": "^9.3.1",
     "pathe": "^1.1.2",
     "picocolors": "^1.1.1",
-    "@agentstage/render": "0.2.2",
-    "@agentstage/bridge": "0.1.2"
+    "@agentstage/render": "0.2.5",
+    "@agentstage/bridge": "0.1.3"
   },
   "devDependencies": {
     "@types/node": "^22.13.5",

package/dist/commands/dev/index.d.ts

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

package/dist/commands/dev/index.js

@@ -1,11 +0,0 @@
-import { Command } from 'commander';
-import { devInitCommand } from './init.js';
-import { devStartCommand } from './start.js';
-import { devStopCommand } from './stop.js';
-import { devStatusCommand } from './status.js';
-export const devCommand = new Command('dev')
-    .description('Development commands for Agentstage')
-    .addCommand(devInitCommand)
-    .addCommand(devStartCommand)
-    .addCommand(devStopCommand)
-    .addCommand(devStatusCommand);

package/dist/commands/dev/init.d.ts

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

package/dist/commands/dev/init.js

@@ -1,215 +0,0 @@
-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';
-import { checkCloudflared, printInstallInstructions } from '../../utils/cloudflared.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
-    // From dist/commands/dev/init.js -> dist/ -> package root
-    const prodPath = join(currentDir, '..', '..', '..', 'template');
-    // Development: template is in the source
-    // From packages/cli/src/commands/dev/init.ts -> packages/cli/
-    const devPath = join(currentDir, '..', '..', '..', '..', 'template');
-    if (existsSync(prodPath)) {
-        return prodPath;
-    }
-    if (existsSync(devPath)) {
-        return devPath;
-    }
-    // Fallback: try current working directory relative paths
-    const cwdProdPath = join(process.cwd(), 'packages', 'cli', 'template');
-    if (existsSync(cwdProdPath)) {
-        return cwdProdPath;
-    }
-    throw new Error('Template directory not found. Please ensure the CLI is properly installed.');
-}
-export const devInitCommand = new Command('init')
-    .description('Initialize a new Agentstage project')
-    .option('-y, --yes', 'Use default settings (non-interactive)', false)
-    .option('--skip-cloudflared-check', 'Skip cloudflared installation check', false)
-    .action(async (options) => {
-    const name = PROJECT_NAME;
-    const useDefault = options.yes;
-    // 1. Check cloudflared installation
-    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)}`);
-        }
-    }
-    // 2. 选择工作目录模式
-    let locationMode;
-    if (useDefault) {
-        locationMode = 'default';
-    }
-    else {
-        const result = await p.select({
-            message: 'Where to store the project?',
-            options: [
-                {
-                    value: 'default',
-                    label: `Default (~/.agentstage/${name})`,
-                    hint: 'Recommended',
-                },
-                {
-                    value: 'current',
-                    label: 'Current directory (./.agentstage)',
-                },
-                {
-                    value: 'custom',
-                    label: 'Custom path',
-                },
-            ],
-        });
-        if (p.isCancel(result)) {
-            consola.info('Cancelled');
-            return;
-        }
-        locationMode = result;
-    }
-    // 3. 确定目标目录
-    let targetDir;
-    switch (locationMode) {
-        case 'default':
-            targetDir = join(homedir(), '.agentstage', name);
-            break;
-        case 'current':
-            targetDir = join(process.cwd(), '.agentstage');
-            break;
-        case 'custom':
-            const customPath = await p.text({
-                message: 'Enter custom path:',
-                placeholder: '/path/to/project',
-                validate: (value) => {
-                    if (!value || value.trim() === '') {
-                        return 'Path is required';
-                    }
-                },
-            });
-            if (p.isCancel(customPath)) {
-                consola.info('Cancelled');
-                return;
-            }
-            targetDir = resolve(customPath);
-            break;
-        default:
-            targetDir = join(homedir(), '.agentstage', name);
-    }
-    // 4. 检查目录
-    if (existsSync(targetDir)) {
-        const files = await readdirSafe(targetDir);
-        if (files.length > 0) {
-            // 项目已存在，提示并退出
-            console.log();
-            consola.info('Project already initialized!');
-            console.log(`  Location: ${c.cyan(targetDir)}`);
-            console.log();
-            console.log(`  cd ${c.cyan(targetDir)}`);
-            console.log(`  ${c.cyan('agentstage dev start')}`);
-            console.log();
-            return;
-        }
-    }
-    // 5. 保存工作目录配置
-    await setWorkspaceDir(targetDir);
-    const s = p.spinner();
-    try {
-        // 6. 复制模板文件
-        s.start('Creating project from template...');
-        const templateDir = getTemplateDir();
-        await mkdir(targetDir, { recursive: true });
-        await copyTemplateFiles(templateDir, targetDir);
-        s.stop('Project template copied');
-        // 7. 更新 package.json 中的 workspace 依赖
-        s.start('Configuring project...');
-        await configurePackageJson(targetDir);
-        s.stop('Project configured');
-        // 8. 安装依赖
-        s.start('Installing dependencies...');
-        await installDependencies(targetDir);
-        s.stop('Dependencies installed');
-        // 完成
-        console.log();
-        consola.success('Project created successfully!');
-        console.log();
-        console.log(`  Location: ${c.cyan(targetDir)}`);
-        console.log();
-        console.log(`  cd ${c.cyan(targetDir)}`);
-        console.log(`  ${c.cyan('agentstage dev start')}`);
-        console.log();
-        console.log(c.dim('To expose your server to the internet:'));
-        console.log(`  ${c.cyan('agentstage dev start --tunnel')}`);
-        console.log();
-    }
-    catch (error) {
-        s.stop('Failed to create project');
-        consola.error(error.message);
-        process.exit(1);
-    }
-});
-async function readdirSafe(dir) {
-    try {
-        return await readdir(dir);
-    }
-    catch {
-        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'));
-    // Replace all workspace:* dependencies with actual npm versions
-    // This fixes the EUNSUPPORTEDPROTOCOL error when users run npm install
-    const npmVersions = {
-        '@agentstage/render': '^0.2.2',
-        '@agentstage/bridge': '^0.1.0',
-        'agent-stage-bridge': '^0.1.0'
-    };
-    for (const [dep, version] of Object.entries(npmVersions)) {
-        if (packageJson.dependencies?.[dep] === 'workspace:*') {
-            packageJson.dependencies[dep] = version;
-        }
-    }
-    await writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2));
-}
-async function installDependencies(targetDir) {
-    // Use npm with --legacy-peer-deps to resolve peer dependency conflicts
-    // This is needed because @json-render packages have strict peer deps
-    await execa('npm', ['install', '--legacy-peer-deps'], { cwd: targetDir, stdio: 'pipe' });
-}

package/dist/commands/dev/start.d.ts

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

package/dist/commands/dev/start.js

@@ -1,145 +0,0 @@
-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 } from 'fs/promises';
-import { existsSync } from 'fs';
-import { join } from 'pathe';
-import { getWorkspaceDir, saveRuntimeConfig, isInitialized, readRuntimeConfig, } from '../../utils/paths.js';
-import { startTunnel, canStartTunnel, printTunnelInfo } from '../../utils/tunnel.js';
-import { checkCloudflared, printInstallInstructions } from '../../utils/cloudflared.js';
-export const devStartCommand = new Command('start')
-    .description('Start the Agentstage Runtime (Vite dev server with Bridge)')
-    .option('-p, --port <port>', 'Port to run the web server on', '3000')
-    .option('-t, --tunnel', 'Expose server to internet via Cloudflare Tunnel', false)
-    .option('--open', 'Open browser automatically', false)
-    .action(async (options) => {
-    // 1. 检查是否已初始化
-    if (!isInitialized()) {
-        consola.error('Project not initialized. Please run `agentstage init` first.');
-        process.exit(1);
-    }
-    const workspaceDir = await getWorkspaceDir();
-    const port = parseInt(options.port, 10);
-    // 2. 检查是否已运行
-    const existingConfig = await readRuntimeConfig();
-    if (existingConfig) {
-        try {
-            process.kill(existingConfig.pid, 0);
-            consola.warn(`Runtime is already running (PID: ${existingConfig.pid}, Port: ${existingConfig.port})`);
-            console.log(`  Web:    ${c.cyan(`http://localhost:${existingConfig.port}`)}`);
-            if (existingConfig.tunnelUrl) {
-                console.log(`  Public: ${c.cyan(c.underline(existingConfig.tunnelUrl))}`);
-            }
-            console.log(`  Bridge: ${c.cyan(`ws://localhost:${existingConfig.port}/_bridge`)}`);
-            return;
-        }
-        catch {
-            // 进程不存在，继续启动
-        }
-    }
-    // 3. 检查是否需要安装依赖
-    const nodeModulesPath = join(workspaceDir, 'node_modules');
-    if (!existsSync(nodeModulesPath)) {
-        const s = p.spinner();
-        s.start('Installing dependencies...');
-        try {
-            await execa('npm', ['install'], { cwd: workspaceDir, stdio: 'pipe' });
-            s.stop('Dependencies installed');
-        }
-        catch (error) {
-            s.stop('Failed to install dependencies');
-            consola.error(error.message);
-            process.exit(1);
-        }
-    }
-    // 4. 检查 cloudflared (如果请求了 tunnel)
-    let tunnelUrl;
-    if (options.tunnel) {
-        const canTunnel = await canStartTunnel();
-        if (!canTunnel) {
-            const info = await checkCloudflared();
-            printInstallInstructions(info);
-            consola.error('Cannot start with --tunnel: cloudflared not installed');
-            process.exit(1);
-        }
-    }
-    const s = p.spinner();
-    s.start('Starting Agentstage Runtime...');
-    try {
-        // 5. 启动 Vite dev server
-        const subprocess = execa('npx', ['vite', '--port', String(port), '--host'], {
-            cwd: workspaceDir,
-            detached: true,
-            stdio: 'ignore',
-        });
-        await mkdir(join(workspaceDir, '.agentstage'), { recursive: true });
-        // 6. 启动 tunnel (如果请求了)
-        if (options.tunnel) {
-            s.message('Starting Cloudflare Tunnel...');
-            try {
-                const tunnel = await startTunnel(port);
-                tunnelUrl = tunnel.url;
-                // Save tunnel info for stop command to use
-                const tunnelModulePath = join(workspaceDir, '.agentstage', 'tunnel.mjs');
-                // Write tunnel info for stop command to use
-                await writeFile(tunnelModulePath, `export const tunnelUrl = '${tunnelUrl}';\nexport const tunnelPid = ${subprocess.pid};\n`);
-            }
-            catch (tunnelError) {
-                s.stop('Tunnel failed to start');
-                consola.warn(`Tunnel error: ${tunnelError.message}`);
-                consola.info('Continuing without tunnel...');
-                // Kill the vite process since we're failing
-                subprocess.kill();
-                process.exit(1);
-            }
-        }
-        // 7. 保存运行时配置
-        const config = {
-            pid: subprocess.pid,
-            port,
-            startedAt: new Date().toISOString(),
-            tunnelUrl,
-        };
-        await saveRuntimeConfig(config);
-        // 8. 等待一下确保服务启动
-        await new Promise((resolve) => setTimeout(resolve, 2000));
-        s.stop('Runtime started successfully');
-        console.log();
-        consola.success('Agentstage Runtime is running');
-        console.log(`  Web:     ${c.cyan(`http://localhost:${port}`)}`);
-        if (tunnelUrl) {
-            printTunnelInfo(tunnelUrl);
-        }
-        console.log(`  Bridge:  ${c.cyan(`ws://localhost:${port}/_bridge`)}`);
-        console.log(`  Workspace: ${c.gray(workspaceDir)}`);
-        console.log();
-        if (options.open) {
-            const openUrl = tunnelUrl || `http://localhost:${port}`;
-            try {
-                await execa('open', [openUrl]);
-            }
-            catch {
-                // Ignore open errors
-            }
-        }
-        // Keep process alive to maintain tunnel
-        if (options.tunnel && tunnelUrl) {
-            console.log(c.dim('Press Ctrl+C to stop'));
-            process.on('SIGINT', async () => {
-                console.log();
-                consola.info('Shutting down...');
-                subprocess.kill();
-                process.exit(0);
-            });
-            // Keep running
-            await new Promise(() => { });
-        }
-    }
-    catch (error) {
-        s.stop('Failed to start runtime');
-        consola.error(error.message);
-        process.exit(1);
-    }
-});

package/dist/commands/dev/status.d.ts

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

package/dist/commands/dev/stop.d.ts

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

package/dist/commands/dev/stop.js

@@ -1,45 +0,0 @@
-import { Command } from 'commander';
-import consola from 'consola';
-import c from 'picocolors';
-import { readRuntimeConfig, removeRuntimeConfig, isInitialized } from '../../utils/paths.js';
-export const devStopCommand = new Command('stop')
-    .description('Stop the Agentstage Runtime')
-    .action(async () => {
-    if (!isInitialized()) {
-        consola.error('Project not initialized. Please run `agentstage init` first.');
-        process.exit(1);
-    }
-    const config = await readRuntimeConfig();
-    if (!config) {
-        consola.warn('Runtime is not running');
-        return;
-    }
-    try {
-        // Check if process exists
-        process.kill(config.pid, 0);
-        // Kill the process
-        process.kill(config.pid, 'SIGTERM');
-        // Wait a bit and check if it's still running
-        await new Promise((resolve) => setTimeout(resolve, 1000));
-        try {
-            process.kill(config.pid, 0);
-            // Still running, force kill
-            process.kill(config.pid, 'SIGKILL');
-        }
-        catch {
-            // Process already stopped
-        }
-        await removeRuntimeConfig();
-        consola.success('Runtime stopped');
-        console.log(`  PID: ${c.gray(config.pid)}`);
-        console.log(`  Port: ${c.gray(config.port)}`);
-        if (config.tunnelUrl) {
-            console.log(`  Tunnel: ${c.gray(config.tunnelUrl)}`);
-        }
-    }
-    catch {
-        // Process doesn't exist, clean up stale config
-        await removeRuntimeConfig();
-        consola.info('Runtime was not running (stale config cleaned up)');
-    }
-});

package/template/components.json

@@ -1,17 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema.json",
-  "style": "default",
-  "rsc": false,
-  "tsx": true,
-  "tailwind": {
-    "config": "tailwind.config.js",
-    "css": "src/index.css",
-    "baseColor": "neutral",
-    "cssVariables": true,
-    "prefix": ""
-  },
-  "aliases": {
-    "components": "@/components",
-    "utils": "@/lib/utils"
-  }
-}

package/template/index.html

@@ -1,13 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Agentstage App</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
-  </body>
-</html>

package/template/package.json

@@ -1,41 +0,0 @@
-{
-  "name": "agentstage-app",
-  "private": true,
-  "version": "0.0.0",
-  "type": "module",
-  "scripts": {
-    "dev": "vite",
-    "build": "tsc && vite build",
-    "preview": "vite preview",
-    "type-check": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@agentstage/render": "workspace:*",
-    "@tanstack/react-router": "^1.114.3",
-    "@tanstack/router-core": "^1.114.3",
-    "@tanstack/router-devtools": "^1.114.3",
-    "agent-stage-bridge": "workspace:*",
-    "class-variance-authority": "^0.7.0",
-    "clsx": "^2.1.0",
-    "lucide-react": "^0.564.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "tailwind-merge": "^2.2.0",
-    "tailwindcss-animate": "^1.0.7",
-    "zod": "^3.23.0",
-    "zustand": "^4.5.0"
-  },
-  "devDependencies": {
-    "@radix-ui/react-slot": "^1.0.2",
-    "@tanstack/router-generator": "^1.114.3",
-    "@tanstack/router-plugin": "^1.114.3",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "@vitejs/plugin-react": "^4.2.1",
-    "autoprefixer": "^10.4.17",
-    "postcss": "^8.5.0",
-    "tailwindcss": "^4.0.0",
-    "typescript": "^5.2.2",
-    "vite": "^5.4.21"
-  }
-}

package/template/postcss.config.js

@@ -1,6 +0,0 @@
-export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-}