fix(ci): resolve boundary and schema snapshot failures from Hyprland PR

Angfr95 · Angfr95 · commit e30d5bd68f5f · 2026-04-30T06:28:38.000+02:00
Add focused openclaw/plugin-sdk/resolve-system-bin subpath so bundled
extensions avoid importing the broad infra-runtime barrel flagged by
the newer boundary check. Regenerate schema snapshot with title and
description for hyprlandCapture so the config snapshot test stays green.
diff --git a/extensions/browser/src/browser/hyprland-capture.test.ts b/extensions/browser/src/browser/hyprland-capture.test.ts
@@ -35,7 +35,7 @@ vi.mock("node:child_process", () => {
   };
 });
 
-vi.mock("openclaw/plugin-sdk/infra-runtime", () => ({
+vi.mock("openclaw/plugin-sdk/resolve-system-bin", () => ({
   resolveSystemBin: mockResolveSystemBin,
 }));
 
diff --git a/extensions/browser/src/browser/hyprland-capture.ts b/extensions/browser/src/browser/hyprland-capture.ts
@@ -1,6 +1,6 @@
 import { execFile, execFileSync, spawn } from "node:child_process";
 import { promisify } from "node:util";
-import { resolveSystemBin } from "openclaw/plugin-sdk/infra-runtime";
+import { resolveSystemBin } from "openclaw/plugin-sdk/resolve-system-bin";
 
 const execFileAsync = promisify(execFile);
 
diff --git a/package.json b/package.json
@@ -326,6 +326,10 @@
       "types": "./dist/plugin-sdk/infra-runtime.d.ts",
       "default": "./dist/plugin-sdk/infra-runtime.js"
     },
+    "./plugin-sdk/resolve-system-bin": {
+      "types": "./dist/plugin-sdk/resolve-system-bin.d.ts",
+      "default": "./dist/plugin-sdk/resolve-system-bin.js"
+    },
     "./plugin-sdk/runtime-config-snapshot": {
       "types": "./dist/plugin-sdk/runtime-config-snapshot.d.ts",
       "default": "./dist/plugin-sdk/runtime-config-snapshot.js"
diff --git a/scripts/lib/plugin-sdk-entrypoints.json b/scripts/lib/plugin-sdk-entrypoints.json
@@ -64,6 +64,7 @@
   "system-event-runtime",
   "transport-ready-runtime",
   "infra-runtime",
+  "resolve-system-bin",
   "runtime-config-snapshot",
   "runtime-group-policy",
   "model-session-runtime",
diff --git a/src/config/schema.base.generated.ts b/src/config/schema.base.generated.ts
@@ -911,6 +911,9 @@ export const GENERATED_BASE_CONFIG_SCHEMA: BaseConfigSchemaResponse = {
               "Best-effort cleanup policy for browser tabs opened by primary-agent sessions. Keep enabled to avoid stale sandbox or managed-browser tabs accumulating across long-lived gateways.",
           },
           hyprlandCapture: {
+            title: "Hyprland Viewport Capture",
+            description:
+              "Enables a Hyprland/Wayland fallback for viewport screenshots using grim and a virtual hyprctl output. Only activates when HYPRLAND_INSTANCE_SIGNATURE is set and the browser profile is not headless. Requires grim and hyprctl to be installed.",
             type: "boolean",
           },
         },
diff --git a/src/config/zod-schema.ts b/src/config/zod-schema.ts
@@ -472,7 +472,13 @@ export const OpenClawSchema = z
           })
           .strict()
           .optional(),
-        hyprlandCapture: z.boolean().optional(),
+        hyprlandCapture: z
+          .boolean()
+          .optional()
+          .meta({ title: "Hyprland Viewport Capture" })
+          .describe(
+            "Enables a Hyprland/Wayland fallback for viewport screenshots using grim and a virtual hyprctl output. Only activates when HYPRLAND_INSTANCE_SIGNATURE is set and the browser profile is not headless. Requires grim and hyprctl to be installed.",
+          ),
       })
       .strict()
       .optional(),
diff --git a/src/plugin-sdk/infra-runtime.ts b/src/plugin-sdk/infra-runtime.ts
@@ -64,4 +64,3 @@ export * from "../utils/fetch-timeout.js";
 export * from "../utils/run-with-concurrency.js";
 export { createRuntimeOutboundDelegates } from "../channels/plugins/runtime-forwarders.js";
 export * from "./ssrf-policy.js";
-export { resolveSystemBin, type SystemBinTrust } from "../infra/resolve-system-bin.js";
diff --git a/src/plugin-sdk/resolve-system-bin.ts b/src/plugin-sdk/resolve-system-bin.ts
@@ -0,0 +1 @@
+export { resolveSystemBin, type SystemBinTrust } from "../infra/resolve-system-bin.js";

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+export { resolveSystemBin, type SystemBinTrust } from "../infra/resolve-system-bin.js";`