@openclawbrain/openclaw 0.1.10 → 0.1.12

package/dist/src/index.d.ts

@@ -1,6 +1,7 @@
-import { CONTRACT_IDS, type ArtifactManifestV1, type ActivationPointerRecordV1, type ActivationPointerSlot, type RuntimeTurnBrainAttachmentPolicyV1, type ContextCompactionMode, type ContextContributionEvidenceStateV1, type CurrentProfileBrainStatusAnswerV1, type FeedbackEventKind, type FeedbackEventV1, type KernelSurfaceValidationResultV1, type LearningBootProfile, type InteractionEventV1, type NormalizedEventExportV1, type NormalizedEventV1, type RouteMode, type RuntimeCompileResponseV1, type RuntimeCompileTargetV1, type RuntimeGraphPlasticityStateV1, type RuntimePlasticitySourceV1, type SparseFeedbackPolicyV1, 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 CurrentProfileStructuralDecisionV1, type FeedbackEventKind, type PackGraphEvolutionV1, type FeedbackEventV1, type KernelSurfaceValidationResultV1, type LearningBootProfile, 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 PendingPrincipalEventV1, type PrincipalLearningCheckpointV1 } from "@openclawbrain/learner";
-import { type ActivationInspection, type ActivationObservabilityReport, type ActivationSlotInspection, type InitHandoffState } from "@openclawbrain/pack-format";
+import { type ActivationInspection, type ActivationObservabilityReport, type GraphEvolutionLogV1, type ActivationSlotInspection, type InitHandoffState } from "@openclawbrain/pack-format";
 export declare const DEFAULT_ASYNC_TEACHER_QUEUE_CAPACITY = 8;
 declare const RECORDED_SESSION_TRACE_CONTRACT: "recorded_session_trace.v1";
 declare const RECORDED_SESSION_FIXTURE_CONTRACT: "recorded_session_replay_fixture.v1";
@@ -20,6 +21,38 @@ export interface RuntimeEventExportBundleSummaryV1 {
     sourceStreams: string[];
     contracts: NormalizedEventExportV1["provenance"]["contracts"];
 }
