@openclawbrain/openclaw 0.3.6 → 0.4.0

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

@@ -1,260 +0,0 @@
-import { readFileSync } from "node:fs";
-import path from "node:path";
-import { describeOpenClawBrainInstallIdentity, describeOpenClawBrainInstallLayout, findInstalledOpenClawBrainPlugin, getOpenClawBrainKnownPluginIds } from "./openclaw-plugin-install.js";
-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;
-}
-function inspectInstalledHookActivationRoot(loaderEntryPath) {
-    let content;
-    try {
-        content = readFileSync(loaderEntryPath, "utf8");
-    }
-    catch (error) {
-        return {
-            ready: false,
-            detail: `installed loader entry ${shortenPath(loaderEntryPath)} could not be read: ${toErrorMessage(error)}`
-        };
-    }
-    const match = content.match(/const\s+ACTIVATION_ROOT\s*=\s*["'`]([^"'`]+)["'`]/) ??
-        content.match(/activationRoot:\s*["'`]([^"'`]+)["'`]/);
-    if (!match || !match[1]) {
-        return {
-            ready: false,
-            detail: `installed loader entry ${shortenPath(loaderEntryPath)} does not declare a pinned activation root`
-        };
-    }
-    const activationRoot = match[1].trim();
-    if (activationRoot === "__ACTIVATION_ROOT__" || activationRoot === "__ACTIVATION_" + "ROOT__") {
-        return {
-            ready: false,
-            detail: `installed loader entry ${shortenPath(loaderEntryPath)} still contains the ACTIVATION_ROOT placeholder; rerun openclawbrain install/attach to pin the runtime hook`
-        };
-    }
-    return {
-        ready: true,
-        detail: `installed loader entry ${shortenPath(loaderEntryPath)} pins activation root ${shortenPath(path.resolve(activationRoot))}`
-    };
-}
-function describeAdditionalInstallDetail(additionalInstalls) {
-    if (additionalInstalls.length === 0) {
-        return "";
-    }
-    return `; additional OpenClawBrain installs also exist at ${additionalInstalls
-        .map((install) => `${shortenPath(install.extensionDir)} (${describeOpenClawBrainInstallLayout(install.installLayout)}, ${describeOpenClawBrainInstallIdentity(install)})`)
-        .join(", ")}`;
-}
-export function inspectOpenClawBrainPluginAllowlist(openclawHome) {
-    const { path: openclawJsonPath, config } = readOpenClawJsonConfig(openclawHome);
-    const installedPlugin = findInstalledOpenClawBrainPlugin(openclawHome);
-    const knownPluginIds = getOpenClawBrainKnownPluginIds(installedPlugin.selectedInstall);
-    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`
-        };
-    }
-    const matchedPluginId = knownPluginIds.find((pluginId) => plugins.allow.includes(pluginId)) ?? null;
-    return matchedPluginId !== null
-        ? {
-            state: "allowed",
-            detail: `${shortenPath(openclawJsonPath)} plugins.allow explicitly includes ${matchedPluginId}; recognized OpenClawBrain ids are ${knownPluginIds.join(", ")}`
-        }
-        : {
-            state: "blocked",
-            detail: `${shortenPath(openclawJsonPath)} plugins.allow excludes recognized OpenClawBrain ids ${knownPluginIds.join(", ")}`
-        };
-}
-export function inspectOpenClawBrainHookStatus(openclawHome) {
-    if (openclawHome === null || openclawHome === undefined || openclawHome.trim().length === 0) {
-        return {
-            scope: "activation_root_only",
-            openclawHome: null,
-            extensionDir: null,
-            hookPath: null,
-            runtimeGuardPath: null,
-            manifestPath: null,
-            packageJsonPath: null,
-            manifestId: null,
-            installId: null,
-            packageName: null,
-            installLayout: null,
-            additionalInstallCount: 0,
-            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 installedPlugin = findInstalledOpenClawBrainPlugin(resolvedHome);
-    if (installedPlugin.selectedInstall === null ||
-        installedPlugin.selectedInstall.loaderEntryPath === null ||
-        installedPlugin.selectedInstall.runtimeGuardPath === null) {
-        const incompleteInstall = installedPlugin.selectedInstall;
-        return {
-            scope: "exact_openclaw_home",
-            openclawHome: resolvedHome,
-            extensionDir: incompleteInstall?.extensionDir ?? null,
-            hookPath: incompleteInstall?.loaderEntryPath ?? null,
-            runtimeGuardPath: incompleteInstall?.runtimeGuardPath ?? null,
-            manifestPath: incompleteInstall?.manifestPath ?? null,
-            packageJsonPath: incompleteInstall?.packageJsonPath ?? null,
-            manifestId: incompleteInstall?.manifestId ?? null,
-            installId: incompleteInstall?.installId ?? null,
-            packageName: incompleteInstall?.packageName ?? null,
-            installLayout: incompleteInstall?.installLayout ?? null,
-            additionalInstallCount: installedPlugin.additionalInstalls.length,
-            installState: "not_installed",
-            loadability: "not_installed",
-            pluginAllowlistState: "unverified",
-            desynced: false,
-            detail: incompleteInstall === null
-                ? `profile hook is not present under ${shortenPath(installedPlugin.extensionsDir)}`
-                : `profile hook is incomplete under ${shortenPath(incompleteInstall.extensionDir)} (${describeOpenClawBrainInstallIdentity(incompleteInstall)})`
-        };
-    }
-    const selectedInstall = installedPlugin.selectedInstall;
-    const additionalInstallDetail = describeAdditionalInstallDetail(installedPlugin.additionalInstalls);
-    const allowlist = inspectOpenClawBrainPluginAllowlist(resolvedHome);
-    const layoutLabel = describeOpenClawBrainInstallLayout(selectedInstall.installLayout);
-    const identityDetail = describeOpenClawBrainInstallIdentity(selectedInstall);
-    const activationRootState = inspectInstalledHookActivationRoot(selectedInstall.loaderEntryPath);
-    if (allowlist.state === "blocked") {
-        return {
-            scope: "exact_openclaw_home",
-            openclawHome: resolvedHome,
-            extensionDir: selectedInstall.extensionDir,
-            hookPath: selectedInstall.loaderEntryPath,
-            runtimeGuardPath: selectedInstall.runtimeGuardPath,
-            manifestPath: selectedInstall.manifestPath,
-            packageJsonPath: selectedInstall.packageJsonPath,
-            manifestId: selectedInstall.manifestId,
-            installId: selectedInstall.installId,
-            packageName: selectedInstall.packageName,
-            installLayout: selectedInstall.installLayout,
-            additionalInstallCount: installedPlugin.additionalInstalls.length,
-            installState: "blocked_by_allowlist",
-            loadability: "blocked",
-            pluginAllowlistState: allowlist.state,
-            desynced: true,
-            detail: `profile hook is installed via ${layoutLabel} at ${shortenPath(selectedInstall.extensionDir)} (${identityDetail}), but ${allowlist.detail}; ` +
-                `the on-disk hook is not loadable and OpenClaw will not load it${additionalInstallDetail}`
-        };
-    }
-    if (allowlist.state === "invalid") {
-        return {
-            scope: "exact_openclaw_home",
-            openclawHome: resolvedHome,
-            extensionDir: selectedInstall.extensionDir,
-            hookPath: selectedInstall.loaderEntryPath,
-            runtimeGuardPath: selectedInstall.runtimeGuardPath,
-            manifestPath: selectedInstall.manifestPath,
-            packageJsonPath: selectedInstall.packageJsonPath,
-            manifestId: selectedInstall.manifestId,
-            installId: selectedInstall.installId,
-            packageName: selectedInstall.packageName,
-            installLayout: selectedInstall.installLayout,
-            additionalInstallCount: installedPlugin.additionalInstalls.length,
-            installState: "blocked_by_allowlist",
-            loadability: "blocked",
-            pluginAllowlistState: allowlist.state,
-            desynced: true,
-            detail: `profile hook is installed via ${layoutLabel} at ${shortenPath(selectedInstall.extensionDir)} (${identityDetail}), but ${allowlist.detail}; ` +
-                `treat hook-load state as broken until install/attach repairs the config${additionalInstallDetail}`
-        };
-    }
-    if (!activationRootState.ready) {
-        return {
-            scope: "exact_openclaw_home",
-            openclawHome: resolvedHome,
-            extensionDir: selectedInstall.extensionDir,
-            hookPath: selectedInstall.loaderEntryPath,
-            runtimeGuardPath: selectedInstall.runtimeGuardPath,
-            manifestPath: selectedInstall.manifestPath,
-            packageJsonPath: selectedInstall.packageJsonPath,
-            manifestId: selectedInstall.manifestId,
-            installId: selectedInstall.installId,
-            packageName: selectedInstall.packageName,
-            installLayout: selectedInstall.installLayout,
-            additionalInstallCount: installedPlugin.additionalInstalls.length,
-            installState: "installed",
-            loadability: "blocked",
-            pluginAllowlistState: allowlist.state,
-            desynced: true,
-            detail: `profile hook is installed via ${layoutLabel} at ${shortenPath(selectedInstall.extensionDir)} (${identityDetail}), but ${activationRootState.detail}${additionalInstallDetail}`
-        };
-    }
-    return {
-        scope: "exact_openclaw_home",
-        openclawHome: resolvedHome,
-        extensionDir: selectedInstall.extensionDir,
-        hookPath: selectedInstall.loaderEntryPath,
-        runtimeGuardPath: selectedInstall.runtimeGuardPath,
-        manifestPath: selectedInstall.manifestPath,
-        packageJsonPath: selectedInstall.packageJsonPath,
-        manifestId: selectedInstall.manifestId,
-        installId: selectedInstall.installId,
-        packageName: selectedInstall.packageName,
-        installLayout: selectedInstall.installLayout,
-        additionalInstallCount: installedPlugin.additionalInstalls.length,
-        installState: "installed",
-        loadability: "loadable",
-        pluginAllowlistState: allowlist.state,
-        desynced: false,
-        detail: `profile hook is installed via ${layoutLabel} at ${shortenPath(selectedInstall.extensionDir)} (${identityDetail})${additionalInstallDetail}`
-    };
-}
-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

@@ -1 +0,0 @@
-{"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/dist/src/openclaw-plugin-install.d.ts

@@ -1,40 +0,0 @@
-export type OpenClawBrainInstallLayout = "generated_shadow_extension" | "native_package_plugin";
-export interface OpenClawBrainInstalledPlugin {
-    openclawHome: string;
-    extensionsDir: string;
-    extensionDir: string;
-    manifestPath: string;
-    packageJsonPath: string;
-    loaderEntryPath: string | null;
-    runtimeGuardPath: string | null;
-    configuredEntries: string[];
-    manifestId: string | null;
-    installId: string | null;
-    packageName: string | null;
-    installLayout: OpenClawBrainInstallLayout;
-}
-export interface OpenClawBrainInstallTarget {
-    installLayout: OpenClawBrainInstallLayout;
-    extensionDir: string;
-    hookPath: string;
-    writeMode: "pin_native_package" | "write_shadow_extension";
-    selectedInstall: OpenClawBrainInstalledPlugin | null;
-    additionalInstalls: OpenClawBrainInstalledPlugin[];
-}
-export interface OpenClawBrainInstalledPluginLookup {
-    openclawHome: string;
-    extensionsDir: string;
-    selectedInstall: OpenClawBrainInstalledPlugin | null;
-    additionalInstalls: OpenClawBrainInstalledPlugin[];
-}
-export declare const OPENCLAWBRAIN_PLUGIN_ID = "openclawbrain";
-export declare const OPENCLAWBRAIN_SHADOW_PACKAGE_NAME = "openclawbrain";
-export declare const OPENCLAWBRAIN_NATIVE_PACKAGE_NAME = "@openclawbrain/openclaw";
-export declare const OPENCLAWBRAIN_NATIVE_INSTALL_ID = "openclaw";
-export declare function describeOpenClawBrainInstallLayout(installLayout: OpenClawBrainInstallLayout): string;
-export declare function getOpenClawBrainKnownPluginIds(install: OpenClawBrainInstalledPlugin | null | undefined): string[];
-export declare function describeOpenClawBrainInstallIdentity(install: OpenClawBrainInstalledPlugin): string;
-export declare function findInstalledOpenClawBrainPlugin(openclawHome: string, pluginId?: string): OpenClawBrainInstalledPluginLookup;
-export declare function resolveOpenClawBrainInstallTarget(openclawHome: string): OpenClawBrainInstallTarget;
-export declare function pinInstalledOpenClawBrainPluginActivationRoot(loaderEntryPath: string, activationRoot: string): void;
-export declare function resolveOpenClawHomeFromExtensionEntryPath(extensionEntryPath: string): string | null;

package/dist/src/openclaw-plugin-install.js

@@ -1,282 +0,0 @@
-import { existsSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
-import path from "node:path";
-export const OPENCLAWBRAIN_PLUGIN_ID = "openclawbrain";
-export const OPENCLAWBRAIN_SHADOW_PACKAGE_NAME = "openclawbrain";
-export const OPENCLAWBRAIN_NATIVE_PACKAGE_NAME = "@openclawbrain/openclaw";
-export const OPENCLAWBRAIN_NATIVE_INSTALL_ID = "openclaw";
-function readJsonObject(filePath) {
-    try {
-        const parsed = JSON.parse(readFileSync(filePath, "utf8"));
-        if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-            return null;
-        }
-        return parsed;
-    }
-    catch {
-        return null;
-    }
-}
-function resolveConfiguredEntries(packageJson) {
-    const entries = packageJson?.openclaw?.extensions;
-    if (!Array.isArray(entries)) {
-        return [];
-    }
-    return entries
-        .filter((entry) => typeof entry === "string")
-        .map((entry) => entry.trim())
-        .filter((entry) => entry.length > 0);
-}
-function resolveLoaderEntryPath(extensionDir, configuredEntries) {
-    for (const configuredEntry of configuredEntries) {
-        const candidate = path.join(extensionDir, configuredEntry);
-        if (existsSync(candidate)) {
-            return candidate;
-        }
-    }
-    return null;
-}
-function resolveRuntimeGuardPath(loaderEntryPath) {
-    const runtimeGuardPath = path.join(path.dirname(loaderEntryPath), "runtime-guard.js");
-    return existsSync(runtimeGuardPath) ? runtimeGuardPath : null;
-}
-function normalizeOptionalString(value) {
-    if (typeof value !== "string") {
-        return null;
-    }
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : null;
-}
-function normalizeInstallId(value) {
-    const normalized = normalizeOptionalString(value);
-    if (normalized === null) {
-        return null;
-    }
-    if (!normalized.startsWith("@")) {
-        return normalized;
-    }
-    const parts = normalized.split("/");
-    return normalizeOptionalString(parts[1] ?? null);
-}
-function listCandidateExtensionDirs(extensionsDir) {
-    const candidates = [];
-    let entries;
-    try {
-        entries = readdirSync(extensionsDir, { withFileTypes: true });
-    }
-    catch {
-        return [];
-    }
-    for (const entry of entries) {
-        if (!entry.isDirectory()) {
-            continue;
-        }
-        const directPath = path.join(extensionsDir, entry.name);
-        candidates.push(directPath);
-        if (!entry.name.startsWith("@")) {
-            continue;
-        }
-        let scopedEntries;
-        try {
-            scopedEntries = readdirSync(directPath, { withFileTypes: true });
-        }
-        catch {
-            continue;
-        }
-        for (const scopedEntry of scopedEntries) {
-            if (!scopedEntry.isDirectory()) {
-                continue;
-            }
-            candidates.push(path.join(directPath, scopedEntry.name));
-        }
-    }
-    return candidates.sort((left, right) => left.localeCompare(right));
-}
-function inferInstallLayout(input) {
-    if (input.packageName === OPENCLAWBRAIN_NATIVE_PACKAGE_NAME) {
-        return "native_package_plugin";
-    }
-    if (input.packageName === OPENCLAWBRAIN_SHADOW_PACKAGE_NAME) {
-        return "generated_shadow_extension";
-    }
-    if (input.installId === OPENCLAWBRAIN_NATIVE_INSTALL_ID &&
-        input.loaderEntryPath !== null &&
-        input.loaderEntryPath.endsWith(path.join("dist", "extension", "index.js"))) {
-        return "native_package_plugin";
-    }
-    if (input.loaderEntryPath !== null &&
-        input.loaderEntryPath.endsWith(path.join("dist", "extension", "index.js"))) {
-        return "native_package_plugin";
-    }
-    if (input.loaderEntryPath !== null &&
-        path.basename(input.loaderEntryPath) === "index.ts" &&
-        (input.installId === OPENCLAWBRAIN_PLUGIN_ID ||
-            path.basename(input.extensionDir) === OPENCLAWBRAIN_PLUGIN_ID)) {
-        return "generated_shadow_extension";
-    }
-    return null;
-}
-function compareInstalledPluginPriority(left, right) {
-    const leftCompleteness = Number(left.loaderEntryPath !== null) + Number(left.runtimeGuardPath !== null);
-    const rightCompleteness = Number(right.loaderEntryPath !== null) + Number(right.runtimeGuardPath !== null);
-    if (leftCompleteness !== rightCompleteness) {
-        return rightCompleteness - leftCompleteness;
-    }
-    const leftLayoutRank = left.installLayout === "native_package_plugin" ? 0 : 1;
-    const rightLayoutRank = right.installLayout === "native_package_plugin" ? 0 : 1;
-    if (leftLayoutRank !== rightLayoutRank) {
-        return leftLayoutRank - rightLayoutRank;
-    }
-    return left.extensionDir.localeCompare(right.extensionDir);
-}
-function inspectOpenClawBrainPluginInstall(extensionDir, pluginId) {
-    const manifestPath = path.join(extensionDir, "openclaw.plugin.json");
-    if (!existsSync(manifestPath)) {
-        return null;
-    }
-    const manifest = readJsonObject(manifestPath);
-    const manifestId = normalizeOptionalString(manifest?.id);
-    if (manifestId !== pluginId) {
-        return null;
-    }
-    const packageJsonPath = path.join(extensionDir, "package.json");
-    if (!existsSync(packageJsonPath)) {
-        return null;
-    }
-    const packageJson = readJsonObject(packageJsonPath);
-    if (packageJson === null) {
-        return null;
-    }
-    const configuredEntries = resolveConfiguredEntries(packageJson);
-    const loaderEntryPath = resolveLoaderEntryPath(extensionDir, configuredEntries);
-    const packageName = typeof packageJson.name === "string" && packageJson.name.trim().length > 0
-        ? packageJson.name.trim()
-        : null;
-    const installId = normalizeInstallId(packageName) ?? normalizeInstallId(path.basename(extensionDir));
-    const installLayout = inferInstallLayout({
-        extensionDir,
-        packageName,
-        installId,
-        loaderEntryPath
-    });
-    if (installLayout === null) {
-        return null;
-    }
-    return {
-        extensionDir,
-        manifestPath,
-        packageJsonPath,
-        loaderEntryPath,
-        runtimeGuardPath: loaderEntryPath === null ? null : resolveRuntimeGuardPath(loaderEntryPath),
-        configuredEntries,
-        manifestId,
-        installId,
-        packageName,
-        installLayout
-    };
-}
-export function describeOpenClawBrainInstallLayout(installLayout) {
-    return installLayout === "native_package_plugin"
-        ? "native package plugin"
-        : "generated shadow extension";
-}
-export function getOpenClawBrainKnownPluginIds(install) {
-    const ids = [];
-    const push = (value) => {
-        const normalized = normalizeOptionalString(value);
-        if (normalized === null || ids.includes(normalized)) {
-            return;
-        }
-        ids.push(normalized);
-    };
-    push(OPENCLAWBRAIN_PLUGIN_ID);
-    push(install?.manifestId ?? null);
-    push(install?.installId ?? null);
-    if (install?.packageName === OPENCLAWBRAIN_NATIVE_PACKAGE_NAME) {
-        push(OPENCLAWBRAIN_NATIVE_INSTALL_ID);
-    }
-    return ids;
-}
-export function describeOpenClawBrainInstallIdentity(install) {
-    return [
-        `manifest=${install.manifestId ?? OPENCLAWBRAIN_PLUGIN_ID}`,
-        `install=${install.installId ?? path.basename(install.extensionDir)}`,
-        `package=${install.packageName ?? "unknown"}`
-    ].join(" ");
-}
-export function findInstalledOpenClawBrainPlugin(openclawHome, pluginId = OPENCLAWBRAIN_PLUGIN_ID) {
-    const resolvedOpenclawHome = path.resolve(openclawHome);
-    const extensionsDir = path.join(resolvedOpenclawHome, "extensions");
-    if (!existsSync(extensionsDir)) {
-        return {
-            openclawHome: resolvedOpenclawHome,
-            extensionsDir,
-            selectedInstall: null,
-            additionalInstalls: []
-        };
-    }
-    const installs = listCandidateExtensionDirs(extensionsDir)
-        .map((extensionDir) => inspectOpenClawBrainPluginInstall(extensionDir, pluginId))
-        .filter((install) => install !== null)
-        .map((install) => ({
-        ...install,
-        openclawHome: resolvedOpenclawHome,
-        extensionsDir
-    }))
-        .sort(compareInstalledPluginPriority);
-    return {
-        openclawHome: resolvedOpenclawHome,
-        extensionsDir,
-        selectedInstall: installs[0] ?? null,
-        additionalInstalls: installs.slice(1)
-    };
-}
-export function resolveOpenClawBrainInstallTarget(openclawHome) {
-    const installedPlugin = findInstalledOpenClawBrainPlugin(openclawHome);
-    const selectedInstall = installedPlugin.selectedInstall;
-    if (selectedInstall !== null &&
-        selectedInstall.installLayout === "native_package_plugin" &&
-        selectedInstall.loaderEntryPath !== null &&
-        selectedInstall.runtimeGuardPath !== null) {
-        return {
-            installLayout: selectedInstall.installLayout,
-            extensionDir: selectedInstall.extensionDir,
-            hookPath: selectedInstall.loaderEntryPath,
-            writeMode: "pin_native_package",
-            selectedInstall,
-            additionalInstalls: installedPlugin.additionalInstalls
-        };
-    }
-    const extensionDir = path.join(openclawHome, "extensions", OPENCLAWBRAIN_PLUGIN_ID);
-    return {
-        installLayout: "generated_shadow_extension",
-        extensionDir,
-        hookPath: path.join(extensionDir, "index.ts"),
-        writeMode: "write_shadow_extension",
-        selectedInstall,
-        additionalInstalls: installedPlugin.additionalInstalls
-    };
-}
-export function pinInstalledOpenClawBrainPluginActivationRoot(loaderEntryPath, activationRoot) {
-    const loaderSource = readFileSync(loaderEntryPath, "utf8");
-    const pinnedActivationRoot = `const ACTIVATION_ROOT = ${JSON.stringify(activationRoot)};`;
-    const nextLoaderSource = loaderSource.replace(/const\s+ACTIVATION_ROOT\s*=\s*["'`][^"'`]*["'`];/, pinnedActivationRoot);
-    if (nextLoaderSource === loaderSource) {
-        throw new Error(`Installed loader entry ${loaderEntryPath} does not expose a patchable ACTIVATION_ROOT constant`);
-    }
-    writeFileSync(loaderEntryPath, nextLoaderSource, "utf8");
-}
-export function resolveOpenClawHomeFromExtensionEntryPath(extensionEntryPath) {
-    let currentPath = path.resolve(extensionEntryPath);
-    while (true) {
-        const parentPath = path.dirname(currentPath);
-        if (parentPath === currentPath) {
-            break;
-        }
-        if (path.basename(parentPath) === "extensions") {
-            return path.dirname(parentPath);
-        }
-        currentPath = parentPath;
-    }
-    return null;
-}
-//# sourceMappingURL=openclaw-plugin-install.js.map

package/dist/src/provider-config.d.ts

@@ -1,64 +0,0 @@
-declare const OPENCLAWBRAIN_PROVIDER_DEFAULTS_CONTRACT = "openclawbrain_provider_defaults.v1";
-declare const ALLOWED_TEACHER_PROVIDERS: readonly ["heuristic", "ollama", "off"];
-declare const ALLOWED_EMBEDDER_PROVIDERS: readonly ["keywords", "ollama", "off"];
-export type OpenClawBrainProviderConfigEnv = Readonly<Record<string, string | undefined>>;
-export type OpenClawBrainTeacherProvider = (typeof ALLOWED_TEACHER_PROVIDERS)[number];
-export type OpenClawBrainEmbedderProvider = (typeof ALLOWED_EMBEDDER_PROVIDERS)[number];
-export type OpenClawBrainProviderResolvedNote = string;
-export interface OpenClawBrainProviderDefaultsRecord {
-    contract: typeof OPENCLAWBRAIN_PROVIDER_DEFAULTS_CONTRACT;
-    writtenAt: string;
-    source: "install";
-    teacherBaseUrl?: string;
-    embedderBaseUrl?: string;
-    teacher?: {
-        provider?: OpenClawBrainTeacherProvider;
-        model?: string | null;
-        timeoutMs?: number;
-        maxPromptChars?: number;
-        maxResponseChars?: number;
-        maxOutputTokens?: number;
-        maxArtifactsPerExport?: number;
-        maxInteractionsPerExport?: number;
-        detectedLocally?: boolean;
-        detectedFromModel?: string | null;
-    };
-    embedder?: {
-        provider?: OpenClawBrainEmbedderProvider;
-        model?: string | null;
-    };
-}
-export interface OpenClawBrainProviderDefaultsReadResult {
-    defaults: OpenClawBrainProviderDefaultsRecord | null;
-    warnings: string[];
-}
-export interface ReadOpenClawBrainProviderConfigInput {
-    env?: OpenClawBrainProviderConfigEnv;
-    activationRoot?: string | null;
-    defaults?: OpenClawBrainProviderDefaultsRecord | null;
-}
-export interface OpenClawBrainProviderSelection<TProvider extends string> {
-    provider: TProvider;
-    model: string;
-}
-export interface OpenClawBrainTeacherConfig extends OpenClawBrainProviderSelection<OpenClawBrainTeacherProvider> {
-    timeoutMs?: number;
-    maxPromptChars?: number;
-    maxResponseChars?: number;
-    maxOutputTokens?: number;
-    maxArtifactsPerExport?: number;
-    maxInteractionsPerExport?: number;
-}
-export interface OpenClawBrainProviderConfig {
-    teacherBaseUrl: string;
-    embedderBaseUrl: string;
-    teacher: OpenClawBrainTeacherConfig;
-    embedder: OpenClawBrainProviderSelection<OpenClawBrainEmbedderProvider>;
-    warnings: string[];
-}
-export declare function resolveOpenClawBrainProviderDefaultsPath(activationRoot: string): string;
-export declare function readOpenClawBrainProviderDefaults(activationRoot: string): OpenClawBrainProviderDefaultsReadResult;
-export declare function resolveOpenClawBrainProviderConfigNotes(config: OpenClawBrainProviderConfig): OpenClawBrainProviderResolvedNote[];
-export declare function readOpenClawBrainProviderConfig(env?: OpenClawBrainProviderConfigEnv): OpenClawBrainProviderConfig;
-export declare function readOpenClawBrainProviderConfigFromSources(input?: ReadOpenClawBrainProviderConfigInput): OpenClawBrainProviderConfig;
-export {};