agent-stage 0.2.13 → 0.2.15

package/dist/index.js

@@ -12,17 +12,23 @@ import { pageCommand } from './commands/page/index.js';
 import { runCommand } from './commands/run/index.js';
 import { guideCommand } from './commands/guide.js';
 import { cleanupCommand } from './commands/cleanup.js';
+import { componentsCommand } from './commands/components.js';
+import { doctorCommand } from './commands/doctor.js';
+import { verifyCommand } from './commands/verify.js';
 const program = new Command();
 program
     .name('agentstage')
     .description('Agent UI Stage CLI - Create interactive UI for AI agents')
     .version(pkg.version);
-// New command structure
-program.addCommand(devCommand);
-program.addCommand(pageCommand);
-program.addCommand(runCommand);
-program.addCommand(guideCommand);
-program.addCommand(cleanupCommand);
+// Register commands
+program.addCommand(devCommand); // dev init/start/stop/status
+program.addCommand(pageCommand); // page add/rm/ls/manifest
+program.addCommand(runCommand); // run get-state/set-state/exec/inspect/watch
+program.addCommand(guideCommand); // guide
+program.addCommand(cleanupCommand); // cleanup
+program.addCommand(componentsCommand); // components
+program.addCommand(doctorCommand); // doctor
+program.addCommand(verifyCommand); // verify
 // Error handling
 program.exitOverride();
 try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-stage",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "files": [
     "dist",
     "template"
@@ -16,8 +16,8 @@
     "execa": "^9.3.1",
     "pathe": "^1.1.2",
     "picocolors": "^1.1.1",
