@dyyz1993/create-agent 1.9.0

package/templates/chat/src/shared/handlers/index.ts

@@ -0,0 +1,2 @@
+export { register as system } from "./system";
+export { register as chat } from "./chat";

package/templates/chat/src/shared/handlers/system.ts

@@ -0,0 +1,27 @@
+import type { RPCServer } from "@dyyz1993/rpc-core";
+import type { MethodParams, MethodResult } from "@dyyz1993/rpc-core";
+import type { RPCMethods, HandlerOptions } from "../rpc-schema";
+
+type RegisterFn = <K extends keyof RPCMethods & string>(
+  method: K,
+  handler: (params: MethodParams<RPCMethods, K>) => Promise<MethodResult<RPCMethods, K>>,
+) => void;
+
+export function register(server: RPCServer, options: HandlerOptions): void {
+  const r: RegisterFn = (method, handler) => {
+    server.register(method, handler as (params: unknown) => Promise<unknown>);
+  };
+
+  r("system.ping", async () => ({
+    pong: true,
+    timestamp: Date.now(),
+    platform: options.platform,
+  }));
+
+  r("system.hello", async (params) => ({
+    message: `Hello ${params.name || "World"}!`,
+    timestamp: Date.now(),
+  }));
+
+  r("system.echo", async (params) => params);
+}

package/templates/chat/src/shared/lib/logger.ts

@@ -0,0 +1,130 @@
+import { appendFile, mkdir as mkdirAsync, readdir as readdirAsync, unlink as unlinkAsync, stat as statAsync } from "fs/promises";
+import { mkdirSync, existsSync } from "fs";
+import { join } from "path";
+
+export type LogModule = "server" | "gateway" | "system" | "chat";
+type LogLevel = "debug" | "info" | "warn" | "error";
+
+interface LogEntry {
+  timestamp: string;
+  level: LogLevel;
+  module: LogModule;
+  message: string;
+  data?: Record<string, unknown>;
+}
+
+let _logDir: string | null = null;
+let _maxAgeDays = 30;
+
+export async function configureLogDir(dir: string, options?: { maxAgeDays?: number }): Promise<void> {
+  _logDir = dir;
+  if (options?.maxAgeDays !== undefined) {
+    _maxAgeDays = options.maxAgeDays;
+  }
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  await cleanOldLogs(dir, _maxAgeDays);
+}
+
+function getLogDir(): string {
+  if (!_logDir) {
+    _logDir = "logs";
+    if (!existsSync(_logDir)) {
+      mkdirSync(_logDir, { recursive: true });
+    }
+  }
+  return _logDir;
+}
+
+async function cleanOldLogs(dir: string, maxAgeDays: number): Promise<void> {
+  try {
+    if (!existsSync(dir)) return;
+    const files = await readdirAsync(dir);
+    const cutoff = Date.now() - maxAgeDays * 86400000;
+    for (const f of files) {
+      if (!f.endsWith(".log")) continue;
+      const filePath = join(dir, f);
+      const s = await statAsync(filePath);
+      if (s.mtimeMs < cutoff) {
+        await unlinkAsync(filePath);
+      }
+    }
+  } catch { /* ignore */ }
+}
+
+function formatLine(entry: LogEntry): string {
+  const base = `[${entry.timestamp}] [${entry.level.toUpperCase()}] [${entry.module}] ${entry.message}`;
+  return entry.data ? `${base} ${JSON.stringify(entry.data)}` : base;
+}
+
+let writeQueue: Promise<void> = Promise.resolve();
+
+function writeToFile(line: string): void {
+  writeQueue = writeQueue.then(async () => {
+    try {
+      const date = new Date().toISOString().slice(0, 10);
+      const dir = getLogDir();
+      if (!existsSync(dir)) {
+        await mkdirAsync(dir, { recursive: true });
+      }
+      await appendFile(join(dir, `${date}.log`), `${line}\n`);
+    } catch { /* ignore */ }
+  });
+}
+
+export function flushLogs(): Promise<void> {
+  return writeQueue;
+}
+
+export class Logger {
+  private readonly module: LogModule;
+
+  constructor(module: LogModule) {
+    this.module = module;
+  }
+
+  debug(message: string, data?: Record<string, unknown>): void {
+    this.write("debug", message, data);
+  }
+
+  info(message: string, data?: Record<string, unknown>): void {
+    this.write("info", message, data);
+  }
+
+  warn(message: string, data?: Record<string, unknown>): void {
+    this.write("warn", message, data);
+  }
+
+  error(message: string, data?: Record<string, unknown>): void {
+    this.write("error", message, data);
+  }
+
+  private write(level: LogLevel, message: string, data?: Record<string, unknown>): void {
+    const entry: LogEntry = {
+      timestamp: new Date().toISOString(),
+      level,
+      module: this.module,
+      message,
+      ...(data ? { data } : {}),
+    };
+
+    const line = formatLine(entry);
+
+    if (level === "error") {
+      console.error(line);
+    } else if (level === "warn") {
+      console.warn(line);
+    } else {
+      console.log(line);
+    }
+
+    if (process.env.NODE_ENV !== "production" || level !== "debug") {
+      writeToFile(line);
+    }
+  }
+}
+
+export function createLogger(module: LogModule): Logger {
+  return new Logger(module);
+}

