@wukonglabs/wukong 0.0.8 → 0.0.10

package/dist/tui/use-input-history.js

@@ -0,0 +1,123 @@
+/**
+ * 输入历史 hook —— 提供 readline 历史导航 + Ctrl+R 反查。
+ *
+ * ## 交互
+ *
+ * - **上下键**:浏览历史(和 readline / bash 一致)
+ *   - 上键:回到更早的历史项;到顶不动
+ *   - 下键:回到更近的历史项;到底恢复为"编辑中"的草稿
+ *   - 浏览中按其他键修改 → 视为在新草稿上编辑(下次按上键回到当前选中)
+ * - **Ctrl+R**:进入反查模式
+ *   - 输入字符 → 实时过滤匹配的最近一条历史
+ *   - 再按 Ctrl+R → 跳到下一条匹配
+ *   - Enter / Esc / 非 Ctrl+R 编辑键 → 退出反查模式(Enter 提交当前匹配)
+ *
+ * ## 持久化
+ *
+ * 本 hook 只维护**进程内**历史。跨 session 持久化(读 `~/.wukong/history`)
+ * 由调用方负责,见 `tui/app.tsx`。
+ *
+ * ## 设计取舍
+ *
+ * 不引第三方库(如 ink-use-input-history)的原因:这些库大多没覆盖 Ctrl+R,
+ * 且与我们的"草稿保留 + 反查"语义不完全一致;自研约 120 行,可控性更好。
+ */
+import { useState, useCallback, useRef, useEffect } from 'react';
+export function useInputHistory(initial = []) {
+    const [entries, setEntries] = useState(initial);
+    const [navIndex, setNavIndex] = useState(null);
+    const draftRef = useRef('');
+    const [draftBeforeNav, setDraftBeforeNav] = useState('');
+    const push = useCallback((entry) => {
+        const trimmed = entry.trim();
+        if (!trimmed)
+            return;
+        setEntries((prev) => {
+            // 与最后一条相同则不重复
+            if (prev.length > 0 && prev[prev.length - 1] === trimmed)
+                return prev;
+            // 上限 1000 条,避免无限增长
+            const next = [...prev, trimmed];
+            return next.length > 1000 ? next.slice(next.length - 1000) : next;
+        });
+    }, []);
+    const navigate = useCallback((direction, currentDraft) => {
+        if (entries.length === 0)
+            return null;
+        // 进入导航前保存草稿
+        if (navIndex === null) {
+            draftRef.current = currentDraft;
+            setDraftBeforeNav(currentDraft);
+        }
+        if (direction === 'up') {
+            // 上键:navIndex 从 null → entries.length-1,否则 -1
+            const nextIdx = navIndex === null ? entries.length - 1 : Math.max(0, navIndex - 1);
+            setNavIndex(nextIdx);
+            return entries[nextIdx] ?? null;
+        }
+        else {
+            // 下键:到底恢复草稿
+            if (navIndex === null)
+                return null;
+            const nextIdx = navIndex + 1;
+            if (nextIdx >= entries.length) {
+                setNavIndex(null);
+                return draftRef.current;
+            }
+            setNavIndex(nextIdx);
+            return entries[nextIdx] ?? null;
+        }
+    }, [entries, navIndex]);
+    const exitNavigation = useCallback(() => {
+        setNavIndex(null);
+    }, []);
+    // entries 外部更新(initial 变化)时重置导航
+    useEffect(() => {
+        setNavIndex(null);
+    }, [entries]);
+    return {
+        entries,
+        push,
+        navIndex,
+        navigate,
+        exitNavigation,
+        draftBeforeNav,
+    };
+}
+/**
+ * 在历史中从 `fromIndex`(含)向更早的方向找第一条包含 `query` 的条目。
+ *
+ * @param entries 历史条目(末尾为最新)
+ * @param query 查询子串(大小写不敏感)
+ * @param fromIndex 从哪个索引开始往前找(含);默认从末尾开始
+ * @returns 匹配结果;无匹配返回 { index: -1, text: '' }
+ */
+export function reverseSearch(entries, query, fromIndex = entries.length - 1) {
+    if (!query || entries.length === 0)
+        return { index: -1, text: '' };
+    const q = query.toLowerCase();
+    for (let i = Math.min(fromIndex, entries.length - 1); i >= 0; i--) {
+        if (entries[i].toLowerCase().includes(q)) {
+            return { index: i, text: entries[i] };
+        }
+    }
+    return { index: -1, text: '' };
+}
+/**
+ * 跳到当前匹配之前的下一条匹配(用于"再按 Ctrl+R")。
+ *
+ * @param entries 历史条目
+ * @param query 查询子串
+ * @param currentIndex 当前匹配的索引
+ * @returns 新的匹配结果;无更早匹配时返回原 currentIndex 的结果
+ */
+export function reverseSearchNext(entries, query, currentIndex) {
+    if (currentIndex <= 0) {
+        // 已经是最早的匹配,返回当前
+        if (currentIndex < 0)
+            return { index: -1, text: '' };
+        return { index: currentIndex, text: entries[currentIndex] };
+    }
+    return reverseSearch(entries, query, currentIndex - 1);
+}
+//# sourceMappingURL=use-input-history.js.map

package/dist/tui/use-input-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-input-history.js","sourceRoot":"","sources":["../../src/tui/use-input-history.ts"],"names":[],"mappings":"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"}

package/dist/tui/use-plan-state.d.ts

@@ -0,0 +1,4 @@
+import type { EventBus } from '@wukonglabs/wukong-agent-sdk';
+import type { TodoItem } from './plan-panel.js';
+export declare function usePlanState(eventBus: EventBus): TodoItem[];
+//# sourceMappingURL=use-plan-state.d.ts.map