+export type ScannerExportStatusV1 = "complete" | "partial" | "failed";
+export interface ScannerExportManifestV1 {
+    scannerId: string;
+    lane: string;
+    status: ScannerExportStatusV1;
+    producedAt: string;
+    sourceManifestPath: string | null;
+    sourceManifestDigest: string | null;
+    warnings: string[];
+    failures: string[];
+}
+export interface ScannedEventExportInputV1 {
+    interactionEvents: readonly InteractionEventV1[];
+    feedbackEvents: readonly FeedbackEventV1[];
+    scanner: ScannerExportManifestV1;
+}
+export type ScannedEventExportNoopReasonV1 = "scan_failed" | "no_events" | "invalid_scanner_manifest";
+export interface ScannedEventExportBuildSuccessV1 {
+    ok: true;
+    normalizedEventExport: NormalizedEventExportV1;
+    scanner: ScannerExportManifestV1;
+    warnings: string[];
+}
+export interface ScannedEventExportBuildFailureV1 {
+    ok: false;
+    normalizedEventExport: null;
+    scanner: ScannerExportManifestV1;
+    warnings: string[];
+    reason: ScannedEventExportNoopReasonV1;
+    error: string;
+}
+export type ScannedEventExportBuildResultV1 = ScannedEventExportBuildSuccessV1 | ScannedEventExportBuildFailureV1;
 export interface RuntimeEventExportBundleManifestV1 {
     contract: typeof RUNTIME_EVENT_EXPORT_BUNDLE_CONTRACT;
     exportName: string;
@@ -27,6 +60,7 @@ export interface RuntimeEventExportBundleManifestV1 {
     payloadPath: string;
     payloadDigest: string;
     summary: RuntimeEventExportBundleSummaryV1;
+    scanner?: ScannerExportManifestV1 | null;
 }
 export interface RuntimeEventExportBundleDescriptor {
     rootDir: string;
@@ -35,11 +69,13 @@ export interface RuntimeEventExportBundleDescriptor {
     manifest: RuntimeEventExportBundleManifestV1;
     normalizedEventExport: NormalizedEventExportV1;
 }
+export type CompileRuntimeBudgetStrategy = "fixed_v1" | "empirical_v1";
 export interface CompileRuntimeContextInput {
     activationRoot: string;
     message: string;
     agentId?: string;
     maxContextBlocks?: number;
+    budgetStrategy?: CompileRuntimeBudgetStrategy;
     maxContextChars?: number;
     mode?: RouteMode;
     compactionMode?: ContextCompactionMode;
@@ -185,7 +221,9 @@ export interface RollbackRuntimeAttachResult {
     parkedCandidatePackId: string | null;
 }
 export interface BootstrapRuntimeAttachInput {
-    profileSelector?: "current_profile";
+    profileSelector?: string | null;
+    profileId?: string | null;
+    brainAttachmentPolicy?: RuntimeTurnBrainAttachmentPolicyV1 | null;
     activationRoot: string;
     packRoot: string;
     packLabel: string;
@@ -208,7 +246,8 @@ export interface BootstrapRuntimeAttachNextStepV1 {
 }
 export interface BootstrapRuntimeAttachResult {
     runtimeOwner: "openclaw";
-    profileSelector: "current_profile";
+    profileSelector: string;
+    operatorReadScope: "current_profile_only";
     activationRoot: string;
     packRoot: string;
     packId: string;
@@ -237,25 +276,38 @@ export interface RuntimeTurnFeedbackInput {
     kind?: FeedbackEventKind | null;
     messageId?: string | null;
     relatedInteractionId?: string | null;
+    actorName?: string | null;
+    priorityHint?: PrincipalPriorityClassV1 | null;
 }
 export interface RuntimeTurnExportInput {
     rootDir: string;
     exportName?: string | null;
     exportedAt?: string | null;
 }
+export interface RuntimeTurnContextFingerprintInputV1 {
+    promptContextFingerprints?: readonly string[] | null;
+    workspaceInjectionSurface?: WorkspaceInjectionSurfaceV1 | null;
+    profileLineage?: readonly string[] | null;
+    sessionLineage?: readonly string[] | null;
+}
 export interface OpenClawRuntimeTurnInput {
     activationRoot?: string | null;
     agentId?: string | null;
+    profileSelector?: string | null;
+    profileId?: string | null;
     sessionId: string;
     channel: string;
+    userId?: string | null;
     sourceStream?: string | null;
     userMessage: string;
     createdAt?: string | null;
     sequenceStart?: number | null;
     maxContextBlocks?: number;
+    budgetStrategy?: CompileRuntimeBudgetStrategy;
     mode?: RouteMode;
     runtimeHints?: readonly string[];
     brainAttachmentPolicy?: RuntimeTurnBrainAttachmentPolicyV1 | null;
+    contextFingerprint?: RuntimeTurnContextFingerprintInputV1 | null;
     compile?: RuntimeTurnCompileInput | null;
     delivery?: boolean | RuntimeTurnDeliveryInput | null;
     feedback?: readonly (RuntimeTurnFeedbackInput | null)[] | null;
@@ -289,7 +341,7 @@ export type RuntimeTurnResult = RuntimeCompileResult & {
     eventExport: RuntimeEventExportResult;
     warnings: string[];
 };
-export type TeacherLoopNoOpReason = "none" | "duplicate_export" | "queue_full" | "no_teacher_artifacts";
+export type TeacherLoopNoOpReason = "none" | "duplicate_export" | "queue_full" | "no_teacher_artifacts" | "empty_scan";
 export interface AsyncTeacherLiveLoopInput extends Pick<AdvanceAlwaysOnLearningRuntimeInput, "packLabel" | "workspace" | "learnedRouting" | "builtAt" | "offlineArtifacts" | "structuralOps" | "sparseFeedback" | "liveSliceSize" | "backfillSliceSize" | "cadence"> {
     maxQueuedExports?: number;
     staleAfterMs?: number;
@@ -337,6 +389,45 @@ export interface AsyncTeacherEnqueueResultV1 {
     notes: string[];
     reason: Exclude<TeacherLoopNoOpReason, "none"> | null;
 }
+export interface AsyncTeacherScannedEnqueueResultV1 {
+    accepted: boolean;
+    exportDigest: string | null;
+    queueDepth: number;
+    notes: string[];
+    reason: Exclude<TeacherLoopNoOpReason, "none"> | ScannedEventExportNoopReasonV1 | null;
+    warnings: string[];
+    error: string | null;
+    scanner: ScannerExportManifestV1;
+}
+export type AsyncTeacherScannerScanNoOpReasonV1 = "none" | "empty_scan" | "duplicate_exports" | "queue_full";
+export interface AsyncTeacherScannerScanHitResultV1 {
+    lane: EventExportLaneV1;
+    exportDigest: string;
+    exportName: string;
+    exportedAt: string;
+    eventRange: Pick<NormalizedEventExportV1["range"], "start" | "end" | "count">;
+    accepted: boolean;
+    queueDepth: number;
+    reason: AsyncTeacherEnqueueResultV1["reason"];
+}
+export interface AsyncTeacherScannerScanResultV1 {
+    runtimeOwner: "openclaw";
+    scanRoot: string;
+    scannedAt: string;
+    selectedCount: number;
+    acceptedCount: number;
+    duplicateCount: number;
+    droppedCount: number;
+    liveAcceptedCount: number;
+    backfillAcceptedCount: number;
+    duplicateScannerDigestCount: number;
+    staleSkippedCount: number;
+    invalidBundleCount: number;
+    noOpReason: AsyncTeacherScannerScanNoOpReasonV1;
+    notes: string[];
+    results: AsyncTeacherScannerScanHitResultV1[];
+    snapshot: AsyncTeacherLiveLoopSnapshotV1;
+}
 export interface CanonicalSupervisionFeedbackRecordV1 {
     eventId: string;
     kind: FeedbackEventKind;
@@ -459,6 +550,10 @@ export declare class AsyncTeacherLiveLoop {
     enqueueNormalizedEventExport(normalizedEventExport: NormalizedEventExportV1, options?: {
         observedAt?: string;
     }): AsyncTeacherEnqueueResultV1;
+    enqueueScannedEventExport(scannedEventExport: ScannedEventExportInputV1, options?: {
+        observedAt?: string;
+    }): AsyncTeacherScannedEnqueueResultV1;
+    ingestRuntimeEventExportScannerScan(scan: RuntimeEventExportScannerScanResultV1): Promise<AsyncTeacherScannerScanResultV1>;
     flush(): Promise<AsyncTeacherLiveLoopSnapshotV1>;
     snapshot(): AsyncTeacherLiveLoopSnapshotV1;
     private ensureDrain;
@@ -466,23 +561,263 @@ export declare class AsyncTeacherLiveLoop {
     private refreshNotes;
 }
 export declare function createAsyncTeacherLiveLoop(input: AsyncTeacherLiveLoopInput): AsyncTeacherLiveLoop;
+export interface ScannerLiveWorkspaceInputV1 {
+    workspaceId: string;
+    snapshotId: string;
+    capturedAt: string;
+    rootDir: string;
+    branch?: string | null;
+    revision?: string | null;
+    dirty?: boolean;
+    manifestDigest?: string | null;
+    labels?: readonly string[];
+    files?: readonly string[];
+}
+export interface ScanRecordedSessionInputV1 {
+    rootDir: string;
+    trace: RecordedSessionTraceV1;
+}
+export interface ScanRecordedSessionResultV1 {
+    runtimeOwner: "openclaw";
+    scanMode: "session";
+    rootDir: string;
+    fixtureHash: string;
+    bundle: RecordedSessionReplayBundleV1;
+}
+export interface ScanLiveEventExportInputV1 {
+    normalizedEventExport: NormalizedEventExportV1;
+    workspace: ScannerLiveWorkspaceInputV1;
+    packLabel?: string | null;
+    observedAt?: string | null;
+    builtAt?: string | null;
+    learnedRouting?: boolean;
+    staleAfterMs?: number;
+    liveSliceSize?: number;
+    backfillSliceSize?: number;
+}
+export interface ScanLiveEventExportResultV1 {
+    runtimeOwner: "openclaw";
+    scanMode: "live";
+    observedAt: string;
+    packLabel: string;
+    supervision: CanonicalSupervisionV1;
+    snapshot: AsyncTeacherLiveLoopSnapshotV1;
+}
+export declare function scanRecordedSession(input: ScanRecordedSessionInputV1): ScanRecordedSessionResultV1;
+export declare function scanLiveEventExport(input: ScanLiveEventExportInputV1): ScanLiveEventExportResultV1;
 export declare function buildRuntimeEventExportBundleManifest(input: {
     exportName: string;
     exportedAt: string;
     payloadPath: string;
     normalizedEventExport: NormalizedEventExportV1;
+    scanner?: ScannerExportManifestV1 | null;
 }): RuntimeEventExportBundleManifestV1;
 export declare function validateRuntimeEventExportBundleManifest(value: RuntimeEventExportBundleManifestV1, normalizedEventExport?: NormalizedEventExportV1): string[];
 export declare function loadRuntimeEventExportBundle(rootDir: string): RuntimeEventExportBundleDescriptor;
+export declare function buildNormalizedEventExportFromScannedEvents(input: ScannedEventExportInputV1): ScannedEventExportBuildResultV1;
+declare const RUNTIME_EVENT_EXPORT_SCANNER_CHECKPOINT_CONTRACT: "runtime_event_export_scanner_checkpoint.v1";
+export declare const DEFAULT_RUNTIME_EVENT_EXPORT_SCANNER_LIVE_TAIL_BUNDLES = 2;
+export declare const DEFAULT_RUNTIME_EVENT_EXPORT_SCANNER_BACKFILL_BUNDLES_PER_PASS = 1;
+export declare const DEFAULT_RUNTIME_EVENT_EXPORT_SCANNER_STALE_HISTORY_MS: number;
+export declare const DEFAULT_RUNTIME_EVENT_EXPORT_SCANNER_CHECKPOINT_BASENAME = ".openclawbrain-scanner-checkpoint.json";
+export interface RuntimeEventExportScannerBundleCursorV1 {
+    exportDigest: string;
+    exportName: string;
+    exportedAt: string;
+    eventRange: Pick<NormalizedEventExportV1["range"], "start" | "end" | "count">;
+}
+export interface RuntimeEventExportScannerCheckpointV1 {
+    contract: typeof RUNTIME_EVENT_EXPORT_SCANNER_CHECKPOINT_CONTRACT;
+    runtimeOwner: "openclaw";
+    scanRoot: string;
+    updatedAt: string;
+    live: {
+        after: RuntimeEventExportScannerBundleCursorV1 | null;
+    };
+    backfill: {
+        before: RuntimeEventExportScannerBundleCursorV1 | null;
+        exhausted: boolean;
+        staleBefore: string | null;
+    };
+    processedExportDigests: string[];
+    stats: {
+        scanPasses: number;
+        liveBundlesScanned: number;
+        backfillBundlesScanned: number;
+        duplicateBundlesSkipped: number;
+        staleBundlesSkipped: number;
+        invalidBundlesSkipped: number;
+    };
+}
+export interface RuntimeEventExportScannerInput {
+    scanRoot: string;
+    checkpointPath?: string;
+    liveTailBundles?: number;
+    backfillBundlesPerPass?: number;
+    staleHistoryMs?: number;
+}
+export interface RuntimeEventExportScannerInvalidBundleV1 {
+    rootDir: string;
+    error: string;
+}
+export type RuntimeEventExportScannerPriorityBucketV1 = "live" | "principal_backfill" | "backfill" | "stale_history";
+export interface RuntimeEventExportScannerQueueEntryV1 {
+    lane: EventExportLaneV1;
+    rootDir: string;
+    exportDigest: string;
+    exportName: string;
+    exportedAt: string;
+    eventRange: Pick<NormalizedEventExportV1["range"], "start" | "end" | "count">;
+    priorityBucket: RuntimeEventExportScannerPriorityBucketV1;
+    priorityScore: number;
+    priorityReasons: string[];
+    humanLabelCount: number;
+    feedbackCount: number;
+    teacherRoles: PrincipalRoleV1[];
+    teacherAuthorities: TeacherAuthorityV1[];
+    priorityClasses: PrincipalPriorityClassV1[];
+    scopedPrincipalEventCount: number;
+    supersedingPrincipalEventCount: number;
+    staleHistory: boolean;
+    ageMsFromLatest: number | null;
+}
+export interface RuntimeEventExportScannerHitV1 {
+    lane: EventExportLaneV1;
+    rootDir: string;
+    exportDigest: string;
+    exportName: string;
+    exportedAt: string;
+    eventRange: Pick<NormalizedEventExportV1["range"], "start" | "end" | "count">;
+    priorityBucket: RuntimeEventExportScannerPriorityBucketV1;
+    priorityScore: number;
+    priorityReasons: string[];
+    humanLabelCount: number;
+    feedbackCount: number;
+    teacherRoles: PrincipalRoleV1[];
+    teacherAuthorities: TeacherAuthorityV1[];
+    priorityClasses: PrincipalPriorityClassV1[];
+    scopedPrincipalEventCount: number;
+    supersedingPrincipalEventCount: number;
+    staleHistory: boolean;
+    ageMsFromLatest: number | null;
+    normalizedEventExport: NormalizedEventExportV1;
+}
+export interface RuntimeEventExportScannerQueueV1 {
+    ageFloor: {
+        newestExportedAt: string | null;
+        staleBefore: string | null;
+        staleHistoryMs: number;
+    };
+    live: RuntimeEventExportScannerQueueEntryV1[];
+    backfill: RuntimeEventExportScannerQueueEntryV1[];
+    staleHistory: RuntimeEventExportScannerQueueEntryV1[];
+}
+export interface RuntimeEventExportScannerScanResultV1 {
+    runtimeOwner: "openclaw";
+    scanRoot: string;
+    checkpointPath: string;
+    scannedAt: string;
+    live: RuntimeEventExportScannerHitV1[];
+    backfill: RuntimeEventExportScannerHitV1[];
+    selected: RuntimeEventExportScannerHitV1[];
+    queue: RuntimeEventExportScannerQueueV1;
+    duplicateExportDigests: string[];
+    staleSkippedExportDigests: string[];
+    invalidBundles: RuntimeEventExportScannerInvalidBundleV1[];
+    idle: boolean;
+    checkpoint: RuntimeEventExportScannerCheckpointV1;
+}
+export interface RuntimeEventExportScannerLoopOptionsV1 {
+    pollIntervalMs?: number;
+    maxPasses?: number;
+    stopWhenIdle?: boolean;
+    signal?: AbortSignal;
+    onPass?: (result: RuntimeEventExportScannerScanResultV1) => void | Promise<void>;
+}
+export interface RuntimeEventExportScannerLoopResultV1 {
+    runtimeOwner: "openclaw";
+    passCount: number;
+    liveBundlesScanned: number;
+    backfillBundlesScanned: number;
+    stoppedReason: "idle" | "max_passes" | "aborted";
+    lastScan: RuntimeEventExportScannerScanResultV1 | null;
+    checkpoint: RuntimeEventExportScannerCheckpointV1;
+}
+export declare function createRuntimeEventExportScannerCheckpoint(input: {
+    scanRoot: string;
+    updatedAt?: string;
+}): RuntimeEventExportScannerCheckpointV1;
+export declare function validateRuntimeEventExportScannerCheckpoint(value: RuntimeEventExportScannerCheckpointV1): string[];
+export declare function loadRuntimeEventExportScannerCheckpoint(checkpointPath: string): RuntimeEventExportScannerCheckpointV1;
+export declare class RuntimeEventExportScanner {
+    readonly scanRoot: string;
+    readonly checkpointPath: string;
+    readonly liveTailBundles: number;
+    readonly backfillBundlesPerPass: number;
+    readonly staleHistoryMs: number;
+    private checkpoint;
+    constructor(input: RuntimeEventExportScannerInput);
+    snapshot(): RuntimeEventExportScannerCheckpointV1;
+    scanOnce(options?: {
+        scannedAt?: string;
+    }): RuntimeEventExportScannerScanResultV1;
+    runLoop(options?: RuntimeEventExportScannerLoopOptionsV1): Promise<RuntimeEventExportScannerLoopResultV1>;
+}
+export declare function createRuntimeEventExportScanner(input: RuntimeEventExportScannerInput): RuntimeEventExportScanner;
 export declare function classifyFeedbackKind(content: string): FeedbackEventKind;
 export declare function formatPromptContext(compileResponse: RuntimeCompileResponseV1): string;
+export interface EmpiricalStructuralBudgetEvidenceV1 {
+    split: number;
+    merge: number;
+    prune: number;
+    connect: number;
+}
+export interface ResolvedCompileBudgetV1 {
+    requestedStrategy: CompileRuntimeBudgetStrategy;
+    effectiveStrategy: CompileRuntimeBudgetStrategy;
+    maxContextBlocks: number;
+    defaultMaxContextBlocks: number;
+    evidence: EmpiricalStructuralBudgetEvidenceV1;
+    evidenceTotal: number;
+    tendencies: EmpiricalStructuralBudgetEvidenceV1;
+    notes: string[];
+}
+export interface CompileStructuralBudgetSignalEvidenceV1 {
+    expansionCandidates: number;
+    traversalActivations: number;
+    overlapPruned: number;
+}
+export declare function deriveEmpiricalStructuralBudget(input: {
+    requestedStrategy?: CompileRuntimeBudgetStrategy;
+    requestedMaxContextBlocks?: number;
+    evolution?: Pick<PackGraphEvolutionV1, "structuralOps" | "prunedBlockIds"> | null;
+    defaultMaxContextBlocks?: number;
+    minimumMaxContextBlocks?: number;
+    maximumMaxContextBlocks?: number;
+}): ResolvedCompileBudgetV1;
+export declare function deriveEmpiricalStructuralBudgetFromCompileSignals(input: {
+    requestedStrategy?: CompileRuntimeBudgetStrategy;
+    requestedMaxContextBlocks?: number;
+    structuralSignals?: Pick<RuntimeCompileStructuralSignalsV1, "matchedCandidateCount" | "selectedMatchedCount" | "overlapPrunedCount" | "traversalActivatedCount"> | null;
+    defaultMaxContextBlocks?: number;
+    minimumMaxContextBlocks?: number;
+    maximumMaxContextBlocks?: number;
+}): ResolvedCompileBudgetV1;
 export declare function resolveActivePackForCompile(activationRoot: string): ActiveCompileTarget;
 export declare function compileRuntimeContext(input: CompileRuntimeContextInput): RuntimeCompileResult;
 export declare function describeAttachStatus(input: AttachStatusInput): AttachStatusSnapshotV1;
 export declare function rollbackRuntimeAttach(input: RollbackRuntimeAttachInput): RollbackRuntimeAttachResult;
 export declare function bootstrapRuntimeAttach(input: BootstrapRuntimeAttachInput): BootstrapRuntimeAttachResult;
 export declare function buildNormalizedRuntimeEventExport(turn: OpenClawRuntimeTurnInput, compileResult: RuntimeCompileResult): NormalizedEventExportV1;
+export interface WriteScannedEventExportBundleInputV1 {
+    rootDir: string;
+    exportName?: string | null;
+    exportedAt?: string | null;
+    scannedEventExport: ScannedEventExportInputV1;
+}
+export type WriteScannedEventExportBundleResultV1 = RuntimeEventExportWriteSuccess | ScannedEventExportBuildFailureV1;
 export declare function writeRuntimeEventExportBundle(turn: OpenClawRuntimeTurnInput, normalizedEventExport: NormalizedEventExportV1): RuntimeEventExportNoWrite | RuntimeEventExportWriteSuccess;
+export declare function writeScannedEventExportBundle(input: WriteScannedEventExportBundleInputV1): WriteScannedEventExportBundleResultV1;
 export declare function runRuntimeTurn(turn: OpenClawRuntimeTurnInput, options?: RunRuntimeTurnOptions): RuntimeTurnResult;
 export declare function runContinuousProductLoopTurn(input: RunContinuousProductLoopTurnInput): ContinuousProductLoopTurnResultV1;
 export type RecordedSessionReplayMode = "no_brain" | "seed_pack" | "learned_replay";
@@ -576,6 +911,34 @@ export interface RecordedSessionReplayTurnReportV1 {
     qualityScore: number;
     compileActiveVersion: number | null;
     promoted: boolean;
+    observability: {
+        scanPolicy: LearningScanPolicy | null;
+        scanSurfaces: string[];
+        humanLabelCount: number;
+        selfLabelCount: number;
+        totalEventCount: number;
+        attributedEventCount: number;
+        selectionDigestCount: number;
+        freshestSourceStream: string | null;
+        freshestCreatedAt: string | null;
+    };
+    warnings: string[];
+}
+export interface RecordedSessionReplayScannerEvidenceV1 {
+    exportTurnCount: number;
+    scanPolicy: LearningScanPolicy | null;
+    scanSurfaceCount: number;
+    scanSurfaces: string[];
+    humanLabelCount: number;
+    selfLabelCount: number;
+    totalEventCount: number;
+    attributedEventCount: number;
+    attributedTurnCount: number;
+    selectionDigestCount: number;
+    selectionDigestTurnCount: number;
+    activePackChangeCount: number;
+    freshestSourceStream: string | null;
+    freshestCreatedAt: string | null;
     warnings: string[];
 }
 export interface RecordedSessionReplayModeSummaryV1 {
@@ -587,6 +950,7 @@ export interface RecordedSessionReplayModeSummaryV1 {
     usedLearnedRouteTurnCount: number;
     promotionCount: number;
     packIds: string[];
+    scannerEvidence: RecordedSessionReplayScannerEvidenceV1;
     scoreHash: string;
 }
 export interface RecordedSessionReplayModeReportV1 {
@@ -745,6 +1109,7 @@ export interface OperatorSurfaceInput {
     updatedAt?: string | null;
     eventExportPath?: string | null;
     teacherSnapshotPath?: string | null;
+    brainAttachmentPolicy?: RuntimeTurnBrainAttachmentPolicyV1 | null;
 }
 export interface OperatorSurfaceSlotSummary {
     slot: ActivationPointerSlot;
@@ -777,6 +1142,19 @@ export interface OperatorBrainStateSummary {
     activeEventExportDigest: string | null;
     detail: string;
 }
+export interface OperatorGraphSummary {
+    available: boolean;
+    runtimePlasticitySource: RuntimePlasticitySourceV1 | null;
+    structuralOps: GraphEvolutionLogV1["structuralOps"] | null;
+    changed: boolean | null;
+    operationsApplied: GraphEvolutionLogV1["structuralEvolutionSummary"]["operationsApplied"];
+    liveBlockCount: number | null;
+    prunedBlockCount: number | null;
+    prePruneBlockCount: number | null;
+    strongestBlockId: string | null;
+    operatorSummary: string | null;
+    detail: string;
+}
 export interface OperatorServePathSummary {
     state: OperatorServePathState;
     fallbackToStaticContext: boolean;
@@ -787,6 +1165,13 @@ export interface OperatorServePathSummary {
     selectionMode: string | null;
     refreshStatus: string | null;
     freshnessChecksum: string | null;
+    requestedBudgetStrategy: string | null;
+    resolvedBudgetStrategy: string | null;
+    resolvedMaxContextBlocks: number | null;
+    structuralBudgetSource: string | null;
+    structuralBudgetEvidence: string | null;
+    structuralBudgetPressures: string | null;
+    structuralDecision: CurrentProfileStructuralDecisionV1;
     contextAttribution: ContextAttributionSummaryV1;
     error: string | null;
 }
@@ -803,11 +1188,18 @@ export interface OperatorSupervisionSummary {
     exportDigest: string | null;
     exportedAt: string | null;
     flowing: boolean | null;
+    scanPolicy: LearningScanPolicy | null;
+    scanSurfaceCount: number;
+    scanSurfaces: string[];
     sourceCount: number;
     freshestSourceStream: string | null;
     freshestCreatedAt: string | null;
     freshestKind: string | null;
     humanLabelCount: number | null;
+    selfLabelCount: number | null;
+    attributedEventCount: number | null;
+    totalEventCount: number | null;
+    selectionDigestCount: number | null;
     sources: string[];
     detail: string;
 }
@@ -824,19 +1216,26 @@ export interface OperatorTeacherLoopSummary {
     notes: string[];
     detail: string;
 }
+export type OperatorLearningBacklogState = "unavailable" | "awaiting_first_export" | "principal_live_priority" | "principal_backfill_priority" | "live_priority" | "backfill_only" | "caught_up";
+export type OperatorLearningWarningState = "teacher_snapshot_unavailable" | "awaiting_first_export" | "principal_live_backlog" | "principal_backfill_pending" | "active_pack_behind_latest_principal" | "passive_backfill_pending" | "teacher_queue_full" | "teacher_labels_stale" | "teacher_no_artifacts";
 export interface OperatorLearningSummary {
     available: boolean;
     sourcePath: string | null;
     bootstrapped: boolean | null;
     mode: AlwaysOnLearningRuntimePlanV1["mode"] | "unavailable";
     nextPriorityLane: AlwaysOnLearningRuntimePlanV1["nextPriorityLane"] | "unavailable";
+    nextPriorityBucket: AlwaysOnLearningRuntimePlanV1["nextPriorityBucket"] | "unavailable";
+    backlogState: OperatorLearningBacklogState;
     pendingLive: number | null;
     pendingBackfill: number | null;
     pendingTotal: number | null;
+    pendingByBucket: AlwaysOnLearningRuntimePlanV1["pending"]["byBucket"] | null;
     freshLivePriority: boolean | null;
     principalCheckpointCount: number | null;
     pendingPrincipalCount: number | null;
     oldestUnlearnedPrincipalEvent: PendingPrincipalEventV1 | null;
+    newestPendingPrincipalEvent: PendingPrincipalEventV1 | null;
+    leadingPrincipalCheckpoint: PrincipalLearningCheckpointV1 | null;
     principalCheckpoints: PrincipalLearningCheckpointV1[];
     principalLagToPromotion: {
         activeEventRangeEnd: number | null;
@@ -844,6 +1243,7 @@ export interface OperatorLearningSummary {
         sequenceLag: number | null;
         status: "unavailable" | "caught_up" | "pending_promotion";
     };
+    warningStates: OperatorLearningWarningState[];
     learnedRange: RuntimeCompileTargetV1["eventRange"] | null;
     materializationCount: number | null;
     lastMaterializedAt: string | null;
@@ -890,6 +1290,15 @@ export interface OperatorPrincipalObservabilitySummary {
     servingDownstreamOfLatestCorrection: boolean | null;
     detail: string;
 }
+interface OperatorManyProfileSupportSummary {
+    operatorSurface: "current_profile_only";
+    declaredAttachmentPolicy: RuntimeTurnBrainAttachmentPolicyV1;
+    sameGatewayIntent: "undeclared" | "dedicated_current_profile_boundary" | "shared_attachment_declared";
+    checkedInProofTopology: "two_local_gateways_dedicated_only";
+    sameGatewayProof: false;
+    sharedWriteSafetyProof: false;
+    detail: string;
+}
 interface OperatorSurfaceReport {
     generatedAt: string;
     activationRoot: string;
@@ -902,6 +1311,7 @@ interface OperatorSurfaceReport {
         candidateAheadBy: string[];
     };
     brain: OperatorBrainStateSummary;
+    graph: OperatorGraphSummary;
     learnedRouting: {
         required: boolean;
         available: boolean;
@@ -942,10 +1352,12 @@ interface OperatorSurfaceReport {
     learning: OperatorLearningSummary;
     teacherLoop: OperatorTeacherLoopSummary;
     principal: OperatorPrincipalObservabilitySummary;
+    manyProfile: OperatorManyProfileSupportSummary;
     findings: OperatorDoctorFinding[];
 }
 export interface CurrentProfileBrainStatusInput extends OperatorSurfaceInput {
     brainAttachmentPolicy?: RuntimeTurnBrainAttachmentPolicyV1 | null;
+    profileId?: string | null;
 }
 export type CurrentProfileBrainStatusV1 = CurrentProfileBrainStatusAnswerV1;
 export declare function buildOperatorSurfaceReport(input: OperatorSurfaceInput): OperatorSurfaceReport;
@@ -1007,3 +1419,6 @@ export { CONTRACT_IDS, buildNormalizedEventExport, createFeedbackEvent, createIn
 export { describeNormalizedEventExportObservability } from "@openclawbrain/event-export";
 export { describeCompileFallbackUsage } from "@openclawbrain/compiler";
 export { describeActivationObservability, inspectActivationState, rollbackActivePack } from "@openclawbrain/pack-format";
+export { createOpenClawLocalSessionTail, OpenClawLocalSessionTail, type OpenClawLocalSessionTailChangeKindV1, type OpenClawLocalSessionTailChangeV1, type OpenClawLocalSessionTailCursorV1, type OpenClawLocalSessionTailInput, type OpenClawLocalSessionTailLoopOptionsV1, type OpenClawLocalSessionTailLoopResultV1, type OpenClawLocalSessionTailNoopReasonV1, type OpenClawLocalSessionTailPollResultV1 } from "./session-tail.js";
+export { discoverOpenClawMainSessionStores, loadOpenClawSessionIndex, readOpenClawAcpStreamFile, readOpenClawSessionFile, type OpenClawMainSessionStoreV1, type OpenClawAcpStreamRecord, type OpenClawInjectedWorkspaceFile, type OpenClawSessionContentPart, type OpenClawSessionCustomRecord, type OpenClawSessionHeaderRecord, type OpenClawSessionIndex, type OpenClawSessionIndexEntry, type OpenClawSessionMessagePayload, type OpenClawSessionMessageRecord, type OpenClawSessionModelChangeRecord, type OpenClawSessionRecord, type OpenClawSessionTextPart, type OpenClawSessionThinkingLevelChangeRecord, type OpenClawSessionThinkingPart, type OpenClawSessionToolCallPart, type OpenClawSystemPromptReport, type OpenClawToolSurfaceEntry } from "./session-store.js";
+export { buildPassiveLearningSessionExportFromOpenClawSessionStore, buildPassiveLearningStoreExportFromOpenClawSessionIndex, type OpenClawPassiveLearningPrivacySummaryV1, type OpenClawPassiveLearningSessionEvidenceV1, type OpenClawPassiveLearningSessionExportV1, type OpenClawPassiveLearningStoreExportV1 } from "./local-session-passive-learning.js";