@openclawbrain/openclaw 0.3.2 → 0.3.3

package/dist/src/openclaw-hook-truth.d.ts

@@ -0,0 +1,25 @@
+export type OpenClawBrainHookInstallState = "installed" | "not_installed" | "blocked_by_allowlist" | "unverified";
+export type OpenClawBrainHookLoadability = "loadable" | "blocked" | "not_installed" | "unverified";
+export type OpenClawBrainHookLoadProof = "status_probe_ready" | "not_ready";
+export type OpenClawBrainPluginAllowlistState = "unrestricted" | "allowed" | "blocked" | "invalid" | "unverified";
+export interface OpenClawBrainHookInspection {
+    scope: "exact_openclaw_home" | "activation_root_only";
+    openclawHome: string | null;
+    hookPath: string | null;
+    runtimeGuardPath: string | null;
+    manifestPath: string | null;
+    installState: OpenClawBrainHookInstallState;
+    loadability: OpenClawBrainHookLoadability;
+    pluginAllowlistState: OpenClawBrainPluginAllowlistState;
+    desynced: boolean;
+    detail: string;
+}
+export interface OpenClawBrainHookLoadSummary extends OpenClawBrainHookInspection {
+    loadProof: OpenClawBrainHookLoadProof;
+}
+export declare function inspectOpenClawBrainPluginAllowlist(openclawHome: string): {
+    state: Exclude<OpenClawBrainPluginAllowlistState, "unverified">;
+    detail: string;
+};
+export declare function inspectOpenClawBrainHookStatus(openclawHome: string | null | undefined): OpenClawBrainHookInspection;
+export declare function summarizeOpenClawBrainHookLoad(inspection: OpenClawBrainHookInspection, statusProbeReady: boolean): OpenClawBrainHookLoadSummary;

package/dist/src/openclaw-hook-truth.js

@@ -0,0 +1,154 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+function toErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function readJsonObjectRecord(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+function readOpenClawJsonConfig(openclawHome) {
+    const openclawJsonPath = path.join(openclawHome, "openclaw.json");
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(openclawJsonPath, "utf8"));
+    }
+    catch (error) {
+        throw new Error(`Failed to read ${openclawJsonPath}: ${toErrorMessage(error)}`);
+    }
+    const config = readJsonObjectRecord(parsed);
+    if (config === null) {
+        throw new Error(`Failed to read ${openclawJsonPath}: openclaw.json must contain a top-level object`);
+    }
+    return {
+        path: openclawJsonPath,
+        config
+    };
+}
+function shortenPath(fullPath) {
+    const homeDir = process.env.HOME ?? "";
+    if (homeDir.length > 0 && fullPath.startsWith(homeDir)) {
+        return "~" + fullPath.slice(homeDir.length);
+    }
+    return fullPath;
+}
+export function inspectOpenClawBrainPluginAllowlist(openclawHome) {
+    const { path: openclawJsonPath, config } = readOpenClawJsonConfig(openclawHome);
+    const plugins = readJsonObjectRecord(config.plugins);
+    if (plugins === null) {
+        return {
+            state: "unrestricted",
+            detail: `${shortenPath(openclawJsonPath)} has no plugins object; the on-disk hook is not blocked by an allowlist`
+        };
+    }
+    if (!Object.prototype.hasOwnProperty.call(plugins, "allow")) {
+        return {
+            state: "unrestricted",
+            detail: `${shortenPath(openclawJsonPath)} does not pin plugins.allow; the on-disk hook is not blocked by an allowlist`
+        };
+    }
+    if (!Array.isArray(plugins.allow)) {
+        return {
+            state: "invalid",
+            detail: `${shortenPath(openclawJsonPath)} has a non-array plugins.allow value, so OpenClawBrain load cannot be proven from config`
+        };
+    }
+    return plugins.allow.includes("openclawbrain")
+        ? {
+            state: "allowed",
+            detail: `${shortenPath(openclawJsonPath)} plugins.allow explicitly includes openclawbrain`
+        }
+        : {
+            state: "blocked",
+            detail: `${shortenPath(openclawJsonPath)} plugins.allow excludes openclawbrain`
+        };
+}
+export function inspectOpenClawBrainHookStatus(openclawHome) {
+    if (openclawHome === null || openclawHome === undefined || openclawHome.trim().length === 0) {
+        return {
+            scope: "activation_root_only",
+            openclawHome: null,
+            hookPath: null,
+            runtimeGuardPath: null,
+            manifestPath: null,
+            installState: "unverified",
+            loadability: "unverified",
+            pluginAllowlistState: "unverified",
+            desynced: false,
+            detail: "profile hook state is unknown from activation-root-only status; pin --openclaw-home to prove install state"
+        };
+    }
+    const resolvedHome = path.resolve(openclawHome);
+    const extensionDir = path.join(resolvedHome, "extensions", "openclawbrain");
+    const hookPath = path.join(extensionDir, "index.ts");
+    const runtimeGuardPath = path.join(extensionDir, "runtime-guard.js");
+    const manifestPath = path.join(extensionDir, "openclaw.plugin.json");
+    if (!(existsSync(hookPath) && existsSync(runtimeGuardPath) && existsSync(manifestPath))) {
+        return {
+            scope: "exact_openclaw_home",
+            openclawHome: resolvedHome,
+            hookPath,
+            runtimeGuardPath,
+            manifestPath,
+            installState: "not_installed",
+            loadability: "not_installed",
+            pluginAllowlistState: "unverified",
+            desynced: false,
+            detail: `profile hook is not present at ${shortenPath(extensionDir)}`
+        };
+    }
+    const allowlist = inspectOpenClawBrainPluginAllowlist(resolvedHome);
+    if (allowlist.state === "blocked") {
+        return {
+            scope: "exact_openclaw_home",
+            openclawHome: resolvedHome,
+            hookPath,
+            runtimeGuardPath,
+            manifestPath,
+            installState: "blocked_by_allowlist",
+            loadability: "blocked",
+            pluginAllowlistState: allowlist.state,
+            desynced: true,
+            detail: `profile hook files exist at ${shortenPath(extensionDir)}, but ${allowlist.detail}; ` +
+                "the on-disk hook is desynced and OpenClaw will not load it"
+        };
+    }
+    if (allowlist.state === "invalid") {
+        return {
+            scope: "exact_openclaw_home",
+            openclawHome: resolvedHome,
+            hookPath,
+            runtimeGuardPath,
+            manifestPath,
+            installState: "blocked_by_allowlist",
+            loadability: "blocked",
+            pluginAllowlistState: allowlist.state,
+            desynced: true,
+            detail: `profile hook files exist at ${shortenPath(extensionDir)}, but ${allowlist.detail}; ` +
+                "treat hook-load state as broken until install/attach repairs the config"
+        };
+    }
+    return {
+        scope: "exact_openclaw_home",
+        openclawHome: resolvedHome,
+        hookPath,
+        runtimeGuardPath,
+        manifestPath,
+        installState: "installed",
+        loadability: "loadable",
+        pluginAllowlistState: allowlist.state,
+        desynced: false,
+        detail: `profile hook is installed at ${shortenPath(extensionDir)}`
+    };
+}
+export function summarizeOpenClawBrainHookLoad(inspection, statusProbeReady) {
+    return {
+        ...inspection,
+        loadProof: inspection.loadability === "loadable" && statusProbeReady
+            ? "status_probe_ready"
+            : "not_ready"
+    };
+}
+//# sourceMappingURL=openclaw-hook-truth.js.map

