@openclawbrain/openclaw 0.2.3 → 0.3.1

package/dist/src/teacher-labeler.js

@@ -0,0 +1,424 @@
+import { CONTRACT_IDS, checksumJsonPayload, validateTeacherSupervisionArtifact } from "@openclawbrain/contracts";
+import { buildNormalizedEventDedupId } from "@openclawbrain/event-export";
+const FEEDBACK_KINDS = new Set(["correction", "teaching", "approval", "suppression"]);
+const OLLAMA_ROUTE_DECISION_STREAM = "openclaw/learning-spine/serve-time-route-decisions";
+const DEFAULT_OLLAMA_BASE_URL = "http://127.0.0.1:11434";
+const DEFAULT_OLLAMA_MODEL = "qwen3.5:9b";
+const DEFAULT_OLLAMA_TIMEOUT_MS = 2_000;
+const DEFAULT_OLLAMA_MAX_PROMPT_CHARS = 4_000;
+const DEFAULT_OLLAMA_MAX_RESPONSE_CHARS = 4_000;
+const DEFAULT_OLLAMA_MAX_OUTPUT_TOKENS = 192;
+const DEFAULT_OLLAMA_MAX_ARTIFACTS_PER_EXPORT = 2;
+const DEFAULT_OLLAMA_MAX_INTERACTIONS = 2;
+const DEFAULT_OLLAMA_MAX_USER_MESSAGE_CHARS = 480;
+const DEFAULT_OLLAMA_MAX_CONTEXT_IDS = 10;
+function normalizeOptionalString(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function normalizePositiveInteger(value, fieldName, fallback) {
+    const resolved = value ?? fallback;
+    if (!Number.isInteger(resolved) || resolved <= 0) {
+        throw new Error(`${fieldName} must be a positive integer`);
+    }
+    return resolved;
+}
+function normalizeBaseUrl(value) {
+    const normalized = normalizeOptionalString(value) ?? DEFAULT_OLLAMA_BASE_URL;
+    return normalized.replace(/\/+$/u, "");
+}
+function truncate(value, maxChars) {
+    if (value.length <= maxChars) {
+        return value;
+    }
+    if (maxChars <= 1) {
+        return value.slice(0, Math.max(0, maxChars));
+    }
+    return `${value.slice(0, Math.max(0, maxChars - 3))}...`;
+}
+function normalizeContent(value) {
+    return value.replace(/\s+/gu, " ").trim();
+}
+function uniqueStrings(values) {
+    return [...new Set(values)];
+}
+function newestIsoTimestamp(values) {
+    return [...values].sort((left, right) => Date.parse(right) - Date.parse(left))[0] ?? "1970-01-01T00:00:00.000Z";
+}
+function slugifyTeacherIdentityFragment(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/gu, "-")
+        .replace(/^-+|-+$/gu, "");
+}
+function buildTeacherPrincipal(sessionId, teacherIdentity) {
+    return {
+        teacherIdentity,
+        teacherRole: "assistant",
+        teacherAuthority: "background",
+        priorityClass: "low",
+        principalScope: {
+            kind: "session",
+            sessionId,
+            scopeKey: `session:${sessionId}|teacher:${teacherIdentity}`
+        }
+    };
+}
+function isFeedbackKind(value) {
+    return FEEDBACK_KINDS.has(value);
+}
+function extractJsonCandidate(value) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        return null;
+    }
+    const firstObjectStart = trimmed.indexOf("{");
+    const lastObjectEnd = trimmed.lastIndexOf("}");
+    if (firstObjectStart >= 0 && lastObjectEnd > firstObjectStart) {
+        return trimmed.slice(firstObjectStart, lastObjectEnd + 1);
+    }
+    const firstArrayStart = trimmed.indexOf("[");
+    const lastArrayEnd = trimmed.lastIndexOf("]");
+    if (firstArrayStart >= 0 && lastArrayEnd > firstArrayStart) {
+        return trimmed.slice(firstArrayStart, lastArrayEnd + 1);
+    }
+    return null;
+}
+function parseTeacherLabelerResponse(response) {
+    const candidate = extractJsonCandidate(response);
+    if (candidate === null) {
+        return [];
+    }
+    try {
+        const parsed = JSON.parse(candidate);
+        if (Array.isArray(parsed)) {
+            return parsed;
+        }
+        if (parsed !== null && typeof parsed === "object" && Array.isArray(parsed.labels)) {
+            return parsed.labels;
+        }
+    }
+    catch {
+        return [];
+    }
+    return [];
+}
+function buildPromptPayload(candidates, config) {
+    return {
+        task: "teacher_supervision_labeling",
+        maxLabels: config.maxArtifactsPerExport,
+        allowedKinds: ["correction", "teaching", "approval", "suppression"],
+        interactions: candidates.map((candidate) => ({
+            interactionEventId: candidate.interaction.eventId,
+            createdAt: candidate.interaction.createdAt,
+            userMessage: truncate(candidate.userMessage, config.maxUserMessageChars),
+            routeDecision: {
+                usedLearnedRouteFn: candidate.decision.usedLearnedRouteFn,
+                fallbackReason: candidate.decision.fallbackReason,
+                selectedContextCount: candidate.decision.actualBudget.selectedCount,
+                kernelContextCount: candidate.decision.kernelContextCount,
+                brainContextCount: candidate.decision.brainContextCount,
+                chosenContextIds: candidate.decision.chosenContextIds.slice(0, config.maxContextIdsPerDecision),
+                selectedBrainContextIds: candidate.decision.selectedBrainContextIds.slice(0, config.maxContextIdsPerDecision),
+                selectedKernelContextIds: candidate.decision.selectedKernelContextIds.slice(0, config.maxContextIdsPerDecision)
+            }
+        }))
+    };
+}
+function buildPrompt(candidates, config) {
+    const payload = JSON.stringify(buildPromptPayload(candidates, config));
+    return [
+        "You create background teacher supervision artifacts for OpenClawBrain.",
+        "Return JSON only.",
+        'Use this shape: {"labels":[{"interactionEventId":"...","kind":"correction|teaching|approval|suppression","content":"..."}]}.',
+        `Emit at most ${config.maxArtifactsPerExport} labels.`,
+        "Only emit concise, reusable supervision grounded in the provided interaction and route decision.",
+        "Skip empty, hedged, or duplicate labels.",
+        payload
+    ].join("\n");
+}
+function buildCandidateKey(interaction) {
+    return `${interaction.sessionId}|${interaction.channel}|${interaction.createdAt}`;
+}
+function matchServeTimeDecision(interaction, exactDecisions, fallbackDecisions) {
+    const exact = exactDecisions.get(interaction.eventId);
+    if (exact !== undefined) {
+        return exact;
+    }
+    return fallbackDecisions.get(buildCandidateKey(interaction)) ?? null;
+}
+function collectCandidates(input, config) {
+    const decisions = [...(input.serveTimeDecisions ?? [])].sort((left, right) => Date.parse(right.recordedAt) - Date.parse(left.recordedAt));
+    const exactDecisions = new Map();
+    const fallbackDecisions = new Map();
+    for (const decision of decisions) {
+        const userMessage = normalizeOptionalString(decision.userMessage);
+        if (userMessage === undefined) {
+            continue;
+        }
+        if (decision.turnCompileEventId !== null && !exactDecisions.has(decision.turnCompileEventId)) {
+            exactDecisions.set(decision.turnCompileEventId, decision);
+        }
+        const turnCreatedAt = normalizeOptionalString(decision.turnCreatedAt);
+        if (turnCreatedAt !== undefined && decision.sessionId !== null && decision.channel !== null) {
+            const key = `${decision.sessionId}|${decision.channel}|${turnCreatedAt}`;
+            if (!fallbackDecisions.has(key)) {
+                fallbackDecisions.set(key, decision);
+            }
+        }
+    }
+    return input.normalizedEventExport.interactionEvents
+        .filter((interaction) => interaction.kind === "memory_compiled")
+        .sort((left, right) => Date.parse(right.createdAt) - Date.parse(left.createdAt))
+        .map((interaction) => {
+        const decision = matchServeTimeDecision(interaction, exactDecisions, fallbackDecisions);
+        const userMessage = normalizeOptionalString(decision?.userMessage);
+        if (decision === null || userMessage === undefined) {
+            return null;
+        }
+        return {
+            interaction,
+            decision,
+            userMessage
+        };
+    })
+        .filter((candidate) => candidate !== null)
+        .slice(0, config.maxInteractionsPerExport);
+}
+function fitCandidatesToPromptBudget(candidates, config) {
+    const accepted = [];
+    for (const candidate of candidates) {
+        const nextAccepted = [...accepted, candidate];
+        if (buildPrompt(nextAccepted, config).length > config.maxPromptChars) {
+            break;
+        }
+        accepted.push(candidate);
+    }
+    return accepted;
+}
+function dedupExistingArtifactIds(artifacts) {
+    return new Set((artifacts ?? []).map((artifact) => artifact.dedupId));
+}
+function buildGeneratedArtifact(input) {
+    const newestSourceCreatedAt = newestIsoTimestamp([
+        input.candidate.interaction.createdAt,
+        input.candidate.decision.recordedAt,
+        input.candidate.decision.turnCreatedAt ?? input.candidate.decision.recordedAt
+    ].filter((value) => typeof value === "string" && value.length > 0));
+    const ageMs = Math.max(0, Date.parse(input.observedAt) - Date.parse(newestSourceCreatedAt));
+    const dedupId = checksumJsonPayload({
+        provider: "ollama",
+        teacherIdentity: input.teacherIdentity,
+        interactionDedupId: buildNormalizedEventDedupId(input.candidate.interaction),
+        kind: input.kind,
+        content: normalizeContent(input.content)
+    });
+    const sourceEventIds = uniqueStrings([input.candidate.interaction.eventId, input.candidate.decision.turnCompileEventId ?? input.candidate.interaction.eventId].filter((value) => typeof value === "string" && value.length > 0));
+    const artifact = {
+        contract: CONTRACT_IDS.teacherSupervisionArtifact,
+        artifactId: `teacher-${dedupId}`,
+        dedupId,
+        kind: input.kind,
+        createdAt: input.observedAt,
+        source: {
+            runtimeOwner: "openclaw",
+            sessionId: input.candidate.interaction.sessionId,
+            channel: input.candidate.interaction.channel,
+            sourceStreams: uniqueStrings([input.candidate.interaction.source.stream, OLLAMA_ROUTE_DECISION_STREAM]),
+            eventRange: {
+                start: input.eventRange.start,
+                end: input.eventRange.end,
+                count: input.eventRange.count
+            },
+            eventExportDigest: input.eventExportDigest
+        },
+        sourceEventIds,
+        relatedInteractionId: input.candidate.interaction.eventId,
+        principal: buildTeacherPrincipal(input.candidate.interaction.sessionId, input.teacherIdentity),
+        content: normalizeContent(input.content),
+        freshness: {
+            status: ageMs <= input.staleAfterMs ? "fresh" : "stale",
+            observedAt: input.observedAt,
+            newestSourceCreatedAt,
+            ageMs,
+            staleAfterMs: input.staleAfterMs
+        }
+    };
+    const validationErrors = validateTeacherSupervisionArtifact(artifact);
+    if (validationErrors.length > 0) {
+        throw new Error(`ollama teacher artifact is invalid: ${validationErrors.join("; ")}`);
+    }
+    return artifact;
+}
+function normalizeOllamaTeacherLabelerConfig(config) {
+    const model = normalizeOptionalString(config.model) ?? DEFAULT_OLLAMA_MODEL;
+    const teacherIdentity = normalizeOptionalString(config.teacherIdentity) ?? `openclaw/teacher/ollama/${slugifyTeacherIdentityFragment(model)}`;
+    return {
+        provider: "ollama",
+        baseUrl: normalizeBaseUrl(config.baseUrl),
+        model,
+        timeoutMs: normalizePositiveInteger(config.timeoutMs, "teacherLabeler.timeoutMs", DEFAULT_OLLAMA_TIMEOUT_MS),
+        maxPromptChars: normalizePositiveInteger(config.maxPromptChars, "teacherLabeler.maxPromptChars", DEFAULT_OLLAMA_MAX_PROMPT_CHARS),
+        maxResponseChars: normalizePositiveInteger(config.maxResponseChars, "teacherLabeler.maxResponseChars", DEFAULT_OLLAMA_MAX_RESPONSE_CHARS),
+        maxOutputTokens: normalizePositiveInteger(config.maxOutputTokens, "teacherLabeler.maxOutputTokens", DEFAULT_OLLAMA_MAX_OUTPUT_TOKENS),
+        maxArtifactsPerExport: normalizePositiveInteger(config.maxArtifactsPerExport, "teacherLabeler.maxArtifactsPerExport", DEFAULT_OLLAMA_MAX_ARTIFACTS_PER_EXPORT),
+        maxInteractionsPerExport: normalizePositiveInteger(config.maxInteractionsPerExport, "teacherLabeler.maxInteractionsPerExport", DEFAULT_OLLAMA_MAX_INTERACTIONS),
+        maxUserMessageChars: normalizePositiveInteger(config.maxUserMessageChars, "teacherLabeler.maxUserMessageChars", DEFAULT_OLLAMA_MAX_USER_MESSAGE_CHARS),
+        maxContextIdsPerDecision: normalizePositiveInteger(config.maxContextIdsPerDecision, "teacherLabeler.maxContextIdsPerDecision", DEFAULT_OLLAMA_MAX_CONTEXT_IDS),
+        teacherIdentity,
+        client: config.client ?? createHttpOllamaTeacherLabelerClient(normalizeBaseUrl(config.baseUrl))
+    };
+}
+class HttpOllamaTeacherLabelerClient {
+    baseUrl;
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl;
+    }
+    async generate(input) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), input.timeoutMs);
+        try {
+            const response = await fetch(`${this.baseUrl}/api/generate`, {
+                method: "POST",
+                headers: {
+                    "content-type": "application/json"
+                },
+                body: JSON.stringify({
+                    model: input.model,
+                    prompt: input.prompt,
+                    stream: false,
+                    options: {
+                        num_predict: input.maxOutputTokens,
+                        temperature: 0
+                    }
+                }),
+                signal: controller.signal
+            });
+            if (!response.ok) {
+                throw new Error(`ollama generate failed with status ${response.status}`);
+            }
+            const parsed = (await response.json());
+            if (typeof parsed.error === "string" && parsed.error.trim().length > 0) {
+                throw new Error(parsed.error);
+            }
+            if (typeof parsed.response !== "string") {
+                throw new Error("ollama generate response field is missing");
+            }
+            return {
+                response: parsed.response
+            };
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+export function createHttpOllamaTeacherLabelerClient(baseUrl = DEFAULT_OLLAMA_BASE_URL) {
+    return new HttpOllamaTeacherLabelerClient(normalizeBaseUrl(baseUrl));
+}
+export function createOllamaTeacherLabeler(config) {
+    const normalized = normalizeOllamaTeacherLabelerConfig(config);
+    return {
+        async label(input) {
+            const candidates = collectCandidates(input, normalized);
+            if (candidates.length === 0) {
+                return {
+                    artifacts: [],
+                    status: "skipped",
+                    detail: "no_matching_interaction_text"
+                };
+            }
+            const budgetedCandidates = fitCandidatesToPromptBudget(candidates, normalized);
+            if (budgetedCandidates.length === 0) {
+                return {
+                    artifacts: [],
+                    status: "skipped",
+                    detail: "prompt_budget_exhausted"
+                };
+            }
+            const prompt = buildPrompt(budgetedCandidates, normalized);
+            try {
+                const generated = await normalized.client.generate({
+                    model: normalized.model,
+                    prompt,
+                    maxOutputTokens: normalized.maxOutputTokens,
+                    timeoutMs: normalized.timeoutMs
+                });
+                if (generated.response.length > normalized.maxResponseChars) {
+                    return {
+                        artifacts: [],
+                        status: "fail_open",
+                        detail: "response_budget_exhausted"
+                    };
+                }
+                const parsedLabels = parseTeacherLabelerResponse(generated.response);
+                if (parsedLabels.length === 0) {
+                    return {
+                        artifacts: [],
+                        status: "skipped",
+                        detail: "no_labels_emitted"
+                    };
+                }
+                const candidateByInteractionId = new Map(budgetedCandidates.map((candidate) => [candidate.interaction.eventId, candidate]));
+                const seenDedupIds = dedupExistingArtifactIds(input.existingArtifacts);
+                const nextArtifacts = [];
+                for (const label of parsedLabels) {
+                    if (nextArtifacts.length >= normalized.maxArtifactsPerExport) {
+                        break;
+                    }
+                    const interactionEventId = typeof label.interactionEventId === "string" && label.interactionEventId.trim().length > 0
+                        ? label.interactionEventId.trim()
+                        : null;
+                    const kind = typeof label.kind === "string" && isFeedbackKind(label.kind) ? label.kind : null;
+                    const content = typeof label.content === "string" && normalizeContent(label.content).length > 0
+                        ? normalizeContent(label.content)
+                        : null;
+                    if (interactionEventId === null || kind === null || content === null) {
+                        continue;
+                    }
+                    const candidate = candidateByInteractionId.get(interactionEventId);
+                    if (candidate === undefined) {
+                        continue;
+                    }
+                    const artifact = buildGeneratedArtifact({
+                        candidate,
+                        kind,
+                        content,
+                        observedAt: input.observedAt,
+                        staleAfterMs: input.staleAfterMs,
+                        eventRange: input.normalizedEventExport.range,
+                        eventExportDigest: input.normalizedEventExport.provenance.exportDigest,
+                        teacherIdentity: normalized.teacherIdentity
+                    });
+                    if (seenDedupIds.has(artifact.dedupId)) {
+                        continue;
+                    }
+                    seenDedupIds.add(artifact.dedupId);
+                    nextArtifacts.push(artifact);
+                }
+                return {
+                    artifacts: nextArtifacts,
+                    status: "ok",
+                    detail: `candidates=${budgetedCandidates.length};labels=${nextArtifacts.length}`
+                };
+            }
+            catch (error) {
+                return {
+                    artifacts: [],
+                    status: "fail_open",
+                    detail: error instanceof Error ? error.message : String(error)
+                };
+            }
+        }
+    };
+}
+export function createTeacherLabeler(config) {
+    if (config === undefined || config === null || config.provider === "none") {
+        return null;
+    }
+    return createOllamaTeacherLabeler(config);
+}
+//# sourceMappingURL=teacher-labeler.js.map

package/dist/src/teacher-labeler.js.map

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

package/extension/index.ts

@@ -1,7 +1,7 @@
 /**
  * OpenClawBrain extension template — canonical, pre-built, versioned with the package.
  *
- * The placeholder __ACTIVATION_ROOT__ is replaced by `openclawbrain setup`
+ * The placeholder __ACTIVATION_ROOT__ is replaced by `openclawbrain install`
  * with the real activation root path at install time.
  *
  * Design constraints:
@@ -9,13 +9,17 @@
  *   - 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<string>();
 
 function warnOnce(key: string, message: string): void {
@@ -56,6 +60,21 @@ async function reportDiagnostic(input: { key: string; message: string; once?: bo
   await appendLocalDiagnosticLog(input.message);
 }
 
+function announceStartupBreadcrumb(): void {
+  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: unknown) {
   const registration = validateExtensionRegistrationApi(api);
   if (!registration.ok) {
@@ -68,12 +87,14 @@ export default function register(api: unknown) {
       "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({

package/extension/runtime-guard.ts

@@ -3,6 +3,11 @@ export interface ExtensionCompileInput {
   message: string;
   sessionId?: string;
   channel?: string;
+  _serveRouteBreadcrumbs?: {
+    invocationSurface: "installed_extension_before_prompt_build";
+    hostEvent: "before_prompt_build";
+    installedEntryPath: string;
+  };
 }
 
 export interface ExtensionCompileSuccess {
@@ -129,6 +134,7 @@ export function createBeforePromptBuildHandler(input: {
   compileRuntimeContext: ExtensionCompileRuntimeContext;
   reportDiagnostic: (diagnostic: ExtensionDiagnostic) => void | Promise<void>;
   debug?: (message: string) => void;
+  extensionEntryPath?: string;
 }): (event: unknown, ctx: unknown) => Promise<Record<string, unknown>> {
   return async (event: unknown, _ctx: unknown) => {
     if (isActivationRootPlaceholder(input.activationRoot)) {
@@ -136,7 +142,7 @@ export function createBeforePromptBuildHandler(input: {
         key: "activation-root-placeholder",
         once: true,
         message:
-          "[openclawbrain] extension inactive: ACTIVATION_ROOT is still a setup placeholder. Run: openclawbrain setup --openclaw-home <path>"
+          "[openclawbrain] BRAIN NOT YET LOADED: ACTIVATION_ROOT is still a placeholder. Run: openclawbrain install --openclaw-home <path>"
       });
       return {};
     }
@@ -156,7 +162,16 @@ export function createBeforePromptBuildHandler(input: {
         activationRoot: input.activationRoot,
         message: normalized.event.message,
         ...(normalized.event.sessionId !== undefined ? { sessionId: normalized.event.sessionId } : {}),
-        ...(normalized.event.channel !== undefined ? { channel: normalized.event.channel } : {})
+        ...(normalized.event.channel !== undefined ? { channel: normalized.event.channel } : {}),
+        ...(input.extensionEntryPath === undefined
+          ? {}
+          : {
+              _serveRouteBreadcrumbs: {
+                invocationSurface: "installed_extension_before_prompt_build" as const,
+                hostEvent: "before_prompt_build" as const,
+                installedEntryPath: input.extensionEntryPath
+              }
+            })
       });
 
       if (!result.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclawbrain/openclaw",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "description": "Primary OpenClawBrain front door for OpenClaw attach, compile, event export, status, and rollback.",
   "type": "module",
   "main": "./dist/src/index.js",
@@ -38,18 +38,19 @@
   },
   "files": [
     "dist/src",
+    "dist/extension",
     "extension"
   ],
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@openclawbrain/compiler": "0.2.3",
-    "@openclawbrain/events": "0.2.3",
-    "@openclawbrain/contracts": "0.2.3",
-    "@openclawbrain/learner": "0.2.3",
-    "@openclawbrain/pack-format": "0.2.3",
-    "@openclawbrain/event-export": "0.2.3"
+    "@openclawbrain/compiler": "0.3.0",
+    "@openclawbrain/contracts": "0.3.0",
+    "@openclawbrain/events": "0.3.0",
+    "@openclawbrain/learner": "0.3.0",
+    "@openclawbrain/pack-format": "0.3.0",
+    "@openclawbrain/event-export": "0.3.0"
   },
   "bin": {
     "openclawbrain": "./dist/src/cli.js",