@openclawbrain/cli 0.4.11 → 0.4.13

package/extension/runtime-guard.ts

@@ -1,6 +1,7 @@
 export interface ExtensionCompileInput {
   activationRoot: string;
   message: string;
+  maxContextChars?: number;
   sessionId?: string;
   channel?: string;
   _serveRouteBreadcrumbs?: {
@@ -38,6 +39,7 @@ export interface ExtensionRegistrationApi {
 
 export interface NormalizedPromptBuildEvent {
   message: string;
+  maxContextChars?: number;
   sessionId?: string;
   channel?: string;
   warnings: ExtensionDiagnostic[];
@@ -94,6 +96,7 @@ export function normalizePromptBuildEvent(event: unknown): { ok: true; event: No
   const warnings: ExtensionDiagnostic[] = [];
   const sessionId = normalizeOptionalScalarField(event.sessionId, "sessionId", warnings);
   const channel = normalizeOptionalScalarField(event.channel, "channel", warnings);
+  const maxContextChars = normalizeOptionalNonNegativeIntegerField(event.maxContextChars, "maxContextChars", warnings);
   const promptFallback = extractTextContent(event.prompt);
   let extractedMessage = promptFallback ?? "";
 
@@ -125,6 +128,7 @@ export function normalizePromptBuildEvent(event: unknown): { ok: true; event: No
     ok: true,
     event: {
       message: extractedMessage,
+      ...(maxContextChars !== undefined ? { maxContextChars } : {}),
       ...(sessionId !== undefined ? { sessionId } : {}),
       ...(channel !== undefined ? { channel } : {}),
       warnings
@@ -170,6 +174,7 @@ export function createBeforePromptBuildHandler(input: {
       const result = input.compileRuntimeContext({
         activationRoot: input.activationRoot,
         message: normalized.event.message,
+        ...(normalized.event.maxContextChars !== undefined ? { maxContextChars: normalized.event.maxContextChars } : {}),
         ...(normalized.event.sessionId !== undefined ? { sessionId: normalized.event.sessionId } : {}),
         ...(normalized.event.channel !== undefined ? { channel: normalized.event.channel } : {}),
         ...(input.extensionEntryPath === undefined
@@ -249,6 +254,46 @@ function normalizeOptionalScalarField(
   return undefined;
 }
 
+function normalizeOptionalNonNegativeIntegerField(
+  value: unknown,
+  fieldName: "maxContextChars",
+  warnings: ExtensionDiagnostic[]
+): number | undefined {
+  if (value === undefined || value === null) {
+    return undefined;
+  }
+
+  if (typeof value === "number" && Number.isSafeInteger(value) && value >= 0) {
+    return value;
+  }
+
+  if (typeof value === "bigint" && value >= 0n && value <= BigInt(Number.MAX_SAFE_INTEGER)) {
+    return Number(value);
+  }
+
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+      return undefined;
+    }
+    if (/^\d+$/.test(trimmed)) {
+      const parsed = Number(trimmed);
+      if (Number.isSafeInteger(parsed)) {
+        return parsed;
+      }
+    }
+  }
+
+  warnings.push({
+    key: `runtime-${fieldName}-ignored`,
+    message:
+      `[openclawbrain] fail-open: ignored unsupported before_prompt_build ${fieldName} ` +
+      `(${fieldName}=${describeValue(value)})`
+  });
+
+  return undefined;
+}
+
 function extractPromptMessage(message: unknown): string | undefined {
   if (typeof message === "string") {
     return normalizeText(message);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclawbrain/cli",
-  "version": "0.4.11",
+  "version": "0.4.13",
   "description": "OpenClawBrain operator CLI package with install/status helpers, daemon controls, and import/export tooling.",
   "type": "module",
   "main": "./dist/src/index.js",
@@ -45,7 +45,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@openclawbrain/compiler": "^0.3.4",
+    "@openclawbrain/compiler": "0.3.5",
     "@openclawbrain/contracts": "^0.3.5",
     "@openclawbrain/events": "^0.3.4",
     "@openclawbrain/learner": "^0.3.4",
@@ -62,3 +62,4 @@
     "test": "node --test dist/test/*.test.js"
   }
 }
+