-    "@agentstage/bridge": "0.1.2",
-    "@agentstage/render": "0.2.2"
+    "@agentstage/render": "0.2.2",
+    "@agentstage/bridge": "0.1.2"
   },
   "devDependencies": {
     "@types/node": "^22.13.5",

package/dist/commands/exec.d.ts

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

package/dist/commands/exec.js

@@ -1,75 +0,0 @@
-import { Command } from 'commander';
-import consola from 'consola';
-import { join } from 'pathe';
-import { FileStore } from '@agentstage/bridge';
-import { BridgeClient } from '@agentstage/bridge/sdk';
-import { isInitialized, readRuntimeConfig, getPagesDir } from '../utils/paths.js';
-export const execCommand = new Command('exec')
-    .description('Execute an action on a page or set state')
-    .argument('<page>', 'Page ID')
-    .argument('[action]', 'Action name')
-    .argument('[payload]', 'Action payload as JSON')
-    .option('-s, --state <json>', 'Set state directly')
-    .option('--wait [timeoutMs]', 'Wait for browser ACK (optional timeout in ms)')
-    .action(async (pageId, action, payload, options) => {
-    try {
-        if (!isInitialized()) {
-            consola.error('Project not initialized. Please run `agentstage init` first.');
-            process.exit(1);
-        }
-        const pagesDir = await getPagesDir();
-        const fileStore = new FileStore({ pagesDir });
-        const storePath = join(pagesDir, pageId, 'store.json');
-        if (options.state) {
-            const state = JSON.parse(options.state);
-            const waitForAck = options.wait !== undefined && options.wait !== false;
-            if (waitForAck) {
-                const timeoutMs = typeof options.wait === 'string' && Number.isFinite(Number(options.wait))
-                    ? Number(options.wait)
-                    : 5000;
-                const config = await readRuntimeConfig();
-                if (!config) {
-                    consola.error('Bridge runtime is not running. Start it first or remove --wait.');
-                    process.exit(1);
-                }
-                const client = new BridgeClient(`ws://localhost:${config.port}/_bridge`);
-                await client.connect();
-                try {
-                    const result = await client.setStateByKey(pageId, 'main', state, {
-                        waitForAck: true,
-                        timeoutMs,
-                    });
-                    consola.success(`State updated with ACK (${storePath}, v${result.version})`);
-                }
-                finally {
-                    client.disconnect();
-                }
-            }
-            else {
-                const saved = await fileStore.save(pageId, {
-                    state,
-                    version: 0,
-                    updatedAt: new Date().toISOString(),
-                    pageId,
-                });
-                consola.success(`State updated (${storePath}, v${saved.version})`);
-            }
-        }
-        else if (action) {
-            // 保留命令参数兼容性，但文件模式仅支持直接写 state
-            if (payload) {
-                JSON.parse(payload);
-            }
-            consola.error('File mode only supports --state. Action dispatch requires a live Bridge connection.');
-            process.exit(1);
-        }
-        else {
-            consola.error('Please specify an action or use --state');
-            process.exit(1);
-        }
-    }
-    catch (error) {
-        consola.error('Failed to execute:', error.message);
-        process.exit(1);
-    }
-});

package/dist/commands/init.d.ts

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

package/dist/commands/init.js

@@ -1,208 +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';
-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'));
-    // 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/inspect.d.ts

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

package/dist/commands/inspect.js

@@ -1,62 +0,0 @@
-import { Command } from 'commander';
-import consola from 'consola';
-import c from 'picocolors';
-import { BridgeClient } from '@agentstage/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

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

package/dist/commands/ls.js

@@ -1,132 +0,0 @@
-import { Command } from 'commander';
-import consola from 'consola';
-import c from 'picocolors';
-import { readdir, readFile } from 'fs/promises';
-import { existsSync } from 'fs';
-import { homedir } from 'os';
-import { join } from 'pathe';
-import { getWorkspaceDir, readRuntimeConfig, isInitialized } from '../utils/paths.js';
-import { BridgeClient } from '@agentstage/bridge/sdk';
-async function readLocalStores(localPagesDir) {
-    if (!existsSync(localPagesDir)) {
-        return [];
-    }
-    const entries = await readdir(localPagesDir, { withFileTypes: true });
-    const stores = [];
-    for (const entry of entries) {
-        if (!entry.isDirectory()) {
-            continue;
-        }
-        const pageId = entry.name;
-        const storePath = join(localPagesDir, pageId, 'store.json');
-        if (!existsSync(storePath)) {
-            continue;
-        }
-        try {
-            const content = await readFile(storePath, 'utf8');
-            const parsed = JSON.parse(content);
-            stores.push({
-                pageId: typeof parsed.pageId === 'string' ? parsed.pageId : pageId,
-                storeKey: 'main',
-                version: typeof parsed.version === 'number' ? parsed.version : 0,
-            });
-        }
-        catch {
-            // Ignore invalid local files in offline mode
-        }
-    }
-    return stores;
-}
-export const lsCommand = new Command('ls')
-    .description('List all pages and their store status')
-    .option('--offline', 'Skip Bridge WebSocket and list local store files only')
-    .action(async (options) => {
-    try {
-        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
-        }
-        console.log();
-        console.log(c.bold('Pages:'));
-        console.log();
-        let stores = [];
-        const localPagesDir = join(homedir(), '.agentstage', 'webapp', 'pages');
-        if (options.offline) {
-            stores = await readLocalStores(localPagesDir);
-        }
-        else {
-            const config = await readRuntimeConfig();
-            if (config) {
-                try {
-                    const client = new BridgeClient(`ws://localhost:${config.port}/_bridge`);
-                    await client.connect();
-                    stores = await client.listStores();
-                    client.disconnect();
-                }
-                catch {
-                    // Bridge 未运行
-                }
-            }
-        }
-        const pageSet = new Set(pages);
-        for (const store of stores) {
-            if (store.pageId !== 'index') {
-                pageSet.add(store.pageId);
-            }
-        }
-        const listedPages = Array.from(pageSet);
-        // 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 (listedPages.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 listedPages) {
-                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) {
-            if (options.offline) {
-                console.log(c.gray(`No local store files found in ${localPagesDir}`));
-            }
-            else {
-                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/restart.d.ts

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

package/dist/commands/restart.js

@@ -1,90 +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 } 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

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

package/dist/commands/rm-page.js

@@ -1,32 +0,0 @@
-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

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

package/dist/commands/start.js

@@ -1,82 +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 } 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

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

package/dist/commands/status.js

@@ -1,52 +0,0 @@
-import { Command } from 'commander';
-import consola from 'consola';
-import c from 'picocolors';
-import { getWorkspaceDir, readRuntimeConfig, isInitialized } from '../utils/paths.js';
-function isRunning(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-export const statusCommand = new Command('status')
-    .description('Show the Agentstage Runtime status')
-    .action(async () => {
-    // 1. 检查是否已初始化
-    if (!isInitialized()) {
-        consola.error('Project not initialized. Please run `agentstage init` first.');
-        process.exit(1);
-    }
-    const workspaceDir = await getWorkspaceDir();
-    console.log();
-    console.log(c.bold('Agentstage Runtime'));
-    console.log(c.gray('─'.repeat(40)));
-    console.log(`Workspace: ${c.cyan(workspaceDir)}`);
-    // 2. 读取运行时配置
-    const config = await readRuntimeConfig();
-    if (!config) {
-        console.log(`Status:    ${c.red('●')} Stopped`);
-        console.log();
-        console.log(c.gray('Run `agentstage start` to start the runtime.'));
-        console.log();
-        return;
-    }
-    // 3. 检查进程是否存活
-    const running = isRunning(config.pid);
-    if (running) {
-        console.log(`Status:    ${c.green('●')} Running`);
-        console.log(`PID:       ${config.pid}`);
-        console.log(`Port:      ${config.port}`);
-        console.log(`Started:   ${new Date(config.startedAt).toLocaleString()}`);
-        console.log(`Web:       ${c.cyan(`http://localhost:${config.port}`)}`);
-        console.log(`Bridge:    ${c.cyan(`ws://localhost:${config.port}/_bridge`)}`);
-    }
-    else {
-        console.log(`Status:    ${c.yellow('●')} Dead (PID file exists but process not found)`);
-        console.log();
-        console.log(c.gray('Run `agentstage start` to restart the runtime.'));
-    }
-    console.log();
-});

package/dist/commands/stop.d.ts

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

package/dist/commands/stop.js

@@ -1,58 +0,0 @@
-import { Command } from 'commander';
-import consola from 'consola';
-import { unlink } from 'fs/promises';
-import { existsSync } from 'fs';
-import { getPidFile, readRuntimeConfig, removeRuntimeConfig, 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 stopCommand = new Command('stop')
-    .description('Stop the Agentstage Runtime')
-    .action(async () => {
-    // 1. 检查是否已初始化
-    if (!isInitialized()) {
-        consola.error('Project not initialized. Please run `agentstage init` first.');
-        process.exit(1);
-    }
-    // 2. 读取运行时配置
-    const config = await readRuntimeConfig();
-    if (!config) {
-        consola.info('Runtime is not running');
-        return;
-    }
-    // 3. 停止进程
-    try {
-        await killProcess(config.pid);
-        await removeRuntimeConfig();
-        // 兼容旧版本：删除 pid 文件
-        const pidFile = await getPidFile();
-        if (existsSync(pidFile)) {
-            await unlink(pidFile).catch(() => { });
-        }
-        consola.success('Runtime stopped');
-    }
-    catch (error) {
-        consola.error('Failed to stop runtime:', error.message);
-        process.exit(1);
-    }
-});

package/dist/commands/watch.d.ts

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

package/dist/commands/watch.js

@@ -1,54 +0,0 @@
-import { Command } from 'commander';
-import consola from 'consola';
-import c from 'picocolors';
-import { BridgeClient } from '@agentstage/bridge/sdk';
-import { readRuntimeConfig, isInitialized } from '../utils/paths.js';
-export const watchCommand = new Command('watch')
-    .description('Watch a page for real-time changes')
-    .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`);
-        client.onEvent((event) => {
-            const timestamp = new Date().toISOString();
-            console.log(c.gray(`[${timestamp}]`), event);
-        });
-        await client.connect();
-        // 查找并订阅所有该 page 的 stores
-        const stores = await client.listStores();
-        const pageStores = stores.filter(s => s.pageId === pageId);
-        if (pageStores.length === 0) {
-            consola.error(`Page "${pageId}" not found`);
-            client.disconnect();
-            process.exit(1);
-        }
-        for (const store of pageStores) {
-            client.subscribe(store.id);
-        }
-        consola.success(`Watching ${c.cyan(pageId)}. Press Ctrl+C to exit.`);
-        console.log();
-        // 保持运行
-        process.on('SIGINT', () => {
-            console.log();
-            consola.info('Stopped watching');
-            client.disconnect();
-            process.exit(0);
-        });
-        await new Promise(() => { });
-    }
-    catch (error) {
-        consola.error('Failed to watch page:', error.message);
-        process.exit(1);
-    }
-});