@openclawbrain/openclaw 0.3.2 → 0.3.3

package/dist/src/index.d.ts

@@ -1,8 +1,9 @@
 import { type CompileSelectionMode } from "@openclawbrain/compiler";
-import { CONTRACT_IDS, type ArtifactManifestV1, type ActivationPointerRecordV1, type ActivationPointerSlot, type RuntimeTurnBrainAttachmentPolicyV1, type ContextCompactionMode, type ContextContributionEvidenceStateV1, type CurrentProfileBrainStatusAnswerV1, type CurrentProfileActivationStateV1, type CurrentProfilePassiveLearningDeltaSummaryV1, type CurrentProfilePassiveLearningWatchStateV1, type BrainServeHotPathTimingV1, type CurrentProfileStructuralDecisionV1, type FeedbackEventKind, type PackGraphConnectDiagnosticsV1, type PackGraphEvolutionV1, type EventSemanticSurfaceV1, type FeedbackEventV1, type KernelSurfaceValidationResultV1, type LearningBootProfile, type LearningCadence, type LearningScanPolicy, type InteractionEventV1, type NormalizedEventExportV1, type NormalizedEventV1, type PrincipalPriorityClassV1, type PrincipalRoleV1, type RouteMode, type RuntimeCompileResponseV1, type RuntimeCompileStructuralSignalsV1, type RuntimeCompileTargetV1, type RuntimeGraphPlasticityStateV1, type RuntimePlasticitySourceV1, type SparseFeedbackPolicyV1, type TeacherAuthorityV1, type TeacherSupervisionArtifactV1, type WorkspaceInjectionSurfaceV1 } from "@openclawbrain/contracts";
+import { CONTRACT_IDS, type ArtifactManifestV1, type ActivationPointerRecordV1, type ActivationPointerSlot, type RuntimeTurnBrainAttachmentPolicyV1, type ContextCompactionMode, type ContextContributionEvidenceStateV1, type CurrentProfileBrainStatusAnswerV1, type CurrentProfileActivationStateV1, type CurrentProfilePassiveLearningDeltaSummaryV1, type CurrentProfilePassiveLearningWatchStateV1, type CurrentProfileAttachmentStateV1, type CurrentProfileAttachmentProofStateV1, type CurrentProfileHookInstallStateV1, type CurrentProfileHookLoadabilityV1, type CurrentProfileHookLoadProofV1, type BrainServeHotPathTimingV1, type CurrentProfileStructuralDecisionV1, type FeedbackEventKind, type PackGraphConnectDiagnosticsV1, type PackGraphEvolutionV1, type EventSemanticSurfaceV1, type FeedbackEventV1, type KernelSurfaceValidationResultV1, type LearningBootProfile, type LearningCadence, type LearningScanPolicy, type InteractionEventV1, type NormalizedEventExportV1, type NormalizedEventV1, type PrincipalPriorityClassV1, type PrincipalRoleV1, type RouteMode, type RuntimeCompileResponseV1, type RuntimeCompileStructuralSignalsV1, type RuntimeCompileTargetV1, type RuntimeGraphPlasticityStateV1, type RuntimePlasticitySourceV1, type SparseFeedbackPolicyV1, type TeacherAuthorityV1, type TeacherSupervisionArtifactV1, type WorkspaceInjectionSurfaceV1 } from "@openclawbrain/contracts";
 import { type EventExportLaneV1 } from "@openclawbrain/event-export";
 import { type AdvanceAlwaysOnLearningRuntimeInput, type AlwaysOnLearningCadenceV1, type AlwaysOnLearningMaterializationJobV1, type AlwaysOnLearningRuntimePlanV1, type AlwaysOnLearningRuntimeStateV1, type BaselineStateV1, type PendingPrincipalEventV1, type PrincipalLearningCheckpointV1 } from "@openclawbrain/learner";
 import { type ActivationInspection, type ActivationObservabilityReport, type GraphEvolutionLogV1, type LearningSpineServeRouteBreadcrumbsV1, type ActivationSlotInspection, type InitHandoffState, type LearningSpineServeRouteDecisionLogEntryV1 } from "@openclawbrain/pack-format";
