@openclawbrain/openclaw 0.1.0

package/README.md

@@ -0,0 +1,43 @@
+# @openclawbrain/openclaw
+
+OpenClaw-facing runtime integration helpers for the TypeScript-first OpenClawBrain stack.
+
+Use this package when OpenClaw needs a narrow, typed bridge over promoted packs without giving up runtime ownership:
+
+- resolve the active promoted pack from activation pointers
+- consume `runtime_compile.v1` through a strict fail-open helper
+- emit normalized interaction and feedback events for learner handoff
+- optionally write learner-facing event-export bundles on disk
+
+```ts
+import { compileRuntimeContext, runRuntimeTurn } from "@openclawbrain/openclaw";
+
+const compileResult = compileRuntimeContext({
+  activationRoot: "/var/openclawbrain/activation",
+  message: "feedback scanner route gating",
+  runtimeHints: ["feedback scanner"]
+});
+
+const turnResult = runRuntimeTurn(
+  {
+    sessionId: "session-123",
+    channel: "whatsapp",
+    userMessage: "feedback scanner route gating",
+    compile: {
+      createdAt: "2026-03-07T17:01:00.000Z"
+    },
+    delivery: {
+      createdAt: "2026-03-07T17:02:00.000Z",
+      messageId: "msg-123"
+    },
+    export: {
+      rootDir: "/var/openclawbrain/exports/session-123"
+    }
+  },
+  {
+    activationRoot: "/var/openclawbrain/activation"
+  }
+);
+```
+
+This package stays fail-open by default: compile failures fall back to standard OpenClaw context injection, and event-export write failures do not erase successful compile output.

package/dist/src/index.d.ts

