openclaw-openagent 1.0.1 → 1.0.2

package/dist/src/plugin-ui/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Plugin UI — UIExtensionLoader 入口
+ *
+ * 将 UI 扩展加载委托给 ui-extension-loader 模块。
+ * 保持对外 API 不变（injectControlUiOverride），内部全部走新框架。
+ */
+/**
+ * 加载全部 UI 扩展。
+ *
+ * 由 index.ts register() 调用。内部通过 Manifest Reconciler
+ * 自动完成扩展点的 apply / revert / skip。
+ */
+export declare function injectControlUiOverride(): Promise<void>;

package/dist/src/plugin-ui/index.js

@@ -0,0 +1,16 @@
+/**
+ * Plugin UI — UIExtensionLoader 入口
+ *
+ * 将 UI 扩展加载委托给 ui-extension-loader 模块。
+ * 保持对外 API 不变（injectControlUiOverride），内部全部走新框架。
+ */
+import { loadUIExtensions } from './ui-extension-loader/index.js';
+/**
+ * 加载全部 UI 扩展。
+ *
+ * 由 index.ts register() 调用。内部通过 Manifest Reconciler
+ * 自动完成扩展点的 apply / revert / skip。
+ */
+export async function injectControlUiOverride() {
+    await loadUIExtensions();
+}

package/dist/src/plugin-ui/ui-extension-loader/backup.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Backup — 文件备份与还原
+ *
+ * 代码级扩展修改宿主 minified bundle 前，先备份原始文件。
+ * 卸载时从备份恢复。OC 升级时备份随 control-ui/ 一起被清除。
+ */
+/**
+ * 备份文件。如果备份已存在则跳过（保持最早的原始版本）。
+ * 如果文件包含无 marker 的手工补丁，拒绝备份。
+ *
+ * @returns true = 备份就绪（已存在或新创建），false = 检测到脏 bundle，调用方必须中止 apply。
+ */
+export declare function backupFile(filepath: string): boolean;
+/**
+ * 从备份还原文件。
+ * 还原后删除备份文件。
+ * 如果备份不存在，记录警告但不抛异常。
+ */
+export declare function restoreFile(filepath: string): boolean;
+/**
+ * 检查备份是否存在。
+ */
+export declare function hasBackup(filepath: string): boolean;

package/dist/src/plugin-ui/ui-extension-loader/backup.js

