@dyyz1993/create-agent 2.1.0 → 2.1.2

package/templates/browser-agent/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/browser-agent/src/shared/modules/timer.ts

@@ -0,0 +1,11 @@
+/**
+ * Timer 模块 — 定时器 & 事件推送
+ */
+export interface TimerMethods {
+  "timer.start": { params: {}; result: { started?: boolean; alreadyRunning?: boolean } };
+  "timer.stop": { params: {}; result: { stopped: boolean } };
+}
+
+export interface TimerEvents {
+  "timer.tick": { count: number; timestamp: number };
+}

package/templates/browser-agent/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/browser-agent/src/shared/rpc-schema.ts

@@ -0,0 +1,34 @@
+import type { AnyMethods } from "@dyyz1993/rpc-core";
+import type { SystemMethods } from "./modules/system";
+import type { FileMethods } from "./modules/file";
+import type { TimerMethods, TimerEvents } from "./modules/timer";
+import type { ChatMethods, ChatEvents } from "./modules/chat";
+import type { BrowserMethods, BrowserEvents } from "./modules/browser";
+import type { SessionMethods } from "./modules/session";
+
+/**
+ * RPC 方法定义 — 前后端共享的唯一类型入口
+ *
+ * 对应 PRD §8 数据模型 + §7 API 设计
+ */
+export interface RPCMethods
+	extends
+		AnyMethods,
+		SystemMethods,
+		FileMethods,
+		TimerMethods,
+		ChatMethods,
+		BrowserMethods,
+		SessionMethods {}
+
+/**
+ * RPC 事件定义
+ */
+export interface RPCEvents extends TimerEvents, ChatEvents, BrowserEvents {}
+
+/**
+ * Handler 注册选项
+ */
+export interface HandlerOptions {
+	platform: "desktop" | "web";
+}

package/templates/browser-agent/tailwind.config.js

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

package/templates/browser-agent/tsconfig.ipc.json

@@ -0,0 +1,14 @@
+{
+	"extends": "./tsconfig.json",
+	"compilerOptions": {
+		"noUnusedLocals": false,
+		"noUnusedParameters": false,
+		"skipLibCheck": true,
+		"noUncheckedIndexedAccess": true,
+		"noImplicitReturns": true,
+		"noFallthroughCasesInSwitch": true,
+		"strict": true
+	},
+	"include": ["src/bun", "src/gateway/ipc-transport.ts", "src/shared"],
+	"exclude": ["node_modules", "dist", "build", "**/__tests__/**", "**/*.test.ts", "**/*.test.tsx"]
+}

package/templates/browser-agent/tsconfig.json

@@ -0,0 +1,36 @@
+{
+	"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/*"]
+		},
+		"noUncheckedIndexedAccess": true,
+		"noImplicitReturns": true
+	},
+	"include": ["src", "../shared"],
+	"exclude": [
+		"node_modules",
+		"dist",
+		"build",
+		"../../package/dist",
+		"**/__tests__/**",
+		"**/*.test.ts",
+		"**/*.test.tsx"
+	]
+}

package/templates/browser-agent/vite.config.ts

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

package/templates/browser-agent/vitest.config.ts

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

package/templates/chat/.husky/commit-msg

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+npx --no -- commitlint --edit "$1"

package/templates/chat/.husky/pre-commit

@@ -0,0 +1,11 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+# Secret detection
+if git diff --cached --name-only --diff-filter=ACM -z | xargs -0 grep -ilE '(password|secret|api.key|private.key|token|credential).*=.*[A-Za-z0-9]{16,}' 2>/dev/null; then
+  echo "⚠️  Potential secrets detected in staged files!"
+  echo "Please review and remove any sensitive data before committing."
+  exit 1
+fi
+
+npx lint-staged

package/templates/chat/.husky/pre-push

@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+echo "⏳ Running lint..."
+pnpm run lint
+echo "✅ Pre-push checks passed. Pushing..."