package/dist/tui/use-plan-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-plan-state.d.ts","sourceRoot":"","sources":["../../src/tui/use-plan-state.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAc,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAkD3D"}

package/dist/tui/use-plan-state.js

@@ -0,0 +1,73 @@
+/**
+ * usePlanState —— 订阅 EventBus 的 plan_update 事件,维护 todos 列表。
+ *
+ * 这是 PlanPanel 的容器逻辑(事件 → state),与 PlanPanel(纯展示)分离。
+ *
+ * ## 事件映射
+ *
+ * - add:    新增 todo(同 id 不重复)
+ * - update: 修改 content / status
+ * - complete: 标记为 completed
+ * - remove: 删除单个(有 todoId)或清空全部(无 todoId)
+ *
+ * ## 测试
+ *
+ * 由于 hook 依赖 React + EventBus,单测里用 @testing-library/react-hooks 的 renderHook。
+ * 本项目暂不引入该依赖,故 hook 通过 App 集成测试间接覆盖;
+ * 纯展示组件 PlanPanel 的单测覆盖所有渲染分支。
+ */
+import { useState, useEffect } from 'react';
+export function usePlanState(eventBus) {
+    const [todos, setTodos] = useState([]);
+    useEffect(() => {
+        const unsub = eventBus.on((event) => {
+            if (event.type !== 'plan_update')
+                return;
+            const { action, todoId, content, status } = event.data;
+            setTodos((prev) => {
+                switch (action) {
+                    case 'add': {
+                        if (!todoId)
+                            return prev;
+                        if (prev.some((t) => t.id === todoId))
+                            return prev;
+                        return [
+                            ...prev,
+                            {
+                                id: todoId,
+                                content: content ?? '(未命名)',
+                                status: status ?? 'pending',
+                            },
+                        ];
+                    }
+                    case 'update': {
+                        if (!todoId)
+                            return prev;
+                        return prev.map((t) => t.id === todoId
+                            ? {
+                                ...t,
+                                ...(content !== undefined ? { content } : {}),
+                                ...(status !== undefined ? { status } : {}),
+                            }
+                            : t);
+                    }
+                    case 'complete': {
+                        if (!todoId)
+                            return prev;
+                        return prev.map((t) => (t.id === todoId ? { ...t, status: 'completed' } : t));
+                    }
+                    case 'remove': {
+                        if (!todoId)
+                            return [];
+                        return prev.filter((t) => t.id !== todoId);
+                    }
+                    default:
+                        return prev;
+                }
+            });
+        });
+        return unsub;
+    }, [eventBus]);
+    return todos;
+}
+//# sourceMappingURL=use-plan-state.js.map

package/dist/tui/use-plan-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-plan-state.js","sourceRoot":"","sources":["../../src/tui/use-plan-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAI5C,MAAM,UAAU,YAAY,CAAC,QAAkB;IAC7C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAa,EAAE,CAAC,CAAC;IAEnD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAiB,EAAE,EAAE;YAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa;gBAAE,OAAO;YACzC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC;YACvD,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE;gBAChB,QAAQ,MAAM,EAAE,CAAC;oBACf,KAAK,KAAK,CAAC,CAAC,CAAC;wBACX,IAAI,CAAC,MAAM;4BAAE,OAAO,IAAI,CAAC;wBACzB,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC;4BAAE,OAAO,IAAI,CAAC;wBACnD,OAAO;4BACL,GAAG,IAAI;4BACP;gCACE,EAAE,EAAE,MAAM;gCACV,OAAO,EAAE,OAAO,IAAI,OAAO;gCAC3B,MAAM,EAAE,MAAM,IAAI,SAAS;6BAC5B;yBACF,CAAC;oBACJ,CAAC;oBACD,KAAK,QAAQ,CAAC,CAAC,CAAC;wBACd,IAAI,CAAC,MAAM;4BAAE,OAAO,IAAI,CAAC;wBACzB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,CAAC,CAAC,EAAE,KAAK,MAAM;4BACb,CAAC,CAAC;gCACE,GAAG,CAAC;gCACJ,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gCAC7C,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;6BAC5C;4BACH,CAAC,CAAC,CAAC,CACN,CAAC;oBACJ,CAAC;oBACD,KAAK,UAAU,CAAC,CAAC,CAAC;wBAChB,IAAI,CAAC,MAAM;4BAAE,OAAO,IAAI,CAAC;wBACzB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAChF,CAAC;oBACD,KAAK,QAAQ,CAAC,CAAC,CAAC;wBACd,IAAI,CAAC,MAAM;4BAAE,OAAO,EAAE,CAAC;wBACvB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;oBAC7C,CAAC;oBACD;wBACE,OAAO,IAAI,CAAC;gBAChB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,OAAO,KAAK,CAAC;IACf,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@wukonglabs/wukong",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "description": "CI-First AI Agent CLI — 极简但功能完整的 AI 编程助手（ReAct 循环 + 内置工具 + 技能系统）",
   "bin": {
     "wukong": "dist/index.js"
   },
+  "type": "module",
   "files": [
     "dist",
     "wukong.json"
@@ -31,10 +32,14 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@wukonglabs/wukong-agent-sdk": "0.0.8"
+    "ink": "^5.2.1",
+    "react": "^18.3.1",
+    "@wukonglabs/wukong-agent-sdk": "0.0.10"
   },
   "devDependencies": {
     "@types/node": "^25.3.2",
+    "@types/react": "^18.3.31",
+    "ink-testing-library": "^4.0.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
   },