agent-stage 0.2.0

package/dist/commands/status.js

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

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

package/dist/commands/stop.js

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

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

package/dist/commands/watch.js

@@ -0,0 +1,54 @@
+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 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);
+    }
+});

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import consola from 'consola';
+import { initCommand } from './commands/init.js';
+import { startCommand } from './commands/start.js';
+import { stopCommand } from './commands/stop.js';
+import { restartCommand } from './commands/restart.js';
+import { statusCommand } from './commands/status.js';
+import { lsCommand } from './commands/ls.js';
+import { inspectCommand } from './commands/inspect.js';
+import { watchCommand } from './commands/watch.js';
+import { execCommand } from './commands/exec.js';
+import { addPageCommand } from './commands/add-page.js';
+import { rmPageCommand } from './commands/rm-page.js';
+import { componentsCommand } from './commands/components.js';
+import { doctorCommand } from './commands/doctor.js';
+import { resetCommand } from './commands/reset.js';
+const program = new Command();
+program
+    .name('agentstage')
+    .description('Agent UI Stage CLI - Create interactive UI for AI agents')
+    .version('0.2.0');
+// 注册命令
+program.addCommand(initCommand);
+program.addCommand(startCommand);
+program.addCommand(stopCommand);
+program.addCommand(restartCommand);
+program.addCommand(statusCommand);
+program.addCommand(lsCommand);
+program.addCommand(inspectCommand);
+program.addCommand(watchCommand);
+program.addCommand(execCommand);
+program.addCommand(addPageCommand);
+program.addCommand(rmPageCommand);
+program.addCommand(componentsCommand);
+program.addCommand(doctorCommand);
+program.addCommand(resetCommand);
+// 错误处理
+program.exitOverride();
+try {
+    await program.parseAsync(process.argv);
+}
+catch (error) {
+    if (error.code !== 'commander.help' && error.code !== 'commander.version') {
+        consola.error(error.message || 'Unknown error');
+        process.exit(1);
+    }
+}

package/dist/utils/paths.d.ts

@@ -0,0 +1,45 @@
+export declare const CLI_CONFIG_DIR: string;
+export declare const WORKSPACE_FILE: string;
+export declare const DEFAULT_WORKSPACE: string;
+/**
+ * 获取当前工作目录
+ */
+export declare function getWorkspaceDir(): Promise<string>;
+/**
+ * 设置工作目录
+ */
+export declare function setWorkspaceDir(dir: string): Promise<void>;
+/**
+ * 获取 PID 文件路径
+ */
+export declare function getPidFile(): Promise<string>;
+/**
+ * 获取 pages 目录
+ */
+export declare function getPagesDir(): Promise<string>;
+export declare function getRuntimeConfigFile(): Promise<string>;
+export interface RuntimeConfig {
+    pid: number;
+    port: number;
+    startedAt: string;
+}
+/**
+ * 读取运行时配置
+ */
+export declare function readRuntimeConfig(): Promise<RuntimeConfig | null>;
+/**
+ * 保存运行时配置
+ */
+export declare function saveRuntimeConfig(config: RuntimeConfig): Promise<void>;
+/**
+ * 删除运行时配置
+ */
+export declare function removeRuntimeConfig(): Promise<void>;
+/**
+ * 检查是否已初始化
+ */
+export declare function isInitialized(): boolean;
+/**
+ * 检查服务是否正在运行
+ */
+export declare function isRunning(): Promise<boolean>;

package/dist/utils/paths.js