package/dist/src/openclaw-hook-truth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-hook-truth.js","sourceRoot":"","sources":["../../src/openclaw-hook-truth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,SAAS,sBAAsB,CAAC,YAAoB;IAClD,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAElE,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,kBAAkB,gBAAgB,KAAK,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,kBAAkB,gBAAgB,iDAAiD,CAAC,CAAC;IACvG,CAAC;IAED,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,MAAM;KACP,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB;IACnC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IACvC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,OAAO,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAwBD,MAAM,UAAU,mCAAmC,CAAC,YAAoB;IAItE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAChF,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAErD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO;YACL,KAAK,EAAE,cAAc;YACrB,MAAM,EAAE,GAAG,WAAW,CAAC,gBAAgB,CAAC,yEAAyE;SAClH,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;QAC5D,OAAO;YACL,KAAK,EAAE,cAAc;YACrB,MAAM,EAAE,GAAG,WAAW,CAAC,gBAAgB,CAAC,8EAA8E;SACvH,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,GAAG,WAAW,CAAC,gBAAgB,CAAC,0FAA0F;SACnI,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC;QAC5C,CAAC,CAAC;YACE,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,GAAG,WAAW,CAAC,gBAAgB,CAAC,kDAAkD;SAC3F;QACH,CAAC,CAAC;YACE,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,GAAG,WAAW,CAAC,gBAAgB,CAAC,uCAAuC;SAChF,CAAC;AACR,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,YAAuC;IACpF,IAAI,YAAY,KAAK,IAAI,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5F,OAAO;YACL,KAAK,EAAE,sBAAsB;YAC7B,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,IAAI;YACd,gBAAgB,EAAE,IAAI;YACtB,YAAY,EAAE,IAAI;YAClB,YAAY,EAAE,YAAY;YAC1B,WAAW,EAAE,YAAY;YACzB,oBAAoB,EAAE,YAAY;YAClC,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,4GAA4G;SACrH,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IACrD,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;IACrE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,sBAAsB,CAAC,CAAC;IAErE,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,gBAAgB,CAAC,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QACxF,OAAO;YACL,KAAK,EAAE,qBAAqB;YAC5B,YAAY,EAAE,YAAY;YAC1B,QAAQ;YACR,gBAAgB;YAChB,YAAY;YACZ,YAAY,EAAE,eAAe;YAC7B,WAAW,EAAE,eAAe;YAC5B,oBAAoB,EAAE,YAAY;YAClC,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,kCAAkC,WAAW,CAAC,YAAY,CAAC,EAAE;SACtE,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,mCAAmC,CAAC,YAAY,CAAC,CAAC;IACpE,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO;YACL,KAAK,EAAE,qBAAqB;YAC5B,YAAY,EAAE,YAAY;YAC1B,QAAQ;YACR,gBAAgB;YAChB,YAAY;YACZ,YAAY,EAAE,sBAAsB;YACpC,WAAW,EAAE,SAAS;YACtB,oBAAoB,EAAE,SAAS,CAAC,KAAK;YACrC,QAAQ,EAAE,IAAI;YACd,MAAM,EACJ,+BAA+B,WAAW,CAAC,YAAY,CAAC,SAAS,SAAS,CAAC,MAAM,IAAI;gBACrF,4DAA4D;SAC/D,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO;YACL,KAAK,EAAE,qBAAqB;YAC5B,YAAY,EAAE,YAAY;YAC1B,QAAQ;YACR,gBAAgB;YAChB,YAAY;YACZ,YAAY,EAAE,sBAAsB;YACpC,WAAW,EAAE,SAAS;YACtB,oBAAoB,EAAE,SAAS,CAAC,KAAK;YACrC,QAAQ,EAAE,IAAI;YACd,MAAM,EACJ,+BAA+B,WAAW,CAAC,YAAY,CAAC,SAAS,SAAS,CAAC,MAAM,IAAI;gBACrF,yEAAyE;SAC5E,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,qBAAqB;QAC5B,YAAY,EAAE,YAAY;QAC1B,QAAQ;QACR,gBAAgB;QAChB,YAAY;QACZ,YAAY,EAAE,WAAW;QACzB,WAAW,EAAE,UAAU;QACvB,oBAAoB,EAAE,SAAS,CAAC,KAAK;QACrC,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,gCAAgC,WAAW,CAAC,YAAY,CAAC,EAAE;KACpE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,UAAuC,EACvC,gBAAyB;IAEzB,OAAO;QACL,GAAG,UAAU;QACb,SAAS,EACP,UAAU,CAAC,WAAW,KAAK,UAAU,IAAI,gBAAgB;YACvD,CAAC,CAAC,oBAAoB;YACtB,CAAC,CAAC,WAAW;KAClB,CAAC;AACJ,CAAC"}

