principles-disciple 1.203.0 → 1.204.0

package/dist/openclaw-sdk.d.ts

@@ -195,14 +195,28 @@ export interface PluginHookBeforePromptBuildResult {
 }
 export interface PluginHookBeforeToolCallEvent {
     toolName: string;
+    /** Host-provided tool call arguments (OpenClaw 2026.7.x sends `params`). */
     params?: Record<string, unknown>;
+    /** @deprecated Host sends `params`; kept for older adapter shims. */
     toolArgs?: Record<string, unknown>;
     agentId?: string;
     sessionId?: string;
     [key: string]: unknown;
 }
 export interface PluginHookBeforeToolCallResult {
+    /**
+     * Host merge contract (OpenClaw 2026.7.x, hook-before-tool-call-result.ts):
+     * only `params`, `block`, `blockReason`, `requireApproval` are read from the
+     * hook result. New code must use these fields.
+     */
+    params?: Record<string, unknown>;
+    block?: boolean;
+    blockReason?: string;
+    /** Shape is host-defined (approval request details). */
+    requireApproval?: unknown;
+    /** @deprecated Use `params`. Host does not read `toolArgs`. */
     toolArgs?: Record<string, unknown>;
+    /** @deprecated Blocking is expressed via `block: true`. Host does not read `skipToolCall`. */
     skipToolCall?: boolean;
     [key: string]: unknown;
 }
@@ -250,15 +264,21 @@ export interface PluginHookSubagentEndedEvent {
     [key: string]: unknown;
 }
 export interface PluginHookLlmOutputEvent {
-    output: string;
+    /**
+     * @deprecated Host (OpenClaw 2026.7.x) does not send `output`. It fires once
+     * per model-loop attempt with `assistantTexts` + `lastAssistant`; read those.
+     */
+    output?: string;
     agentId?: string;
     sessionId?: string;
     runId?: string;
     provider?: string;
     model?: string;
     usage?: TokenUsage;
+    /** Host-provided full assistant texts for this model-loop attempt. */
     assistantTexts?: string[];
     trigger?: string;
+    /** Last complete assistant message object (host-defined shape). */
     lastAssistant?: unknown;
     [key: string]: unknown;
 }
@@ -314,6 +334,8 @@ export interface PluginHookBeforeMessageWriteResult {
         role?: string;
         content?: unknown;
     };
+    /** Host contract: `block: true` prevents the transcript write entirely. */
+    block?: boolean;
     [key: string]: unknown;
 }
 export interface OpenClawPluginHttpRouteParams {

package/dist/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "principles-disciple",
   "name": "Principles Disciple",
   "description": "Turn repeated Agent corrections into Owner-approved, observable, reversible behavior principles. Stop correcting the same AI behavior across sessions.",
-  "version": "1.203.0",
+  "version": "1.204.0",
   "activation": {
     "onCapabilities": [
       "hook"

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "principles-disciple",
   "name": "Principles Disciple",
   "description": "Turn repeated Agent corrections into Owner-approved, observable, reversible behavior principles. Stop correcting the same AI behavior across sessions.",
-  "version": "1.203.0",
+  "version": "1.204.0",
   "activation": {
     "onCapabilities": [
       "hook"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "principles-disciple",
-  "version": "1.203.0",
+  "version": "1.204.0",
   "description": "Turn repeated Agent corrections into Owner-approved, observable, reversible behavior principles. Stop correcting the same AI behavior across sessions.",
   "type": "module",
   "main": "./dist/index.js",