@@ -0,0 +1,82 @@
+/**
+ * Backup — 文件备份与还原
+ *
+ * 代码级扩展修改宿主 minified bundle 前，先备份原始文件。
+ * 卸载时从备份恢复。OC 升级时备份随 control-ui/ 一起被清除。
+ */
+import { copyFileSync, unlinkSync, existsSync, readFileSync } from 'node:fs';
+import { logger } from '../../util/logger.js';
+const BACKUP_SUFFIX = '.openagent-bak';
+/** Patterns that indicate openagent modifications in the bundle.
+ * NOTE: __openagentMarked is NOT listed here — it's handled by the
+ * removed-extensions scanner for marked-expose cleanup. */
+const OPENAGENT_FINGERPRINTS = [
+    '__openagentRenderToolCard',
+    '__openagentOwnsToolCards',
+    '__tcid',
+    '__openagentIsRemoteToolName',
+    '__openagentToolCallIds',
+    '__openagentKeepToolPayload',
+];
+const OPENAGENT_MARKER_PATTERN = '/*openagent:';
+/**
+ * 检测文件是否包含无 marker 的 openagent 手工补丁。
+ * 如果文件包含 openagent 特征字符串但没有对应的 marker 注释，
+ * 说明这是一个被手工修改过的文件，不应该作为"原始备份"保存。
+ */
+function isDirtyBundle(filepath) {
+    try {
+        const content = readFileSync(filepath, 'utf-8');
+        const hasFingerprint = OPENAGENT_FINGERPRINTS.some(fp => content.includes(fp));
+        const hasMarker = content.includes(OPENAGENT_MARKER_PATTERN);
+        // 有 openagent 特征但没有 marker → 手工补丁
+        return hasFingerprint && !hasMarker;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 备份文件。如果备份已存在则跳过（保持最早的原始版本）。
+ * 如果文件包含无 marker 的手工补丁，拒绝备份。
+ *
+ * @returns true = 备份就绪（已存在或新创建），false = 检测到脏 bundle，调用方必须中止 apply。
+ */
+export function backupFile(filepath) {
+    const backupPath = filepath + BACKUP_SUFFIX;
+    if (existsSync(backupPath)) {
+        logger.debug(`[ui-ext] Backup already exists: ${backupPath}`);
+        return true;
+    }
+    // 检测脏 bundle：包含 openagent 代码但没有 marker
+    if (isDirtyBundle(filepath)) {
+        logger.warn(`[ui-ext] Dirty bundle detected: ${filepath} contains unmarked openagent patches. ` +
+            `Refusing to backup or patch. Please reinstall OpenClaw to get a clean bundle, then restart.`);
+        return false;
+    }
+    copyFileSync(filepath, backupPath);
+    logger.debug(`[ui-ext] Backed up: ${filepath}`);
+    return true;
+}
+/**
+ * 从备份还原文件。
+ * 还原后删除备份文件。
+ * 如果备份不存在，记录警告但不抛异常。
+ */
+export function restoreFile(filepath) {
+    const backupPath = filepath + BACKUP_SUFFIX;
+    if (!existsSync(backupPath)) {
+        logger.debug(`[ui-ext] No backup found: ${backupPath}`);
+        return false;
+    }
+    copyFileSync(backupPath, filepath);
+    unlinkSync(backupPath);
+    logger.debug(`[ui-ext] Restored from backup: ${filepath}`);
+    return true;
+}
+/**
+ * 检查备份是否存在。
+ */
+export function hasBackup(filepath) {
+    return existsSync(filepath + BACKUP_SUFFIX);
+}

package/dist/src/plugin-ui/ui-extension-loader/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * UIExtensionLoader — 主流程
+ *
+ * Manifest Reconciler：对比注册表（期望状态）与清单文件（当前状态），
+ * 自动完成扩展点的 apply / revert / skip。
+ *
+ * 共享文件的扩展按组处理：任何一个需要变更 → 恢复 backup → 重新 apply 全组。
+ *
+ * 每次 Gateway 启动时调用 loadUIExtensions()。
+ */
+/**
+ * 加载全部 UI 扩展。
+ *
+ * Reconciliation 流程：
+ * 1. 读取 manifest（不存在视为空）
+ * 2. 检测 bundleHash：不同 → OC 升级 → 全部重新 apply
+ * 3. 独立扩展逐个 apply/revert
+ * 4. 共享文件扩展按组处理：任何一个变更 → 恢复 backup → 重新 apply 全组
+ * 5. 写入新 manifest
+ */
+export declare function loadUIExtensions(): Promise<void>;
+/**
+ * 卸载全部 UI 扩展（插件卸载时调用）。
+ *
+ * 共享文件扩展：恢复 backup 即可（一次还原覆盖所有修改）。
+ * 独立扩展：逐个 revert。
+ */
+export declare function unloadUIExtensions(): Promise<void>;

package/dist/src/plugin-ui/ui-extension-loader/index.js

@@ -0,0 +1,240 @@
+/**
+ * UIExtensionLoader — 主流程
+ *
+ * Manifest Reconciler：对比注册表（期望状态）与清单文件（当前状态），
+ * 自动完成扩展点的 apply / revert / skip。
+ *
+ * 共享文件的扩展按组处理：任何一个需要变更 → 恢复 backup → 重新 apply 全组。
+ *
+ * 每次 Gateway 启动时调用 loadUIExtensions()。
+ */
+import { join } from 'node:path';
+import { logger } from '../../util/logger.js';
+import { resolveControlUiDir, findFileByPrefix, extractBundleHash } from './locator.js';
+import { readManifest, writeManifest, removeManifest } from './manifest.js';
+import { restoreFile } from './backup.js';
+import { UI_EXTENSIONS } from './registry-regex.js';
+import { REMOVED_UI_EXTENSIONS } from './removed-extensions.js';
+// ── 注入策略：正则模式链（无需 .map，21 版本全仿真验证通过）──────────────────
+/**
+ * 获取当前 bundle 的 hash（用于检测 OC 升级）。
+ */
+function getCurrentBundleHash(controlUiDir) {
+    const assetsDir = join(controlUiDir, 'assets');
+    const bundlePath = findFileByPrefix(assetsDir, 'index-');
+    return bundlePath ? extractBundleHash(bundlePath) : 'unknown';
+}
+/**
+ * 判断一个扩展是否需要变更（新增、更新、或删除）。
+ */
+function needsChange(ext, // null = 已从注册表删除
+oldVersion // null = manifest 中不存在
+) {
+    if (ext === null)
+        return true; // 需要删除
+    if (oldVersion === null)
+        return true; // 需要新增
+    return ext.version !== oldVersion; // 需要更新
+}
+/**
+ * 加载全部 UI 扩展。
+ *
+ * Reconciliation 流程：
+ * 1. 读取 manifest（不存在视为空）
+ * 2. 检测 bundleHash：不同 → OC 升级 → 全部重新 apply
+ * 3. 独立扩展逐个 apply/revert
+ * 4. 共享文件扩展按组处理：任何一个变更 → 恢复 backup → 重新 apply 全组
+ * 5. 写入新 manifest
+ */
+export async function loadUIExtensions() {
+    const controlUiDir = resolveControlUiDir();
+    if (!controlUiDir) {
+        logger.warn('[ui-ext] control-ui directory not found, skipping');
+        return;
+    }
+    logger.info(`[ui-ext] control-ui located: ${controlUiDir}`);
+    const currentHash = getCurrentBundleHash(controlUiDir);
+    const manifest = readManifest(controlUiDir);
+    const removedIds = new Set(REMOVED_UI_EXTENSIONS.map(ext => ext.id));
+    // bundleHash 不同 → OC 升级了
+    const isOcUpgrade = manifest !== null && manifest.bundleHash !== currentHash;
+    const needFullReapply = isOcUpgrade;
+    if (isOcUpgrade) {
+        logger.info(`[ui-ext] OC upgrade detected (${manifest.bundleHash} → ${currentHash}), re-applying all`);
+    }
+    // These are removed backend dist patches from the previous SSE strategy.
+    // Scan every startup regardless of manifest state: migration sites may have
+    // missing manifests, stale backups, or hand-applied copies.
+    // Track which shared files were restored so we force those groups to rebuild.
+    const forceSharedRebuild = new Set();
+    for (const ext of REMOVED_UI_EXTENSIONS) {
+        const result = safeRevertRemoved(ext, controlUiDir);
+        if (result === 'failed') {
+            logger.error(`[ui-ext] ${ext.id}: removed backend patch could not be reverted; aborting UI extension load`);
+            return;
+        }
+        if (result === 'restored' && ext.sharedFile) {
+            forceSharedRebuild.add(ext.sharedFile);
+            logger.info(`[ui-ext] ${ext.id}: shared file '${ext.sharedFile}' restored, will force group rebuild`);
+        }
+    }
+    const oldExtensions = (manifest && !needFullReapply)
+        ? Object.fromEntries(Object.entries(manifest.extensions).filter(([id]) => !removedIds.has(id)))
+        : {};
+    // ── 分组：独立扩展 vs 共享文件扩展 ──
+    const independentExts = [];
+    const sharedGroups = new Map();
+    for (const ext of UI_EXTENSIONS) {
+        if (ext.sharedFile) {
+            const group = sharedGroups.get(ext.sharedFile) ?? [];
+            group.push(ext);
+            sharedGroups.set(ext.sharedFile, group);
+        }
+        else {
+            independentExts.push(ext);
+        }
+    }
+    const newExtensions = {};
+    let applied = 0;
+    let skipped = 0;
+    // ── 处理独立扩展（逐个 apply/revert）──
+    for (const ext of independentExts) {
+        const old = oldExtensions[ext.id];
+        if (old && old.version === ext.version && !ext.alwaysApply) {
+            skipped++;
+            newExtensions[ext.id] = { version: ext.version };
+            logger.debug(`[ui-ext] ${ext.id}: skip (v${ext.version} unchanged)`);
+            continue;
+        }
+        if (old && old.version !== ext.version) {
+            // 版本变了，先 revert
+            logger.debug(`[ui-ext] ${ext.id}: revert (v${old.version} → v${ext.version})`);
+            safeRevert(ext, controlUiDir);
+        }
+        logger.debug(`[ui-ext] ${ext.id}: apply v${ext.version}`);
+        if (safeApply(ext, controlUiDir)) {
+            newExtensions[ext.id] = { version: ext.version };
+            applied++;
+        }
+    }
+    // ── 处理共享文件扩展（按组批量 reconcile）──
+    for (const [sharedFile, group] of sharedGroups) {
+        // 检查这个组里是否有任何扩展需要变更
+        let groupNeedsChange = forceSharedRebuild.has(sharedFile);
+        if (groupNeedsChange) {
+            logger.info(`[ui-ext] Shared group '${sharedFile}': forced rebuild due to removed extension cleanup`);
+        }
+        if (!groupNeedsChange) {
+            for (const ext of group) {
+                const old = oldExtensions[ext.id];
+                if (needsChange(ext, old?.version ?? null)) {
+                    groupNeedsChange = true;
+                    break;
+                }
+            }
+        }
+        // 检查是否有被删除的扩展（在 manifest 中属于该组但不在当前注册表中）
+        // 如果有，必须触发组重建以清除残留补丁
+        const groupRegistryIds = new Set(group.map(e => e.id));
+        for (const oldId of Object.keys(oldExtensions)) {
+            // 只关心曾经属于本组的扩展（不在当前注册表中 + 不在当前组中）
+            if (!groupRegistryIds.has(oldId) && !UI_EXTENSIONS.some(e => e.id === oldId)) {
+                // 无法确定旧扩展属于哪个组（manifest 不记录 sharedFile），保守触发重建
+                logger.info(`[ui-ext] Orphaned extension '${oldId}' found, triggering group '${sharedFile}' rebuild`);
+                groupNeedsChange = true;
+                break;
+            }
+        }
+        if (!groupNeedsChange) {
+            // 全组无变更，跳过
+            for (const ext of group) {
+                newExtensions[ext.id] = { version: ext.version };
+                skipped++;
+                logger.debug(`[ui-ext] ${ext.id}: skip (shared group '${sharedFile}' unchanged)`);
+            }
+            continue;
+        }
+        // 有变更 → 恢复 backup → 重新 apply 全组
+        logger.info(`[ui-ext] Shared group '${sharedFile}': changes detected, rebuilding`);
+        // 恢复 backup（仅当之前有补丁时才需要还原）
+        const assetsDir = join(controlUiDir, 'assets');
+        const bundlePath = findFileByPrefix(assetsDir, 'index-');
+        if (bundlePath) {
+            const restored = restoreFile(bundlePath);
+            if (restored) {
+                logger.debug(`[ui-ext] Restored backup for shared group '${sharedFile}'`);
+            }
+            else {
+                logger.debug(`[ui-ext] No backup to restore (first install or OC upgrade)`);
+            }
+        }
+        // 重新 apply 全组中所有应保留的扩展
+        for (const ext of group) {
+            logger.debug(`[ui-ext] ${ext.id}: apply v${ext.version} (group rebuild)`);
+            if (safeApply(ext, controlUiDir)) {
+                newExtensions[ext.id] = { version: ext.version };
+                applied++;
+            }
+        }
+    }
+    // ── 写入新 manifest ──
+    const newManifest = {
+        bundleHash: currentHash,
+        strategy: 'regex',
+        extensions: newExtensions,
+    };
+    writeManifest(controlUiDir, newManifest);
+    logger.info(`[ui-ext] Done: ${applied} applied, ${skipped} skipped`);
+}
+/**
+ * 卸载全部 UI 扩展（插件卸载时调用）。
+ *
+ * 共享文件扩展：恢复 backup 即可（一次还原覆盖所有修改）。
+ * 独立扩展：逐个 revert。
+ */
+export async function unloadUIExtensions() {
+    const controlUiDir = resolveControlUiDir();
+    if (!controlUiDir)
+        return;
+    // 先恢复共享文件的 backup
+    const assetsDir = join(controlUiDir, 'assets');
+    const bundlePath = findFileByPrefix(assetsDir, 'index-');
+    if (bundlePath) {
+        restoreFile(bundlePath);
+    }
+    // 再逆序 revert 独立扩展
+    for (const ext of UI_EXTENSIONS.slice().reverse()) {
+        if (!ext.sharedFile) {
+            safeRevert(ext, controlUiDir);
+        }
+    }
+    removeManifest(controlUiDir);
+    logger.info('[ui-ext] All UI extensions unloaded');
+}
+// ── Helpers ──────────────────────────────────────────────────────────────
+function safeApply(ext, controlUiDir) {
+    try {
+        return ext.apply(controlUiDir);
+    }
+    catch (err) {
+        logger.error(`[ui-ext] Failed to apply '${ext.id}': ${err.message}`);
+        return false;
+    }
+}
+function safeRevert(ext, controlUiDir) {
+    try {
+        ext.revert(controlUiDir);
+    }
+    catch (err) {
+        logger.error(`[ui-ext] Failed to revert '${ext.id}': ${err.message}`);
+    }
+}
+function safeRevertRemoved(ext, controlUiDir) {
+    try {
+        return ext.revert(controlUiDir);
+    }
+    catch (err) {
+        logger.error(`[ui-ext] Failed to revert removed extension '${ext.id}': ${err.message}`);
+        return 'failed';
+    }
+}

package/dist/src/plugin-ui/ui-extension-loader/locator.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Locator — 定位 OpenClaw control-ui 目录和文件
+ *
+ * 唯一定位方法：require.resolve('openclaw')
+ * 插件通过 symlink 依赖宿主 openclaw 包，如果 symlink 不存在，
+ * 插件的 import 语句就会失败，根本执行不到这里。
+ */
+/**
+ * 定位 control-ui 目录。
+ *
+ * require.resolve('openclaw')
+ *   → /usr/lib/node_modules/openclaw/dist/index.js
+ *   → dirname → dist/
+ *   → join('control-ui') → dist/control-ui/
+ */
+export declare function resolveControlUiDir(): string | null;
+/**
+ * 定位 OpenClaw dist 目录。
+ *
+ * control-ui 是 dist/control-ui 的子目录，后端 gateway-cli-*.js 也在同一个
+ * dist 下。这里优先从已解析出的 control-ui 反推，避免 Docker 场景下
+ * require.resolve('openclaw') 失效。
+ */
+export declare function resolveOpenClawDistDir(controlUiDir?: string | null): string | null;
+/**
+ * 在目录中查找匹配前缀的第一个文件。
+ * 用于定位 Vite code-split 后的文件（如 index-D7mg1IkY.js）。
+ * @param suffix 文件后缀，默认 '.js'，传 '.js.map' 可找 source map
+ */
+export declare function findFileByPrefix(dir: string, prefix: string, suffix?: string): string | null;
+/**
+ * 获取 bundle 文件名中的 hash 部分，用作 bundleHash。
+ * index-D7mg1IkY.js → D7mg1IkY
+ */
+export declare function extractBundleHash(bundlePath: string): string;

package/dist/src/plugin-ui/ui-extension-loader/locator.js

@@ -0,0 +1,129 @@
+/**
+ * Locator — 定位 OpenClaw control-ui 目录和文件
+ *
+ * 唯一定位方法：require.resolve('openclaw')
+ * 插件通过 symlink 依赖宿主 openclaw 包，如果 symlink 不存在，
+ * 插件的 import 语句就会失败，根本执行不到这里。
+ */
+import { existsSync, readdirSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { createRequire } from 'node:module';
+import { logger } from '../../util/logger.js';
+function addControlUiCandidatesFromEntrypoint(candidates, entryPoint) {
+    if (!entryPoint)
+        return;
+    const entryDir = dirname(resolve(entryPoint));
+    candidates.push(
+    // npm/global install: openclaw/dist/index.js -> openclaw/dist/control-ui
+    join(entryDir, 'control-ui'), 
+    // package root entry: openclaw/openclaw.mjs or openclaw/index.js -> openclaw/dist/control-ui
+    join(entryDir, 'dist', 'control-ui'), 
+    // package sub-entry fallback: openclaw/dist/index.js -> openclaw/dist/control-ui
+    join(dirname(entryDir), 'dist', 'control-ui'));
+}
+function addDistCandidatesFromEntrypoint(candidates, entryPoint) {
+    if (!entryPoint)
+        return;
+    const entryDir = dirname(resolve(entryPoint));
+    candidates.push(
+    // npm/global install: openclaw/dist/index.js -> openclaw/dist
+    entryDir, 
+    // package root entry: openclaw/openclaw.mjs or openclaw/index.js -> openclaw/dist
+    join(entryDir, 'dist'), 
+    // package sub-entry fallback: openclaw/dist/index.js -> openclaw/dist
+    join(dirname(entryDir), 'dist'));
+}
+/**
+ * 定位 control-ui 目录。
+ *
+ * require.resolve('openclaw')
+ *   → /usr/lib/node_modules/openclaw/dist/index.js
+ *   → dirname → dist/
+ *   → join('control-ui') → dist/control-ui/
+ */
+export function resolveControlUiDir() {
+    const candidates = [];
+    // In local development it is possible for the plugin's peerDependency
+    // symlink to resolve to a different OpenClaw installation than the gateway
+    // process that is currently serving /chat. Prefer the actual process
+    // entrypoint when available.
+    addControlUiCandidatesFromEntrypoint(candidates, process.argv[1]);
+    try {
+        const require = createRequire(import.meta.url);
+        const entryPoint = require.resolve('openclaw');
+        addControlUiCandidatesFromEntrypoint(candidates, entryPoint);
+    }
+    catch {
+        // Docker installs the plugin outside /app/node_modules, so resolving the
+        // host package from the plugin path can fail even though OpenClaw is
+        // running from /app. Fall through to cwd-based candidates below.
+    }
+    // Docker image layout: process cwd is /app, UI lives at /app/dist/control-ui.
+    candidates.push(join(process.cwd(), 'dist', 'control-ui'), join(resolve(process.cwd(), '..'), 'dist', 'control-ui'));
+    for (const candidate of candidates) {
+        if (existsSync(candidate)) {
+            logger.debug(`[ui-ext] control-ui located: ${candidate}`);
+            return candidate;
+        }
+    }
+    logger.warn('[ui-ext] Could not locate control-ui directory');
+    return null;
+}
+/**
+ * 定位 OpenClaw dist 目录。
+ *
+ * control-ui 是 dist/control-ui 的子目录，后端 gateway-cli-*.js 也在同一个
+ * dist 下。这里优先从已解析出的 control-ui 反推，避免 Docker 场景下
+ * require.resolve('openclaw') 失效。
+ */
+export function resolveOpenClawDistDir(controlUiDir) {
+    const candidates = [];
+    if (controlUiDir) {
+        candidates.push(dirname(controlUiDir));
+    }
+    addDistCandidatesFromEntrypoint(candidates, process.argv[1]);
+    try {
+        const require = createRequire(import.meta.url);
+        const entryPoint = require.resolve('openclaw');
+        addDistCandidatesFromEntrypoint(candidates, entryPoint);
+    }
+    catch {
+        // Docker 插件路径下可能无法 resolve 宿主 openclaw；继续走 cwd 兜底。
+    }
+    candidates.push(join(process.cwd(), 'dist'), join(resolve(process.cwd(), '..'), 'dist'));
+    for (const candidate of candidates) {
+        if (existsSync(candidate)) {
+            logger.debug(`[ui-ext] openclaw dist located: ${candidate}`);
+            return candidate;
+        }
+    }
+    logger.warn('[ui-ext] Could not locate OpenClaw dist directory');
+    return null;
+}
+/**
+ * 在目录中查找匹配前缀的第一个文件。
+ * 用于定位 Vite code-split 后的文件（如 index-D7mg1IkY.js）。
+ * @param suffix 文件后缀，默认 '.js'，传 '.js.map' 可找 source map
+ */
+export function findFileByPrefix(dir, prefix, suffix = '.js') {
+    try {
+        const entries = readdirSync(dir);
+        const match = entries.find(e => e.startsWith(prefix) && e.endsWith(suffix));
+        if (match) {
+            logger.debug(`[ui-ext] Found file: ${match}`);
+        }
+        return match ? join(dir, match) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 获取 bundle 文件名中的 hash 部分，用作 bundleHash。
+ * index-D7mg1IkY.js → D7mg1IkY
+ */
+export function extractBundleHash(bundlePath) {
+    const filename = bundlePath.split('/').pop() ?? '';
+    const match = filename.match(/^index-(.+)\.js$/);
+    return match?.[1] ?? filename;
+}

package/dist/src/plugin-ui/ui-extension-loader/manifest.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Manifest — 清单文件读写
+ *
+ * 存储在 control-ui/openagent-manifest.json，
+ * 记录当前已加载的扩展点及其版本，用于 reconciliation。
+ */
+export interface ManifestData {
+    bundleHash: string;
+    /** 当前使用的注入策略。 */
+    strategy?: 'regex';
+    extensions: Record<string, {
+        version: number;
+    }>;
+}
+/**
+ * 读取清单文件。不存在或解析失败返回 null。
+ */
+export declare function readManifest(controlUiDir: string): ManifestData | null;
+/**
+ * 写入清单文件。
+ */
+export declare function writeManifest(controlUiDir: string, data: ManifestData): void;
+/**
+ * 删除清单文件。
+ */
+export declare function removeManifest(controlUiDir: string): void;

package/dist/src/plugin-ui/ui-extension-loader/manifest.js

@@ -0,0 +1,45 @@
+/**
+ * Manifest — 清单文件读写
+ *
+ * 存储在 control-ui/openagent-manifest.json，
+ * 记录当前已加载的扩展点及其版本，用于 reconciliation。
+ */
+import { readFileSync, writeFileSync, unlinkSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { logger } from '../../util/logger.js';
+const MANIFEST_FILENAME = 'openagent-manifest.json';
+/**
+ * 读取清单文件。不存在或解析失败返回 null。
+ */
+export function readManifest(controlUiDir) {
+    const filepath = join(controlUiDir, MANIFEST_FILENAME);
+    if (!existsSync(filepath)) {
+        return null;
+    }
+    try {
+        const raw = readFileSync(filepath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        logger.warn(`[ui-ext] Failed to parse manifest: ${err.message}`);
+        return null;
+    }
+}
+/**
+ * 写入清单文件。
+ */
+export function writeManifest(controlUiDir, data) {
+    const filepath = join(controlUiDir, MANIFEST_FILENAME);
+    writeFileSync(filepath, JSON.stringify(data, null, 2), 'utf-8');
+    logger.debug('[ui-ext] Manifest written');
+}
+/**
+ * 删除清单文件。
+ */
+export function removeManifest(controlUiDir) {
+    const filepath = join(controlUiDir, MANIFEST_FILENAME);
+    if (existsSync(filepath)) {
+        unlinkSync(filepath);
+        logger.debug('[ui-ext] Manifest removed');
+    }
+}

package/dist/src/plugin-ui/ui-extension-loader/registry-regex.d.ts

@@ -0,0 +1,9 @@
+/**
+ * UIExtension 注册表 — 正则模式链方案（无需 source map）
+ *
+ * 用正则锚点定位注入位置，无需 source map。
+ *
+ * 验证来源：full-inject.mjs — 21 版本 × 6 扩展点，acorn 语法 100% 合法。
+ */
+import type { UIExtension } from './types.js';
+export declare const UI_EXTENSIONS: UIExtension[];