@openclawbrain/openclaw 0.2.3 → 0.3.1

package/README.md

@@ -102,10 +102,11 @@ This package stays fail-open for non-learned-required compile misses, and event-
 Keep `install` as the front-door lifecycle command:
 
 - `openclawbrain install` is the default attach path. On many-profile hosts, pass `--openclaw-home <path>` or set `OPENCLAW_HOME` so the target profile is explicit instead of guessed.
+- `openclawbrain install` now writes only the real profile hook and activation state. It no longer creates `BRAIN.md` or rewrites `AGENTS.md`.
 - `openclawbrain detach --openclaw-home <path>` removes only the OpenClaw profile hook. It preserves OpenClawBrain activation data and now says so plainly in both human output and JSON.
 - `openclawbrain uninstall --openclaw-home <path> --keep-data|--purge-data` removes the profile hook and forces the operator to pick the data outcome explicitly.
 - `--restart <never|safe|external>` is guidance only for detach/uninstall. The default `safe` guidance stays conservative: restart the running OpenClaw profile before expecting hook-state changes to take effect; otherwise the next launch picks them up.
-- plain `status` stays the human answer to “How’s the brain?” and now keeps compact lifecycle truth visible: attachment state, serve state, rollback readiness, backlog frontier, warnings, and a conservative next step.
+- plain `status` stays the human answer to “How’s the brain?” and now keeps compact lifecycle truth visible without dumping teacher/no-op or other proof chatter by default; use `--detailed` when you want the dense operator report.
 
 ## Narrow operator contract
 

package/dist/extension/index.d.ts

@@ -0,0 +1 @@
+export default function register(api: unknown): void;

package/dist/extension/index.js

