@openclawbrain/cli 0.4.12 → 0.4.13

package/dist/src/local-learner.d.ts

@@ -403,6 +403,7 @@ export declare function buildGraphLocalActionSet(nodeBlockId: string, neighborBl
     queryVector: Record<string, number>;
 }, tau: number, stopBias?: number): GraphLocalActionSet;
 export declare const STOP_ACTION_ID = "__STOP__";
+export declare function buildStopActionUpdateBlockId(nodeBlockId: string): string;
 export declare function createDefaultBaselineState(alpha?: number): BaselineStateV1;
 /**
  * EMA update: on first observation use the raw outcome; thereafter blend.

package/dist/src/local-learner.js

@@ -3670,7 +3670,11 @@ export function buildGraphLocalActionSet(nodeBlockId, neighborBlockIds, graph, v
 // TrajectoryStepV1, TrajectoryV1 defined below in PG5 section
 export const STOP_ACTION_ID = "__STOP__";
 const STOP_ACTION = STOP_ACTION_ID;
+const STOP_ACTION_UPDATE_SEPARATOR = "::";
 const DEFAULT_STOP_BIAS = 0.0;
+export function buildStopActionUpdateBlockId(nodeBlockId) {
+    return `${nodeBlockId}${STOP_ACTION_UPDATE_SEPARATOR}${STOP_ACTION_ID}`;
+}
 const DEFAULT_TAU = 1.0;
 const DEFAULT_BASELINE_ALPHA = 0.05;
 const MAX_TRAJECTORY_LENGTH = 20;
@@ -3741,15 +3745,12 @@ export function computeTrajectoryPolicyGradient(trajectory, adjacency, graph, ve
                         grad = (1 / tau) * (-prob);
                     }
                 }
-                tailGradient.set(j, (tailGradient.get(j) ?? 0) + grad);
+                const gradientKey = j === STOP_ACTION_ID ? buildStopActionUpdateBlockId(step.nodeBlockId) : j;
+                tailGradient.set(gradientKey, (tailGradient.get(gradientKey) ?? 0) + grad);
             }
         }
         // Weight by advantage and pgScale, accumulate into updates
         for (const [blockId, grad] of tailGradient) {
-            // Skip STOP action — it has no learnable weight
-            if (blockId === STOP_ACTION_ID) {
-                continue;
-            }
             const scaledDelta = advantage * grad * pgScale;
             const current = updates.get(blockId);
             if (current === undefined) {
@@ -4587,13 +4588,12 @@ function computeTrajectoryPolicyGradientV2(trajectory, adjacency, graph, vectors
                 const grad = neighborId === actionKey
                     ? (1 / tau) * (1 - prob)
                     : (1 / tau) * (-prob);
-                tailGradient.set(neighborId, (tailGradient.get(neighborId) ?? 0) + grad);
+                const gradientKey = neighborId === STOP_ACTION ? buildStopActionUpdateBlockId(step.nodeBlockId) : neighborId;
+                tailGradient.set(gradientKey, (tailGradient.get(gradientKey) ?? 0) + grad);
             }
         }
         // Weight by advantage and pgScale
         for (const [blockId, grad] of tailGradient) {
-            if (blockId === STOP_ACTION)
-                continue; // don't update virtual STOP
             const delta = roundPolicyGradientValue(advantage * grad * pgScale);
             if (delta === 0)
                 continue;

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.12",
+  "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"
   }
 }
+