From 4b500184067704d9c3c1ffb1eed8eb4f1e7f1584 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Mon, 2 Mar 2026 19:54:47 +0000
Subject: [PATCH] fix: restore helper imports and plugin hook test exports

---
 src/agents/tools/image-tool.ts    |  3 ++-
 src/agents/tools/pdf-tool.ts      |  3 ++-
 src/plugins/hooks.test-helpers.ts | 25 +++++++++++++++++++++++++
 3 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/src/agents/tools/image-tool.ts b/src/agents/tools/image-tool.ts
index 22c442f5dcb..5a4f56b8d90 100644
--- a/src/agents/tools/image-tool.ts
+++ b/src/agents/tools/image-tool.ts
@@ -2,7 +2,7 @@ import { type Context, complete } from "@mariozechner/pi-ai";
 import { Type } from "@sinclair/typebox";
 import type { OpenClawConfig } from "../../config/config.js";
 import { resolveUserPath } from "../../utils.js";
-import { loadWebMedia } from "../../web/media.js";
+import { getDefaultLocalRoots, loadWebMedia } from "../../web/media.js";
 import { minimaxUnderstandImage } from "../minimax-vlm.js";
 import {
   coerceImageAssistantText,
@@ -24,6 +24,7 @@ import {
   discoverAuthStorage,
   discoverModels,
   ensureOpenClawModelsJson,
+  normalizeWorkspaceDir,
   resolveSandboxedBridgeMediaPath,
   runWithImageModelFallback,
   type AnyAgentTool,
diff --git a/src/agents/tools/pdf-tool.ts b/src/agents/tools/pdf-tool.ts
index f6dc40b276a..3755c6faa77 100644
--- a/src/agents/tools/pdf-tool.ts
+++ b/src/agents/tools/pdf-tool.ts
@@ -3,7 +3,7 @@ import { Type } from "@sinclair/typebox";
 import type { OpenClawConfig } from "../../config/config.js";
 import { extractPdfContent, type PdfExtractedContent } from "../../media/pdf-extract.js";
 import { resolveUserPath } from "../../utils.js";
-import { loadWebMediaRaw } from "../../web/media.js";
+import { getDefaultLocalRoots, loadWebMediaRaw } from "../../web/media.js";
 import {
   coerceImageModelConfig,
   type ImageModelConfig,
@@ -30,6 +30,7 @@ import {
   discoverAuthStorage,
   discoverModels,
   ensureOpenClawModelsJson,
+  normalizeWorkspaceDir,
   resolveSandboxedBridgeMediaPath,
   runWithImageModelFallback,
   type AnyAgentTool,
diff --git a/src/plugins/hooks.test-helpers.ts b/src/plugins/hooks.test-helpers.ts
index e0d7c6b6f58..8b7076239c2 100644
--- a/src/plugins/hooks.test-helpers.ts
+++ b/src/plugins/hooks.test-helpers.ts
@@ -1,4 +1,5 @@
 import type { PluginRegistry } from "./registry.js";
+import type { PluginHookAgentContext, PluginHookRegistration } from "./types.js";
 
 export function createMockPluginRegistry(
   hooks: Array<{ hookName: string; handler: (...args: unknown[]) => unknown }>,
@@ -22,3 +23,27 @@ export function createMockPluginRegistry(
     commands: [],
   } as unknown as PluginRegistry;
 }
+
+export const TEST_PLUGIN_AGENT_CTX: PluginHookAgentContext = {
+  agentId: "test-agent",
+  sessionKey: "test-session",
+  sessionId: "test-session-id",
+  workspaceDir: "/tmp/openclaw-test",
+  messageProvider: "test",
+};
+
+export function addTestHook(params: {
+  registry: PluginRegistry;
+  pluginId: string;
+  hookName: PluginHookRegistration["hookName"];
+  handler: PluginHookRegistration["handler"];
+  priority?: number;
+}) {
+  params.registry.typedHooks.push({
+    pluginId: params.pluginId,
+    hookName: params.hookName,
+    handler: params.handler,
+    priority: params.priority ?? 0,
+    source: "test",
+  } as PluginHookRegistration);
+}