@@ -0,0 +1,148 @@
+import { type ActivationPointerRecordV1, type FeedbackEventKind, type NormalizedEventExportV1, type RouteMode, type RuntimeCompileResponseV1 } from "@openclawbrain/contracts";
+import { type ActivationSlotInspection } from "@openclawbrain/pack-format";
+declare const RUNTIME_EVENT_EXPORT_BUNDLE_CONTRACT: "normalized_event_export_bundle.v1";
+export declare const RUNTIME_EVENT_EXPORT_BUNDLE_LAYOUT: {
+    readonly manifest: "manifest.json";
+    readonly payload: "normalized-event-export.json";
+};
+export interface RuntimeEventExportBundleSummaryV1 {
+    runtimeOwner: "openclaw";
+    sessionId: string | null;
+    channel: string | null;
+    eventRange: Pick<NormalizedEventExportV1["range"], "start" | "end" | "count">;
+    interactionCount: number;
+    feedbackCount: number;
+    sourceStreams: string[];
+    contracts: NormalizedEventExportV1["provenance"]["contracts"];
+}
+export interface RuntimeEventExportBundleManifestV1 {
+    contract: typeof RUNTIME_EVENT_EXPORT_BUNDLE_CONTRACT;
+    exportName: string;
+    exportedAt: string;
+    payloadPath: string;
+    payloadDigest: string;
+    summary: RuntimeEventExportBundleSummaryV1;
+}
+export interface RuntimeEventExportBundleDescriptor {
+    rootDir: string;
+    manifestPath: string;
+    payloadPath: string;
+    manifest: RuntimeEventExportBundleManifestV1;
+    normalizedEventExport: NormalizedEventExportV1;
+}
+export interface CompileRuntimeContextInput {
+    activationRoot: string;
+    message: string;
+    agentId?: string;
+    maxContextBlocks?: number;
+    mode?: RouteMode;
+    runtimeHints?: readonly string[];
+}
+export interface ActiveCompileTarget {
+    activationRoot: string;
+    activePointer: ActivationPointerRecordV1;
+    inspection: ActivationSlotInspection;
+}
+export interface RuntimeCompileSuccess {
+    ok: true;
+    fallbackToStaticContext: false;
+    activationRoot: string;
+    activePackId: string;
+    packRootDir: string;
+    compileResponse: RuntimeCompileResponseV1;
+    brainContext: string;
+}
+export interface RuntimeCompileFailure {
+    ok: false;
+    fallbackToStaticContext: true;
+    activationRoot: string;
+    error: string;
+    brainContext: string;
+}
+export type RuntimeCompileResult = RuntimeCompileSuccess | RuntimeCompileFailure;
+export interface RuntimeTurnCompileInput {
+    createdAt?: string | null;
+    sequence?: number | null;
+    eventId?: string | null;
+}
+export interface RuntimeTurnDeliveryInput {
+    createdAt?: string | null;
+    sequence?: number | null;
+    eventId?: string | null;
+    messageId?: string | null;
+}
+export interface RuntimeTurnFeedbackInput {
+    content: string;
+    createdAt?: string | null;
+    sequence?: number | null;
+    eventId?: string | null;
+    kind?: FeedbackEventKind | null;
+    messageId?: string | null;
+    relatedInteractionId?: string | null;
+}
+export interface RuntimeTurnExportInput {
+    rootDir: string;
+    exportName?: string | null;
+    exportedAt?: string | null;
+}
+export interface OpenClawRuntimeTurnInput {
+    activationRoot?: string | null;
+    agentId?: string | null;
+    sessionId: string;
+    channel: string;
+    sourceStream?: string | null;
+    userMessage: string;
+    createdAt?: string | null;
+    sequenceStart?: number | null;
+    maxContextBlocks?: number;
+    mode?: RouteMode;
+    runtimeHints?: readonly string[];
+    compile?: RuntimeTurnCompileInput | null;
+    delivery?: boolean | RuntimeTurnDeliveryInput | null;
+    feedback?: readonly (RuntimeTurnFeedbackInput | null)[] | null;
+    export?: RuntimeTurnExportInput | null;
+}
+export interface RuntimeEventExportNoWrite {
+    ok: true;
+    wroteBundle: false;
+    normalizedEventExport: NormalizedEventExportV1;
+}
+export interface RuntimeEventExportWriteSuccess {
+    ok: true;
+    wroteBundle: true;
+    normalizedEventExport: NormalizedEventExportV1;
+    rootDir: string;
+    manifestPath: string;
+    payloadPath: string;
+    manifest: RuntimeEventExportBundleManifestV1;
+}
+export interface RuntimeEventExportFailure {
+    ok: false;
+    wroteBundle: false;
+    error: string;
+}
+export type RuntimeEventExportResult = RuntimeEventExportNoWrite | RuntimeEventExportWriteSuccess | RuntimeEventExportFailure;
+export interface RunRuntimeTurnOptions {
+    activationRoot?: string;
+    failOpen?: boolean;
+}
+export type RuntimeTurnResult = RuntimeCompileResult & {
+    eventExport: RuntimeEventExportResult;
+    warnings: string[];
+};
+export declare function buildRuntimeEventExportBundleManifest(input: {
+    exportName: string;
+    exportedAt: string;
+    payloadPath: string;
+    normalizedEventExport: NormalizedEventExportV1;
+}): RuntimeEventExportBundleManifestV1;
+export declare function validateRuntimeEventExportBundleManifest(value: RuntimeEventExportBundleManifestV1, normalizedEventExport?: NormalizedEventExportV1): string[];
+export declare function loadRuntimeEventExportBundle(rootDir: string): RuntimeEventExportBundleDescriptor;
+export declare function classifyFeedbackKind(content: string): FeedbackEventKind;
+export declare function formatPromptContext(compileResponse: RuntimeCompileResponseV1): string;
+export declare function resolveActivePackForCompile(activationRoot: string): ActiveCompileTarget;
+export declare function compileRuntimeContext(input: CompileRuntimeContextInput): RuntimeCompileResult;
+export declare function buildNormalizedRuntimeEventExport(turn: OpenClawRuntimeTurnInput, compileResult: RuntimeCompileResult): NormalizedEventExportV1;
+export declare function writeRuntimeEventExportBundle(turn: OpenClawRuntimeTurnInput, normalizedEventExport: NormalizedEventExportV1): RuntimeEventExportNoWrite | RuntimeEventExportWriteSuccess;
+export declare function runRuntimeTurn(turn: OpenClawRuntimeTurnInput, options?: RunRuntimeTurnOptions): RuntimeTurnResult;
+export {};

package/dist/src/index.js