package/extension/index.ts

@@ -11,7 +11,10 @@
  */
 import { fileURLToPath } from "node:url";
 
-import { compileRuntimeContext } from "@openclawbrain/openclaw";
+import {
+  compileRuntimeContext,
+  recordOpenClawProfileRuntimeLoadProof
+} from "@openclawbrain/openclaw";
 import {
   createBeforePromptBuildHandler,
   isActivationRootPlaceholder,
@@ -94,6 +97,21 @@ export default function register(api: unknown) {
       }),
       { priority: 5 }
     );
+    if (!isActivationRootPlaceholder(ACTIVATION_ROOT)) {
+      try {
+        recordOpenClawProfileRuntimeLoadProof({
+          activationRoot: ACTIVATION_ROOT,
+          extensionEntryPath: EXTENSION_ENTRY_PATH
+        });
+      } catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        void reportDiagnostic({
+          key: `runtime-load-proof:${detail}`,
+          once: true,
+          message: `[openclawbrain] runtime load proof failed: ${detail}`
+        });
+      }
+    }
     announceStartupBreadcrumb();
   } catch (error) {
     const detail = error instanceof Error ? error.stack ?? error.message : String(error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclawbrain/openclaw",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Primary OpenClawBrain front door for OpenClaw attach, compile, event export, status, and rollback.",
   "type": "module",
   "main": "./dist/src/index.js",
@@ -45,12 +45,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@openclawbrain/compiler": "0.3.2",
-    "@openclawbrain/contracts": "0.3.2",
-    "@openclawbrain/events": "0.3.2",
-    "@openclawbrain/learner": "0.3.2",
-    "@openclawbrain/pack-format": "0.3.2",
-    "@openclawbrain/event-export": "0.3.2"
+    "@openclawbrain/compiler": "^0.3.3",
+    "@openclawbrain/contracts": "^0.3.3",
+    "@openclawbrain/events": "^0.3.3",
+    "@openclawbrain/learner": "^0.3.3",
+    "@openclawbrain/pack-format": "^0.3.3",
+    "@openclawbrain/event-export": "^0.3.3"
   },
   "bin": {
     "openclawbrain": "./dist/src/cli.js",