package/templates/chat/CHANGELOG.md

@@ -0,0 +1,15 @@
+# pi-chat-app
+
+## 1.0.2
+
+### Patch Changes
+
+- Updated dependencies [[`29d2171`](https://github.com/dyyz1993/pi-agent-template/commit/29d217148f6e0b496cc06716e11847b3e522e266)]:
+  - @dyyz1993/rpc-core@2.2.1
+
+## 1.0.1
+
+### Patch Changes
+
+- Updated dependencies [[`29d2171`](https://github.com/dyyz1993/pi-agent-template/commit/29d217148f6e0b496cc06716e11847b3e522e266), [`724470a`](https://github.com/dyyz1993/pi-agent-template/commit/724470a784b48a66591e06299fab8ad72f023962)]:
+  - @dyyz1993/rpc-core@3.0.0

package/templates/chat/commitlint.config.js

@@ -0,0 +1,8 @@
+export default {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [2, 'always', ['feat', 'fix', 'docs', 'style', 'refactor', 'test', 'chore', 'revert', 'perf']],
+    'subject-max-length': [2, 'always', 80],
+    'subject-case': [0],
+  },
+};

package/templates/chat/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-chat-app",
-	"version": "1.0.0",
+	"version": "1.0.2",
 	"description": "Chat-focused template",
 	"scripts": {
 		"start": "vite build && electrobun dev",
@@ -14,13 +14,15 @@
 		"build:linux": "vite build && electrobun build --env=canary",
 		"lint": "eslint .",
 		"lint:fix": "eslint . --fix",
+		"format": "prettier --write .",
+		"format:check": "prettier --check .",
 		"prepare": "husky",
 		"test": "vitest run",
 		"test:watch": "vitest",
 		"test:coverage": "vitest run --coverage"
 	},
 	"dependencies": {
-		"@dyyz1993/rpc-core": "^1.2.0",
+		"@dyyz1993/rpc-core": "^2.2.1",
 		"@tanstack/react-virtual": "^3.13.24",
 		"electrobun": "1.18.1",
 		"i18next": "^24.2.2",
@@ -35,7 +37,7 @@
 		"zustand": "^5.0.12"
 	},
 	"devDependencies": {
-		"@dyyz1993/eslint-plugin-rpc": "workspace:*",
+		"@dyyz1993/eslint-plugin-rpc": "^1.1.0",
 		"@eslint/js": "^9.0.0",
 		"@testing-library/jest-dom": "^6.9.1",
 		"@testing-library/react": "^16.3.2",
@@ -60,7 +62,20 @@
 		"typescript": "^5.7.2",
 		"typescript-eslint": "^8.0.0",
 		"vite": "^6.0.3",
-		"vitest": "^4.1.5"
+		"vitest": "^4.1.5",
+		"@commitlint/cli": "^19.8.1",
+		"@commitlint/config-conventional": "^19.8.1",
+		"prettier": "^3.5.3",
+		"lint-staged": "^15.5.2"
+	},
+	"lint-staged": {
+		"*.{ts,tsx}": [
+			"eslint --fix",
+			"prettier --write"
+		],
+		"*.{json,md,css,html}": [
+			"prettier --write"
+		]
 	},
 	"overrides": {
 		"minimatch": "^10.0.1"

package/templates/chat/src/mainview/__tests__/hooks/use-input-history.test.ts

@@ -0,0 +1,125 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { renderHook, act } from "@testing-library/react";
+import { useInputHistory } from "../../hooks/use-input-history";
+
+describe("useInputHistory", () => {
+	beforeEach(() => {
+		window.localStorage.clear();
+	});
+
+	it("saveToHistory stores entry", () => {
+		const { result } = renderHook(() => useInputHistory("test-session"));
+		act(() => {
+			result.current.saveToHistory("hello");
+		});
+		expect(result.current.hasPrev).toBe(true);
+	});
+
+	it("saveToHistory ignores empty", () => {
+		const { result } = renderHook(() => useInputHistory("test-session"));
+		act(() => {
+			result.current.saveToHistory("  ");
+		});
+		expect(result.current.hasPrev).toBe(false);
+	});
+
+	it("navigatePrev returns items", () => {
+		const { result } = renderHook(() => useInputHistory("test-session"));
+		act(() => {
+			result.current.saveToHistory("first");
+			result.current.saveToHistory("second");
+		});
+		let value: string | null = null;
+		act(() => {
+			value = result.current.navigatePrev();
+		});
+		expect(value).toBe("second");
+
+		act(() => {
+			value = result.current.navigatePrev();
+		});
+		expect(value).toBe("first");
+	});
+
+	it("navigateNext returns empty string at end", () => {
+		const { result } = renderHook(() => useInputHistory("test-session"));
+		act(() => {
+			result.current.saveToHistory("hello");
+		});
+		act(() => {
+			result.current.navigatePrev();
+		});
+		let value: string | null = null;
+		act(() => {
+			value = result.current.navigateNext();
+		});
+		expect(value).toBe("");
+	});
+
+	it("clearHistory removes all", () => {
+		const { result } = renderHook(() => useInputHistory("test-session"));
+		act(() => {
+			result.current.saveToHistory("a");
+			result.current.saveToHistory("b");
+		});
+		act(() => {
+			result.current.clearHistory();
+		});
+		expect(result.current.hasPrev).toBe(false);
+	});
+
+	it("deduplicates entries", () => {
+		const { result } = renderHook(() => useInputHistory("test-session"));
+		act(() => {
+			result.current.saveToHistory("hello");
+			result.current.saveToHistory("hello");
+		});
+		let count = 0;
+		while (result.current.hasPrev) {
+			act(() => {
+				result.current.navigatePrev();
+			});
+			count++;
+			if (count > 20) break;
+		}
+		expect(count).toBe(1);
+	});
+
+	it("respects max 10 items", () => {
+		const { result } = renderHook(() => useInputHistory("test-session"));
+		act(() => {
+			for (let i = 0; i < 15; i++) {
+				result.current.saveToHistory(`item-${i}`);
+			}
+		});
+		let count = 0;
+		while (result.current.hasPrev) {
+			act(() => {
+				result.current.navigatePrev();
+			});
+			count++;
+			if (count > 20) break;
+		}
+		expect(count).toBe(10);
+	});
+
+	it("resetIndex goes back to -1", () => {
+		const { result } = renderHook(() => useInputHistory("test-session"));
+		act(() => {
+			result.current.saveToHistory("first");
+			result.current.saveToHistory("second");
+			result.current.saveToHistory("third");
+		});
+		act(() => {
+			result.current.navigatePrev();
+		});
+		act(() => {
+			result.current.navigatePrev();
+		});
+		expect(result.current.hasNext).toBe(true);
+		act(() => {
+			result.current.resetIndex();
+		});
+		expect(result.current.hasNext).toBe(false);
+	});
+});

package/templates/chat/src/mainview/__tests__/setup.ts

@@ -1,37 +1,40 @@
-import "@testing-library/jest-dom/vitest";
+import { expect } from "vitest";
+import * as matchers from "@testing-library/jest-dom/matchers";
+
+expect.extend(matchers);
 
 Object.defineProperty(window, "matchMedia", {
-  writable: true,
-  value: (query: string) => ({
-    matches: false,
-    media: query,
-    onchange: null,
-    addListener: () => {},
-    removeListener: () => {},
-    addEventListener: () => {},
-    removeEventListener: () => {},
-    dispatchEvent: () => false,
-  }),
+	writable: true,
+	value: (query: string) => ({
+		matches: false,
+		media: query,
+		onchange: null,
+		addListener: () => {},
+		removeListener: () => {},
+		addEventListener: () => {},
+		removeEventListener: () => {},
+		dispatchEvent: () => false,
+	}),
 });
 
 const localStorageMock = (() => {
-  let store: Record<string, string> = {};
-  return {
-    getItem: (key: string) => store[key] ?? null,
-    setItem: (key: string, value: string) => {
-      store[key] = String(value);
-    },
-    removeItem: (key: string) => {
-      delete store[key];
-    },
-    clear: () => {
-      store = {};
-    },
-    get length() {
-      return Object.keys(store).length;
-    },
-    key: (i: number) => Object.keys(store)[i] ?? null,
-  };
+	let store: Record<string, string> = {};
+	return {
+		getItem: (key: string) => store[key] ?? null,
+		setItem: (key: string, value: string) => {
+			store[key] = String(value);
+		},
+		removeItem: (key: string) => {
+			delete store[key];
+		},
+		clear: () => {
+			store = {};
+		},
+		get length() {
+			return Object.keys(store).length;
+		},
+		key: (i: number) => Object.keys(store)[i] ?? null,
+	};
 })();
 
 Object.defineProperty(window, "localStorage", { value: localStorageMock });

package/templates/chat/src/mainview/components/chat/ChatPanel.tsx

@@ -1,66 +1,91 @@
-import { useEffect, useRef } from "react";
+import { useCallback, useEffect, useRef } from "react";
 import { MessageSquare, Send } from "lucide-react";
 import { useTranslation } from "react-i18next";
 import { useChatStore } from "../../stores/use-chat-store";
+import { useInputHistory } from "../../hooks/use-input-history";
 import { MessageBubble } from "./MessageBubble";
 
 export function ChatPanel() {
-  const { t } = useTranslation();
-  const messages = useChatStore((s) => s.messages);
-  const inputText = useChatStore((s) => s.inputText);
-  const setInputText = useChatStore((s) => s.setInputText);
-  const sendMessage = useChatStore((s) => s.sendMessage);
-  const messagesEndRef = useRef<HTMLDivElement>(null);
+	const { t } = useTranslation();
+	const messages = useChatStore((s) => s.messages);
+	const inputText = useChatStore((s) => s.inputText);
+	const setInputText = useChatStore((s) => s.setInputText);
+	const sendMessage = useChatStore((s) => s.sendMessage);
+	const messagesEndRef = useRef<HTMLDivElement>(null);
+	const { saveToHistory, navigatePrev, navigateNext } = useInputHistory("default");
 
-  useEffect(() => {
-    messagesEndRef.current?.scrollIntoView({ behavior: "smooth" });
-  }, [messages]);
+	const handleSend = useCallback(() => {
+		const text = inputText.trim();
+		if (!text) return;
+		saveToHistory(text);
+		sendMessage();
+	}, [inputText, saveToHistory, sendMessage]);
 
-  return (
-    <div className="flex-1 flex flex-col overflow-hidden relative">
-      {/* Chat header */}
-      <div className="px-4 py-2 bg-[var(--color-bg-secondary)] border-b border-[var(--color-border-primary)] flex items-center justify-between flex-shrink-0">
-        <h2 className="text-sm font-semibold flex items-center gap-1.5">
-          <MessageSquare className="w-4 h-4 text-[var(--color-text-accent)]" />
-          {t("chat.title")}
-          {messages.length > 0 && (
-            <span className="ml-1 px-2 py-0.5 bg-[var(--color-accent)]/30 text-[var(--color-text-accent)] rounded text-[10px]">
-              {messages.length}
-            </span>
-          )}
-        </h2>
-      </div>
+	useEffect(() => {
+		messagesEndRef.current?.scrollIntoView({ behavior: "smooth" });
+	}, [messages]);
 
-      {/* Messages list */}
-      <div className="flex-1 overflow-y-auto p-4 space-y-3">
-        {messages.length === 0 ? (
-          <div className="flex items-center justify-center h-full text-[var(--color-text-placeholder)] text-sm">
-            {t("chat.empty")}
-          </div>
-        ) : (
-          messages.map((msg) => <MessageBubble key={msg.id} message={msg} />)
-        )}
-        <div ref={messagesEndRef} />
-      </div>
+	return (
+		<div className="flex-1 flex flex-col overflow-hidden relative">
+			{/* Chat header */}
+			<div className="px-4 py-2 bg-[var(--color-bg-secondary)] border-b border-[var(--color-border-primary)] flex items-center justify-between flex-shrink-0">
+				<h2 className="text-sm font-semibold flex items-center gap-1.5">
+					<MessageSquare className="w-4 h-4 text-[var(--color-text-accent)]" />
+					{t("chat.title")}
+					{messages.length > 0 && (
+						<span className="ml-1 px-2 py-0.5 bg-[var(--color-accent)]/30 text-[var(--color-text-accent)] rounded text-[10px]">
+							{messages.length}
+						</span>
+					)}
+				</h2>
+			</div>
 
-      {/* Input bar */}
-      <div className="px-4 py-3 bg-[var(--color-bg-secondary)] border-t border-[var(--color-border-primary)] flex gap-2 flex-shrink-0">
-        <input
-          type="text"
-          value={inputText}
-          onChange={(e) => setInputText(e.target.value)}
-          onKeyDown={(e) => e.key === "Enter" && !e.shiftKey && sendMessage()}
-          placeholder={t("chat.placeholder")}
-          className="flex-1 px-3 py-2 text-sm bg-[var(--color-bg-tertiary)] rounded-lg text-[var(--color-text-primary)] border border-[var(--color-border-secondary)] focus:border-[var(--color-accent)] focus:outline-none"
-        />
-        <button
-          onClick={sendMessage}
-          className="px-4 py-2 text-sm bg-[var(--color-accent)] hover:bg-[var(--color-accent-hover)] rounded-lg transition-colors flex items-center gap-1.5"
-        >
-          <Send className="w-4 h-4" />
-          {t("chat.send")}
-        </button>
-      </div>
-    </div>
-  );
+			{/* Messages list */}
+			<div className="flex-1 overflow-y-auto p-4 space-y-3">
+				{messages.length === 0 ? (
+					<div className="flex items-center justify-center h-full text-[var(--color-text-placeholder)] text-sm">
+						{t("chat.empty")}
+					</div>
+				) : (
+					messages.map((msg) => <MessageBubble key={msg.id} message={msg} />)
+				)}
+				<div ref={messagesEndRef} />
+			</div>
+
+			{/* Input bar */}
+			<form
+				onSubmit={(e) => e.preventDefault()}
+				className="px-4 py-3 bg-[var(--color-bg-secondary)] border-t border-[var(--color-border-primary)] flex gap-2 flex-shrink-0"
+			>
+				<input
+					type="text"
+					value={inputText}
+					onChange={(e) => setInputText(e.target.value)}
+					onKeyDown={(e) => {
+						if (e.key === "Enter" && !e.shiftKey) {
+							e.preventDefault();
+							handleSend();
+						} else if (e.key === "ArrowUp" && !inputText) {
+							e.preventDefault();
+							const prev = navigatePrev();
+							if (prev !== null) setInputText(prev);
+						} else if (e.key === "ArrowDown") {
+							e.preventDefault();
+							const next = navigateNext();
+							if (next !== null) setInputText(next);
+						}
+					}}
+					placeholder={t("chat.placeholder")}
+					className="flex-1 px-3 py-2 text-sm bg-[var(--color-bg-tertiary)] rounded-lg text-[var(--color-text-primary)] border border-[var(--color-border-secondary)] focus:border-[var(--color-accent)] focus:outline-none"
+				/>
+				<button
+					onClick={handleSend}
+					className="px-4 py-2 text-sm bg-[var(--color-accent)] hover:bg-[var(--color-accent-hover)] rounded-lg transition-colors flex items-center gap-1.5"
+				>
+					<Send className="w-4 h-4" />
+					{t("chat.send")}
+				</button>
+			</form>
+		</div>
+	);
 }