package/templates/chat/src/shared/lib/path-security.ts

@@ -0,0 +1,38 @@
+import { resolve } from "path";
+
+let allowedRoots: string[] = [process.cwd()];
+
+export function setAllowedRoots(roots: string[]): void {
+  allowedRoots = roots.map((r) => resolve(r));
+}
+
+export function isRpcPathAllowed(requestedPath: string): boolean {
+  try {
+    if (requestedPath.includes("\0")) return false;
+
+    const decoded = decodeURIComponent(requestedPath);
+    const resolved = resolve(decoded);
+    return allowedRoots.some(
+      (root) => resolved === root || resolved.startsWith(root + "/")
+    );
+  } catch {
+    return false;
+  }
+}
+
+export function validatePath(requestedPath: string): string {
+  if (requestedPath.includes("\0")) {
+    throw new Error(`Access denied: path contains null bytes`);
+  }
+
+  const decoded = decodeURIComponent(requestedPath);
+  const resolved = resolve(decoded);
+
+  if (!isRpcPathAllowed(resolved)) {
+    throw new Error(
+      `Access denied: path "${requestedPath}" is outside allowed roots`
+    );
+  }
+
+  return resolved;
+}

package/templates/chat/src/shared/lib/port-registry.ts

@@ -0,0 +1,103 @@
+/**
+ * Global port registry — tracks all running pi-agent instances.
+ *
+ * File: ~/.pi-agent/ports.json
+ *
+ * Format:
+ * {
+ *   "/absolute/project/path": {
+ *     "port": 3101,
+ *     "pid": 12345,
+ *     "startedAt": "2026-04-29T08:00:00.000Z",
+ *     "name": "my-project"
+ *   }
+ * }
+ */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { join, basename } from "path";
+import { homedir } from "os";
+
+const REGISTRY_DIR = join(homedir(), ".pi-agent");
+const REGISTRY_FILE = join(REGISTRY_DIR, "ports.json");
+
+export interface PortEntry {
+  port: number;
+  pid: number;
+  startedAt: string;
+  name: string;
+}
+
+export type PortRegistry = Record<string, PortEntry>;
+
+function ensureDir() {
+  if (!existsSync(REGISTRY_DIR)) {
+    mkdirSync(REGISTRY_DIR, { recursive: true });
+  }
+}
+
+export function readRegistry(): PortRegistry {
+  try {
+    if (!existsSync(REGISTRY_FILE)) return {};
+    return JSON.parse(readFileSync(REGISTRY_FILE, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+
+function writeRegistry(registry: PortRegistry): void {
+  ensureDir();
+  writeFileSync(REGISTRY_FILE, JSON.stringify(registry, null, 2), "utf-8");
+}
+
+export function registerPort(projectPath: string, port: number, name: string): void {
+  const registry = readRegistry();
+  registry[projectPath] = {
+    port,
+    pid: process.pid,
+    startedAt: new Date().toISOString(),
+    name: name || basename(projectPath),
+  };
+  writeRegistry(registry);
+}
+
+export function unregisterPort(projectPath: string): void {
+  const registry = readRegistry();
+  delete registry[projectPath];
+  if (Object.keys(registry).length === 0) {
+    writeRegistry(registry);
+  } else {
+    writeRegistry(registry);
+  }
+}
+
+export function cleanupStaleEntries(): void {
+  const registry = readRegistry();
+  let changed = false;
+  for (const [path, entry] of Object.entries(registry)) {
+    try {
+      process.kill(entry.pid, 0);
+    } catch {
+      delete registry[path];
+      changed = true;
+    }
+  }
+  if (changed) writeRegistry(registry);
+}
+
+export function formatRegistryForOutput(): string {
+  cleanupStaleEntries();
+  const registry = readRegistry();
+  const entries = Object.entries(registry);
+  if (entries.length === 0) return "No active instances.";
+
+  const lines = entries.map(([path, entry]) => {
+    const uptime = Math.round((Date.now() - new Date(entry.startedAt).getTime()) / 1000);
+    const uptimeStr = uptime < 60 ? `${uptime}s` : uptime < 3600 ? `${Math.floor(uptime / 60)}m ${uptime % 60}s` : `${Math.floor(uptime / 3600)}h ${Math.floor((uptime % 3600) / 60)}m`;
+    return `  ${entry.name}  →  http://localhost:${entry.port}  (PID ${entry.pid}, up ${uptimeStr})\n  ${path}`;
+  });
+
+  return `Active pi-agent instances (${entries.length}):\n${lines.join("\n\n")}\n\nRegistry: ${REGISTRY_FILE}`;
+}
+
+export { REGISTRY_FILE };

package/templates/chat/src/shared/modules/chat.ts

@@ -0,0 +1,20 @@
+/**
+ * Chat 模块 — 聊天消息
+ */
+export interface ChatMethods {
+  "chat.list": {
+    params: { limit?: number; cursor?: string };
+    result: {
+      messages: { id: string; role: "user" | "assistant"; content: string; timestamp: number }[];
+      hasMore: boolean;
+    };
+  };
+  "chat.send": {
+    params: { content: string };
+    result: { ok: boolean };
+  };
+}
+
+export interface ChatEvents {
+  "chat.message": { id: string; role: "user" | "assistant"; content: string; timestamp: number };
+}

package/templates/chat/src/shared/modules/system.ts

@@ -0,0 +1,8 @@
+/**
+ * System 模块 — 基础连通性 & 调试
+ */
+export interface SystemMethods {
+  "system.ping": { params: {}; result: { pong: boolean; timestamp: number; platform: string } };
+  "system.hello": { params: { name?: string }; result: { message: string; timestamp: number } };
+  "system.echo": { params: unknown; result: unknown };
+}

package/templates/chat/src/shared/register-all-handlers.ts

@@ -0,0 +1,36 @@
+import { RPCServer, type Transport } from "@dyyz1993/rpc-core";
+import type { HandlerOptions } from "./rpc-schema";
+import * as handlers from "./handlers/index";
+
+type RegisterFn = (server: RPCServer, options: HandlerOptions) => void;
+
+/**
+ * 自动注册所有 handlers — 从 handlers/index.ts barrel 导入
+ *
+ * 新增模块：在 handlers/ 创建文件，并在 handlers/index.ts 加一行 export
+ */
+export function registerAllHandlers(server: RPCServer, options: HandlerOptions): void {
+  for (const mod of Object.values(handlers) as RegisterFn[]) {
+    mod(server, options);
+  }
+}
+
+const noopTransport: Transport = {
+  send: async () => {},
+  onMessage: () => () => {},
+  onError: () => () => {},
+  onDisconnect: () => () => {},
+  isConnected: () => false,
+  close: () => {},
+};
+
+let _cachedMethods: string[] | null = null;
+
+export function discoverMethodNames(): string[] {
+  if (_cachedMethods) return _cachedMethods;
+  const server = new RPCServer(noopTransport);
+  registerAllHandlers(server, { platform: "web" });
+  _cachedMethods = server.getRegisteredMethods();
+  server.close();
+  return _cachedMethods;
+}

package/templates/chat/src/shared/rpc-schema.ts

@@ -0,0 +1,11 @@
+import type { AnyMethods } from "@dyyz1993/rpc-core";
+import type { SystemMethods } from "./modules/system";
+import type { ChatMethods, ChatEvents } from "./modules/chat";
+
+export interface RPCMethods extends AnyMethods, SystemMethods, ChatMethods {}
+
+export interface RPCEvents extends ChatEvents {}
+
+export interface HandlerOptions {
+  platform: "desktop" | "web";
+}

package/templates/chat/tailwind.config.js

@@ -0,0 +1,15 @@
+/** @type {import('tailwindcss').Config} */
+export default {
+	darkMode: "class",
+	content: ["./src/mainview/**/*.{html,js,ts,jsx,tsx}"],
+	theme: {
+		extend: {
+			colors: {
+				gray: {
+					850: "#1f2937",
+				},
+			},
+		},
+	},
+	plugins: [],
+};

package/templates/chat/tsconfig.json

@@ -0,0 +1,26 @@
+{
+	"compilerOptions": {
+		"target": "ES2020",
+		"useDefineForClassFields": true,
+		"lib": ["ES2020", "DOM", "DOM.Iterable"],
+		"module": "ESNext",
+		"skipLibCheck": true,
+		"moduleResolution": "bundler",
+		"allowImportingTsExtensions": true,
+		"isolatedModules": true,
+		"moduleDetection": "force",
+		"noEmit": true,
+		"jsx": "react-jsx",
+		"strict": true,
+		"noUnusedLocals": true,
+		"noUnusedParameters": true,
+		"noFallthroughCasesInSwitch": true,
+		"baseUrl": ".",
+		"paths": {
+			"@dyyz1993/rpc-core": ["../packages/rpc-core/src/index.ts"],
+			"@shared/*": ["../shared/*"]
+		}
+	},
+	"include": ["src", "../shared"],
+	"exclude": ["node_modules", "dist", "build", "../../package/dist", "**/__tests__/**", "**/*.test.ts", "**/*.test.tsx"]
+}

package/templates/chat/vite.config.ts

@@ -0,0 +1,3 @@
+import { createViteConfig } from "../shared/vite-base.config";
+
+export default createViteConfig(__dirname);

package/templates/chat/vitest.config.ts

@@ -0,0 +1,3 @@
+import { createVitestConfig } from "../shared/vitest-base.config";
+
+export default createVitestConfig(__dirname);

package/templates/general/.env.example

@@ -0,0 +1,7 @@
+# Web server configuration
+PORT=3100
+AUTH_TOKEN=your-secret-token-here
+MAX_UPLOAD_SIZE=5242880
+LOG_DIR=logs
+ENABLE_BASH=true
+CORS_ORIGIN=http://localhost:5173

package/templates/general/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 [username]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/templates/general/README.md

@@ -0,0 +1,113 @@
+# Pi Agent App
+
+Desktop + Web application template built with Electrobun, React, Tailwind CSS, and RPC architecture.
+
+## Getting Started
+
+```bash
+bun install
+
+# Development with HMR (recommended)
+bun run dev:hmr
+
+# Development without HMR
+bun run dev
+
+# Build
+bun run build
+```
+
+## Transport 选型
+
+本项目基于 `@dyyz1993/rpc-core`，提供 4 种 Transport 适配不同场景：
+
+| Transport | 场景 | 通信方式 |
+|---|---|---|
+| `WebSocketTransport` | Web 端 | TCP → WebSocket 长连接 |
+| `IPCTransport` | Electrobun 桌面端 | macOS Mach Port 原生桥接 |
+| `InMemoryTransport` | 同进程（TUI / 测试） | 进程内函数直接调用 |
+| `StdioTransport` | 父子进程（CLI / TUI） | NDJSON over stdin/stdout |
+
+### 使用示例
+
+```typescript
+// Web 端
+import { WebSocketTransport } from "@dyyz1993/rpc-core";
+const transport = new WebSocketTransport("ws://localhost:3100/ws?token=xxx");
+await transport.connect();
+
+// 桌面端 (Electrobun)
+import { IPCTransport } from "@dyyz1993/rpc-core";
+const transport = new IPCTransport();
+
+// 同进程 TUI / 测试
+import { InMemoryTransport } from "@dyyz1993/rpc-core";
+const { client, server } = InMemoryTransport.createPair();
+
+// 父子进程 CLI
+import { StdioTransport } from "@dyyz1993/rpc-core";
+const transport = new StdioTransport(); // 默认 process.stdin / process.stdout
+await transport.connect();
+```
+
+### 父子进程 STDIO 对接
+
+```typescript
+// 父进程：启动 TUI 子进程
+import { spawn } from "child_process";
+import { StdioTransport } from "@dyyz1993/rpc-core";
+
+const child = spawn("bun", ["tui.ts"], { stdio: ["pipe", "pipe", "inherit"] });
+const transport = new StdioTransport({
+  stdin: child.stdout,
+  stdout: child.stdin,
+});
+await transport.connect();
+```
+
+## Project Structure
+
+```
+├── src/
+│   ├── bun/
+│   │   └── index.ts          # Desktop entry (Electrobun main process)
+│   ├── server.ts             # Web entry (HTTP + WebSocket server)
+│   ├── gateway/
+│   │   ├── http-routes.ts    # HTTP endpoints
+│   │   ├── ws-handler.ts     # WebSocket RPC server
+│   │   └── ipc-transport.ts  # Electrobun IPC bridge
+│   ├── shared/
+│   │   ├── rpc-schema.ts     # Unified RPC type definitions
+│   │   ├── register-all-handlers.ts
+│   │   ├── modules/          # RPC method type definitions
+│   │   └── handlers/         # RPC handler implementations
+│   └── mainview/             # React frontend
+│       ├── App.tsx
+│       ├── components/
+│       │   ├── activity-bar/
+│       │   ├── chat/
+│       │   ├── explorer/
+│       │   ├── feed/
+│       │   ├── file-preview/
+│       │   ├── git/
+│       │   ├── search/       # File search across project
+│       │   └── debug/
+│       ├── stores/            # Zustand state management
+│       └── lib/
+│           └── api-client.ts  # Typed RPC client (auto-detects transport)
+├── eslint-plugin-rpc/        # Custom ESLint rules for RPC conventions
+├── electrobun.config.ts
+├── vite.config.ts
+└── tailwind.config.js
+```
+
+## RPC 模块列表
+
+| 模块 | 方法 | 事件 | 说明 |
+|---|---|---|---|
+| `system` | ping, hello, echo | - | 连通性测试 |
+| `file` | listDir, readFile, createFile, createDir, rename, delete, copy, findProjectRoot | - | 文件系统操作 |
+| `timer` | start, stop | timer.tick | 定时器 + 实时推送 |
+| `chat` | list, send | chat.message | 聊天（支持按 role 过滤） |
+| `git` | status, diff, log, branches, checkout, add, reset, commit, push, pull | - | Git 版本控制 |
+| `feed` | post, list | feed.update | Feed 流（支持 category 过滤） |