agent-stage 0.2.0

package/dist/commands/init.js

@@ -0,0 +1,208 @@
+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;
+    }
+    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 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';
+    }
+    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;
+    }
+    // 2. 确定目标目录
+    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);
+    }
+    // 3. 检查目录
+    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 start')}`);
+            console.log();
+            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!');
+        console.log();
+        console.log(`  Location: ${c.cyan(targetDir)}`);
+        console.log();
+        console.log(`  cd ${c.cyan(targetDir)}`);
+        console.log(`  ${c.cyan('agentstage start')}`);
+        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 workspace:* with actual version or local path
+    // In dev mode (monorepo), use file: protocol to reference the local bridge package
+    // Check if we're in the monorepo by looking for packages/bridge from the CLI location
+    const currentFilePath = fileURLToPath(import.meta.url);
+    const localBridgePath = resolve(join(dirname(currentFilePath), '..', '..', '..', 'bridge'));
+    const isDev = existsSync(localBridgePath);
+    if (isDev) {
+        // In dev mode, use file: protocol to reference the local bridge package
+        // This works with both npm and pnpm
+        packageJson.dependencies['agent-stage-bridge'] = `file:${localBridgePath}`;
+    }
+    else {
+        // Use npm version for production
+        packageJson.dependencies['agent-stage-bridge'] = '^0.1.0';
+    }
+    await writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2));
+}
+async function installDependencies(targetDir) {
+    // Check if we're in the monorepo by looking for packages/bridge from the CLI location
+    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/inspect.d.ts

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

package/dist/commands/inspect.js

@@ -0,0 +1,62 @@
+import { Command } from 'commander';
+import consola from 'consola';
+import c from 'picocolors';
+import { BridgeClient } from 'agent-stage-bridge/sdk';
+import { readRuntimeConfig, isInitialized } from '../utils/paths.js';
+export const inspectCommand = new Command('inspect')
+    .description('Inspect a page\'s schema, actions, and current state')
+    .argument('<page>', 'Page ID')
+    .action(async (pageId) => {
+    try {
+        // 1. 检查是否已初始化
+        if (!isInitialized()) {
+            consola.error('Project not initialized. Please run `agentstage init` first.');
+            process.exit(1);
+        }
+        // 2. 检查是否已启动
+        const config = await readRuntimeConfig();
+        if (!config) {
+            consola.error('Runtime is not running. Please run `agentstage start` first.');
+            process.exit(1);
+        }
+        const client = new BridgeClient(`ws://localhost:${config.port}/_bridge`);
+        await client.connect();
+        // 查找 page 对应的 store
+        const stores = await client.listStores();
+        const pageStores = stores.filter(s => s.pageId === pageId);
+        if (pageStores.length === 0) {
+            consola.error(`Page "${pageId}" not found or not connected`);
+            client.disconnect();
+            process.exit(1);
+        }
+        for (const storeInfo of pageStores) {
+            const description = await client.describe?.(storeInfo.id);
+            const state = await client.getState?.(storeInfo.id);
+            console.log();
+            console.log(c.bold(`${pageId}/${storeInfo.storeKey}`));
+            console.log(c.gray('─'.repeat(40)));
+            if (description) {
+                console.log(c.bold('Schema:'));
+                console.log(JSON.stringify(description.schema, null, 2));
+                console.log();
+                console.log(c.bold('Actions:'));
+                if (description.actions) {
+                    for (const [name, action] of Object.entries(description.actions)) {
+                        console.log(`  ${c.cyan(name)} - ${action.description || ''}`);
+                    }
+                }
+                console.log();
+            }
+            if (state) {
+                console.log(c.bold('Current State:'));
+                console.log(JSON.stringify(state.state, null, 2));
+            }
+        }
+        console.log();
+        client.disconnect();
+    }
+    catch (error) {
+        consola.error('Failed to inspect page:', error.message);
+        process.exit(1);
+    }
+});

package/dist/commands/ls.d.ts

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

package/dist/commands/ls.js

@@ -0,0 +1,84 @@
+import { Command } from 'commander';
+import consola from 'consola';
+import c from 'picocolors';
+import { readdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'pathe';
+import { getWorkspaceDir, readRuntimeConfig, isInitialized } from '../utils/paths.js';
+import { BridgeClient } from 'agent-stage-bridge/sdk';
+export const lsCommand = new Command('ls')
+    .description('List all pages and their store status')
+    .action(async () => {
+    try {
+        // 1. 检查是否已初始化
+        if (!isInitialized()) {
+            consola.error('Project not initialized. Please run `agentstage init` first.');
+            process.exit(1);
+        }
+        const workspaceDir = await getWorkspaceDir();
+        const routesDir = join(workspaceDir, 'src', 'routes');
+        let pages = [];
+        if (existsSync(routesDir)) {
+            const entries = await readdir(routesDir, { withFileTypes: true });
+            pages = entries
+                .filter(e => e.isFile() && e.name.endsWith('.tsx') && !e.name.startsWith('_'))
+                .map(e => e.name.replace('.tsx', ''))
+                .filter(name => name !== 'index'); // index is the home page
+        }
+        // 2. 检查是否已启动
+        const config = await readRuntimeConfig();
+        console.log();
+        console.log(c.bold('Pages:'));
+        console.log();
+        let stores = [];
+        if (config) {
+            try {
+                const client = new BridgeClient(`ws://localhost:${config.port}/_bridge`);
+                await client.connect();
+                stores = await client.listStores();
+                client.disconnect();
+            }
+            catch {
+                // Bridge 未运行
+            }
+        }
+        // Show home page
+        const homeStores = stores.filter(s => s.pageId === 'index');
+        if (homeStores.length > 0) {
+            console.log(`  ${c.green('●')} ${c.bold('/ (home)')}`);
+            for (const store of homeStores) {
+                console.log(`      └─ ${store.storeKey}  v${store.version}`);
+            }
+        }
+        else {
+            console.log(`  ${c.gray('○')} / (home)`);
+        }
+        // Show other pages
+        if (pages.length === 0) {
+            console.log(c.gray('  No additional pages. Create one with:'));
+            console.log(c.gray('  agentstage add-page <name>'));
+        }
+        else {
+            for (const page of pages) {
+                const pageStores = stores.filter(s => s.pageId === page);
+                if (pageStores.length > 0) {
+                    console.log(`  ${c.green('●')} ${c.bold('/' + page)}`);
+                    for (const store of pageStores) {
+                        console.log(`      └─ ${store.storeKey}  v${store.version}`);
+                    }
+                }
+                else {
+                    console.log(`  ${c.gray('○')} /${page}`);
+                }
+            }
+        }
+        console.log();
+        if (stores.length === 0) {
+            console.log(c.gray('Runtime is not running. Run `agentstage start` to see live status.'));
+            console.log();
+        }
+    }
+    catch (error) {
+        consola.error('Failed to list pages:', error.message);
+    }
+});

package/dist/commands/reset.d.ts

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

package/dist/commands/reset.js

@@ -0,0 +1,92 @@
+import { Command } from 'commander';
+import * as p from '@clack/prompts';
+import consola from 'consola';
+import c from 'picocolors';
+import { rm, unlink } from 'fs/promises';
+import { existsSync } from 'fs';
+import { getWorkspaceDir, readRuntimeConfig, WORKSPACE_FILE } from '../utils/paths.js';
+const PROJECT_NAME = 'webapp';
+export const resetCommand = new Command('reset')
+    .description('Reset Agentstage by removing the project and workspace configuration')
+    .option('-y, --yes', 'Skip confirmation', false)
+    .action(async (options) => {
+    console.log();
+    console.log(c.bold('Agentstage Reset'));
+    console.log(c.gray('─'.repeat(50)));
+    console.log();
+    try {
+        // 1. 检查 workspace 是否存在
+        let workspaceDir;
+        try {
+            workspaceDir = await getWorkspaceDir();
+        }
+        catch (error) {
+            consola.info('No workspace found. Nothing to reset.');
+            console.log();
+            return;
+        }
+        // 2. 显示要删除的内容
+        console.log(c.yellow('The following will be deleted:'));
+        console.log(`  • Project: ${c.cyan(workspaceDir)}`);
+        console.log(`  • Config:  ${c.cyan(WORKSPACE_FILE)}`);
+        console.log();
+        // 3. 检查 runtime 是否在运行
+        const config = await readRuntimeConfig();
+        if (config) {
+            try {
+                process.kill(config.pid, 0);
+                consola.warn('Runtime appears to be running. Please stop it first:');
+                console.log(`  ${c.cyan('agentstage stop')}`);
+                console.log();
+                process.exit(1);
+            }
+            catch {
+                // 进程不在运行，继续
+            }
+        }
+        // 4. 确认
+        if (!options.yes) {
+            const confirmed = await p.confirm({
+                message: 'Are you sure you want to delete everything?',
+                initialValue: false,
+            });
+            if (p.isCancel(confirmed) || !confirmed) {
+                consola.info('Cancelled');
+                console.log();
+                return;
+            }
+        }
+        // 5. 删除项目目录
+        const s = p.spinner();
+        s.start('Deleting project...');
+        if (existsSync(workspaceDir)) {
+            // 使用 rimraf 风格删除（多次尝试）
+            for (let i = 0; i < 3; i++) {
+                try {
+                    await rm(workspaceDir, { recursive: true, force: true, maxRetries: 3 });
+                    break;
+                }
+                catch (err) {
+                    if (i === 2)
+                        throw err;
+                    await new Promise(r => setTimeout(r, 100));
+                }
+            }
+        }
+        // 6. 删除配置文件
+        if (existsSync(WORKSPACE_FILE)) {
+            await unlink(WORKSPACE_FILE);
+        }
+        s.stop('Project deleted');
+        console.log();
+        consola.success('Reset complete!');
+        console.log();
+        console.log('You can now run:');
+        console.log(`  ${c.cyan('agentstage init')}  to create a new project`);
+        console.log();
+    }
+    catch (error) {
+        consola.error('Failed to reset:', error.message);
+        process.exit(1);
+    }
+});

package/dist/commands/restart.d.ts

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

package/dist/commands/restart.js

@@ -0,0 +1,90 @@
+import { Command } from 'commander';
+import * as p from '@clack/prompts';
+import consola from 'consola';
+import c from 'picocolors';
+import { execa } from 'execa';
+import { mkdir } from 'fs/promises';
+import { join } from 'pathe';
+import { getWorkspaceDir, saveRuntimeConfig, readRuntimeConfig, isInitialized } from '../utils/paths.js';
+async function killProcess(pid) {
+    try {
+        process.kill(pid, 'SIGTERM');
+        let attempts = 0;
+        while (attempts < 10) {
+            await new Promise(r => setTimeout(r, 500));
+            try {
+                process.kill(pid, 0);
+                attempts++;
+            }
+            catch {
+                break;
+            }
+        }
+        if (attempts >= 10) {
+            process.kill(pid, 'SIGKILL');
+        }
+    }
+    catch (error) {
+        if (error.code !== 'ESRCH')
+            throw error;
+    }
+}
+export const restartCommand = new Command('restart')
+    .description('Restart the Agentstage Runtime (stop and start)')
+    .option('-p, --port <port>', 'Port to run the web server on', '3000')
+    .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);
+    const s = p.spinner();
+    // 2. 停止现有服务
+    const existingConfig = await readRuntimeConfig();
+    if (existingConfig) {
+        s.start('Stopping current runtime...');
+        try {
+            await killProcess(existingConfig.pid);
+            s.stop('Runtime stopped');
+        }
+        catch (error) {
+            s.stop('Failed to stop runtime');
+            consola.warn('Continuing with start...');
+        }
+    }
+    // 3. 启动新服务
+    s.start('Starting Agentstage Runtime...');
+    try {
+        // 启动 TanStack Start 项目（包含 Bridge Gateway）
+        const subprocess = execa('npm', ['run', 'dev'], {
+            cwd: workspaceDir,
+            detached: true,
+            stdio: 'ignore',
+            env: {
+                ...process.env,
+                PORT: String(port),
+            },
+        });
+        await mkdir(join(workspaceDir, '.agentstage'), { recursive: true });
+        // 保存运行时配置
+        await saveRuntimeConfig({
+            pid: subprocess.pid,
+            port,
+            startedAt: new Date().toISOString(),
+        });
+        s.stop('Runtime restarted successfully');
+        console.log();
+        consola.success('Agentstage Runtime is running');
+        console.log(`  Web:    ${c.cyan(`http://localhost:${port}`)}`);
+        console.log(`  Bridge: ${c.cyan(`ws://localhost:${port}/_bridge`)}`);
+        console.log();
+        console.log(`  Workspace: ${c.gray(workspaceDir)}`);
+    }
+    catch (error) {
+        s.stop('Failed to start runtime');
+        consola.error(error.message);
+        process.exit(1);
+    }
+});

package/dist/commands/rm-page.d.ts

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

package/dist/commands/rm-page.js

@@ -0,0 +1,32 @@
+import { Command } from 'commander';
+import consola from 'consola';
+import { unlink } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'pathe';
+import { getWorkspaceDir, isInitialized } from '../utils/paths.js';
+export const rmPageCommand = new Command('rm-page')
+    .description('Remove a page from the routes directory')
+    .argument('<name>', 'Page name')
+    .action(async (name) => {
+    // 检查是否已初始化
+    if (!isInitialized()) {
+        consola.error('Project not initialized. Please run `agentstage init` first.');
+        process.exit(1);
+    }
+    try {
+        const workspaceDir = await getWorkspaceDir();
+        const routesDir = join(workspaceDir, 'src', 'routes');
+        const pageFile = join(routesDir, `${name}.tsx`);
+        if (!existsSync(pageFile)) {
+            consola.error(`Page "${name}" not found at src/routes/${name}.tsx`);
+            process.exit(1);
+        }
+        await unlink(pageFile);
+        consola.success(`Page "${name}" deleted`);
+        console.log(`  Note: TanStack Router will automatically remove the route`);
+    }
+    catch (error) {
+        consola.error('Failed to delete page:', error.message);
+        process.exit(1);
+    }
+});

package/dist/commands/start.d.ts

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

package/dist/commands/start.js

@@ -0,0 +1,82 @@
+import { Command } from 'commander';
+import * as p from '@clack/prompts';
+import consola from 'consola';
+import c from 'picocolors';
+import { execa } from 'execa';
+import { mkdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'pathe';
+import { getWorkspaceDir, saveRuntimeConfig, isInitialized, readRuntimeConfig } from '../utils/paths.js';
+export const startCommand = 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')
+    .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}`)}`);
+            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);
+        }
+    }
+    const s = p.spinner();
+    s.start('Starting Agentstage Runtime...');
+    try {
+        // 4. 启动 Vite dev server
+        // WebSocket 会通过 bridgePlugin() 自动挂载到 Vite server
+        const subprocess = execa('npx', ['vite', '--port', String(port), '--host'], {
+            cwd: workspaceDir,
+            detached: true,
+            stdio: 'ignore',
+        });
+        await mkdir(join(workspaceDir, '.agentstage'), { recursive: true });
+        // 5. 保存运行时配置
+        await saveRuntimeConfig({
+            pid: subprocess.pid,
+            port,
+            startedAt: new Date().toISOString(),
+        });
+        // 6. 等待一下确保服务启动
+        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}`)}`);
+        console.log(`  Bridge: ${c.cyan(`ws://localhost:${port}/_bridge`)}`);
+        console.log();
+        console.log(`  Workspace: ${c.gray(workspaceDir)}`);
+    }
+    catch (error) {
+        s.stop('Failed to start runtime');
+        consola.error(error.message);
+        process.exit(1);
+    }
+});

package/dist/commands/status.d.ts

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