page-action-cache 1.0.1 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "page-action-cache",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Page action caching extension for OpenClaw - caches LLM browser operations to avoid re-analyzing the same DOM",
   "keywords": [
     "automation",
@@ -17,24 +17,22 @@
     "directory": "extensions/page-action-cache"
   },
   "files": [
-    "index.ts",
     "dist/",
-    "src/",
     "skills/",
     "docs/",
     "package.json",
     "openclaw.plugin.json"
   ],
   "type": "module",
-  "main": "src/hooks-entry.js",
+  "main": "dist/hooks-entry.js",
   "exports": {
     ".": {
       "types": "./src/index.d.ts",
-      "default": "./src/index.js"
+      "default": "./dist/index.js"
     },
     "./hooks-entry": {
-      "types": "./src/hooks-entry.d.ts",
-      "default": "./src/hooks-entry.js"
+      "types": "./dist/hooks-entry.d.ts",
+      "default": "./dist/hooks-entry.js"
     }
   },
   "scripts": {
@@ -70,7 +68,7 @@
   },
   "openclaw": {
     "extensions": [
-      "./src/hooks-entry.js"
+      "./dist/hooks-entry.js"
     ]
   }
-}
+}

package/index.ts

@@ -1,118 +0,0 @@
-/**
- * Page Action Cache Extension
- * 页面操作缓存扩展入口
- *
- * 功能：
- * - 缓存 LLM 生成的浏览器操作序列
- * - 避免重复分析相同页面
- * - 大幅降低 token 消耗和操作延迟
- *
- * 使用方法：
- * 1. 安装扩展：npm install @openclaw/page-action-cache
- * 2. 在配置中启用扩展
- * 3. LLM 会自动使用缓存的操作序列
- */
-
-import type { CacheConfig } from "./src/types.js";
-import { registerPageActionCacheHooks } from "./src/hooks.js";
-import { getToolDefinitions } from "./src/tools.js";
-
-// ============================================================================
-// 扩展元数据
-// ============================================================================
-
-export const metadata = {
-  name: "Page Action Cache",
-  version: "1.0.0",
-  description:
-    "缓存 LLM 浏览器操作序列，避免重复分析相同页面，大幅降低 token 消耗",
-  author: "OpenClaw",
-  license: "MIT",
-};
-
-// ============================================================================
-// 默认配置
-// ============================================================================
-
-const DEFAULT_CONFIG: CacheConfig = {
-  enabled: true,
-  autoUseCache: true,
-  scenarioRecognitionEnabled: true,
-  llmClassificationThreshold: 70,
-  cacheLevelStrategy: "auto",
-  defaultCacheLevel: "L3",
-  pageChangeDetectionEnabled: true,
-  changeInvalidationThreshold: 80,
-  invalidationStrategy: "soft",
-  maxVersionsPerEntry: 3,
-  variableExtractionEnabled: true,
-  allowUserConfirmVariables: false,
-  encryptSensitiveCache: false,
-  accessControlEnabled: false,
-  allowedUserIds: [],
-  logSanitizationEnabled: true,
-  showCacheStatusToUser: true,
-  enableUserCacheConfirmation: false,
-  enableUserForcedRefresh: true,
-  enableUserCacheErrorReport: true,
-  trackExecutionStats: true,
-  statsUpdateInterval: 60,
-};
-
-// ============================================================================
-// 扩展初始化
-// ============================================================================
-
-/**
- * 扩展初始化函数
- */
-export function activate(api: any, config?: Partial<CacheConfig>): void {
-  console.log(`[PageActionCache] Initializing v${metadata.version}...`);
-
-  const finalConfig = { ...DEFAULT_CONFIG, ...config };
-
-  // 注册 Hooks
-  registerPageActionCacheHooks(api, finalConfig);
-
-  // 注册自定义工具
-  const toolDefinitions = getToolDefinitions();
-  for (const toolDef of toolDefinitions) {
-    api.registerTool?.(toolDef);
-    console.log(`[PageActionCache] Registered tool: ${toolDef.name}`);
-  }
-
-  console.log("[PageActionCache] Extension activated successfully");
-}
-
-/**
- * 扩展停用函数
- */
-export function deactivate(): void {
-  console.log("[PageActionCache] Deactivating...");
-  // 清理资源
-  console.log("[PageActionCache] Extension deactivated");
-}
-
-// ============================================================================
-// 导出（用于测试和调试）
-// ============================================================================
-
-export * from "./src/types.js";
-export { getCacheStore } from "./src/cache-store.js";
-export { getScenarioRecognizer } from "./src/scenario-recognizer.js";
-export { getVariableResolver } from "./src/variable-resolver.js";
-export { getCacheInvalidator } from "./src/cache-invalidator.js";
-export { getSecurityPolicy } from "./src/security-policy.js";
-export { getUXEnhancer } from "./src/ux-enhancer.js";
-export { getActionsExecutor } from "./src/actions-executor.js";
-export { getCacheStrategyFactory } from "./src/cache-strategy.js";
-
-// ============================================================================
-// 默认导出（OpenClaw 扩展系统使用）
-// ============================================================================
-
-export default {
-  metadata,
-  activate,
-  deactivate,
-};