@@ -0,0 +1,138 @@
+import { join, resolve } from 'pathe';
+import { existsSync } from 'fs';
+import { mkdir, readFile, writeFile } from 'fs/promises';
+import { homedir } from 'os';
+// CLI 配置目录
+export const CLI_CONFIG_DIR = join(homedir(), '.config', 'agentstage');
+export const WORKSPACE_FILE = join(CLI_CONFIG_DIR, 'workspace');
+// 默认工作目录
+export const DEFAULT_WORKSPACE = join(homedir(), '.agentstage');
+/**
+ * 获取当前工作目录
+ */
+export async function getWorkspaceDir() {
+    // 1. 从配置文件读取
+    try {
+        const workspace = await readFile(WORKSPACE_FILE, 'utf8');
+        if (workspace && existsSync(workspace.trim())) {
+            return workspace.trim();
+        }
+    }
+    catch {
+        // 配置文件不存在
+    }
+    // 2. 检查当前目录是否有 .agentstage
+    const currentDir = join(process.cwd(), '.agentstage');
+    if (existsSync(currentDir)) {
+        return currentDir;
+    }
+    // 3. 检查默认目录是否存在
+    if (existsSync(DEFAULT_WORKSPACE)) {
+        return DEFAULT_WORKSPACE;
+    }
+    // 4. 没有初始化
+    throw new Error('No workspace found. Run `agentstage init` first, or cd to a directory with .agentstage/');
+}
+/**
+ * 设置工作目录
+ */
+export async function setWorkspaceDir(dir) {
+    await mkdir(CLI_CONFIG_DIR, { recursive: true });
+    await writeFile(WORKSPACE_FILE, resolve(dir));
+}
+/**
+ * 获取 PID 文件路径
+ */
+export async function getPidFile() {
+    const workspace = await getWorkspaceDir();
+    return join(workspace, '.agentstage', 'pid');
+}
+/**
+ * 获取 pages 目录
+ */
+export async function getPagesDir() {
+    const workspace = await getWorkspaceDir();
+    // Vite template structure
+    if (existsSync(join(workspace, 'src', 'pages'))) {
+        return join(workspace, 'src', 'pages');
+    }
+    // Legacy TanStack Start structure (for backwards compatibility)
+    if (existsSync(join(workspace, 'src', 'routes', 'pages'))) {
+        return join(workspace, 'src', 'routes', 'pages');
+    }
+    if (existsSync(join(workspace, 'app', 'routes', 'pages'))) {
+        return join(workspace, 'app', 'routes', 'pages');
+    }
+    throw new Error('Pages directory not found at src/pages');
+}
+// 运行时配置文件路径
+export async function getRuntimeConfigFile() {
+    const workspace = await getWorkspaceDir();
+    return join(workspace, '.agentstage', 'runtime.json');
+}
+/**
+ * 读取运行时配置
+ */
+export async function readRuntimeConfig() {
+    const configFile = await getRuntimeConfigFile();
+    if (!existsSync(configFile)) {
+        return null;
+    }
+    try {
+        const content = await readFile(configFile, 'utf8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 保存运行时配置
+ */
+export async function saveRuntimeConfig(config) {
+    const configFile = await getRuntimeConfigFile();
+    await mkdir(join(configFile, '..'), { recursive: true });
+    await writeFile(configFile, JSON.stringify(config, null, 2));
+}
+/**
+ * 删除运行时配置
+ */
+export async function removeRuntimeConfig() {
+    const configFile = await getRuntimeConfigFile();
+    if (existsSync(configFile)) {
+        await writeFile(configFile, ''); // 清空而不是删除，便于检查
+    }
+}
+/**
+ * 检查是否已初始化
+ */
+export function isInitialized() {
+    // 检查配置文件是否存在
+    if (!existsSync(WORKSPACE_FILE)) {
+        return false;
+    }
+    try {
+        const workspace = readFileSync(WORKSPACE_FILE, 'utf8');
+        // 检查工作目录是否有 package.json（项目标志）
+        return existsSync(join(workspace.trim(), 'package.json'));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 检查服务是否正在运行
+ */
+export async function isRunning() {
+    const config = await readRuntimeConfig();
+    if (!config)
+        return false;
+    try {
+        process.kill(config.pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+import { readFileSync } from 'fs';

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "agent-stage",
+  "version": "0.2.0",
+  "files": ["dist", "template"],
+  "type": "module",
+  "bin": {
+    "agent-stage": "./dist/index.js"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "rimraf dist && tsc -p tsconfig.build.json",
+    "typecheck": "pnpm -C ../bridge build && tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "agent-stage-bridge": "^0.1.0",
+    "@clack/prompts": "^0.8.2",
+    "commander": "^12.1.0",
+    "consola": "^3.2.3",
+    "execa": "^9.3.1",
+    "pathe": "^1.1.2",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.5",
+    "rimraf": "^6.0.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.8.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/template/components.json

@@ -0,0 +1,17 @@
+{
+  "$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

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

@@ -0,0 +1,40 @@
+{
+  "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": {
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "@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",
+    "tailwind-merge": "^2.2.0",
+    "tailwindcss-animate": "^1.0.7",
+    "lucide-react": "^0.300.0",
+    "zod": "^3.23.0",
+    "zustand": "^4.5.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.43",
+    "@types/react-dom": "^18.2.17",
+    "@radix-ui/react-slot": "^1.0.2",
+    "@tanstack/router-generator": "^1.114.3",
+    "@tanstack/router-plugin": "^1.114.3",
+    "@vitejs/plugin-react": "^4.2.1",
+    "autoprefixer": "^10.4.17",
+    "postcss": "^8.4.33",
+    "tailwindcss": "^3.4.1",
+    "typescript": "^5.2.2",
+    "vite": "^5.0.8"
+  }
+}

package/template/postcss.config.js

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

package/template/src/components/ui/button.tsx

@@ -0,0 +1,55 @@
+import * as React from "react"
+import { Slot } from "@radix-ui/react-slot"
+import { cva, type VariantProps } from "class-variance-authority"
+import { cn } from "@/lib/utils"
+
+const buttonVariants = cva(
+  "inline-flex items-center justify-center whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50",
+  {
+    variants: {
+      variant: {
+        default: "bg-primary text-primary-foreground hover:bg-primary/90",
+        destructive:
+          "bg-destructive text-destructive-foreground hover:bg-destructive/90",
+        outline:
+          "border border-input bg-background hover:bg-accent hover:text-accent-foreground",
+        secondary:
+          "bg-secondary text-secondary-foreground hover:bg-secondary/80",
+        ghost: "hover:bg-accent hover:text-accent-foreground",
+        link: "text-primary underline-offset-4 hover:underline",
+      },
+      size: {
+        default: "h-10 px-4 py-2",
+        sm: "h-9 rounded-md px-3",
+        lg: "h-11 rounded-md px-8",
+        icon: "h-10 w-10",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  }
+)
+
+export interface ButtonProps
+  extends React.ButtonHTMLAttributes<HTMLButtonElement>,
+    VariantProps<typeof buttonVariants> {
+  asChild?: boolean
+}
+
+const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
+  ({ className, variant, size, asChild = false, ...props }, ref) => {
+    const Comp = asChild ? Slot : "button"
+    return (
+      <Comp
+        className={cn(buttonVariants({ variant, size, className }))}
+        ref={ref}
+        {...props}
+      />
+    )
+  }
+)
+Button.displayName = "Button"
+
+export { Button, buttonVariants }

package/template/src/components/ui/card.tsx

@@ -0,0 +1,78 @@
+import * as React from "react"
+import { cn } from "@/lib/utils"
+
+const Card = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn(
+      "rounded-lg border bg-card text-card-foreground shadow-sm",
+      className
+    )}
+    {...props}
+  />
+))
+Card.displayName = "Card"
+
+const CardHeader = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn("flex flex-col space-y-1.5 p-6", className)}
+    {...props}
+  />
+))
+CardHeader.displayName = "CardHeader"
+
+const CardTitle = React.forwardRef<
+  HTMLParagraphElement,
+  React.HTMLAttributes<HTMLHeadingElement>
+>(({ className, ...props }, ref) => (
+  <h3
+    ref={ref}
+    className={cn(
+      "text-2xl font-semibold leading-none tracking-tight",
+      className
+    )}
+    {...props}
+  />
+))
+CardTitle.displayName = "CardTitle"
+
+const CardDescription = React.forwardRef<
+  HTMLParagraphElement,
+  React.HTMLAttributes<HTMLParagraphElement>
+>(({ className, ...props }, ref) => (
+  <p
+    ref={ref}
+    className={cn("text-sm text-muted-foreground", className)}
+    {...props}
+  />
+))
+CardDescription.displayName = "CardDescription"
+
+const CardContent = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div ref={ref} className={cn("p-6 pt-0", className)} {...props} />
+))
+CardContent.displayName = "CardContent"
+
+const CardFooter = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn("flex items-center p-6 pt-0", className)}
+    {...props}
+  />
+))
+CardFooter.displayName = "CardFooter"
+
+export { Card, CardHeader, CardFooter, CardTitle, CardDescription, CardContent }

package/template/src/components/ui/input.tsx

@@ -0,0 +1,24 @@
+import * as React from "react"
+import { cn } from "@/lib/utils"
+
+export interface InputProps
+  extends React.InputHTMLAttributes<HTMLInputElement> {}
+
+const Input = React.forwardRef<HTMLInputElement, InputProps>(
+  ({ className, type, ...props }, ref) => {
+    return (
+      <input
+        type={type}
+        className={cn(
+          "flex h-10 w-full rounded-md border border-input bg-background px-3 py-2 text-sm ring-offset-background file:border-0 file:bg-transparent file:text-sm file:font-medium placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50",
+          className
+        )}
+        ref={ref}
+        {...props}
+      />
+    )
+  }
+)
+Input.displayName = "Input"
+
+export { Input }