feat(FN-2477): add executable OpenClaw runtime adapter

- Replace deferred OpenClaw placeholder runtime with an executable adapter that creates sessions, prompts with fallback, describes models, and disposes safely - Add a dedicated pi-module seam and local runtime contract types to decouple plugin compilation from engine internals while preserving runtime behavior - Update OpenClaw plugin metadata, manifest/package descriptions, and README to reflect active execution support instead of deferred status - Harden dashboard DevServerStore save flow against ENOENT temp-directory races and add regression coverage for project-directory removal during save
2026-04-24 10:55:28 -07:00
parent ab1e67452a
commit e27d31bd47
18 changed files with 391 additions and 125 deletions
--- a/plugins/fusion-plugin-openclaw-runtime/README.md
+++ b/plugins/fusion-plugin-openclaw-runtime/README.md
@@ -1,12 +1,16 @@
 # OpenClaw Runtime Plugin

-> **Status:** Experimental placeholder - runtime execution deferred
-
-Provides an OpenClaw runtime plugin for Fusion. This package enables runtime registration and discovery so agents can be configured with `runtimeConfig.runtimeHint: "openclaw"`.
+Provides an executable OpenClaw runtime plugin for Fusion. This package enables runtime registration, discovery, and session execution so agents configured with `runtimeConfig.runtimeHint: "openclaw"` can run through the standard runtime adapter contract.

 ## Overview

-This plugin mirrors the Hermes runtime plugin pattern: runtime registration succeeds and can be discovered by Fusion's runtime resolver, while execution behavior is intentionally deferred.
+This plugin follows the runtime adapter pattern used by other executable plugin runtimes:
+
+- Registers OpenClaw runtime metadata for resolver discovery
+- Creates executable runtime sessions via `createFnAgent`
+- Delegates prompt execution through `promptWithFallback`
+- Exposes model descriptions through `describeModel`
+- Supports best-effort session disposal via `dispose()`

 ## Installation

@@ -22,15 +26,6 @@ cp -r fusion-plugin-openclaw-runtime ~/.fusion/plugins/
 fn plugin add ./plugins/fusion-plugin-openclaw-runtime
 ```

-## Current Status
-
-| Component | Status |
-|-----------|--------|
-| Plugin Scaffold | ✅ Complete |
-| Runtime Registration | ✅ Complete |
-| Runtime Discovery | ✅ Complete |
-| Runtime Execution | ⏳ Deferred placeholder |
-
 ## Runtime Metadata

 - **Plugin ID:** `fusion-plugin-openclaw-runtime`
@@ -38,7 +33,7 @@ fn plugin add ./plugins/fusion-plugin-openclaw-runtime
 - **Runtime ID:** `openclaw`
 - **Runtime name:** `OpenClaw Runtime`
 - **Version:** `0.1.0`
- **Description:** Experimental OpenClaw runtime integration for Fusion tasks (execution deferred)
+- **Description:** OpenClaw-backed AI session using the user's configured pi provider and model

 ## Agent Configuration

@@ -54,16 +49,6 @@ Configure an agent to target OpenClaw via `runtimeConfig.runtimeHint`:
 }
 ```