@@ -0,0 +1,81 @@
+/**
+ * OpenClawBrain extension template — canonical, pre-built, versioned with the package.
+ *
+ * The placeholder __ACTIVATION_ROOT__ is replaced by `openclawbrain install`
+ * with the real activation root path at install time.
+ *
+ * Design constraints:
+ *   - Empty brain → returns empty object (no context injected)
+ *   - Compilation errors → fail-open, never breaks the session
+ *   - Missing activation root → fail-open with console.warn
+ */
+import { fileURLToPath } from "node:url";
+import { compileRuntimeContext } from "@openclawbrain/openclaw";
+import { createBeforePromptBuildHandler, isActivationRootPlaceholder, validateExtensionRegistrationApi } from "./runtime-guard.js";
+const ACTIVATION_ROOT = "__ACTIVATION_ROOT__";
+const EXTENSION_ENTRY_PATH = fileURLToPath(import.meta.url);
+const warnedDiagnostics = new Set();
+function warnOnce(key, message) {
+    if (warnedDiagnostics.has(key)) {
+        return;
+    }
+    warnedDiagnostics.add(key);
+    console.warn(message);
+}
+async function appendLocalDiagnosticLog(message) {
+    try {
+        const fs = await import("fs");
+        const os = await import("os");
+        const rootDir = `${os.homedir()}/.openclawbrain`;
+        const logPath = `${rootDir}/extension-errors.log`;
+        fs.mkdirSync(rootDir, { recursive: true });
+        fs.appendFileSync(logPath, `${new Date().toISOString()} ${message.replace(/\s+/g, " ").trim()}\n`);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        warnOnce(`local-diagnostic-log:${detail}`, `[openclawbrain] failed to append local extension diagnostic log: ${detail}`);
+    }
+}
+async function reportDiagnostic(input) {
+    if (input.once) {
+        if (warnedDiagnostics.has(input.key)) {
+            return;
+        }
+        warnedDiagnostics.add(input.key);
+    }
+    console.warn(input.message);
+    await appendLocalDiagnosticLog(input.message);
+}
+function announceStartupBreadcrumb() {
+    if (isActivationRootPlaceholder(ACTIVATION_ROOT)) {
+        warnOnce("startup-brain-not-yet-loaded", "[openclawbrain] BRAIN NOT YET LOADED: install has not pinned ACTIVATION_ROOT yet. Run: openclawbrain install --openclaw-home <path>");
+        return;
+    }
+    warnOnce("startup-brain-loaded", `[openclawbrain] BRAIN LOADED: runtime hook registered for before_prompt_build (activationRoot=${ACTIVATION_ROOT})`);
+}
+export default function register(api) {
+    const registration = validateExtensionRegistrationApi(api);
+    if (!registration.ok) {
+        void reportDiagnostic(registration.diagnostic);
+        return;
+    }
+    try {
+        registration.api.on("before_prompt_build", createBeforePromptBuildHandler({
+            activationRoot: ACTIVATION_ROOT,
+            extensionEntryPath: EXTENSION_ENTRY_PATH,
+            compileRuntimeContext,
+            reportDiagnostic,
+            debug: (message) => console.debug(message)
+        }), { priority: 5 });
+        announceStartupBreadcrumb();
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.stack ?? error.message : String(error);
+        void reportDiagnostic({
+            key: "registration-failed",
+            once: true,
+            message: `[openclawbrain] extension registration failed: ${detail}`
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/extension/index.js.map

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

package/dist/extension/runtime-guard.d.ts

@@ -0,0 +1,61 @@
+export interface ExtensionCompileInput {
+    activationRoot: string;
+    message: string;
+    sessionId?: string;
+    channel?: string;
+    _serveRouteBreadcrumbs?: {
+        invocationSurface: "installed_extension_before_prompt_build";
+        hostEvent: "before_prompt_build";
+        installedEntryPath: string;
+    };
+}
+export interface ExtensionCompileSuccess {
+    ok: true;
+    brainContext: string;
+}
+export interface ExtensionCompileFailure {
+    ok: false;
+    hardRequirementViolated: boolean;
+    error: string;
+    brainContext: string;
+}
+export type ExtensionCompileResult = ExtensionCompileSuccess | ExtensionCompileFailure;
+export type ExtensionCompileRuntimeContext = (input: ExtensionCompileInput) => ExtensionCompileResult;
+export interface ExtensionDiagnostic {
+    key: string;
+    message: string;
+    once?: boolean;
+}
+export interface ExtensionRegistrationApi {
+    on(eventName: string, handler: (event: unknown, ctx: unknown) => Promise<Record<string, unknown>>, options?: {
+        priority?: number;
+    }): void;
+}
+export interface NormalizedPromptBuildEvent {
+    message: string;
+    sessionId?: string;
+    channel?: string;
+    warnings: ExtensionDiagnostic[];
+}
+export declare function isActivationRootPlaceholder(activationRoot: string): boolean;
+export declare function validateExtensionRegistrationApi(api: unknown): {
+    ok: true;
+    api: ExtensionRegistrationApi;
+} | {
+    ok: false;
+    diagnostic: ExtensionDiagnostic;
+};
+export declare function normalizePromptBuildEvent(event: unknown): {
+    ok: true;
+    event: NormalizedPromptBuildEvent;
+} | {
+    ok: false;
+    diagnostic: ExtensionDiagnostic;
+};
+export declare function createBeforePromptBuildHandler(input: {
+    activationRoot: string;
+    compileRuntimeContext: ExtensionCompileRuntimeContext;
+    reportDiagnostic: (diagnostic: ExtensionDiagnostic) => void | Promise<void>;
+    debug?: (message: string) => void;
+    extensionEntryPath?: string;
+}): (event: unknown, ctx: unknown) => Promise<Record<string, unknown>>;

package/dist/extension/runtime-guard.js

@@ -0,0 +1,230 @@
+export function isActivationRootPlaceholder(activationRoot) {
+    return activationRoot === "__ACTIVATION_" + "ROOT__" || activationRoot.trim().length === 0;
+}
+export function validateExtensionRegistrationApi(api) {
+    if (!isRecord(api) || typeof api.on !== "function") {
+        return {
+            ok: false,
+            diagnostic: {
+                key: "registration-api-invalid",
+                once: true,
+                message: `[openclawbrain] extension inactive: host registration API is missing api.on(event, handler, options) ` +
+                    `(received=${describeValue(api)})`
+            }
+        };
+    }
+    return {
+        ok: true,
+        api: api
+    };
+}
+export function normalizePromptBuildEvent(event) {
+    if (!isRecord(event)) {
+        return {
+            ok: false,
+            diagnostic: failOpenDiagnostic("runtime-event-not-object", "before_prompt_build event is not an object", `event=${describeValue(event)}`)
+        };
+    }
+    const messages = event.messages;
+    if (!Array.isArray(messages)) {
+        return {
+            ok: false,
+            diagnostic: failOpenDiagnostic("runtime-messages-not-array", "before_prompt_build event.messages is not an array", `event=${describeValue(event)} messages=${describeValue(messages)}`)
+        };
+    }
+    const warnings = [];
+    const sessionId = normalizeOptionalScalarField(event.sessionId, "sessionId", warnings);
+    const channel = normalizeOptionalScalarField(event.channel, "channel", warnings);
+    let extractedMessage = "";
+    if (messages.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) ?? "";
+        if (extractedMessage.length === 0) {
+            warnings.push(failOpenDiagnostic("runtime-last-message-invalid", "before_prompt_build last message has no usable text content", `lastMessage=${describeValue(lastMessage)}`));
+        }
+    }
+    return {
+        ok: true,
+        event: {
+            message: extractedMessage,
+            ...(sessionId !== undefined ? { sessionId } : {}),
+            ...(channel !== undefined ? { channel } : {}),
+            warnings
+        }
+    };
+}
+export function createBeforePromptBuildHandler(input) {
+    return async (event, _ctx) => {
+        if (isActivationRootPlaceholder(input.activationRoot)) {
+            await input.reportDiagnostic({
+                key: "activation-root-placeholder",
+                once: true,
+                message: "[openclawbrain] BRAIN NOT YET LOADED: ACTIVATION_ROOT is still a placeholder. Run: openclawbrain install --openclaw-home <path>"
+            });
+            return {};
+        }
+        const normalized = normalizePromptBuildEvent(event);
+        if (!normalized.ok) {
+            await input.reportDiagnostic(normalized.diagnostic);
+            return {};
+        }
+        for (const warning of normalized.event.warnings) {
+            await input.reportDiagnostic(warning);
+        }
+        try {
+            const result = input.compileRuntimeContext({
+                activationRoot: input.activationRoot,
+                message: normalized.event.message,
+                ...(normalized.event.sessionId !== undefined ? { sessionId: normalized.event.sessionId } : {}),
+                ...(normalized.event.channel !== undefined ? { channel: normalized.event.channel } : {}),
+                ...(input.extensionEntryPath === undefined
+                    ? {}
+                    : {
+                        _serveRouteBreadcrumbs: {
+                            invocationSurface: "installed_extension_before_prompt_build",
+                            hostEvent: "before_prompt_build",
+                            installedEntryPath: input.extensionEntryPath
+                        }
+                    })
+            });
+            if (!result.ok) {
+                const mode = result.hardRequirementViolated ? "hard-fail" : "fail-open";
+                await input.reportDiagnostic({
+                    key: `compile-${mode}`,
+                    message: `[openclawbrain] ${mode}: ${result.error} ` +
+                        `(activationRoot=${input.activationRoot}, sessionId=${normalized.event.sessionId ?? "unknown"}, channel=${normalized.event.channel ?? "unknown"})`
+                });
+                return {};
+            }
+            if (result.brainContext.length > 0) {
+                input.debug?.(`[openclawbrain] compiled context, chars: ${result.brainContext.length}`);
+                return {
+                    appendSystemContext: result.brainContext
+                };
+            }
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.stack ?? error.message : String(error);
+            await input.reportDiagnostic({
+                key: "compile-threw",
+                message: `[openclawbrain] compile threw: ${detail} ` +
+                    `(activationRoot=${input.activationRoot}, sessionId=${normalized.event.sessionId ?? "unknown"}, channel=${normalized.event.channel ?? "unknown"})`
+            });
+        }
+        return {};
+    };
+}
+function failOpenDiagnostic(key, reason, detail) {
+    return {
+        key,
+        message: `[openclawbrain] fail-open: ${reason} (${detail})`
+    };
+}
+function normalizeOptionalScalarField(value, fieldName, warnings) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : undefined;
+    }
+    if (typeof value === "number" || typeof value === "bigint" || typeof value === "boolean") {
+        return String(value);
+    }
+    warnings.push({
+        key: `runtime-${fieldName}-ignored`,
+        message: `[openclawbrain] fail-open: ignored unsupported before_prompt_build ${fieldName} ` +
+            `(${fieldName}=${describeValue(value)})`
+    });
+    return undefined;
+}
+function extractPromptMessage(message) {
+    if (typeof message === "string") {
+        return normalizeText(message);
+    }
+    if (!isRecord(message)) {
+        return undefined;
+    }
+    return extractTextContent(message.content);
+}
+function extractTextContent(content) {
+    if (typeof content === "string") {
+        return normalizeText(content);
+    }
+    if (Array.isArray(content)) {
+        const parts = content
+            .map((part) => extractTextPart(part))
+            .filter((part) => part !== undefined);
+        return parts.length > 0 ? parts.join("\n") : undefined;
+    }
+    if (isRecord(content)) {
+        if (typeof content.text === "string") {
+            return normalizeText(content.text);
+        }
+        if (typeof content.content === "string") {
+            return normalizeText(content.content);
+        }
+    }
+    return undefined;
+}
+function extractTextPart(part) {
+    if (typeof part === "string") {
+        return normalizeText(part);
+    }
+    if (!isRecord(part)) {
+        return undefined;
+    }
+    if ("text" in part && typeof part.text === "string") {
+        return normalizeText(part.text);
+    }
+    if ("content" in part && typeof part.content === "string") {
+        return normalizeText(part.content);
+    }
+    return undefined;
+}
+function normalizeText(value) {
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function describeValue(value) {
+    if (value === null) {
+        return "null";
+    }
+    if (Array.isArray(value)) {
+        const itemKinds = Array.from(new Set(value.slice(0, 4).map((entry) => {
+            if (entry === null) {
+                return "null";
+            }
+            if (Array.isArray(entry)) {
+                return "array";
+            }
+            return typeof entry;
+        })));
+        const suffix = value.length > 4 ? ",..." : "";
+        return `array(len=${value.length}, itemKinds=${itemKinds.join("|") || "none"}${suffix})`;
+    }
+    if (typeof value === "string") {
+        const preview = value.replace(/\s+/g, " ").trim().slice(0, 48);
+        const suffix = value.trim().length > 48 ? "..." : "";
+        return `string(len=${value.length}, preview=${JSON.stringify(preview + suffix)})`;
+    }
+    if (typeof value === "object") {
+        const keys = Object.keys(value).slice(0, 6);
+        const suffix = Object.keys(value).length > 6 ? ",..." : "";
+        return `object(keys=${keys.join(",") || "none"}${suffix})`;
+    }
+    if (typeof value === "function") {
+        return "function";
+    }
+    if (typeof value === "symbol") {
+        return `symbol(${String(value.description ?? "")})`;
+    }
+    return `${typeof value}(${String(value)})`;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=runtime-guard.js.map

package/dist/extension/runtime-guard.js.map

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

package/dist/src/cli.d.ts

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 import { type DaemonCliArgs } from "./daemon.js";
-import { createAsyncTeacherLiveLoop, createOpenClawLocalSessionTail, createRuntimeEventExportScanner, type CurrentProfileBrainStatusInput } from "./index.js";
+import { createAsyncTeacherLiveLoop, createOpenClawLocalSessionTail, createRuntimeEventExportScanner, type AsyncTeacherLabelerConfigV1, type CurrentProfileBrainStatusInput } from "./index.js";
 interface ParsedStatusRollbackCliArgs {
     command: "status" | "rollback";
     input: CurrentProfileBrainStatusInput;
+    openclawHome: string | null;
     json: boolean;
     help: boolean;
     dryRun: boolean;
@@ -11,23 +12,29 @@ interface ParsedStatusRollbackCliArgs {
 }
 interface ParsedAttachCliArgs {
     command: "attach";
+    openclawHome: string;
+    openclawHomeSource: "explicit";
     activationRoot: string;
-    packRoot: string;
-    packLabel: string;
+    activationRootSource: ParsedInstallCliArgs["activationRootSource"];
+    shared: boolean;
     workspaceId: string;
-    brainAttachmentPolicy: CurrentProfileBrainStatusInput["brainAttachmentPolicy"];
+    workspaceIdSource: ParsedInstallCliArgs["workspaceIdSource"];
+    skipEmbedderProvision: boolean;
+    skipEmbedderProvisionSource: ParsedInstallCliArgs["skipEmbedderProvisionSource"];
     json: boolean;
     help: boolean;
 }
-interface ParsedSetupCliArgs {
-    command: "install" | "setup";
+interface ParsedInstallCliArgs {
+    command: "install";
     openclawHome: string;
-    openclawHomeSource: "explicit" | "env" | "discovered_single_profile";
+    openclawHomeSource: "explicit" | "env" | "discovered_single_home";
     activationRoot: string;
     activationRootSource: "explicit" | "default_from_openclaw_home";
     shared: boolean;
     workspaceId: string;
-    workspaceIdSource: "explicit" | "openclaw_json_profile" | "openclaw_home_dir" | "fallback";
+    workspaceIdSource: "explicit" | "openclaw_json_profile" | "openclaw_json_single_profile_key" | "current_profile_boundary" | "openclaw_home_dir" | "fallback";
+    skipEmbedderProvision: boolean;
+    skipEmbedderProvisionSource: "flag" | "env" | null;
     json: boolean;
     help: boolean;
 }
@@ -111,13 +118,15 @@ interface ParsedResetCliArgs {
     json: boolean;
     help: boolean;
 }
-type ParsedOperatorCliArgs = ParsedStatusRollbackCliArgs | ParsedAttachCliArgs | ParsedScanCliArgs | ParsedSetupCliArgs | ParsedDetachCliArgs | ParsedUninstallCliArgs | ParsedContextCliArgs | ParsedHistoryCliArgs | ParsedLearnCliArgs | ParsedWatchCliArgs | DaemonCliArgs | ParsedExportCliArgs | ParsedImportCliArgs | ParsedResetCliArgs;
+type ParsedOperatorCliArgs = ParsedStatusRollbackCliArgs | ParsedAttachCliArgs | ParsedScanCliArgs | ParsedInstallCliArgs | ParsedDetachCliArgs | ParsedUninstallCliArgs | ParsedContextCliArgs | ParsedHistoryCliArgs | ParsedLearnCliArgs | ParsedWatchCliArgs | DaemonCliArgs | ParsedExportCliArgs | ParsedImportCliArgs | ParsedResetCliArgs;
 export declare function parseOperatorCliArgs(argv: readonly string[]): ParsedOperatorCliArgs;
 export interface WatchCommandRuntimeV1 {
     activationRoot: string;
     scanRoot: string;
     sessionTailCursorPath: string;
     teacherSnapshotPath: string;
+    startupWarnings: string[];
+    lastTeacherError: string | null;
     replayState: {
         replayedBundleCount: number;
         replayedEventCount: number;
@@ -132,6 +141,7 @@ export interface CreateWatchCommandRuntimeInputV1 {
     scanRoot?: string | null;
     profileRoots?: readonly string[];
     log?: (message: string) => void;
+    teacherLabeler?: AsyncTeacherLabelerConfigV1 | null;
 }
 export interface WatchCommandPassResultV1 {
     localPoll: ReturnType<WatchCommandRuntimeV1["localSessionTail"]["pollOnce"]>;