@openclawbrain/openclaw 0.2.3 → 0.3.0

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

@@ -4,8 +4,8 @@
  * Resolution order:
  *   1. Explicit `--activation-root <path>` (passed as `explicit` arg)
  *   2. A selected OpenClaw profile home (`openclawHome` option or OPENCLAW_HOME env)
- *   3. Default location: ~/.openclawbrain/activation
- *   4. Scan ~/.openclaw-*​/extensions/openclawbrain/index.ts for hardcoded activation paths
+ *   3. Unpinned host auto-detect from ~/.openclawbrain/activation and installed profile hooks
+ *   4. Refuse clearly if host-local signals disagree or are unresolved
  *   5. Fail with a clear error message
  *
  * Exported for use by CLI commands and other agents' code.
@@ -22,9 +22,12 @@ function normalizeOptionalString(value) {
     const trimmed = value.trim();
     return trimmed.length > 0 ? trimmed : null;
 }
-function buildInstallSetupGuidance() {
+function buildInstallGuidance() {
     return "Run: openclawbrain install --openclaw-home <path>";
 }
+function buildProfilePinningGuidance() {
+    return "Pass --activation-root <path> to pin the brain directly, or --openclaw-home <path> (or OPENCLAW_HOME) to select one installed OpenClaw profile.";
+}
 function extractActivationRootFromExtension(filePath) {
     try {
         const content = readFileSync(filePath, "utf8");
@@ -41,7 +44,7 @@ function extractActivationRootFromExtension(filePath) {
             candidate === "__ACTIVATION_" + "ROOT__") {
             return {
                 activationRoot: null,
-                diagnostic: `installed extension ${filePath} still contains the ACTIVATION_ROOT setup placeholder`
+                diagnostic: `installed extension ${filePath} still contains the ACTIVATION_ROOT placeholder`
             };
         }
         const resolvedCandidate = path.resolve(candidate);
@@ -71,29 +74,56 @@ function readActivationRootFromOpenClawHome(openclawHome) {
     return extractActivationRootFromExtension(extensionIndex);
 }
 /**
- * Scan ~/.openclaw-* directories for extension index.ts files that
- * contain hardcoded activation root paths.
+ * Scan ~/.openclaw-* directories for installed profile hooks and record
+ * either the pinned activation root or the reason the hook is unresolved.
  */
-function scanExtensionsForActivationRoot() {
+function scanInstalledProfileActivationRoots() {
     const homeDir = path.resolve(getHomeDir());
     let entries;
     try {
         entries = readdirSync(homeDir);
     }
     catch {
-        return null;
+        return [];
     }
+    const probes = [];
     for (const entry of entries) {
         if (!entry.startsWith(".openclaw-"))
             continue;
-        const extensionIndex = path.join(homeDir, entry, "extensions", "openclawbrain", "index.ts");
+        const openclawHome = path.join(homeDir, entry);
+        const extensionIndex = path.join(openclawHome, "extensions", "openclawbrain", "index.ts");
         if (!existsSync(extensionIndex))
             continue;
         const found = extractActivationRootFromExtension(extensionIndex);
-        if (found.activationRoot !== null)
-            return found.activationRoot;
+        probes.push({
+            openclawHome: path.resolve(openclawHome),
+            extensionIndex,
+            activationRoot: found.activationRoot,
+            diagnostic: found.diagnostic
+        });
+    }
+    return probes.sort((left, right) => left.openclawHome.localeCompare(right.openclawHome));
+}
+function buildUnpinnedResolutionRefusal(input) {
+    const details = [];
+    const { defaultActivationRoot, installedProfileProbes } = input;
+    if (defaultActivationRoot !== null) {
+        details.push(`  - default HOME root -> ${defaultActivationRoot}`);
+    }
+    for (const probe of installedProfileProbes) {
+        if (probe.activationRoot !== null) {
+            details.push(`  - ${probe.openclawHome} -> ${probe.activationRoot}`);
+            continue;
+        }
+        details.push(`  - ${probe.openclawHome} -> unresolved: ${probe.diagnostic ?? `installed extension ${probe.extensionIndex} is unresolved`}`);
     }
-    return null;
+    return [
+        "Refusing to auto-select an activation root from unpinned host state.",
+        "Detected targets:",
+        ...details,
+        buildProfilePinningGuidance(),
+        buildInstallGuidance()
+    ].join("\n");
 }
 /**
  * Resolve the activation root path through the detection chain.
@@ -120,24 +150,41 @@ export function resolveActivationRoot(options = {}) {
         }
         const selectedActivationRootDiagnostic = selectedActivationRoot?.diagnostic ?? null;
         if (selectedActivationRootDiagnostic !== null) {
-            throw new Error(`OpenClawBrain extension found for OpenClaw profile home ${path.resolve(selectedOpenClawHome)}, but activation root is unresolved: ${selectedActivationRootDiagnostic}. ${buildInstallSetupGuidance()}`);
+            throw new Error(`OpenClawBrain extension found for OpenClaw profile home ${path.resolve(selectedOpenClawHome)}, but activation root is unresolved: ${selectedActivationRootDiagnostic}. ${buildInstallGuidance()}`);
         }
-        throw new Error(`No brain found for OpenClaw profile home ${path.resolve(selectedOpenClawHome)}. ${buildInstallSetupGuidance()}`);
+        throw new Error(`No brain found for OpenClaw profile home ${path.resolve(selectedOpenClawHome)}. ${buildInstallGuidance()}`);
     }
     // 3. Default location: ~/.openclawbrain/activation
     const defaultPath = path.join(getHomeDir(), ".openclawbrain", "activation");
-    if (existsSync(defaultPath)) {
-        return path.resolve(defaultPath);
+    const resolvedDefaultPath = existsSync(defaultPath) ? path.resolve(defaultPath) : null;
+    // 4. Scan installed profile hooks under HOME
+    const installedProfileProbes = scanInstalledProfileActivationRoots();
+    const resolvedCandidateRoots = new Set();
+    const hasUnresolvedInstalledProfiles = installedProfileProbes.some((probe) => probe.activationRoot === null);
+    if (resolvedDefaultPath !== null) {
+        resolvedCandidateRoots.add(resolvedDefaultPath);
     }
-    // 4. Scan extensions
-    const scanned = scanExtensionsForActivationRoot();
-    if (scanned !== null) {
-        return path.resolve(scanned);
+    for (const probe of installedProfileProbes) {
+        if (probe.activationRoot !== null) {
+            resolvedCandidateRoots.add(path.resolve(probe.activationRoot));
+        }
+    }
+    if (resolvedCandidateRoots.size === 1 && !hasUnresolvedInstalledProfiles) {
+        return [...resolvedCandidateRoots][0];
+    }
+    if ((resolvedCandidateRoots.size > 1 || hasUnresolvedInstalledProfiles) && installedProfileProbes.length > 0) {
+        if (quiet) {
+            return "";
+        }
+        throw new Error(buildUnpinnedResolutionRefusal({
+            defaultActivationRoot: resolvedDefaultPath,
+            installedProfileProbes
+        }));
     }
     // 5. Nothing found
     if (quiet) {
         return "";
     }
-    throw new Error(`No brain found. ${buildInstallSetupGuidance()}`);
+    throw new Error(`No brain found. ${buildInstallGuidance()}`);
 }
 //# sourceMappingURL=resolve-activation-root.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"resolve-activation-root.js","sourceRoot":"","sources":["../../src/resolve-activation-root.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resolve-activation-root.js","sourceRoot":"","sources":["../../src/resolve-activation-root.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,40 @@
+export interface InstalledExtensionPackageJson {
+    name?: unknown;
+    version?: unknown;
+    private?: unknown;
+    type?: unknown;
+    openclaw?: {
+        extensions?: unknown;
+    };
+    dependencies?: Record<string, string>;
+}
+export interface InstalledPluginManifest {
+    id?: unknown;
+    name?: unknown;
+    description?: unknown;
+    version?: unknown;
+    configSchema?: unknown;
+}
+export interface ShadowProfileExtensionInstall {
+    openclawHome: string;
+    extensionsDir: string;
+    extensionDir: string;
+    manifestPath: string;
+    packageJsonPath: string;
+    loaderEntryPath: string;
+    runtimeGuardPath: string;
+    manifest: InstalledPluginManifest;
+    packageJson: InstalledExtensionPackageJson;
+    configuredEntries: string[];
+}
+export interface ShadowProfileExtensionLoadProof extends ShadowProfileExtensionInstall {
+    runtimeGuardExportNames: string[];
+    registeredEventName: string;
+    registeredPriority: number | null;
+    probeWarning: string;
+    probeResult: Record<string, unknown>;
+    diagnosticLogPath: string;
+    diagnosticLogContents: string;
+}
+export declare function inspectInstalledOpenClawBrainExtension(openclawHome: string, extensionId?: string): ShadowProfileExtensionInstall;
+export declare function proveInstalledOpenClawBrainExtensionLoad(openclawHome: string, extensionId?: string): Promise<ShadowProfileExtensionLoadProof>;

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

@@ -0,0 +1,214 @@
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+const REQUIRED_RUNTIME_GUARD_EXPORTS = [
+    "createBeforePromptBuildHandler",
+    "isActivationRootPlaceholder",
+    "normalizePromptBuildEvent",
+    "validateExtensionRegistrationApi"
+];
+export function inspectInstalledOpenClawBrainExtension(openclawHome, extensionId = "openclawbrain") {
+    const resolvedOpenclawHome = path.resolve(openclawHome);
+    const extensionsDir = path.join(resolvedOpenclawHome, "extensions");
+    const extensionDir = path.join(extensionsDir, extensionId);
+    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}`);
+    }
+    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} ` +
+            `(received=${describeValue(manifest.id)})`);
+    }
+    if (typeof manifest.version !== "string" || manifest.version.trim().length === 0) {
+        throw new Error(`[shadow-extension-load-proof] Plugin manifest version must be a non-empty string at ${manifestPath}`);
+    }
+    const packageJson = readRequiredJson(packageJsonPath, "package manifest");
+    const configuredEntries = readConfiguredEntries(packageJson, packageJsonPath);
+    const loaderEntryPath = resolveLoaderEntryPath(extensionDir, configuredEntries);
+    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 (typeof packageJson.version === "string" &&
+        packageJson.version.trim().length > 0 &&
+        packageJson.version !== manifest.version) {
+        throw new Error(`[shadow-extension-load-proof] Installed package and plugin manifest versions disagree ` +
+            `(package=${packageJson.version}, manifest=${manifest.version})`);
+    }
+    return {
+        openclawHome: resolvedOpenclawHome,
+        extensionsDir,
+        extensionDir,
+        manifestPath,
+        packageJsonPath,
+        loaderEntryPath,
+        runtimeGuardPath,
+        manifest,
+        packageJson,
+        configuredEntries
+    };
+}
+export async function proveInstalledOpenClawBrainExtensionLoad(openclawHome, extensionId = "openclawbrain") {
+    const inspected = inspectInstalledOpenClawBrainExtension(openclawHome, extensionId);
+    const runtimeGuardModule = await importWithHelpfulError(inspected.runtimeGuardPath, "runtime-guard.js");
+    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");
+    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)})`);
+    }
+    const registrations = [];
+    loaderModule.default({
+        on(eventName, handler, options) {
+            registrations.push({
+                eventName,
+                handler,
+                priority: typeof options?.priority === "number" ? options.priority : null
+            });
+        }
+    });
+    if (registrations.length !== 1) {
+        throw new Error(`[shadow-extension-load-proof] Installed loader must register exactly one hook ` +
+            `(received=${registrations.length})`);
+    }
+    const registeredHook = registrations[0];
+    if (registeredHook.eventName !== "before_prompt_build") {
+        throw new Error(`[shadow-extension-load-proof] Installed loader must register before_prompt_build ` +
+            `(received=${JSON.stringify(registeredHook.eventName)})`);
+    }
+    if (registeredHook.priority !== 5) {
+        throw new Error(`[shadow-extension-load-proof] Installed loader must register before_prompt_build with priority 5 ` +
+            `(received=${registeredHook.priority === null ? "null" : String(registeredHook.priority)})`);
+    }
+    const warnings = [];
+    const originalWarn = console.warn;
+    console.warn = (...args) => {
+        warnings.push(args.map((value) => String(value)).join(" "));
+    };
+    let probeResult;
+    try {
+        probeResult = await registeredHook.handler({
+            messages: {
+                content: "not-an-array"
+            }
+        }, {});
+    }
+    finally {
+        console.warn = originalWarn;
+    }
+    if (!isRecord(probeResult) || Object.keys(probeResult).length !== 0) {
+        throw new Error(`[shadow-extension-load-proof] Malformed before_prompt_build probe must fail open with an empty object ` +
+            `(received=${describeValue(probeResult)})`);
+    }
+    const probeWarning = warnings.find((message) => message.includes("before_prompt_build event.messages is not an array"));
+    if (probeWarning === undefined) {
+        throw new Error(`[shadow-extension-load-proof] Installed runtime-guard did not emit the expected malformed-event diagnostic ` +
+            `(warnings=${warnings.length === 0 ? "none" : warnings.join(" | ")})`);
+    }
+    const diagnosticLogPath = path.join(homedir(), ".openclawbrain", "extension-errors.log");
+    if (!existsSync(diagnosticLogPath)) {
+        throw new Error(`[shadow-extension-load-proof] Installed runtime-guard did not write a local diagnostic log at ${diagnosticLogPath}`);
+    }
+    const diagnosticLogContents = readFileSync(diagnosticLogPath, "utf8");
+    if (!diagnosticLogContents.includes("before_prompt_build event.messages is not an array")) {
+        throw new Error(`[shadow-extension-load-proof] Local diagnostic log at ${diagnosticLogPath} does not contain the malformed-event failure`);
+    }
+    return {
+        ...inspected,
+        runtimeGuardExportNames,
+        registeredEventName: registeredHook.eventName,
+        registeredPriority: registeredHook.priority,
+        probeWarning,
+        probeResult,
+        diagnosticLogPath,
+        diagnosticLogContents
+    };
+}
+function readRequiredJson(filePath, label) {
+    let raw;
+    try {
+        raw = readFileSync(filePath, "utf8");
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`[shadow-extension-load-proof] Failed to read ${label} at ${filePath}: ${detail}`);
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`[shadow-extension-load-proof] Failed to parse ${label} at ${filePath}: ${detail}`);
+    }
+}
+function readConfiguredEntries(packageJson, packageJsonPath) {
+    const extensions = packageJson.openclaw?.extensions;
+    if (!Array.isArray(extensions)) {
+        throw new Error(`[shadow-extension-load-proof] Installed package manifest must expose openclaw.extensions as a non-empty string array at ${packageJsonPath} ` +
+            `(received=${describeValue(extensions)})`);
+    }
+    const configuredEntries = extensions.filter((entry) => typeof entry === "string" && entry.trim().length > 0);
+    if (configuredEntries.length === 0) {
+        throw new Error(`[shadow-extension-load-proof] Installed package manifest openclaw.extensions is empty at ${packageJsonPath}`);
+    }
+    return configuredEntries;
+}
+function resolveLoaderEntryPath(extensionDir, configuredEntries) {
+    for (const configuredEntry of configuredEntries) {
+        const candidate = path.join(extensionDir, configuredEntry);
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    throw new Error(`[shadow-extension-load-proof] Installed package manifest points at missing loader entries in ${extensionDir} ` +
+        `(configured=${configuredEntries.join(", ")})`);
+}
+async function importWithHelpfulError(filePath, label) {
+    try {
+        return await import(pathToFileURL(filePath).href);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.stack ?? error.message : String(error);
+        throw new Error(`[shadow-extension-load-proof] Installed ${label} failed to import from ${filePath}: ${detail}`);
+    }
+}
+function describeValue(value) {
+    if (value === null) {
+        return "null";
+    }
+    if (Array.isArray(value)) {
+        return `array(len=${value.length})`;
+    }
+    if (typeof value === "string") {
+        return `string(${JSON.stringify(value)})`;
+    }
+    if (typeof value === "object") {
+        return `object(keys=${Object.keys(value).join(",") || "none"})`;
+    }
+    return `${typeof value}(${String(value)})`;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=shadow-extension-proof.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-extension-proof.js","sourceRoot":"","sources":["../../src/shadow-extension-proof.ts"],"names":[],"mappings":"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"}

package/dist/src/teacher-labeler.d.ts

@@ -0,0 +1,50 @@
+import { type NormalizedEventExportV1, type TeacherSupervisionArtifactV1 } from "@openclawbrain/contracts";
+import type { LearningSpineServeRouteDecisionLogEntryV1 } from "@openclawbrain/pack-format";
+export interface TeacherLabelerRunInputV1 {
+    normalizedEventExport: NormalizedEventExportV1;
+    observedAt: string;
+    staleAfterMs: number;
+    serveTimeDecisions?: readonly LearningSpineServeRouteDecisionLogEntryV1[];
+    existingArtifacts?: readonly TeacherSupervisionArtifactV1[];
+}
+export interface TeacherLabelerResultV1 {
+    artifacts: TeacherSupervisionArtifactV1[];
+    status: "ok" | "skipped" | "fail_open";
+    detail: string;
+}
+export interface TeacherLabeler {
+    label(input: TeacherLabelerRunInputV1): Promise<TeacherLabelerResultV1>;
+}
+export interface OllamaTeacherLabelerGenerateInputV1 {
+    model: string;
+    prompt: string;
+    maxOutputTokens: number;
+    timeoutMs: number;
+}
+export interface OllamaTeacherLabelerClient {
+    generate(input: OllamaTeacherLabelerGenerateInputV1): Promise<{
+        response: string;
+    }>;
+}
+export interface AsyncTeacherOllamaLabelerConfigV1 {
+    provider: "ollama";
+    baseUrl?: string;
+    model?: string;
+    timeoutMs?: number;
+    maxPromptChars?: number;
+    maxResponseChars?: number;
+    maxOutputTokens?: number;
+    maxArtifactsPerExport?: number;
+    maxInteractionsPerExport?: number;
+    maxUserMessageChars?: number;
+    maxContextIdsPerDecision?: number;
+    teacherIdentity?: string;
+    client?: OllamaTeacherLabelerClient;
+}
+export interface AsyncTeacherNoopLabelerConfigV1 {
+    provider: "none";
+}
+export type AsyncTeacherLabelerConfigV1 = AsyncTeacherNoopLabelerConfigV1 | AsyncTeacherOllamaLabelerConfigV1;
+export declare function createHttpOllamaTeacherLabelerClient(baseUrl?: string): OllamaTeacherLabelerClient;
+export declare function createOllamaTeacherLabeler(config: AsyncTeacherOllamaLabelerConfigV1): TeacherLabeler;
+export declare function createTeacherLabeler(config: AsyncTeacherLabelerConfigV1 | null | undefined): TeacherLabeler | null;