@openclawbrain/openclaw 0.3.4 → 0.3.6

package/dist/src/resolve-activation-root.js

@@ -13,6 +13,7 @@
 import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 import { describeOpenClawHomeInspection, discoverOpenClawHomes, formatOpenClawHomeLayout, inspectOpenClawHome } from "./openclaw-home-layout.js";
+import { findInstalledOpenClawBrainPlugin } from "./openclaw-plugin-install.js";
 function getHomeDir() {
     return process.env.HOME ?? process.env.USERPROFILE ?? "~";
 }
@@ -68,11 +69,13 @@ function extractActivationRootFromExtension(filePath) {
     }
 }
 function readActivationRootFromOpenClawHome(openclawHome) {
-    const extensionIndex = path.join(path.resolve(openclawHome), "extensions", "openclawbrain", "index.ts");
-    if (!existsSync(extensionIndex)) {
+    const installedPlugin = findInstalledOpenClawBrainPlugin(openclawHome);
+    if (installedPlugin.selectedInstall === null ||
+        installedPlugin.selectedInstall.loaderEntryPath === null ||
+        installedPlugin.selectedInstall.runtimeGuardPath === null) {
         return null;
     }
-    return extractActivationRootFromExtension(extensionIndex);
+    return extractActivationRootFromExtension(installedPlugin.selectedInstall.loaderEntryPath);
 }
 /**
  * Scan discoverable ~/.openclaw* directories for installed hooks and record
@@ -82,14 +85,16 @@ function scanInstalledProfileActivationRoots() {
     const probes = [];
     for (const inspection of discoverOpenClawHomes(path.resolve(getHomeDir()))) {
         const openclawHome = inspection.openclawHome;
-        const extensionIndex = path.join(openclawHome, "extensions", "openclawbrain", "index.ts");
-        if (!existsSync(extensionIndex)) {
+        const installedPlugin = findInstalledOpenClawBrainPlugin(openclawHome);
+        if (installedPlugin.selectedInstall === null ||
+            installedPlugin.selectedInstall.loaderEntryPath === null ||
+            installedPlugin.selectedInstall.runtimeGuardPath === null) {
             continue;
         }
-        const found = extractActivationRootFromExtension(extensionIndex);
+        const found = extractActivationRootFromExtension(installedPlugin.selectedInstall.loaderEntryPath);
         probes.push({
             openclawHome,
-            extensionIndex,
+            extensionEntryPath: installedPlugin.selectedInstall.loaderEntryPath,
             activationRoot: found.activationRoot,
             diagnostic: found.diagnostic,
             inspection
@@ -109,7 +114,7 @@ function buildUnpinnedResolutionRefusal(input) {
             details.push(`  - ${probe.openclawHome} [${inspectionSummary}] -> ${probe.activationRoot}`);
             continue;
         }
-        details.push(`  - ${probe.openclawHome} [${inspectionSummary}] -> unresolved: ${probe.diagnostic ?? `installed extension ${probe.extensionIndex} is unresolved`}`);
+        details.push(`  - ${probe.openclawHome} [${inspectionSummary}] -> unresolved: ${probe.diagnostic ?? `installed extension ${probe.extensionEntryPath} is unresolved`}`);
     }
     return [
         "Refusing to auto-select an activation root from unpinned host state.",
@@ -182,4 +187,4 @@ export function resolveActivationRoot(options = {}) {
     }
     throw new Error(`No brain found. ${buildInstallGuidance()}`);
 }
-//# sourceMappingURL=resolve-activation-root.js.map
+//# sourceMappingURL=resolve-activation-root.js.map

package/dist/src/shadow-extension-proof.d.ts

@@ -1,3 +1,4 @@
+import { type OpenClawBrainInstallLayout } from "./openclaw-plugin-install.js";
 export interface InstalledExtensionPackageJson {
     name?: unknown;
     version?: unknown;
@@ -19,6 +20,7 @@ export interface ShadowProfileExtensionInstall {
     openclawHome: string;
     extensionsDir: string;
     extensionDir: string;
+    installLayout: OpenClawBrainInstallLayout;
     manifestPath: string;
     packageJsonPath: string;
     loaderEntryPath: string;
@@ -26,6 +28,7 @@ export interface ShadowProfileExtensionInstall {
     manifest: InstalledPluginManifest;
     packageJson: InstalledExtensionPackageJson;
     configuredEntries: string[];
+    additionalInstalls: import("./openclaw-plugin-install.js").OpenClawBrainInstalledPlugin[];
 }
 export interface ShadowProfileExtensionLoadProof extends ShadowProfileExtensionInstall {
     runtimeGuardExportNames: string[];

package/dist/src/shadow-extension-proof.js

@@ -2,6 +2,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
+import { describeOpenClawBrainInstallLayout, findInstalledOpenClawBrainPlugin } from "./openclaw-plugin-install.js";
 const REQUIRED_RUNTIME_GUARD_EXPORTS = [
     "createBeforePromptBuildHandler",
     "isActivationRootPlaceholder",
@@ -10,26 +11,19 @@ const REQUIRED_RUNTIME_GUARD_EXPORTS = [
 ];
 export function inspectInstalledOpenClawBrainExtension(openclawHome, extensionId = "openclawbrain") {
     const resolvedOpenclawHome = path.resolve(openclawHome);
-    const extensionsDir = path.join(resolvedOpenclawHome, "extensions");
-    const extensionDir = path.join(extensionsDir, extensionId);
+    const installedPlugin = findInstalledOpenClawBrainPlugin(resolvedOpenclawHome, extensionId);
+    const extensionsDir = installedPlugin.extensionsDir;
     if (!existsSync(extensionsDir)) {
         throw new Error(`[shadow-extension-load-proof] OpenClaw extensions dir is missing: ${extensionsDir}`);
     }
-    if (!existsSync(extensionDir)) {
-        throw new Error(`[shadow-extension-load-proof] Installed extension dir is missing: ${extensionDir}`);
-    }
-    const manifestPath = path.join(extensionDir, "openclaw.plugin.json");
-    const packageJsonPath = path.join(extensionDir, "package.json");
-    const runtimeGuardPath = path.join(extensionDir, "runtime-guard.js");
-    if (!existsSync(manifestPath)) {
-        throw new Error(`[shadow-extension-load-proof] Plugin manifest missing: ${manifestPath}`);
-    }
-    if (!existsSync(packageJsonPath)) {
-        throw new Error(`[shadow-extension-load-proof] Package manifest missing: ${packageJsonPath}`);
-    }
-    if (!existsSync(runtimeGuardPath)) {
-        throw new Error(`[shadow-extension-load-proof] Installed runtime-guard.js is missing: ${runtimeGuardPath}`);
+    if (installedPlugin.selectedInstall === null) {
+        throw new Error(`[shadow-extension-load-proof] Installed extension dir is missing for plugin ${JSON.stringify(extensionId)} under ${extensionsDir}`);
     }
+    const selectedInstall = installedPlugin.selectedInstall;
+    const extensionDir = selectedInstall.extensionDir;
+    const manifestPath = selectedInstall.manifestPath;
+    const packageJsonPath = selectedInstall.packageJsonPath;
+    const runtimeGuardPath = selectedInstall.runtimeGuardPath;
     const manifest = readRequiredJson(manifestPath, "plugin manifest");
     if (manifest.id !== extensionId) {
         throw new Error(`[shadow-extension-load-proof] Plugin manifest id must be ${JSON.stringify(extensionId)} at ${manifestPath} ` +
@@ -41,12 +35,16 @@ export function inspectInstalledOpenClawBrainExtension(openclawHome, extensionId
     const packageJson = readRequiredJson(packageJsonPath, "package manifest");
     const configuredEntries = readConfiguredEntries(packageJson, packageJsonPath);
     const loaderEntryPath = resolveLoaderEntryPath(extensionDir, configuredEntries);
+    const resolvedRuntimeGuardPath = runtimeGuardPath ?? path.join(path.dirname(loaderEntryPath), "runtime-guard.js");
+    if (!existsSync(resolvedRuntimeGuardPath)) {
+        throw new Error(`[shadow-extension-load-proof] Installed runtime-guard.js is missing: ${resolvedRuntimeGuardPath}`);
+    }
     if (packageJson.type !== "module") {
         throw new Error(`[shadow-extension-load-proof] Installed package manifest must declare \"type\": \"module\" at ${packageJsonPath} ` +
             `(received=${describeValue(packageJson.type)})`);
     }
-    if (packageJson.name !== extensionId) {
-        throw new Error(`[shadow-extension-load-proof] Installed package manifest name must match plugin id ${JSON.stringify(extensionId)} at ${packageJsonPath} ` +
+    if (packageJson.name !== extensionId && packageJson.name !== "@openclawbrain/openclaw") {
+        throw new Error(`[shadow-extension-load-proof] Installed package manifest name must match ${JSON.stringify(extensionId)} or \"@openclawbrain/openclaw\" at ${packageJsonPath} ` +
             `(received=${describeValue(packageJson.name)})`);
     }
     if (typeof packageJson.version === "string" &&
@@ -59,25 +57,27 @@ export function inspectInstalledOpenClawBrainExtension(openclawHome, extensionId
         openclawHome: resolvedOpenclawHome,
         extensionsDir,
         extensionDir,
+        installLayout: selectedInstall.installLayout,
         manifestPath,
         packageJsonPath,
         loaderEntryPath,
-        runtimeGuardPath,
+        runtimeGuardPath: resolvedRuntimeGuardPath,
         manifest,
         packageJson,
-        configuredEntries
+        configuredEntries,
+        additionalInstalls: installedPlugin.additionalInstalls
     };
 }
 export async function proveInstalledOpenClawBrainExtensionLoad(openclawHome, extensionId = "openclawbrain") {
     const inspected = inspectInstalledOpenClawBrainExtension(openclawHome, extensionId);
-    const runtimeGuardModule = await importWithHelpfulError(inspected.runtimeGuardPath, "runtime-guard.js");
+    const runtimeGuardModule = await importWithHelpfulError(inspected.runtimeGuardPath, `runtime-guard.js (${describeOpenClawBrainInstallLayout(inspected.installLayout)})`);
     const runtimeGuardExportNames = Object.keys(runtimeGuardModule).sort((left, right) => left.localeCompare(right));
     const missingRuntimeGuardExports = REQUIRED_RUNTIME_GUARD_EXPORTS.filter((exportName) => !runtimeGuardExportNames.includes(exportName));
     if (missingRuntimeGuardExports.length > 0) {
         throw new Error(`[shadow-extension-load-proof] Installed runtime-guard.js is missing required exports ` +
             `${missingRuntimeGuardExports.join(", ")} at ${inspected.runtimeGuardPath}`);
     }
-    const loaderModule = await importWithHelpfulError(inspected.loaderEntryPath, "loader entry");
+    const loaderModule = await importWithHelpfulError(inspected.loaderEntryPath, `loader entry (${describeOpenClawBrainInstallLayout(inspected.installLayout)})`);
     if (typeof loaderModule.default !== "function") {
         throw new Error(`[shadow-extension-load-proof] Installed loader entry default export must be a function at ${inspected.loaderEntryPath} ` +
             `(received=${describeValue(loaderModule.default)})`);
@@ -215,4 +215,4 @@ function describeValue(value) {
 function isRecord(value) {
     return typeof value === "object" && value !== null;
 }
-//# sourceMappingURL=shadow-extension-proof.js.map
+//# sourceMappingURL=shadow-extension-proof.js.map

package/extension/runtime-guard.ts

@@ -94,19 +94,22 @@ export function normalizePromptBuildEvent(event: unknown): { ok: true; event: No
   const warnings: ExtensionDiagnostic[] = [];
   const sessionId = normalizeOptionalScalarField(event.sessionId, "sessionId", warnings);
   const channel = normalizeOptionalScalarField(event.channel, "channel", warnings);
-  let extractedMessage = "";
+  const promptFallback = extractTextContent(event.prompt);
+  let extractedMessage = promptFallback ?? "";
 
   if (messages.length === 0) {
-    warnings.push(
-      failOpenDiagnostic(
-        "runtime-messages-empty",
-        "before_prompt_build event.messages is empty",
-        `event=${describeValue(event)}`
-      )
-    );
+    if (extractedMessage.length === 0) {
+      warnings.push(
+        failOpenDiagnostic(
+          "runtime-messages-empty",
+          "before_prompt_build event.messages is empty",
+          `event=${describeValue(event)}`
+        )
+      );
+    }
   } else {
     const lastMessage = messages.at(-1);
-    extractedMessage = extractPromptMessage(lastMessage) ?? "";
+    extractedMessage = extractPromptMessage(lastMessage) ?? promptFallback ?? "";
     if (extractedMessage.length === 0) {
       warnings.push(
         failOpenDiagnostic(

package/openclaw.plugin.json

@@ -0,0 +1,11 @@
+{
+  "id": "openclawbrain",
+  "name": "OpenClawBrain",
+  "description": "Learned memory and context from OpenClawBrain",
+  "version": "0.3.6",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@openclawbrain/openclaw",
-  "version": "0.3.4",
-  "description": "Primary OpenClawBrain front door for OpenClaw attach, compile, event export, status, and rollback.",
+  "version": "0.3.6",
+  "description": "Canonical OpenClawBrain front door for OpenClaw attach, compile, event export, status, and rollback.",
   "type": "module",
   "main": "./dist/src/index.js",
   "types": "./dist/src/index.d.ts",
@@ -11,7 +11,8 @@
   "keywords": [
     "openclawbrain",
     "openclaw",
-    "front-door",
+    "canonical-front-door",
+    "operator-lifecycle",
     "route-fn",
     "integration",
     "typescript"
@@ -39,7 +40,8 @@
   "files": [
     "dist/src",
     "dist/extension",
-    "extension"
+    "extension",
+    "openclaw.plugin.json"
   ],
   "publishConfig": {
     "access": "public"
@@ -53,12 +55,19 @@
     "@openclawbrain/event-export": "^0.3.4"
   },
   "bin": {
-    "openclawbrain": "./dist/src/cli.js",
-    "openclawbrain-ops": "./dist/src/cli.js"
+    "openclawbrain": "dist/src/cli.js",
+    "openclawbrain-ops": "dist/src/cli.js"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/extension/index.js"
+    ]
   },
   "scripts": {
     "build": "rm -rf dist && tsc -b",
     "clean": "rm -rf dist && tsc -b --clean",
+    "prepublishOnly": "npm run release:verify",
+    "release:verify": "npm test && node ../../scripts/verify-openclaw-package-tarball.mjs",
     "test": "node --test dist/test/*.test.js"
   }
-}
+}