-## Placeholder Runtime Behavior
-
-The runtime factory currently returns a deferred placeholder object:
-
- Runtime registration and lookup are supported
- Runtime factory invocation succeeds
- `execute()` intentionally throws a descriptive not-implemented/deferred error
-
-This prevents silent misbehavior while making runtime configuration and compatibility tests possible.
-
 ## Local Development

 ```bash
--- a/plugins/fusion-plugin-openclaw-runtime/dist/tests/index.test.js
+++ b/plugins/fusion-plugin-openclaw-runtime/dist/tests/index.test.js
@@ -1,5 +1,16 @@
 import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+const { mockCreateFnAgent, mockPromptWithFallback, mockDescribeModel } = vi.hoisted(() => ({
+    mockCreateFnAgent: vi.fn(),
+    mockPromptWithFallback: vi.fn(),
+    mockDescribeModel: vi.fn().mockReturnValue("unknown model"),
+}));
+vi.mock("../pi-module.js", () => ({
+    createFnAgent: mockCreateFnAgent,
+    promptWithFallback: mockPromptWithFallback,
+    describeModel: mockDescribeModel,
+}));
 import plugin, { openclawRuntimeMetadata, openclawRuntimeFactory, OPENCLAW_RUNTIME_ID } from "../index.js";
+import { OpenClawRuntimeAdapter } from "../runtime-adapter.js";
 function createMockContext(overrides = {}) {
    return {
        pluginId: "fusion-plugin-openclaw-runtime",
@@ -39,7 +50,7 @@ describe("openclaw-runtime plugin", () => {
            expect(plugin.runtime).toBeDefined();
            expect(plugin.runtime?.metadata.runtimeId).toBe(OPENCLAW_RUNTIME_ID);
            expect(plugin.runtime?.metadata.name).toBe("OpenClaw Runtime");
-            expect(plugin.runtime?.metadata.description).toContain("execution deferred");
+            expect(plugin.runtime?.metadata.description).toContain("OpenClaw-backed AI session");
            expect(plugin.runtime?.metadata.version).toBe("0.1.0");
        });
        it("should have consistent runtime metadata between export and manifest", () => {
@@ -51,41 +62,32 @@ describe("openclaw-runtime plugin", () => {
        it("onLoad should log startup message and emit loaded event", async () => {
            const ctx = createMockContext();
            await plugin.hooks.onLoad?.(ctx);
-            expect(ctx.logger.info).toHaveBeenCalledWith(expect.stringContaining("OpenClaw Runtime Plugin loaded"));
+            expect(ctx.logger.info).toHaveBeenCalledWith("OpenClaw Runtime Plugin loaded");
            expect(ctx.emitEvent).toHaveBeenCalledWith("openclaw-runtime:loaded", {
                runtimeId: OPENCLAW_RUNTIME_ID,
                version: "0.1.0",
-                status: "deferred",
            });
        });
        it("onUnload should not throw", () => {
            expect(() => plugin.hooks.onUnload?.()).not.toThrow();
        });
    });
-    describe("deferred runtime behavior", () => {
+    describe("runtime factory behavior", () => {
        it("should export runtime constants", () => {
            expect(OPENCLAW_RUNTIME_ID).toBe("openclaw");
            expect(openclawRuntimeMetadata.runtimeId).toBe("openclaw");
            expect(typeof openclawRuntimeFactory).toBe("function");
        });
-        it("runtime factory should return placeholder runtime shape", () => {
-            const runtime = openclawRuntimeFactory(createMockContext());
-            expect(runtime).toMatchObject({
-                runtimeId: "openclaw",
-                version: "0.1.0",
-                status: "deferred",
-            });
-            expect(runtime).toHaveProperty("message");
-            expect(String(runtime.message)).toContain("discovery and configuration only");
-            expect(String(runtime.message)).not.toContain("FN-");
+        it("runtime factory should return executable runtime adapter", async () => {
+            const runtime = (await openclawRuntimeFactory(createMockContext()));
+            expect(runtime).toBeInstanceOf(OpenClawRuntimeAdapter);
+            expect(runtime.id).toBe("openclaw");
+            expect(runtime.name).toBe("OpenClaw Runtime");
+            expect(runtime).not.toHaveProperty("status");
+            expect(runtime).not.toHaveProperty("execute");
        });
-        it("runtime execute should reject with deferred/not-implemented error", async () => {
-            const runtime = openclawRuntimeFactory(createMockContext());
-            await expect(runtime.execute()).rejects.toThrow("not implemented");
-            await expect(runtime.execute()).rejects.toThrow("deferred");
-        });
-        it("factory creation should not throw", () => {
-            expect(() => openclawRuntimeFactory(createMockContext())).not.toThrow();
+        it("factory creation should not throw", async () => {
+            await expect(openclawRuntimeFactory(createMockContext())).resolves.toBeInstanceOf(OpenClawRuntimeAdapter);
        });
    });
 });
--- a/plugins/fusion-plugin-openclaw-runtime/dist/tests/index.test.js.map
+++ b/plugins/fusion-plugin-openclaw-runtime/dist/tests/index.test.js.map
@@ -1 +1 @@
-{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../src/__tests__/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,MAAM,EAAE,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAmB3G,SAAS,iBAAiB,CAAC,YAAkC,EAAE;IAC7D,OAAO;QACL,QAAQ,EAAE,gCAAgC;QAC1C,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE;YACN,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;YACb,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;YACb,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;YACd,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;SACf;QACD,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE;QAClB,SAAS,EAAE;YACT,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;SACjB;QACD,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACxC,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;YAClE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;YAC7D,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YAC1D,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YACrE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC/D,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;YAC7E,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;YAC7E,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;YACjE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;QACrB,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;YACvE,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;YAChC,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAU,CAAC,CAAC;YAExC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAC1C,MAAM,CAAC,gBAAgB,CAAC,gCAAgC,CAAC,CAC1D,CAAC;YACF,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,yBAAyB,EAAE;gBACpE,SAAS,EAAE,mBAAmB;gBAC9B,OAAO,EAAE,OAAO;gBAChB,MAAM,EAAE,UAAU;aACnB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;YACnC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACzC,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC7C,MAAM,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC3D,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;YACjE,MAAM,OAAO,GAAG,sBAAsB,CAAC,iBAAiB,EAAS,CAA4B,CAAC;YAE9F,MAAM,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC;gBAC5B,SAAS,EAAE,UAAU;gBACrB,OAAO,EAAE,OAAO;gBAChB,MAAM,EAAE,UAAU;aACnB,CAAC,CAAC;YACH,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAC;YAC9E,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;YACjF,MAAM,OAAO,GAAG,sBAAsB,CAAC,iBAAiB,EAAS,CAAsC,CAAC;YACxG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;YACnE,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,MAAM,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,iBAAiB,EAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../src/__tests__/index.test.ts"],"names":[],"mappings":"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"}
--- a/plugins/fusion-plugin-openclaw-runtime/dist/index.d.ts
+++ b/plugins/fusion-plugin-openclaw-runtime/dist/index.d.ts
@@ -1,8 +1,8 @@
 /**
 * OpenClaw Runtime Plugin
 *
- * Registers an experimental OpenClaw runtime with Fusion's plugin runtime
- * discovery pipeline. Runtime execution behavior is intentionally deferred.
+ * Provides an executable OpenClaw runtime adapter for Fusion's plugin runtime
+ * discovery and session execution pipeline.
 */
 import type { FusionPlugin, PluginRuntimeFactory, PluginRuntimeManifestMetadata } from "@fusion/plugin-sdk";
 declare const OPENCLAW_RUNTIME_ID = "openclaw";
--- a/plugins/fusion-plugin-openclaw-runtime/dist/index.d.ts.map
+++ b/plugins/fusion-plugin-openclaw-runtime/dist/index.d.ts.map
@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,YAAY,EAEZ,oBAAoB,EACpB,6BAA6B,EAC9B,MAAM,oBAAoB,CAAC;AAE5B,QAAA,MAAM,mBAAmB,aAAa,CAAC;AAGvC,QAAA,MAAM,uBAAuB,EAAE,6BAK9B,CAAC;AAEF,QAAA,MAAM,sBAAsB,EAAE,oBAa7B,CAAC;AAEF,QAAA,MAAM,MAAM,EAAE,YA4BZ,CAAC;AAEH,eAAe,MAAM,CAAC;AAEtB,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,6BAA6B,EAC9B,MAAM,oBAAoB,CAAC;AAE5B,QAAA,MAAM,mBAAmB,aAAa,CAAC;AAGvC,QAAA,MAAM,uBAAuB,EAAE,6BAK9B,CAAC;AAEF,QAAA,MAAM,sBAAsB,EAAE,oBAE7B,CAAC;AAEF,QAAA,MAAM,MAAM,EAAE,YA2BZ,CAAC;AAEH,eAAe,MAAM,CAAC;AAEtB,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,CAAC"}
--- a/plugins/fusion-plugin-openclaw-runtime/dist/index.js
+++ b/plugins/fusion-plugin-openclaw-runtime/dist/index.js
@@ -1,35 +1,28 @@
 /**
 * OpenClaw Runtime Plugin
 *
- * Registers an experimental OpenClaw runtime with Fusion's plugin runtime
- * discovery pipeline. Runtime execution behavior is intentionally deferred.
+ * Provides an executable OpenClaw runtime adapter for Fusion's plugin runtime
+ * discovery and session execution pipeline.
 */
 import { definePlugin } from "@fusion/plugin-sdk";
+import { OpenClawRuntimeAdapter } from "./runtime-adapter.js";
 const OPENCLAW_RUNTIME_ID = "openclaw";
 const OPENCLAW_RUNTIME_VERSION = "0.1.0";
 const openclawRuntimeMetadata = {
    runtimeId: OPENCLAW_RUNTIME_ID,
    name: "OpenClaw Runtime",
-    description: "Experimental OpenClaw runtime integration for Fusion tasks (execution deferred)",
+    description: "OpenClaw-backed AI session using the user's configured pi provider and model",
    version: OPENCLAW_RUNTIME_VERSION,
 };
-const openclawRuntimeFactory = (_ctx) => {
-    return {
-        runtimeId: OPENCLAW_RUNTIME_ID,
-        version: OPENCLAW_RUNTIME_VERSION,
-        status: "deferred",
-        message: "OpenClaw runtime execution is currently deferred. This runtime is registered for discovery and configuration only.",
-        execute: async () => {
-            throw new Error("OpenClaw runtime is not implemented yet. Runtime discovery and configuration are supported, but execution is deferred.");
-        },
-    };
+const openclawRuntimeFactory = async () => {
+    return new OpenClawRuntimeAdapter();
 };
 const plugin = definePlugin({
    manifest: {
        id: "fusion-plugin-openclaw-runtime",
        name: "OpenClaw Runtime Plugin",
        version: "0.1.0",
-        description: "OpenClaw runtime plugin for Fusion with experimental deferred execution",
+        description: "Provides OpenClaw runtime for Fusion AI agents",
        author: "Fusion Team",
        homepage: "https://github.com/gsxdsm/fusion",
        runtime: openclawRuntimeMetadata,
@@ -37,11 +30,10 @@ const plugin = definePlugin({
    state: "installed",
    hooks: {
        onLoad: (ctx) => {
-            ctx.logger.info("OpenClaw Runtime Plugin loaded (experimental placeholder runtime)");
+            ctx.logger.info("OpenClaw Runtime Plugin loaded");
            ctx.emitEvent("openclaw-runtime:loaded", {
                runtimeId: OPENCLAW_RUNTIME_ID,
                version: OPENCLAW_RUNTIME_VERSION,
-                status: "deferred",
            });
        },
        onUnload: () => {
--- a/plugins/fusion-plugin-openclaw-runtime/dist/index.js.map
+++ b/plugins/fusion-plugin-openclaw-runtime/dist/index.js.map
@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQlD,MAAM,mBAAmB,GAAG,UAAU,CAAC;AACvC,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAEzC,MAAM,uBAAuB,GAAkC;IAC7D,SAAS,EAAE,mBAAmB;IAC9B,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,iFAAiF;IAC9F,OAAO,EAAE,wBAAwB;CAClC,CAAC;AAEF,MAAM,sBAAsB,GAAyB,CAAC,IAAmB,EAAE,EAAE;IAC3E,OAAO;QACL,SAAS,EAAE,mBAAmB;QAC9B,OAAO,EAAE,wBAAwB;QACjC,MAAM,EAAE,UAAU;QAClB,OAAO,EACL,oHAAoH;QACtH,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,IAAI,KAAK,CACb,wHAAwH,CACzH,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,MAAM,GAAiB,YAAY,CAAC;IACxC,QAAQ,EAAE;QACR,EAAE,EAAE,gCAAgC;QACpC,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,yEAAyE;QACtF,MAAM,EAAE,aAAa;QACrB,QAAQ,EAAE,kCAAkC;QAC5C,OAAO,EAAE,uBAAuB;KACjC;IACD,KAAK,EAAE,WAAW;IAClB,KAAK,EAAE;QACL,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;YACd,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;YACrF,GAAG,CAAC,SAAS,CAAC,yBAAyB,EAAE;gBACvC,SAAS,EAAE,mBAAmB;gBAC9B,OAAO,EAAE,wBAAwB;gBACjC,MAAM,EAAE,UAAU;aACnB,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE;YACb,qCAAqC;QACvC,CAAC;KACF;IACD,OAAO,EAAE;QACP,QAAQ,EAAE,uBAAuB;QACjC,OAAO,EAAE,sBAAsB;KAChC;CACF,CAAC,CAAC;AAEH,eAAe,MAAM,CAAC;AAEtB,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAO9D,MAAM,mBAAmB,GAAG,UAAU,CAAC;AACvC,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAEzC,MAAM,uBAAuB,GAAkC;IAC7D,SAAS,EAAE,mBAAmB;IAC9B,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,8EAA8E;IAC3F,OAAO,EAAE,wBAAwB;CAClC,CAAC;AAEF,MAAM,sBAAsB,GAAyB,KAAK,IAAI,EAAE;IAC9D,OAAO,IAAI,sBAAsB,EAAE,CAAC;AACtC,CAAC,CAAC;AAEF,MAAM,MAAM,GAAiB,YAAY,CAAC;IACxC,QAAQ,EAAE;QACR,EAAE,EAAE,gCAAgC;QACpC,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,gDAAgD;QAC7D,MAAM,EAAE,aAAa;QACrB,QAAQ,EAAE,kCAAkC;QAC5C,OAAO,EAAE,uBAAuB;KACjC;IACD,KAAK,EAAE,WAAW;IAClB,KAAK,EAAE;QACL,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;YACd,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;YAClD,GAAG,CAAC,SAAS,CAAC,yBAAyB,EAAE;gBACvC,SAAS,EAAE,mBAAmB;gBAC9B,OAAO,EAAE,wBAAwB;aAClC,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE;YACb,qCAAqC;QACvC,CAAC;KACF;IACD,OAAO,EAAE;QACP,QAAQ,EAAE,uBAAuB;QACjC,OAAO,EAAE,sBAAsB;KAChC;CACF,CAAC,CAAC;AAEH,eAAe,MAAM,CAAC;AAEtB,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,CAAC"}
--- a/plugins/fusion-plugin-openclaw-runtime/manifest.json
+++ b/plugins/fusion-plugin-openclaw-runtime/manifest.json
@@ -2,13 +2,13 @@
  "id": "fusion-plugin-openclaw-runtime",
  "name": "OpenClaw Runtime Plugin",
  "version": "0.1.0",
-  "description": "OpenClaw runtime plugin for Fusion with experimental deferred execution",
+  "description": "Provides OpenClaw runtime for Fusion AI agents",
  "author": "Fusion Team",
  "homepage": "https://github.com/gsxdsm/fusion",
  "runtime": {
    "runtimeId": "openclaw",
    "name": "OpenClaw Runtime",
-    "description": "Experimental OpenClaw runtime integration for Fusion tasks (execution deferred)",
+    "description": "OpenClaw-backed AI session using the user's configured pi provider and model",
    "version": "0.1.0"
  }
 }
--- a/plugins/fusion-plugin-openclaw-runtime/package.json
+++ b/plugins/fusion-plugin-openclaw-runtime/package.json
@@ -2,7 +2,7 @@
  "name": "@fusion-plugin-examples/openclaw-runtime",
  "version": "0.1.0",
  "type": "module",
-  "description": "OpenClaw runtime plugin for Fusion - experimental placeholder runtime registration",
+  "description": "Provides OpenClaw runtime for Fusion AI agents",
  "keywords": [
    "fusion-plugin",
    "openclaw",
--- a/plugins/fusion-plugin-openclaw-runtime/src/tests/index.test.ts
+++ b/plugins/fusion-plugin-openclaw-runtime/src/tests/index.test.ts
@@ -1,5 +1,19 @@
 import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+
+const { mockCreateFnAgent, mockPromptWithFallback, mockDescribeModel } = vi.hoisted(() => ({
+  mockCreateFnAgent: vi.fn(),
+  mockPromptWithFallback: vi.fn(),
+  mockDescribeModel: vi.fn().mockReturnValue("unknown model"),
+}));
+
+vi.mock("../pi-module.js", () => ({
+  createFnAgent: mockCreateFnAgent,
+  promptWithFallback: mockPromptWithFallback,
+  describeModel: mockDescribeModel,
+}));
+
 import plugin, { openclawRuntimeMetadata, openclawRuntimeFactory, OPENCLAW_RUNTIME_ID } from "../index.js";
+import { OpenClawRuntimeAdapter } from "../runtime-adapter.js";

 interface MockLogger {
  info: ReturnType<typeof vi.fn>;
@@ -61,7 +75,7 @@ describe("openclaw-runtime plugin", () => {
      expect(plugin.runtime).toBeDefined();
      expect(plugin.runtime?.metadata.runtimeId).toBe(OPENCLAW_RUNTIME_ID);
      expect(plugin.runtime?.metadata.name).toBe("OpenClaw Runtime");
-      expect(plugin.runtime?.metadata.description).toContain("execution deferred");
+      expect(plugin.runtime?.metadata.description).toContain("OpenClaw-backed AI session");
      expect(plugin.runtime?.metadata.version).toBe("0.1.0");
    });

@@ -76,13 +90,10 @@ describe("openclaw-runtime plugin", () => {
      const ctx = createMockContext();
      await plugin.hooks.onLoad?.(ctx as any);

-      expect(ctx.logger.info).toHaveBeenCalledWith(
-        expect.stringContaining("OpenClaw Runtime Plugin loaded"),
-      );
+      expect(ctx.logger.info).toHaveBeenCalledWith("OpenClaw Runtime Plugin loaded");
      expect(ctx.emitEvent).toHaveBeenCalledWith("openclaw-runtime:loaded", {
        runtimeId: OPENCLAW_RUNTIME_ID,
        version: "0.1.0",
-        status: "deferred",
      });
    });

@@ -91,34 +102,27 @@ describe("openclaw-runtime plugin", () => {
    });
  });

-  describe("deferred runtime behavior", () => {
+  describe("runtime factory behavior", () => {
    it("should export runtime constants", () => {
      expect(OPENCLAW_RUNTIME_ID).toBe("openclaw");
      expect(openclawRuntimeMetadata.runtimeId).toBe("openclaw");
      expect(typeof openclawRuntimeFactory).toBe("function");
    });

-    it("runtime factory should return placeholder runtime shape", () => {
-      const runtime = openclawRuntimeFactory(createMockContext() as any) as Record<string, unknown>;
+    it("runtime factory should return executable runtime adapter", async () => {
+      const runtime = (await openclawRuntimeFactory(createMockContext() as any)) as OpenClawRuntimeAdapter;

-      expect(runtime).toMatchObject({
-        runtimeId: "openclaw",
-        version: "0.1.0",
-        status: "deferred",
-      });
-      expect(runtime).toHaveProperty("message");
-      expect(String(runtime.message)).toContain("discovery and configuration only");
-      expect(String(runtime.message)).not.toContain("FN-");
+      expect(runtime).toBeInstanceOf(OpenClawRuntimeAdapter);
+      expect(runtime.id).toBe("openclaw");
+      expect(runtime.name).toBe("OpenClaw Runtime");
+      expect(runtime).not.toHaveProperty("status");
+      expect(runtime).not.toHaveProperty("execute");
    });

-    it("runtime execute should reject with deferred/not-implemented error", async () => {
-      const runtime = openclawRuntimeFactory(createMockContext() as any) as { execute: () => Promise<never> };
-      await expect(runtime.execute()).rejects.toThrow("not implemented");
-      await expect(runtime.execute()).rejects.toThrow("deferred");
-    });
-
-    it("factory creation should not throw", () => {
-      expect(() => openclawRuntimeFactory(createMockContext() as any)).not.toThrow();
+    it("factory creation should not throw", async () => {
+      await expect(openclawRuntimeFactory(createMockContext() as any)).resolves.toBeInstanceOf(
+        OpenClawRuntimeAdapter,
+      );
    });
  });
 });
--- a/plugins/fusion-plugin-openclaw-runtime/src/tests/runtime-adapter.test.ts
+++ b/plugins/fusion-plugin-openclaw-runtime/src/tests/runtime-adapter.test.ts
@@ -0,0 +1,97 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { OpenClawRuntimeAdapter } from "../runtime-adapter.js";
+
+const { mockCreateFnAgent, mockPromptWithFallback, mockDescribeModel } = vi.hoisted(() => ({
+  mockCreateFnAgent: vi.fn(),
+  mockPromptWithFallback: vi.fn(),
+  mockDescribeModel: vi.fn(),
+}));
+
+vi.mock("../pi-module.js", () => ({
+  createFnAgent: mockCreateFnAgent,
+  promptWithFallback: mockPromptWithFallback,
+  describeModel: mockDescribeModel,
+}));
+
+describe("OpenClawRuntimeAdapter", () => {
+  let adapter: OpenClawRuntimeAdapter;
+
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mockDescribeModel.mockReturnValue("mock/anthropic-claude");
+    adapter = new OpenClawRuntimeAdapter();
+  });
+
+  afterEach(() => {
+    vi.restoreAllMocks();
+  });
+
+  it("has stable runtime identity", () => {
+    expect(adapter.id).toBe("openclaw");
+    expect(adapter.name).toBe("OpenClaw Runtime");
+  });
+
+  it("delegates createSession to createFnAgent with mapped options", async () => {
+    const mockSession = { dispose: vi.fn() };
+    mockCreateFnAgent.mockResolvedValue({ session: mockSession, sessionFile: "/tmp/session.json" });
+
+    const result = await adapter.createSession({
+      cwd: "/project",
+      systemPrompt: "You are helpful",
+      defaultProvider: "anthropic",
+      defaultModelId: "claude-sonnet-4-5",
+      fallbackProvider: "openai",
+      fallbackModelId: "gpt-4o",
+      skills: ["bash"],
+    });
+
+    expect(mockCreateFnAgent).toHaveBeenCalledWith({
+      cwd: "/project",
+      systemPrompt: "You are helpful",
+      tools: undefined,
+      customTools: undefined,
+      onText: undefined,
+      onThinking: undefined,
+      onToolStart: undefined,
+      onToolEnd: undefined,
+      defaultProvider: "anthropic",
+      defaultModelId: "claude-sonnet-4-5",
+      fallbackProvider: "openai",
+      fallbackModelId: "gpt-4o",
+      defaultThinkingLevel: undefined,
+      sessionManager: undefined,
+      skillSelection: undefined,
+      skills: ["bash"],
+    });
+    expect(result.session).toBe(mockSession);
+    expect(result.sessionFile).toBe("/tmp/session.json");
+  });
+
+  it("delegates promptWithFallback to pi seam", async () => {
+    const session = { id: "s-1" };
+    mockPromptWithFallback.mockResolvedValue(undefined);
+
+    await adapter.promptWithFallback(session as any, "Hello", { images: [] });
+
+    expect(mockPromptWithFallback).toHaveBeenCalledWith(session, "Hello", { images: [] });
+  });
+
+  it("delegates describeModel to pi seam", () => {
+    const session = { id: "s-2" };
+    mockDescribeModel.mockReturnValue("anthropic/claude-sonnet-4-5");
+
+    const result = adapter.describeModel(session as any);
+
+    expect(mockDescribeModel).toHaveBeenCalledWith(session);
+    expect(result).toBe("anthropic/claude-sonnet-4-5");
+  });
+
+  it("dispose calls session.dispose when present and no-ops otherwise", async () => {
+    const disposeMock = vi.fn().mockResolvedValue(undefined);
+
+    await adapter.dispose({ dispose: disposeMock });
+    await expect(adapter.dispose({ id: "no-dispose" } as any)).resolves.toBeUndefined();
+
+    expect(disposeMock).toHaveBeenCalledTimes(1);
+  });
+});
--- a/plugins/fusion-plugin-openclaw-runtime/src/index.ts
+++ b/plugins/fusion-plugin-openclaw-runtime/src/index.ts
@@ -1,14 +1,14 @@
 /**
 * OpenClaw Runtime Plugin
 *
- * Registers an experimental OpenClaw runtime with Fusion's plugin runtime
- * discovery pipeline. Runtime execution behavior is intentionally deferred.
+ * Provides an executable OpenClaw runtime adapter for Fusion's plugin runtime
+ * discovery and session execution pipeline.
 */

 import { definePlugin } from "@fusion/plugin-sdk";
+import { OpenClawRuntimeAdapter } from "./runtime-adapter.js";
 import type {
  FusionPlugin,
-  PluginContext,
  PluginRuntimeFactory,
  PluginRuntimeManifestMetadata,
 } from "@fusion/plugin-sdk";
@@ -19,23 +19,12 @@ const OPENCLAW_RUNTIME_VERSION = "0.1.0";
 const openclawRuntimeMetadata: PluginRuntimeManifestMetadata = {
  runtimeId: OPENCLAW_RUNTIME_ID,
  name: "OpenClaw Runtime",
-  description: "Experimental OpenClaw runtime integration for Fusion tasks (execution deferred)",
+  description: "OpenClaw-backed AI session using the user's configured pi provider and model",
  version: OPENCLAW_RUNTIME_VERSION,
 };

-const openclawRuntimeFactory: PluginRuntimeFactory = (_ctx: PluginContext) => {
-  return {
-    runtimeId: OPENCLAW_RUNTIME_ID,
-    version: OPENCLAW_RUNTIME_VERSION,
-    status: "deferred",
-    message:
-      "OpenClaw runtime execution is currently deferred. This runtime is registered for discovery and configuration only.",
-    execute: async () => {
-      throw new Error(
-        "OpenClaw runtime is not implemented yet. Runtime discovery and configuration are supported, but execution is deferred.",
-      );
-    },
-  };
+const openclawRuntimeFactory: PluginRuntimeFactory = async () => {
+  return new OpenClawRuntimeAdapter();
 };

 const plugin: FusionPlugin = definePlugin({
@@ -43,7 +32,7 @@ const plugin: FusionPlugin = definePlugin({
    id: "fusion-plugin-openclaw-runtime",
    name: "OpenClaw Runtime Plugin",
    version: "0.1.0",
-    description: "OpenClaw runtime plugin for Fusion with experimental deferred execution",
+    description: "Provides OpenClaw runtime for Fusion AI agents",
    author: "Fusion Team",
    homepage: "https://github.com/gsxdsm/fusion",
    runtime: openclawRuntimeMetadata,
@@ -51,11 +40,10 @@ const plugin: FusionPlugin = definePlugin({
  state: "installed",
  hooks: {
    onLoad: (ctx) => {
-      ctx.logger.info("OpenClaw Runtime Plugin loaded (experimental placeholder runtime)");
+      ctx.logger.info("OpenClaw Runtime Plugin loaded");
      ctx.emitEvent("openclaw-runtime:loaded", {
        runtimeId: OPENCLAW_RUNTIME_ID,
        version: OPENCLAW_RUNTIME_VERSION,
-        status: "deferred",
      });
    },
    onUnload: () => {
@@ -70,4 +58,4 @@ const plugin: FusionPlugin = definePlugin({

 export default plugin;

-export { openclawRuntimeMetadata, openclawRuntimeFactory, OPENCLAW_RUNTIME_ID };
+export { openclawRuntimeMetadata, openclawRuntimeFactory, OPENCLAW_RUNTIME_ID };
--- a/plugins/fusion-plugin-openclaw-runtime/src/pi-module.ts
+++ b/plugins/fusion-plugin-openclaw-runtime/src/pi-module.ts
@@ -0,0 +1,44 @@
+/**
+ * Pi Module Seam
+ *
+ * Provides a mockable import path for pi functions used by the OpenClawRuntimeAdapter.
+ */
+
+export interface PiAgentSession {
+  dispose?: () => Promise<void> | void;
+}
+
+export interface PiAgentResult {
+  session: PiAgentSession;
+  sessionFile?: string;
+}
+
+export interface PiAgentOptions {
+  cwd: string;
+  systemPrompt: string;
+  tools?: unknown;
+  customTools?: unknown;
+  onText?: (text: string) => void;
+  onThinking?: (text: string) => void;
+  onToolStart?: (toolName: string, args?: unknown) => void;
+  onToolEnd?: (toolName: string, result?: unknown) => void;
+  defaultProvider?: string;
+  defaultModelId?: string;
+  fallbackProvider?: string;
+  fallbackModelId?: string;
+  defaultThinkingLevel?: string;
+  sessionManager?: unknown;
+  skillSelection?: unknown;
+  skills?: string[];
+}
+
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const _piModule = require("../../../packages/engine/src/pi.js") as {
+  createFnAgent: (options: PiAgentOptions) => Promise<PiAgentResult>;
+  promptWithFallback: (session: PiAgentSession, prompt: string, options?: unknown) => Promise<void>;
+  describeModel: (session: PiAgentSession) => string;
+};
+
+export const createFnAgent = _piModule.createFnAgent;
+export const promptWithFallback = _piModule.promptWithFallback;
+export const describeModel = _piModule.describeModel;
--- a/plugins/fusion-plugin-openclaw-runtime/src/runtime-adapter.ts
+++ b/plugins/fusion-plugin-openclaw-runtime/src/runtime-adapter.ts
@@ -0,0 +1,49 @@
+import type {
+  AgentRuntime,
+  AgentRuntimeOptions,
+  AgentSession,
+  AgentSessionResult,
+} from "./types.js";
+import { createFnAgent, describeModel, promptWithFallback } from "./pi-module.js";
+
+const getModelDescription = describeModel;
+
+export class OpenClawRuntimeAdapter implements AgentRuntime {
+  readonly id = "openclaw";
+  readonly name = "OpenClaw Runtime";
+
+  async createSession(options: AgentRuntimeOptions): Promise<AgentSessionResult> {
+    return createFnAgent({
+      cwd: options.cwd,
+      systemPrompt: options.systemPrompt,
+      tools: options.tools,
+      customTools: options.customTools,
+      onText: options.onText,
+      onThinking: options.onThinking,
+      onToolStart: options.onToolStart,
+      onToolEnd: options.onToolEnd,
+      defaultProvider: options.defaultProvider,
+      defaultModelId: options.defaultModelId,
+      fallbackProvider: options.fallbackProvider,
+      fallbackModelId: options.fallbackModelId,
+      defaultThinkingLevel: options.defaultThinkingLevel,
+      sessionManager: options.sessionManager,
+      skillSelection: options.skillSelection,
+      skills: options.skills,
+    });
+  }
+
+  async promptWithFallback(session: AgentSession, prompt: string, options?: unknown): Promise<void> {
+    return promptWithFallback(session, prompt, options);
+  }
+
+  describeModel(session: AgentSession): string {
+    return getModelDescription(session);
+  }
+
+  async dispose(session: AgentSession): Promise<void> {
+    if (typeof (session as { dispose?: () => Promise<void> }).dispose === "function") {
+      await (session as { dispose: () => Promise<void> }).dispose();
+    }
+  }
+}
--- a/plugins/fusion-plugin-openclaw-runtime/src/types.ts
+++ b/plugins/fusion-plugin-openclaw-runtime/src/types.ts
@@ -0,0 +1,47 @@
+/**
+ * OpenClaw Runtime Plugin - Type Definitions
+ *
+ * The runtime contract is defined locally to avoid compile-time coupling to
+ * internal engine exports.
+ */
+
+/** Minimal session shape used by the runtime adapter. */
+export interface AgentSession {
+  dispose?: () => Promise<void> | void;
+}
+
+/** Options for creating an agent session. Mirrors createFnAgent inputs used by the adapter. */
+export interface AgentRuntimeOptions {
+  cwd: string;
+  systemPrompt: string;
+  tools?: unknown;
+  customTools?: unknown;
+  onText?: (text: string) => void;
+  onThinking?: (text: string) => void;
+  onToolStart?: (toolName: string, args?: unknown) => void;
+  onToolEnd?: (toolName: string, result?: unknown) => void;
+  defaultProvider?: string;
+  defaultModelId?: string;
+  fallbackProvider?: string;
+  fallbackModelId?: string;
+  defaultThinkingLevel?: string;
+  sessionManager?: unknown;
+  skillSelection?: unknown;
+  skills?: string[];
+}
+
+/** Result of creating a session. */
+export interface AgentSessionResult {
+  session: AgentSession;
+  sessionFile?: string;
+}
+
+/** Agent runtime adapter interface. */
+export interface AgentRuntime {
+  id: string;
+  name: string;
+  createSession(options: AgentRuntimeOptions): Promise<AgentSessionResult>;
+  promptWithFallback(session: AgentSession, prompt: string, options?: unknown): Promise<void>;
+  describeModel(session: AgentSession): string;
+  dispose?(session: AgentSession): Promise<void>;
+}