@openclawbrain/openclaw 0.2.2 → 0.2.3

package/dist/src/index.d.ts

@@ -1,7 +1,8 @@
+import { type CompileSelectionMode } from "@openclawbrain/compiler";
 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 GraphEvolutionLogV1, type ActivationSlotInspection, type InitHandoffState } from "@openclawbrain/pack-format";
+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 ActivationSlotInspection, type InitHandoffState, type LearningSpineServeRouteDecisionLogEntryV1 } 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";
@@ -78,8 +79,15 @@ export interface CompileRuntimeContextInput {
     budgetStrategy?: CompileRuntimeBudgetStrategy;
     maxContextChars?: number;
     mode?: RouteMode;
+    selectionMode?: CompileSelectionMode;
     compactionMode?: ContextCompactionMode;
     runtimeHints?: readonly string[];
+    /** Optional session ID for serve-time route decision logging (extension callers). */
+    sessionId?: string;
+    /** Optional channel identifier for serve-time route decision logging (extension callers). */
+    channel?: string;
+    /** @internal Suppress serve-time logging inside compileRuntimeContext when called from runRuntimeTurn (which logs separately). */
+    _suppressServeLog?: boolean;
 }
 export interface ActiveCompileTarget {
     activationRoot: string;
@@ -305,6 +313,7 @@ export interface OpenClawRuntimeTurnInput {
     maxContextBlocks?: number;
     budgetStrategy?: CompileRuntimeBudgetStrategy;
     mode?: RouteMode;
+    selectionMode?: CompileSelectionMode;
     runtimeHints?: readonly string[];
     brainAttachmentPolicy?: RuntimeTurnBrainAttachmentPolicyV1 | null;
     contextFingerprint?: RuntimeTurnContextFingerprintInputV1 | null;
@@ -345,6 +354,13 @@ export type TeacherLoopNoOpReason = "none" | "duplicate_export" | "queue_full" |
 export interface AsyncTeacherLiveLoopInput extends Pick<AdvanceAlwaysOnLearningRuntimeInput, "packLabel" | "workspace" | "learnedRouting" | "builtAt" | "offlineArtifacts" | "structuralOps" | "sparseFeedback" | "liveSliceSize" | "backfillSliceSize" | "cadence"> {
     maxQueuedExports?: number;
     staleAfterMs?: number;
+    resumeFromSnapshot?: AsyncTeacherLiveLoopSnapshotV1 | null;
+    resolveLearnedRoutingState?: () => {
+        pgVersion?: AdvanceAlwaysOnLearningRuntimeInput["pgVersion"];
+        serveTimeDecisions?: LearningSpineServeRouteDecisionLogEntryV1[];
+        baselineState?: BaselineStateV1;
+    };
+    persistUpdatedBaseline?: (state: BaselineStateV1) => void;
 }
 export interface AsyncTeacherQueuedExportJobV1 {
     jobId: string;
@@ -381,6 +397,18 @@ export interface AsyncTeacherLiveLoopSnapshotV1 {
         lastMaterialization: AlwaysOnLearningMaterializationJobV1 | null;
     };
     diagnostics: AsyncTeacherLiveLoopDiagnosticsV1;
+    state?: {
+        interactionEvents: InteractionEventV1[];
+        feedbackEvents: FeedbackEventV1[];
+        seenExportDigests: string[];
+    };
+    runtime?: {
+        startedAt: string | null;
+        lastHeartbeatAt: string | null;
+        lastScanAt: string | null;
+        scanRoot: string | null;
+        lastAppliedMaterializationJobId: string | null;
+    };
 }
 export interface AsyncTeacherEnqueueResultV1 {
     accepted: boolean;
@@ -602,9 +630,13 @@ export interface ScanLiveEventExportResultV1 {
     packLabel: string;
     supervision: CanonicalSupervisionV1;
     snapshot: AsyncTeacherLiveLoopSnapshotV1;
+    labelFlow: OperatorLabelFlowSummary;
+    learningPath: OperatorLearningPathSummary;
 }
 export declare function scanRecordedSession(input: ScanRecordedSessionInputV1): ScanRecordedSessionResultV1;
 export declare function scanLiveEventExport(input: ScanLiveEventExportInputV1): ScanLiveEventExportResultV1;
+export declare function resolveAsyncTeacherLiveLoopSnapshotPath(activationRoot: string): string;
+export declare function loadAsyncTeacherLiveLoopSnapshot(snapshotPath: string): AsyncTeacherLiveLoopSnapshotV1;
 export declare function buildRuntimeEventExportBundleManifest(input: {
     exportName: string;
     exportedAt: string;
@@ -1155,6 +1187,27 @@ export interface OperatorGraphSummary {
     operatorSummary: string | null;
     detail: string;
 }
+export type OperatorObservabilitySource = "active_pack" | "event_export" | "materialized_candidate" | "missing";
+export type OperatorPolicyGradientVersion = "v1" | "v2" | "unavailable";
+export interface OperatorLabelFlowSummary {
+    source: OperatorObservabilitySource;
+    humanLabelCount: number | null;
+    selfLabelCount: number | null;
+    asyncTeacherArtifactCount: number | null;
+    implicitPositiveCount: number | null;
+    detail: string;
+}
+export interface OperatorLearningPathSummary {
+    available: boolean;
+    source: OperatorObservabilitySource;
+    policyGradientVersion: OperatorPolicyGradientVersion;
+    policyGradientMethod: string | null;
+    objective: string | null;
+    targetConstruction: string | null;
+    connectOpsFired: number | null;
+    reconstructedTrajectoryCount: number | null;
+    detail: string;
+}
 export interface OperatorServePathSummary {
     state: OperatorServePathState;
     fallbackToStaticContext: boolean;
@@ -1208,10 +1261,14 @@ export interface OperatorTeacherLoopSummary {
     sourcePath: string | null;
     lastNoOpReason: TeacherLoopNoOpReason | "unavailable";
     latestFreshness: AsyncTeacherLiveLoopDiagnosticsV1["latestFreshness"] | "unavailable";
+    startedAt: string | null;
+    lastHeartbeatAt: string | null;
+    lastScanAt: string | null;
     lastProcessedAt: string | null;
     queueDepth: number | null;
     queueCapacity: number | null;
     running: boolean | null;
+    lastAppliedMaterializationJobId: string | null;
     lastMaterializedPackId: string | null;
     notes: string[];
     detail: string;
@@ -1312,6 +1369,8 @@ interface OperatorSurfaceReport {
     };
     brain: OperatorBrainStateSummary;
     graph: OperatorGraphSummary;
+    labelFlow: OperatorLabelFlowSummary;
+    learningPath: OperatorLearningPathSummary;
     learnedRouting: {
         required: boolean;
         available: boolean;
@@ -1360,6 +1419,8 @@ export interface CurrentProfileBrainStatusInput extends OperatorSurfaceInput {
     profileId?: string | null;
 }
 export type CurrentProfileBrainStatusV1 = CurrentProfileBrainStatusAnswerV1;
+export declare function summarizeNormalizedEventExportLabelFlow(normalizedEventExport: NormalizedEventExportV1, asyncTeacherArtifactCount?: number): OperatorLabelFlowSummary;
+export declare function summarizeLearningPathFromMaterialization(materialization: AlwaysOnLearningMaterializationJobV1 | null): OperatorLearningPathSummary;
 export declare function buildOperatorSurfaceReport(input: OperatorSurfaceInput): OperatorSurfaceReport;
 export declare function describeCurrentProfileBrainStatus(input: CurrentProfileBrainStatusInput): CurrentProfileBrainStatusV1;
 export declare function formatOperatorRollbackReport(result: RollbackRuntimeAttachResult): string;
@@ -1420,7 +1481,7 @@ export { describeNormalizedEventExportObservability } from "@openclawbrain/event
 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 { discoverOpenClawMainSessionStores, discoverOpenClawSessionStores, loadOpenClawSessionIndex, readOpenClawAcpStreamFile, readOpenClawSessionFile, type OpenClawMainSessionStoreV1, type OpenClawSessionStoreV1, 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";
 export { resolveActivationRoot, type ResolveActivationRootOptions } from "./resolve-activation-root.js";
 export { runDaemonCommand, type DaemonCliArgs, type DaemonSubcommand, parseDaemonArgs } from "./daemon.js";