From 68c77bb55d8f4d4ed8eb0b57e0d869b00525b174 Mon Sep 17 00:00:00 2001
From: Jamil Zakirov <jamil@zakirov.com>
Date: Wed, 13 May 2026 09:11:50 +0000
Subject: [PATCH] feat(plugin-sdk): export plugin hook types

Add `openclaw/plugin-sdk/types` entrypoint that re-exports plugin hook
types, so external plugins can import typed hook interfaces without
reaching into internal paths.

Also export `resolveActiveEmbeddedRunSessionId` from
`agent-harness-runtime` for session resolution in embedded runs.
---
 package.json                            | 4 ++++
 scripts/lib/plugin-sdk-entrypoints.json | 1 +
 src/plugin-sdk/agent-harness-runtime.ts | 8 +++++++-
 src/plugin-sdk/types.ts                 | 1 +
 4 files changed, 13 insertions(+), 1 deletion(-)
 create mode 100644 src/plugin-sdk/types.ts

diff --git a/package.json b/package.json
index 3e1c3318607..99dc15ecb08 100644
--- a/package.json
+++ b/package.json
@@ -499,6 +499,10 @@
       "types": "./dist/plugin-sdk/host-runtime.d.ts",
       "default": "./dist/plugin-sdk/host-runtime.js"
     },
+    "./plugin-sdk/types": {
+      "types": "./dist/plugin-sdk/types.d.ts",
+      "default": "./dist/plugin-sdk/types.js"
+    },
     "./plugin-sdk/process-runtime": {
       "types": "./dist/plugin-sdk/process-runtime.d.ts",
       "default": "./dist/plugin-sdk/process-runtime.js"
diff --git a/scripts/lib/plugin-sdk-entrypoints.json b/scripts/lib/plugin-sdk-entrypoints.json
index 1e433915d52..7ae9cc5be66 100644
--- a/scripts/lib/plugin-sdk-entrypoints.json
+++ b/scripts/lib/plugin-sdk-entrypoints.json
@@ -101,6 +101,7 @@
   "agent-harness-runtime",
   "hook-runtime",
   "host-runtime",
+  "types",
   "process-runtime",
   "windows-spawn",
   "acp-runtime",
diff --git a/src/plugin-sdk/agent-harness-runtime.ts b/src/plugin-sdk/agent-harness-runtime.ts
index 99f84e92c29..d905d110f68 100644
--- a/src/plugin-sdk/agent-harness-runtime.ts
+++ b/src/plugin-sdk/agent-harness-runtime.ts
@@ -7,6 +7,7 @@ import {
   abortEmbeddedPiRun,
   clearActiveEmbeddedRun,
   queueEmbeddedPiMessageWithOutcome,
+  resolveActiveEmbeddedRunSessionId,
   setActiveEmbeddedRun,
   type EmbeddedPiQueueMessageOptions,
 } from "../agents/pi-embedded-runner/runs.js";
@@ -105,7 +106,12 @@ export { resolveModelAuthMode } from "../agents/model-auth.js";
 export { supportsModelTools } from "../agents/model-tool-support.js";
 export { resolveAttemptSpawnWorkspaceDir } from "../agents/pi-embedded-runner/run/attempt.thread-helpers.js";
 export { buildEmbeddedAttemptToolRunContext } from "../agents/pi-embedded-runner/run/attempt.tool-run-context.js";
-export { abortEmbeddedPiRun as abortAgentHarnessRun, clearActiveEmbeddedRun, setActiveEmbeddedRun };
+export {
+  abortEmbeddedPiRun as abortAgentHarnessRun,
+  clearActiveEmbeddedRun,
+  resolveActiveEmbeddedRunSessionId,
+  setActiveEmbeddedRun,
+};
 
 /**
  * @deprecated Active-run queueing is an internal runtime concern. Use current
diff --git a/src/plugin-sdk/types.ts b/src/plugin-sdk/types.ts
new file mode 100644
index 00000000000..3d0f25cabc8
--- /dev/null
+++ b/src/plugin-sdk/types.ts
@@ -0,0 +1 @@
+export * from "../plugins/types.js";