+export { clearOpenClawProfileRuntimeLoadProof, listOpenClawProfileRuntimeLoadProofs, recordOpenClawProfileRuntimeLoadProof, resolveAttachmentRuntimeLoadProofsPath, type OpenClawProfileRuntimeLoadProofRecordV1, type OpenClawProfileRuntimeLoadProofSetV1, type OpenClawProfileRuntimeLoadProofsV1 } from "./attachment-truth.js";
 import { type AsyncTeacherLabelerConfigV1 } from "./teacher-labeler.js";
 export { createHttpOllamaTeacherLabelerClient, createOllamaTeacherLabeler, createTeacherLabeler, type AsyncTeacherLabelerConfigV1, type AsyncTeacherNoopLabelerConfigV1, type AsyncTeacherOllamaLabelerConfigV1, type OllamaTeacherLabelerClient, type TeacherLabeler, type TeacherLabelerResultV1, type TeacherLabelerRunInputV1 } from "./teacher-labeler.js";
 export declare const DEFAULT_ASYNC_TEACHER_QUEUE_CAPACITY = 8;
@@ -1298,6 +1299,7 @@ export type OperatorBrainState = InitHandoffState | "no_active_pack";
 export type OperatorServePathState = "serving_active_pack" | "fail_open_static_context" | "hard_fail" | "unprobed";
 export interface OperatorSurfaceInput {
     activationRoot: string;
+    openclawHome?: string | null;
     updatedAt?: string | null;
     eventExportPath?: string | null;
     teacherSnapshotPath?: string | null;
@@ -1556,6 +1558,26 @@ export interface OperatorRouteFnFreshnessSummary {
     lastDecisionUsedLearnedRouteFn: boolean | null;
     detail: string;
 }
+interface OperatorHookSummary {
+    scope: "exact_openclaw_home" | "activation_root_only";
+    openclawHome: string | null;
+    hookPath: string | null;
+    runtimeGuardPath: string | null;
+    manifestPath: string | null;
+    installState: CurrentProfileHookInstallStateV1;
+    loadability: CurrentProfileHookLoadabilityV1;
+    loadProof: CurrentProfileHookLoadProofV1;
+    desynced: boolean;
+    detail: string;
+}
+interface OperatorAttachmentTruthSummary {
+    state: CurrentProfileAttachmentStateV1;
+    proofState: CurrentProfileAttachmentProofStateV1;
+    watchOnly: boolean;
+    activationRoot: string | null;
+    servingSlot: "active" | "none";
+    detail: string;
+}
 interface OperatorManyProfileSupportSummary {
     operatorSurface: "current_profile_only";
     declaredAttachmentPolicy: RuntimeTurnBrainAttachmentPolicyV1;
@@ -1621,6 +1643,8 @@ interface OperatorSurfaceReport {
     learning: OperatorLearningSummary;
     teacherLoop: OperatorTeacherLoopSummary;
     routeFn: OperatorRouteFnFreshnessSummary;
+    hook: OperatorHookSummary;
+    attachmentTruth: OperatorAttachmentTruthSummary;
     principal: OperatorPrincipalObservabilitySummary;
     manyProfile: OperatorManyProfileSupportSummary;
     findings: OperatorDoctorFinding[];

package/dist/src/index.js

@@ -7,8 +7,10 @@ import { CONTRACT_IDS, buildEventSemanticSurface, buildNormalizedEventExport, ca
 import { classifyFeedbackSignalContent, describeNormalizedEventExportObservability } from "@openclawbrain/event-export";
 import { DEFAULT_TEACHER_SUPERVISION_STALE_AFTER_MS, advanceAlwaysOnLearningRuntime, buildTeacherSupervisionArtifactsFromNormalizedEventExport, createAlwaysOnLearningRuntimeState, describeAlwaysOnLearningRuntimeState, materializeAlwaysOnLearningCandidatePack, materializeCandidatePackFromNormalizedEventExport } from "@openclawbrain/learner";
 import { LEARNING_SPINE_LOG_LAYOUT, activatePack, describeActivationObservability, describeActivationTarget, describePackCompileTarget, inspectActivationState, loadPackFromActivation, promoteCandidatePack, readLearningSpineLogEntries, rollbackActivePack, stageCandidatePack } from "@openclawbrain/pack-format";
+import { inspectOpenClawBrainHookStatus, summarizeOpenClawBrainHookLoad } from "./openclaw-hook-truth.js";
 import { appendLearningUpdateLogs, appendServeTimeRouteDecisionLog } from "./learning-spine.js";
 import { buildFeedbackSemanticMetadata, buildInteractionSemanticMetadata } from "./semantic-metadata.js";
+export { clearOpenClawProfileRuntimeLoadProof, listOpenClawProfileRuntimeLoadProofs, recordOpenClawProfileRuntimeLoadProof, resolveAttachmentRuntimeLoadProofsPath } from "./attachment-truth.js";
 import { createTeacherLabeler } from "./teacher-labeler.js";
 export { createHttpOllamaTeacherLabelerClient, createOllamaTeacherLabeler, createTeacherLabeler } from "./teacher-labeler.js";
 const DEFAULT_AGENT_ID = "openclaw-runtime";
@@ -6128,6 +6130,18 @@ function buildOperatorFindings(report) {
     const push = (severity, code, summary, detail) => {
         findings.push({ severity, code, summary, detail });
     };
+    if (report.hook.desynced) {
+        push("fail", "hook_desynced", "profile hook is blocked by OpenClaw config desync", report.hook.detail);
+    }
+    else if (report.attachmentTruth.state === "not_attached") {
+        push("fail", "current_profile_not_attached", "current profile is not attached", report.attachmentTruth.detail);
+    }
+    else if (report.attachmentTruth.state === "unknown") {
+        push("warn", "attachment_scope_partial", "current-profile attachment is not self-proven", report.attachmentTruth.detail);
+    }
+    else {
+        push("pass", "current_profile_attached", "current profile hook is present", report.attachmentTruth.detail);
+    }
     if (report.activation.state === "broken_install") {
         push("fail", "activation_broken_install", "activation root is broken", report.activation.detail);
     }
@@ -6338,6 +6352,46 @@ function summarizeCurrentProfilePassiveLearning(report, activePackId) {
         detail
     };
 }
+function summarizeOperatorHook(report) {
+    return summarizeOpenClawBrainHookLoad(inspectOpenClawBrainHookStatus(report.openclawHome ?? null), report.servePath.state === "serving_active_pack");
+}
+function summarizeOperatorAttachmentTruth(report) {
+    const watchOnly = report.active !== null || report.teacherLoop.watchState !== "not_visible";
+    if (report.hook.scope === "exact_openclaw_home") {
+        if (report.hook.installState === "not_installed") {
+            return {
+                state: "not_attached",
+                proofState: "self_proving",
+                watchOnly,
+                activationRoot: null,
+                servingSlot: "none",
+                detail: watchOnly
+                    ? "the selected OpenClaw home has no OpenClawBrain hook, even though this activation root still shows serve/watch activity"
+                    : "the selected OpenClaw home has no OpenClawBrain hook"
+            };
+        }
+        return {
+            state: "attached",
+            proofState: "self_proving",
+            watchOnly: false,
+            activationRoot: report.activationRoot,
+            servingSlot: report.active === null ? "none" : "active",
+            detail: report.hook.installState === "blocked_by_allowlist"
+                ? "current profile hook files exist, but OpenClaw will not load them until the plugin allowlist/config desync is repaired"
+                : "current profile hook is present on the selected OpenClaw home"
+        };
+    }
+    return {
+        state: "unknown",
+        proofState: "activation_root_only",
+        watchOnly,
+        activationRoot: watchOnly ? report.activationRoot : null,
+        servingSlot: report.active === null ? "none" : "active",
+        detail: watchOnly
+            ? "activation-root-only status can see this root serving and/or being watched, but it does not prove that the current profile is attached"
+            : "activation-root-only status cannot prove whether the current profile is attached"
+    };
+}
 function summarizeCurrentProfileBrainSummary(input) {
     const packId = input.activePackId ?? "unknown";
     if (input.activationState === "broken_install") {
@@ -6346,9 +6400,17 @@ function summarizeCurrentProfileBrainSummary(input) {
     if (input.activationState === "stale_incomplete") {
         return "Brain activation has retained stale/incomplete state and no serving active pack.";
     }
-    if (!input.attached) {
+    if (input.attachmentState === "not_attached") {
         return "Brain is not attached to the current Profile.";
     }
+    if (input.hookDesynced) {
+        return "Brain hook files exist, but OpenClaw config currently blocks them from loading.";
+    }
+    if (input.attachmentState === "unknown") {
+        return input.watchOnly
+            ? "This activation root is visible, but current-profile attachment is only watch/serve scoped and not self-proven."
+            : "Current-profile attachment is unknown because this read is activation-root-only.";
+    }
     if (input.serveState === "fail_open_static_context") {
         return "Brain is attached but would fail open to static context.";
     }
@@ -6367,19 +6429,19 @@ function summarizeCurrentProfileBrainSummary(input) {
     return "Brain is attached but has not been compile-probed yet.";
 }
 function summarizeCurrentProfileBrainStatusLevel(input) {
-    if (!input.attached) {
+    if (input.hookDesynced || input.attachmentState === "not_attached") {
         return "fail";
     }
     if (input.serveState === "fail_open_static_context" || input.serveState === "hard_fail") {
         return "fail";
     }
-    if (input.awaitingFirstExport || input.serveState === "unprobed") {
+    if (input.attachmentState === "unknown" || input.awaitingFirstExport || input.serveState === "unprobed") {
         return "warn";
     }
     return input.routeFreshness === "updated" ? "ok" : "warn";
 }
 function buildCurrentProfileTurnAttributionFromReport(report, policyMode, profileId) {
-    if (report.servePath.state === "unprobed") {
+    if (report.servePath.state === "unprobed" || report.attachmentTruth.state !== "attached") {
         return null;
     }
     const brainStatus = report.servePath.state;
@@ -6458,7 +6520,7 @@ function buildCurrentProfileTurnAttributionFromReport(report, policyMode, profil
     };
 }
 function buildCurrentProfileBrainStatusFromReport(report, policyMode, profileId) {
-    const attached = report.active !== null;
+    const attachmentState = report.attachmentTruth.state;
     const awaitingFirstExport = isAwaitingFirstExportSlot(report.active);
     const activationState = report.activation.state;
     const routerIdentity = report.servePath.routerIdentity ?? report.learnedRouting.routerIdentity ?? report.active?.routerIdentity ?? null;
@@ -6468,7 +6530,8 @@ function buildCurrentProfileBrainStatusFromReport(report, policyMode, profileId)
     const activePackId = report.brain.activePackId ?? report.servePath.activePackId ?? report.active?.packId ?? null;
     const passiveLearning = summarizeCurrentProfilePassiveLearning(report, activePackId);
     const status = summarizeCurrentProfileBrainStatusLevel({
-        attached,
+        attachmentState,
+        hookDesynced: report.hook.desynced,
         serveState: report.servePath.state,
         routeFreshness,
         awaitingFirstExport
@@ -6485,13 +6548,15 @@ function buildCurrentProfileBrainStatusFromReport(report, policyMode, profileId)
             noun: "Profile",
             selector: "current_profile",
             profileId,
-            detail: attached
-                ? "The Host resolves the current Profile through the active Attachment boundary only."
-                : "The current Profile has no active Brain attachment visible at the Host boundary."
+            detail: attachmentState === "attached"
+                ? "The Host resolves the current Profile through the selected OpenClaw home and its active Attachment boundary."
+                : attachmentState === "not_attached"
+                    ? "The selected OpenClaw home has no OpenClawBrain hook for the current Profile."
+                    : "This read is activation-root-only, so current-profile attachment is not self-proven."
         },
         brain: {
             noun: "Brain",
-            activationRoot: attached ? report.activationRoot : null,
+            activationRoot: attachmentState === "not_attached" ? null : report.activationRoot,
             logRoot: summarizeCurrentProfileLogRoot(report.activationRoot),
             activePackId,
             initMode: report.learnedRouting.initMode,
@@ -6504,7 +6569,9 @@ function buildCurrentProfileBrainStatusFromReport(report, policyMode, profileId)
             lastPromotionAt: report.promotion.lastPromotion.at,
             summary: summarizeCurrentProfileBrainSummary({
                 activationState,
-                attached,
+                attachmentState,
+                watchOnly: report.attachmentTruth.watchOnly,
+                hookDesynced: report.hook.desynced,
                 serveState: report.servePath.state,
                 brainState: report.brain.state,
                 awaitingFirstExport,
@@ -6515,29 +6582,30 @@ function buildCurrentProfileBrainStatusFromReport(report, policyMode, profileId)
                 ? report.activation.detail
                 : report.brain.detail
         },
-        attachment: attached
-            ? {
-                noun: "Attachment",
-                state: "attached",
-                activationRoot: report.activationRoot,
-                servingSlot: "active",
-                policyMode,
-                policy: buildCurrentProfileAttachmentPolicy(policyMode),
-                detail: policyMode === "shared"
-                    ? "current profile is attached to a shared OpenClawBrain activation boundary"
-                    : policyMode === "dedicated"
-                        ? "current profile is attached to a dedicated OpenClawBrain activation boundary"
-                        : "current profile is attached to an OpenClawBrain activation boundary, but shared-vs-dedicated policy has not been declared"
-            }
-            : {
-                noun: "Attachment",
-                state: "not_attached",
-                activationRoot: null,
-                servingSlot: "none",
-                policyMode,
-                policy: buildCurrentProfileAttachmentPolicy(policyMode),
-                detail: "current profile is not attached to an OpenClawBrain activation boundary"
-            },
+        hook: {
+            noun: "Hook",
+            scope: report.hook.scope,
+            openclawHome: report.hook.openclawHome,
+            hookPath: report.hook.hookPath,
+            runtimeGuardPath: report.hook.runtimeGuardPath,
+            manifestPath: report.hook.manifestPath,
+            installState: report.hook.installState,
+            loadability: report.hook.loadability,
+            loadProof: report.hook.loadProof,
+            desynced: report.hook.desynced,
+            detail: report.hook.detail
+        },
+        attachment: {
+            noun: "Attachment",
+            state: attachmentState,
+            activationRoot: report.attachmentTruth.activationRoot,
+            servingSlot: report.attachmentTruth.servingSlot,
+            policyMode,
+            policy: buildCurrentProfileAttachmentPolicy(policyMode),
+            proofState: report.attachmentTruth.proofState,
+            watchOnly: report.attachmentTruth.watchOnly,
+            detail: report.attachmentTruth.detail
+        },
         brainStatus: {
             status,
             brainState: report.brain.state,
@@ -6550,21 +6618,27 @@ function buildCurrentProfileBrainStatusFromReport(report, policyMode, profileId)
             timing: report.servePath.timing,
             detail: activationState === "broken_install"
                 ? `current profile activation is broken: ${report.activation.detail}`
-                : activationState === "stale_incomplete"
-                    ? `current profile activation is stale/incomplete: ${report.activation.detail}`
-                    : activationState === "detached"
-                        ? "current profile has no attached active pack at the activation boundary"
-                        : report.servePath.state === "serving_active_pack"
-                            ? awaitingFirstExport
-                                ? `current profile is serving seed-state pack ${activePackId ?? "unknown"} while awaiting the first exported turn`
-                                : report.brain.state === "pg_promoted_pack_authoritative"
-                                    ? `current profile is serving promoted pack ${activePackId ?? "unknown"}; serve-visible change came from activation promotion, not hot-path mutation`
-                                    : `current profile is serving active pack ${activePackId ?? "unknown"}; learned routing is active, but authority is still seed-state`
-                            : report.servePath.state === "fail_open_static_context"
-                                ? "current profile would fail open to static context because no serving pack is available"
-                                : report.servePath.state === "hard_fail"
-                                    ? "current profile cannot serve because the learned-route or activation requirement hard-failed"
-                                    : "current profile serve state has not been compile-probed yet"
+                : report.hook.desynced
+                    ? `current profile hook is blocked: ${report.hook.detail}`
+                    : activationState === "stale_incomplete"
+                        ? `current profile activation is stale/incomplete: ${report.activation.detail}`
+                        : attachmentState === "not_attached"
+                            ? "current profile is not attached to this Brain activation root"
+                            : attachmentState === "unknown"
+                                ? "current profile attachment is not self-proven from this activation-root-only read"
+                                : activationState === "detached"
+                                    ? "current profile has no attached active pack at the activation boundary"
+                                    : report.servePath.state === "serving_active_pack"
+                                        ? awaitingFirstExport
+                                            ? `current profile is serving seed-state pack ${activePackId ?? "unknown"} while awaiting the first exported turn`
+                                            : report.brain.state === "pg_promoted_pack_authoritative"
+                                                ? `current profile is serving promoted pack ${activePackId ?? "unknown"}; serve-visible change came from activation promotion, not hot-path mutation`
+                                                : `current profile is serving active pack ${activePackId ?? "unknown"}; learned routing is active, but authority is still seed-state`
+                                        : report.servePath.state === "fail_open_static_context"
+                                            ? "current profile would fail open to static context because no serving pack is available"
+                                            : report.servePath.state === "hard_fail"
+                                                ? "current profile cannot serve because the learned-route or activation requirement hard-failed"
+                                                : "current profile serve state has not been compile-probed yet"
         },
         passiveLearning,
         currentTurnAttribution: buildCurrentProfileTurnAttributionFromReport(report, policyMode, profileId)
@@ -6639,6 +6713,18 @@ export function buildOperatorSurfaceReport(input) {
         activePackId: active?.packId ?? null,
         learnedRouting
     });
+    const teacherLoop = summarizeTeacherLoop(input);
+    const hook = summarizeOperatorHook({
+        activationRoot,
+        openclawHome: normalizeOptionalString(input.openclawHome) ?? null,
+        servePath
+    });
+    const attachmentTruth = summarizeOperatorAttachmentTruth({
+        activationRoot,
+        active,
+        teacherLoop,
+        hook
+    });
     const reportBase = {
         generatedAt: updatedAt,
         activationRoot,
@@ -6679,8 +6765,10 @@ export function buildOperatorSurfaceReport(input) {
         },
         supervision: summarizeSupervision(input),
         learning: summarizeAlwaysOnLearning(input, active),
-        teacherLoop: summarizeTeacherLoop(input),
+        teacherLoop,
         routeFn,
+        hook,
+        attachmentTruth,
         principal: summarizePrincipalObservability(input, active),
         manyProfile: summarizeManyProfileSupport(brainAttachmentPolicy)
     };