package/src/actions-executor.ts

@@ -1,441 +0,0 @@
-/**
- * Actions Executor
- * 操作执行器 - 执行缓存的原子化操作
- */
-
-import type {
-  AtomicAction,
-  ExecutionResult,
-  PwAi,
-  VariableMap,
-  NavigateAction,
-  ClickAction,
-  TypeAction,
-  PressAction,
-  HoverAction,
-  ScreenshotAction,
-  EvaluateAction,
-} from "./types.js";
-
-// ============================================================================
-// Actions Executor 类
-// ============================================================================
-
-/**
- * 操作执行器
- */
-export class ActionsExecutor {
-  private pw: PwAi | null = null;
-  private cdpUrl: string = "";
-
-  constructor(cdpUrl?: string) {
-    if (cdpUrl) {
-      this.cdpUrl = cdpUrl;
-    }
-  }
-
-  /**
-   * 设置 Playwright 客户端
-   */
-  setPlaywrightClient(pw: PwAi): void {
-    this.pw = pw;
-  }
-
-  /**
-   * 设置 CDP URL
-   */
-  setCdpUrl(cdpUrl: string): void {
-    this.cdpUrl = cdpUrl;
-  }
-
-  /**
-   * 执行单个操作
-   */
-  async execute(
-    action: AtomicAction,
-    variables?: VariableMap
-  ): Promise<ExecutionResult> {
-    const startTime = Date.now();
-
-    try {
-      // 应用变量
-      const resolvedAction = this.applyVariables(action, variables);
-
-      // 根据操作类型执行
-      switch (resolvedAction.type) {
-        case "navigate":
-          await this.executeNavigate(resolvedAction as NavigateAction);
-          break;
-
-        case "click":
-          await this.executeClick(resolvedAction as ClickAction);
-          break;
-
-        case "type":
-          await this.executeType(resolvedAction as TypeAction);
-          break;
-
-        case "press":
-          await this.executePress(resolvedAction as PressAction);
-          break;
-
-        case "hover":
-          await this.executeHover(resolvedAction as HoverAction);
-          break;
-
-        case "screenshot":
-          await this.executeScreenshot(resolvedAction as ScreenshotAction);
-          break;
-
-        case "scroll":
-        case "wait":
-        case "select":
-        case "focus":
-        case "drag":
-        case "upload":
-          await this.executeEvaluate(resolvedAction as EvaluateAction);
-          break;
-
-        case "composite":
-          // 复合操作暂不实现
-          throw new Error("Composite actions not yet implemented");
-
-        default:
-          throw new Error(`Unsupported action type: ${action.type}`);
-      }
-
-      return {
-        action: action.type,
-        success: true,
-        duration: Date.now() - startTime,
-      };
-    } catch (error) {
-      return {
-        action: action.type,
-        success: false,
-        error: error instanceof Error ? error.message : String(error),
-        duration: Date.now() - startTime,
-      };
-    }
-  }
-
-  /**
-   * 批量执行操作
-   */
-  async executeBatch(
-    actions: AtomicAction[],
-    variables?: VariableMap,
-    options?: {
-      fromIndex?: number;
-      toIndex?: number;
-      atomic?: boolean; // 是否原子执行（全部成功或全部失败）
-    }
-  ): Promise<ExecutionResult[]> {
-    const from = options?.fromIndex ?? 0;
-    const to =
-      options?.toIndex !== undefined ? options.toIndex + 1 : actions.length;
-    const atomic = options?.atomic ?? false;
-
-    const results: ExecutionResult[] = [];
-    const actionsToExecute = actions.slice(from, to);
-
-    for (const action of actionsToExecute) {
-      const result = await this.execute(action, variables);
-      results.push(result);
-
-      // 原子执行：失败则停止
-      if (atomic && !result.success) {
-        break;
-      }
-    }
-
-    return results;
-  }
-
-  // -------------------------------------------------------------------------
-  // 具体操作实现
-  // -------------------------------------------------------------------------
-
-  private async executeNavigate(action: NavigateAction): Promise<void> {
-    if (!this.pw) {
-      throw new Error("Playwright client not set");
-    }
-
-    await this.pw.navigateViaPlaywright({
-      cdpUrl: action.cdpUrl || this.cdpUrl,
-      targetId: action.targetId,
-      url: action.url,
-      waitUntil: action.navigationPolicy?.waitUntil || "domcontentloaded",
-      timeout: action.navigationPolicy?.timeout,
-    });
-  }
-
-  private async executeClick(action: ClickAction): Promise<void> {
-    if (!this.pw) {
-      throw new Error("Playwright client not set");
-    }
-
-    await this.pw.clickViaPlaywright({
-      cdpUrl: action.cdpUrl || this.cdpUrl,
-      targetId: action.targetId,
-      ref: action.ref,
-      doubleClick: action.doubleClick,
-      button: action.button || "left",
-      modifiers: action.modifiers,
-      timeoutMs: action.timeoutMs,
-    });
-  }
-
-  private async executeType(action: TypeAction): Promise<void> {
-    if (!this.pw) {
-      throw new Error("Playwright client not set");
-    }
-
-    await this.pw.typeViaPlaywright({
-      cdpUrl: action.cdpUrl || this.cdpUrl,
-      targetId: action.targetId,
-      ref: action.ref,
-      text: action.text,
-      submit: action.submit,
-      slowly: action.slowly,
-      timeoutMs: action.timeoutMs,
-    });
-  }
-
-  private async executePress(action: PressAction): Promise<void> {
-    if (!this.pw) {
-      throw new Error("Playwright client not set");
-    }
-
-    await this.pw.pressKeyViaPlaywright({
-      cdpUrl: action.cdpUrl || this.cdpUrl,
-      targetId: action.targetId,
-      key: action.key,
-      delayMs: action.delayMs,
-    });
-  }
-
-  private async executeHover(action: HoverAction): Promise<void> {
-    if (!this.pw) {
-      throw new Error("Playwright client not set");
-    }
-
-    await this.pw.hoverViaPlaywright({
-      cdpUrl: action.cdpUrl || this.cdpUrl,
-      targetId: action.targetId,
-      ref: action.ref,
-      timeoutMs: action.timeoutMs,
-    });
-  }
-
-  private async executeScreenshot(action: ScreenshotAction): Promise<string> {
-    if (!this.pw) {
-      throw new Error("Playwright client not set");
-    }
-
-    return this.pw.screenshotViaPlaywright({
-      cdpUrl: action.cdpUrl || this.cdpUrl,
-      targetId: action.targetId,
-    });
-  }
-
-  private async executeEvaluate(action: EvaluateAction): Promise<any> {
-    if (!this.pw) {
-      throw new Error("Playwright client not set");
-    }
-
-    return this.pw.evaluateViaPlaywright({
-      cdpUrl: action.cdpUrl || this.cdpUrl,
-      targetId: action.targetId,
-      code: action.evaluate.code,
-      args: action.evaluate.args,
-    });
-  }
-
-  // -------------------------------------------------------------------------
-  // 变量替换
-  // -------------------------------------------------------------------------
-
-  /**
-   * 应用变量到操作
-   */
-  private applyVariables(
-    action: AtomicAction,
-    variables?: VariableMap
-  ): AtomicAction {
-    if (!variables) {
-      return action;
-    }
-
-    // 检查是否需要变量替换
-    if (!action.variable) {
-      return action;
-    }
-
-    // 获取变量值
-    const value = variables[action.variable];
-    if (value === undefined) {
-      // 变量未定义，返回原操作
-      return action;
-    }
-
-    // 根据操作类型设置正确的参数
-    const actionType = action.type;
-    if (actionType === "type") {
-      return { ...action, text: value as string };
-    } else if (actionType === "press") {
-      return { ...action, key: value as string };
-    } else if (actionType === "navigate") {
-      return { ...action, url: value as string };
-    } else if (actionType === "scroll" || actionType === "wait" ||
-               actionType === "select" || actionType === "focus" ||
-               actionType === "drag" || actionType === "upload") {
-      // evaluate 操作替换模板变量
-      return this.replaceTemplateVariables(action, variables);
-    } else {
-      // 其他操作替换所有字符串参数中的模板变量
-      return this.replaceTemplateVariables(action, variables);
-    }
-  }
-
-  /**
-   * 替换操作中的模板变量
-   */
-  private replaceTemplateVariables(
-    action: AtomicAction,
-    variables: VariableMap
-  ): AtomicAction {
-    const result: any = { ...action };
-
-    // 替换字符串类型参数中的 ${variable}
-    for (const key of Object.keys(action)) {
-      const value = (action as any)[key];
-      if (typeof value === "string") {
-        result[key] = value.replace(/\$\{([^}]+)\}/g, (match, varName) => {
-          const replacement = variables[varName];
-          return replacement !== undefined ? replacement : match;
-        });
-      }
-    }
-
-    // 特殊处理 evaluate.code（如果存在）
-    if (result.evaluate?.code && typeof result.evaluate.code === "string") {
-      result.evaluate.code = result.evaluate.code.replace(
-        /\$\{([^}]+)\}/g,
-        (match: string, varName: string) => {
-          const replacement = variables[varName];
-          return replacement !== undefined ? replacement : match;
-        }
-      );
-    }
-
-    return result;
-  }
-
-  // -------------------------------------------------------------------------
-  // 格式化输出
-  // -------------------------------------------------------------------------
-
-  /**
-   * 格式化操作列表
-   */
-  formatActions(actions: AtomicAction[]): string {
-    return actions
-      .map((action, i) => this.formatAction(action, i + 1))
-      .join("\n");
-  }
-
-  /**
-   * 格式化单个操作
-   */
-  private formatAction(action: AtomicAction, index: number): string {
-    switch (action.type) {
-      case "navigate":
-        return `${index}. 导航到：${(action as NavigateAction).url}`;
-
-      case "screenshot":
-        return `${index}. 截图`;
-
-      case "click":
-        const btn = (action as ClickAction).button || "left";
-        const dbl = (action as ClickAction).doubleClick ? "双击" : "";
-        const mod = (action as ClickAction).modifiers?.length
-          ? `+${(action as ClickAction).modifiers!.join("+")}`
-          : "";
-        return `${index}. ${dbl}点击（${btn}${mod}）：${action.ref}`;
-
-      case "type":
-        const txt = (action as TypeAction).text
-          ? `="${(action as TypeAction).text}"`
-          : "";
-        const sub = (action as TypeAction).submit ? " [提交]" : "";
-        const slow = (action as TypeAction).slowly ? " [慢速]" : "";
-        return `${index}. 输入：${action.ref}${txt}${sub}${slow}`;
-
-      case "press":
-        const delay = (action as PressAction).delayMs
-          ? `(${(action as PressAction).delayMs}ms)`
-          : "";
-        return `${index}. 按键：${(action as PressAction).key}${delay}${
-          action.ref ? ` @ ${action.ref}` : ""
-        }`;
-
-      case "hover":
-        return `${index}. 悬停：${action.ref}`;
-
-      case "scroll":
-        return `${index}. 滚动：${
-          (action as EvaluateAction).evaluate?.code || "向下滚动"
-        }`;
-
-      case "wait":
-        const waitDelay = action.delay ? `(${action.delay}ms)` : "";
-        return `${index}. 等待：${
-          (action as EvaluateAction).evaluate?.code || "默认等待"
-        }${waitDelay}`;
-
-      case "select":
-        return `${index}. 选择：${action.ref}`;
-
-      case "focus":
-        return `${index}. 聚焦：${action.ref}`;
-
-      case "drag":
-        return `${index}. 拖拽：${action.ref}`;
-
-      case "upload":
-        return `${index}. 上传：${action.ref}`;
-
-      default:
-        return `${index}. ${action.type}：${action.ref || ""}`;
-    }
-  }
-
-  /**
-   * 格式化执行结果
-   */
-  formatExecutionResults(results: ExecutionResult[]): string {
-    return results
-      .map((r, i) => {
-        const icon = r.success ? "✅" : "❌";
-        const time = r.duration ? `(${r.duration}ms)` : "";
-        return `${icon} 操作 ${i + 1}: ${r.action} ${time}${
-          r.error ? ` - ${r.error}` : ""
-        }`;
-      })
-      .join("\n");
-  }
-}
-
-// ============================================================================
-// 单例
-// ============================================================================
-
-let actionsExecutorInstance: ActionsExecutor | null = null;
-
-export function getActionsExecutor(cdpUrl?: string): ActionsExecutor {
-  if (!actionsExecutorInstance) {
-    actionsExecutorInstance = new ActionsExecutor(cdpUrl);
-  }
-  return actionsExecutorInstance;
-}