@@ -0,0 +1,495 @@
+import { createHash } from "node:crypto";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import process from "node:process";
+import { compileRuntime } from "@openclawbrain/compiler";
+import { CONTRACT_IDS, buildNormalizedEventExport, canonicalJson, checksumJsonPayload, createFeedbackEvent, createInteractionEvent, validateNormalizedEventExport } from "@openclawbrain/contracts";
+import { inspectActivationState } from "@openclawbrain/pack-format";
+const DEFAULT_AGENT_ID = "openclaw-runtime";
+const FEEDBACK_KINDS = new Set(["correction", "teaching", "approval", "suppression"]);
+const RUNTIME_EVENT_EXPORT_BUNDLE_CONTRACT = "normalized_event_export_bundle.v1";
+export const RUNTIME_EVENT_EXPORT_BUNDLE_LAYOUT = {
+    manifest: "manifest.json",
+    payload: "normalized-event-export.json"
+};
+function toErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function readJsonFile(filePath) {
+    return JSON.parse(readFileSync(filePath, "utf8"));
+}
+function resolveBundlePayloadPath(rootDir, payloadPath) {
+    const resolved = path.resolve(rootDir, payloadPath);
+    const relative = path.relative(rootDir, resolved);
+    if (path.isAbsolute(payloadPath) || relative.startsWith("..") || relative === "") {
+        throw new Error("event export bundle payloadPath must stay within the bundle root");
+    }
+    return resolved;
+}
+export function buildRuntimeEventExportBundleManifest(input) {
+    return {
+        contract: RUNTIME_EVENT_EXPORT_BUNDLE_CONTRACT,
+        exportName: input.exportName,
+        exportedAt: input.exportedAt,
+        payloadPath: input.payloadPath,
+        payloadDigest: checksumJsonPayload(input.normalizedEventExport),
+        summary: {
+            runtimeOwner: input.normalizedEventExport.provenance.runtimeOwner,
+            sessionId: input.normalizedEventExport.provenance.sessionId,
+            channel: input.normalizedEventExport.provenance.channel,
+            eventRange: {
+                start: input.normalizedEventExport.range.start,
+                end: input.normalizedEventExport.range.end,
+                count: input.normalizedEventExport.range.count
+            },
+            interactionCount: input.normalizedEventExport.provenance.interactionCount,
+            feedbackCount: input.normalizedEventExport.provenance.feedbackCount,
+            sourceStreams: [...input.normalizedEventExport.provenance.sourceStreams],
+            contracts: [...input.normalizedEventExport.provenance.contracts]
+        }
+    };
+}
+export function validateRuntimeEventExportBundleManifest(value, normalizedEventExport) {
+    const errors = [];
+    if (value.contract !== RUNTIME_EVENT_EXPORT_BUNDLE_CONTRACT) {
+        errors.push("normalized_event_export_bundle.v1 contract is required");
+    }
+    if (value.exportName.length === 0) {
+        errors.push("exportName is required");
+    }
+    if (Number.isNaN(Date.parse(value.exportedAt))) {
+        errors.push("exportedAt must be an ISO timestamp");
+    }
+    if (value.payloadPath.length === 0) {
+        errors.push("payloadPath is required");
+    }
+    if (value.payloadDigest.length === 0) {
+        errors.push("payloadDigest is required");
+    }
+    if (normalizedEventExport !== undefined) {
+        const exportErrors = validateNormalizedEventExport(normalizedEventExport);
+        if (exportErrors.length > 0) {
+            errors.push(...exportErrors);
+        }
+        const rebuilt = buildRuntimeEventExportBundleManifest({
+            exportName: value.exportName,
+            exportedAt: value.exportedAt,
+            payloadPath: value.payloadPath,
+            normalizedEventExport
+        });
+        if (rebuilt.payloadDigest !== value.payloadDigest) {
+            errors.push("event export bundle payloadDigest does not match the supplied normalized event export");
+        }
+        if (canonicalJson(rebuilt.summary) !== canonicalJson(value.summary)) {
+            errors.push("event export bundle summary does not match the supplied normalized event export");
+        }
+    }
+    return errors;
+}
+export function loadRuntimeEventExportBundle(rootDir) {
+    const resolvedRoot = path.resolve(rootDir);
+    const manifestPath = path.join(resolvedRoot, RUNTIME_EVENT_EXPORT_BUNDLE_LAYOUT.manifest);
+    const manifest = readJsonFile(manifestPath);
+    const payloadPath = resolveBundlePayloadPath(resolvedRoot, manifest.payloadPath);
+    const normalizedEventExport = readJsonFile(payloadPath);
+    const validationErrors = validateRuntimeEventExportBundleManifest(manifest, normalizedEventExport);
+    if (validationErrors.length > 0) {
+        throw new Error(`event export bundle is invalid: ${validationErrors.join("; ")}`);
+    }
+    return {
+        rootDir: resolvedRoot,
+        manifestPath,
+        payloadPath,
+        manifest,
+        normalizedEventExport
+    };
+}
+function normalizeNonEmptyString(value, fieldName) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new Error(`${fieldName} is required`);
+    }
+    return value.trim();
+}
+function normalizeOptionalString(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+}
+function normalizeNonNegativeInteger(value, fieldName, fallbackValue) {
+    if (value === undefined || value === null) {
+        return fallbackValue;
+    }
+    if (!Number.isInteger(value) || value < 0) {
+        throw new Error(`${fieldName} must be a non-negative integer`);
+    }
+    return value;
+}
+function normalizeIsoTimestamp(value, fieldName, fallbackValue) {
+    const candidate = value ?? fallbackValue;
+    if (candidate === undefined || candidate === null || candidate === "") {
+        throw new Error(`${fieldName} is required`);
+    }
+    if (typeof candidate !== "string" || Number.isNaN(Date.parse(candidate))) {
+        throw new Error(`${fieldName} must be an ISO timestamp`);
+    }
+    return new Date(candidate).toISOString();
+}
+function normalizeMode(value) {
+    return value ?? "heuristic";
+}
+function normalizeRuntimeHints(value) {
+    if (value === undefined) {
+        return [];
+    }
+    if (value.some((item) => typeof item !== "string" || item.trim().length === 0)) {
+        throw new Error("runtimeHints must be an array of non-empty strings");
+    }
+    return value.map((item) => item.trim());
+}
+function deterministicEventId(value) {
+    const digest = createHash("sha256").update(JSON.stringify(value)).digest("hex");
+    return `evt-${digest.slice(0, 16)}`;
+}
+function nextSequenceFactory(startValue = 1) {
+    let cursor = normalizeNonNegativeInteger(startValue, "sequenceStart", 1);
+    return (explicitValue) => {
+        if (explicitValue !== undefined && explicitValue !== null) {
+            const normalized = normalizeNonNegativeInteger(explicitValue, "sequence", explicitValue);
+            cursor = Math.max(cursor, normalized + 1);
+            return normalized;
+        }
+        const current = cursor;
+        cursor += 1;
+        return current;
+    };
+}
+function isFeedbackKind(value) {
+    return FEEDBACK_KINDS.has(value);
+}
+function isPresent(value) {
+    return value !== null;
+}
+export function classifyFeedbackKind(content) {
+    const normalized = content.trim().toLowerCase();
+    if (normalized.length === 0) {
+        return "teaching";
+    }
+    if (/\b(stop|suppress|mute|silence|pause|don't send|do not send)\b/u.test(normalized)) {
+        return "suppression";
+    }
+    if (/\b(approved|approve|looks good|ship it|exactly right|that works)\b/u.test(normalized)) {
+        return "approval";
+    }
+    if (/\b(wrong|incorrect|correction|not right|do this instead|not x[, ]+y)\b/u.test(normalized) ||
+        normalized.startsWith("no") ||
+        normalized.startsWith("wrong")) {
+        return "correction";
+    }
+    return "teaching";
+}
+export function formatPromptContext(compileResponse) {
+    const lines = [
+        "[BRAIN_CONTEXT v1]",
+        `PACK_ID: ${compileResponse.packId}`,
+        `MODE: ${compileResponse.diagnostics.modeEffective}`
+    ];
+    if (compileResponse.diagnostics.routerIdentity !== null) {
+        lines.push(`ROUTER: ${compileResponse.diagnostics.routerIdentity}`);
+    }
+    if (compileResponse.selectedContext.length > 0) {
+        lines.push("");
+    }
+    for (const block of compileResponse.selectedContext) {
+        lines.push(`SOURCE: ${block.source}`);
+        lines.push(`BLOCK_ID: ${block.id}`);
+        lines.push(block.text.trim());
+        lines.push("");
+    }
+    if (lines[lines.length - 1] === "") {
+        lines.pop();
+    }
+    lines.push("[/BRAIN_CONTEXT]");
+    return `${lines.join("\n")}\n`;
+}
+function fallbackCompileResult(error, activationRoot) {
+    return {
+        ok: false,
+        fallbackToStaticContext: true,
+        activationRoot: path.resolve(activationRoot),
+        error: toErrorMessage(error),
+        brainContext: ""
+    };
+}
+export function resolveActivePackForCompile(activationRoot) {
+    const resolvedActivationRoot = path.resolve(normalizeNonEmptyString(activationRoot, "activationRoot"));
+    const inspection = inspectActivationState(resolvedActivationRoot);
+    const activePointer = inspection.pointers.active;
+    if (inspection.active === null || activePointer === null) {
+        throw new Error(`No active pack pointer found in ${resolvedActivationRoot}`);
+    }
+    if (!inspection.active.activationReady) {
+        throw new Error(`Active pack is not activation-ready: ${inspection.active.findings.join("; ")}`);
+    }
+    return {
+        activationRoot: resolvedActivationRoot,
+        activePointer,
+        inspection: inspection.active
+    };
+}
+export function compileRuntimeContext(input) {
+    const activationRoot = path.resolve(normalizeNonEmptyString(input.activationRoot, "activationRoot"));
+    const agentId = normalizeOptionalString(input.agentId) ?? process.env.OPENCLAWBRAIN_AGENT_ID ?? DEFAULT_AGENT_ID;
+    const runtimeHints = normalizeRuntimeHints(input.runtimeHints);
+    try {
+        const target = resolveActivePackForCompile(activationRoot);
+        const compileResponse = compileRuntime(target.activePointer.packRootDir, {
+            contract: CONTRACT_IDS.runtimeCompile,
+            agentId,
+            userMessage: normalizeNonEmptyString(input.message, "message"),
+            maxContextBlocks: normalizeNonNegativeInteger(input.maxContextBlocks, "maxContextBlocks", 4),
+            modeRequested: normalizeMode(input.mode),
+            activePackId: target.activePointer.packId,
+            ...(runtimeHints.length > 0 ? { runtimeHints } : {})
+        });
+        return {
+            ok: true,
+            fallbackToStaticContext: false,
+            activationRoot,
+            activePackId: target.activePointer.packId,
+            packRootDir: path.resolve(target.activePointer.packRootDir),
+            compileResponse,
+            brainContext: formatPromptContext(compileResponse)
+        };
+    }
+    catch (error) {
+        return fallbackCompileResult(error, activationRoot);
+    }
+}
+function buildCompileInteractionEvent(input) {
+    if (!input.compileResult.ok) {
+        return null;
+    }
+    const sequence = input.nextSequence(input.turn.compile?.sequence);
+    const eventId = normalizeOptionalString(input.turn.compile?.eventId) ?? deterministicEventId({
+        channel: input.turn.channel,
+        createdAt: input.createdAt,
+        kind: "memory_compiled",
+        packId: input.compileResult.compileResponse.packId,
+        sequence,
+        sessionId: input.turn.sessionId,
+        source: input.sourceStream
+    });
+    return createInteractionEvent({
+        eventId,
+        agentId: input.agentId,
+        sessionId: input.turn.sessionId,
+        channel: input.turn.channel,
+        sequence,
+        kind: "memory_compiled",
+        createdAt: input.createdAt,
+        source: {
+            runtimeOwner: "openclaw",
+            stream: input.sourceStream
+        },
+        packId: input.compileResult.compileResponse.packId
+    });
+}
+function buildDeliveryInteractionEvent(input) {
+    if (input.turn.delivery === undefined || input.turn.delivery === null || input.turn.delivery === false) {
+        return null;
+    }
+    const delivery = typeof input.turn.delivery === "object" ? input.turn.delivery : {};
+    const createdAt = normalizeIsoTimestamp(delivery.createdAt, "delivery.createdAt", input.defaultCreatedAt);
+    const sequence = input.nextSequence(delivery.sequence);
+    const messageId = normalizeOptionalString(delivery.messageId);
+    const eventId = normalizeOptionalString(delivery.eventId) ?? deterministicEventId({
+        channel: input.turn.channel,
+        createdAt,
+        kind: "message_delivered",
+        messageId: messageId ?? null,
+        packId: input.compileResult.ok ? input.compileResult.compileResponse.packId : null,
+        sequence,
+        sessionId: input.turn.sessionId,
+        source: input.sourceStream
+    });
+    return createInteractionEvent({
+        eventId,
+        agentId: input.agentId,
+        sessionId: input.turn.sessionId,
+        channel: input.turn.channel,
+        sequence,
+        kind: "message_delivered",
+        createdAt,
+        source: {
+            runtimeOwner: "openclaw",
+            stream: input.sourceStream
+        },
+        ...(input.compileResult.ok ? { packId: input.compileResult.compileResponse.packId } : {}),
+        ...(messageId !== undefined ? { messageId } : {})
+    });
+}
+function buildFeedbackEvents(input) {
+    const feedbackItems = input.turn.feedback ?? [];
+    return feedbackItems.map((item, index) => {
+        if (item === null) {
+            throw new Error(`feedback[${index}] must be an object`);
+        }
+        const content = normalizeNonEmptyString(item.content, `feedback[${index}].content`);
+        const createdAt = normalizeIsoTimestamp(item.createdAt, `feedback[${index}].createdAt`, input.defaultCreatedAt);
+        const sequence = input.nextSequence(item.sequence);
+        const kind = item.kind === undefined || item.kind === null ? classifyFeedbackKind(content) : item.kind;
+        if (!isFeedbackKind(kind)) {
+            throw new Error(`feedback[${index}].kind must be correction, teaching, approval, or suppression`);
+        }
+        const messageId = normalizeOptionalString(item.messageId);
+        const eventId = normalizeOptionalString(item.eventId) ?? deterministicEventId({
+            channel: input.turn.channel,
+            content,
+            createdAt,
+            kind,
+            messageId: messageId ?? null,
+            sequence,
+            sessionId: input.turn.sessionId,
+            source: input.sourceStream
+        });
+        const relatedInteractionId = normalizeOptionalString(item.relatedInteractionId) ?? input.compileInteraction?.eventId;
+        return createFeedbackEvent({
+            eventId,
+            agentId: input.agentId,
+            sessionId: input.turn.sessionId,
+            channel: input.turn.channel,
+            sequence,
+            kind,
+            createdAt,
+            source: {
+                runtimeOwner: "openclaw",
+                stream: input.sourceStream
+            },
+            content,
+            ...(messageId !== undefined ? { messageId } : {}),
+            ...(relatedInteractionId !== undefined ? { relatedInteractionId } : {})
+        });
+    });
+}
+export function buildNormalizedRuntimeEventExport(turn, compileResult) {
+    const agentId = normalizeOptionalString(turn.agentId) ?? process.env.OPENCLAWBRAIN_AGENT_ID ?? DEFAULT_AGENT_ID;
+    const sessionId = normalizeNonEmptyString(turn.sessionId, "sessionId");
+    const channel = normalizeNonEmptyString(turn.channel, "channel");
+    const sourceStream = normalizeOptionalString(turn.sourceStream) ?? `openclaw/runtime/${channel}`;
+    const compileCreatedAt = normalizeIsoTimestamp(turn.compile?.createdAt, "compile.createdAt", turn.createdAt);
+    const nextSequence = nextSequenceFactory(turn.sequenceStart ?? 1);
+    const normalizedTurn = {
+        ...turn,
+        agentId,
+        channel,
+        sessionId
+    };
+    const compileInteraction = buildCompileInteractionEvent({
+        turn: normalizedTurn,
+        compileResult,
+        sourceStream,
+        nextSequence,
+        createdAt: compileCreatedAt,
+        agentId
+    });
+    const feedbackEvents = buildFeedbackEvents({
+        turn: normalizedTurn,
+        sourceStream,
+        nextSequence,
+        defaultCreatedAt: compileCreatedAt,
+        compileInteraction,
+        agentId
+    });
+    const deliveryInteraction = buildDeliveryInteractionEvent({
+        turn: normalizedTurn,
+        compileResult,
+        sourceStream,
+        nextSequence,
+        defaultCreatedAt: compileCreatedAt,
+        agentId
+    });
+    const interactionEvents = [compileInteraction, deliveryInteraction].filter(isPresent);
+    if (interactionEvents.length === 0 && feedbackEvents.length === 0) {
+        throw new Error("runtime turn did not produce any normalized events");
+    }
+    const normalizedEventExport = buildNormalizedEventExport({
+        interactionEvents,
+        feedbackEvents
+    });
+    const validationErrors = validateNormalizedEventExport(normalizedEventExport);
+    if (validationErrors.length > 0) {
+        throw new Error(`normalized event export is invalid: ${validationErrors.join("; ")}`);
+    }
+    return normalizedEventExport;
+}
+export function writeRuntimeEventExportBundle(turn, normalizedEventExport) {
+    if (turn.export === undefined || turn.export === null) {
+        return {
+            ok: true,
+            wroteBundle: false,
+            normalizedEventExport
+        };
+    }
+    const rootDir = normalizeNonEmptyString(turn.export.rootDir, "export.rootDir");
+    const exportName = normalizeOptionalString(turn.export.exportName) ??
+        `${turn.sessionId}-${normalizedEventExport.range.start}-${normalizedEventExport.range.end}`;
+    const exportedAt = normalizeIsoTimestamp(turn.export.exportedAt, "export.exportedAt", normalizedEventExport.range.lastCreatedAt ?? normalizedEventExport.range.firstCreatedAt ?? new Date().toISOString());
+    const resolvedRoot = path.resolve(rootDir);
+    const manifest = buildRuntimeEventExportBundleManifest({
+        exportName,
+        exportedAt,
+        payloadPath: RUNTIME_EVENT_EXPORT_BUNDLE_LAYOUT.payload,
+        normalizedEventExport
+    });
+    const manifestPath = path.join(resolvedRoot, RUNTIME_EVENT_EXPORT_BUNDLE_LAYOUT.manifest);
+    const payloadPath = path.join(resolvedRoot, manifest.payloadPath);
+    mkdirSync(path.dirname(payloadPath), { recursive: true });
+    writeFileSync(payloadPath, canonicalJson(normalizedEventExport), "utf8");
+    writeFileSync(manifestPath, canonicalJson(manifest), "utf8");
+    const descriptor = loadRuntimeEventExportBundle(resolvedRoot);
+    return {
+        ok: true,
+        wroteBundle: true,
+        normalizedEventExport,
+        rootDir: descriptor.rootDir,
+        manifestPath: descriptor.manifestPath,
+        payloadPath: descriptor.payloadPath,
+        manifest: descriptor.manifest
+    };
+}
+export function runRuntimeTurn(turn, options = {}) {
+    const agentId = normalizeOptionalString(turn.agentId);
+    const compileInput = {
+        activationRoot: options.activationRoot ?? normalizeNonEmptyString(turn.activationRoot ?? undefined, "activationRoot"),
+        message: normalizeNonEmptyString(turn.userMessage, "userMessage"),
+        ...(agentId !== undefined ? { agentId } : {}),
+        ...(turn.maxContextBlocks !== undefined ? { maxContextBlocks: turn.maxContextBlocks } : {}),
+        ...(turn.mode !== undefined ? { mode: turn.mode } : {}),
+        ...(turn.runtimeHints !== undefined ? { runtimeHints: turn.runtimeHints } : {})
+    };
+    const compileResult = compileRuntimeContext(compileInput);
+    const warnings = [];
+    try {
+        const normalizedEventExport = buildNormalizedRuntimeEventExport(turn, compileResult);
+        const eventExport = writeRuntimeEventExportBundle(turn, normalizedEventExport);
+        return {
+            ...compileResult,
+            eventExport,
+            warnings
+        };
+    }
+    catch (error) {
+        if (options.failOpen === false) {
+            throw error;
+        }
+        warnings.push(toErrorMessage(error));
+        return {
+            ...compileResult,
+            eventExport: {
+                ok: false,
+                wroteBundle: false,
+                error: toErrorMessage(error)
+            },
+            warnings
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@openclawbrain/openclaw",
+  "version": "0.1.0",
+  "description": "OpenClaw-facing runtime integration helpers for active-pack compile consumption and normalized event emission.",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "sideEffects": false,
+  "license": "Apache-2.0",
+  "author": "Jonathan Gu <jonathangu@gmail.com>",
+  "keywords": [
+    "openclawbrain",
+    "openclaw",
+    "runtime",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jonathangu/openclawbrain.git",
+    "directory": "packages/openclaw"
+  },
+  "homepage": "https://github.com/jonathangu/openclawbrain/tree/main/packages/openclaw#readme",
+  "bugs": {
+    "url": "https://github.com/jonathangu/openclawbrain/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js",
+      "default": "./dist/src/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "prepack": "pnpm run build",
+    "test": "node --test dist/test/*.test.js"
+  },
+  "dependencies": {
+    "@openclawbrain/compiler": "workspace:^",
+    "@openclawbrain/contracts": "workspace:^",
+    "@openclawbrain/learner": "workspace:^",
+    "@openclawbrain/pack-format": "workspace:^"
+  }
+}