principles-disciple 1.133.0 → 1.134.0

package/dist/core/schema/schema-definitions.js

@@ -49,6 +49,8 @@ export const SCHEMAS = {
           empathy_signal_json TEXT NOT NULL,
           blob_ref TEXT,
           raw_excerpt TEXT,
+          stop_reason TEXT,
+          thinking_blocks_count INTEGER,
           created_at TEXT NOT NULL
         )`,
                 indexes: [
@@ -87,6 +89,7 @@ export const SCHEMAS = {
           gfi_before REAL,
           gfi_after REAL,
           params_json TEXT NOT NULL,
+          result_preview TEXT,
           created_at TEXT NOT NULL
         )`,
                 indexes: [

package/dist/core/trajectory-types.d.ts

@@ -28,6 +28,8 @@ export interface TrajectoryAssistantTurnInput {
     sanitizedText: string;
     usageJson: unknown;
     empathySignalJson: unknown;
+    stopReason?: string | null;
+    thinkingBlocksCount?: number | null;
     createdAt?: string;
 }
 export interface TrajectoryUserTurnInput {
@@ -50,6 +52,7 @@ export interface TrajectoryToolCallInput {
     gfiBefore?: number | null;
     gfiAfter?: number | null;
     paramsJson?: unknown;
+    resultPreview?: string | null;
     createdAt?: string;
 }
 export interface TrajectoryPainEventInput {
@@ -190,6 +193,8 @@ export interface AssistantTurnRecord {
     rawText: string;
     sanitizedText: string;
     blobRef: string | null;
+    stopReason: string | null;
+    thinkingBlocksCount: number | null;
     createdAt: string;
 }
 export interface CorrectionSampleRecord {

package/dist/core/trajectory.d.ts

@@ -118,6 +118,7 @@ export declare class TrajectoryDatabase {
         errorMessage: string | null;
         gfiBefore: number | null;
         gfiAfter: number | null;
+        resultPreview: string | null;
         createdAt: string;
     }[];
     /**

package/dist/core/trajectory.js

@@ -93,9 +93,9 @@ export class TrajectoryDatabase {
             const result = this.db.prepare(`
         INSERT INTO assistant_turns (
           session_id, run_id, provider, model, raw_text, sanitized_text, usage_json,
-          empathy_signal_json, blob_ref, raw_excerpt, created_at
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-      `).run(input.sessionId, input.runId, input.provider, input.model, rawStorage.inlineText, input.sanitizedText, safeJson(input.usageJson), safeJson(input.empathySignalJson), rawStorage.blobRef, rawStorage.excerpt, createdAt);
+          empathy_signal_json, blob_ref, raw_excerpt, stop_reason, thinking_blocks_count, created_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `).run(input.sessionId, input.runId, input.provider, input.model, rawStorage.inlineText, input.sanitizedText, safeJson(input.usageJson), safeJson(input.empathySignalJson), rawStorage.blobRef, rawStorage.excerpt, input.stopReason ?? null, input.thinkingBlocksCount ?? null, createdAt);
             return Number(result.lastInsertRowid);
         });
     }
@@ -120,9 +120,9 @@ export class TrajectoryDatabase {
             const result = this.db.prepare(`
         INSERT INTO tool_calls (
           session_id, tool_name, outcome, duration_ms, exit_code, error_type, error_message,
-          gfi_before, gfi_after, params_json, created_at
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-      `).run(input.sessionId, input.toolName, input.outcome, input.durationMs ?? null, input.exitCode ?? null, input.errorType ?? null, input.errorMessage ?? null, input.gfiBefore ?? null, input.gfiAfter ?? null, safeJson(input.paramsJson), createdAt);
+          gfi_before, gfi_after, params_json, result_preview, created_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `).run(input.sessionId, input.toolName, input.outcome, input.durationMs ?? null, input.exitCode ?? null, input.errorType ?? null, input.errorMessage ?? null, input.gfiBefore ?? null, input.gfiAfter ?? null, safeJson(input.paramsJson), input.resultPreview ?? null, createdAt);
             return Number(result.lastInsertRowid);
         });
         if (input.outcome === 'success') {
@@ -548,7 +548,8 @@ export class TrajectoryDatabase {
      */
     listAssistantTurns(sessionId) {
         const rows = this.db.prepare(`
-      SELECT id, session_id, run_id, provider, model, raw_text, sanitized_text, blob_ref, created_at
+      SELECT id, session_id, run_id, provider, model, raw_text, sanitized_text, blob_ref,
+             stop_reason, thinking_blocks_count, created_at
       FROM assistant_turns
       WHERE session_id = ?
       ORDER BY id ASC
@@ -562,6 +563,8 @@ export class TrajectoryDatabase {
             rawText: this.restoreRawText(row.raw_text, row.blob_ref),
             sanitizedText: String(row.sanitized_text ?? ''),
             blobRef: row.blob_ref ? String(row.blob_ref) : null,
+            stopReason: row.stop_reason != null ? String(row.stop_reason) : null,
+            thinkingBlocksCount: row.thinking_blocks_count != null ? Number(row.thinking_blocks_count) : null,
             createdAt: String(row.created_at),
         }));
     }
@@ -574,7 +577,7 @@ export class TrajectoryDatabase {
     listToolCallsForSession(sessionId) {
         const rows = this.db.prepare(`
       SELECT id, tool_name, outcome, params_json, duration_ms, exit_code, error_type, error_message,
-             gfi_before, gfi_after, created_at
+             gfi_before, gfi_after, result_preview, created_at
       FROM tool_calls
       WHERE session_id = ?
       ORDER BY id ASC
@@ -604,6 +607,7 @@ export class TrajectoryDatabase {
                 errorMessage: row.error_message ? String(row.error_message) : null,
                 gfiBefore: row.gfi_before != null ? Number(row.gfi_before) : null,
                 gfiAfter: row.gfi_after != null ? Number(row.gfi_after) : null,
+                resultPreview: row.result_preview != null ? String(row.result_preview) : null,
                 createdAt: String(row.created_at),
             };
         });
@@ -1085,6 +1089,23 @@ export class TrajectoryDatabase {
                 }
             }
         }
+        // Trajectory enhancement: add stop_reason, thinking_blocks_count, result_preview
+        const trajectoryEnhancementColumns = [
+            { table: 'assistant_turns', name: 'stop_reason', type: 'TEXT' },
+            { table: 'assistant_turns', name: 'thinking_blocks_count', type: 'INTEGER' },
+            { table: 'tool_calls', name: 'result_preview', type: 'TEXT' },
+        ];
+        for (const col of trajectoryEnhancementColumns) {
+            try {
+                this.db.exec(`ALTER TABLE ${col.table} ADD COLUMN ${col.name} ${col.type}`);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                if (!message.includes('duplicate column name') && !message.includes('no column named')) {
+                    throw err;
+                }
+            }
+        }
         // PRI-406: Partial unique index on canonical_pain_id (non-null only) for dedup
         this.db.exec(`
       CREATE UNIQUE INDEX IF NOT EXISTS idx_pain_events_canonical_pain_id

package/dist/hooks/after-tool-call-helpers.d.ts

@@ -17,6 +17,11 @@ import { type SessionState } from '../core/session-tracker.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
 import type { PluginHookAfterToolCallEvent } from '../openclaw-sdk.js';
 import type { ToolCallOutcome, ToolCallObservation, PainAdmissionDecision } from './after-tool-call-types.js';
+/**
+ * Extract a preview string from tool call result for diagnostic evidence.
+ * Pure function — no I/O, no side effects. ERR-001 / ERR-014 compliant.
+ */
+export declare function extractToolResultPreview(result: unknown): string | null;
 /**
  * Classify the outcome of a tool call event.
  *

package/dist/hooks/after-tool-call-helpers.js

@@ -25,6 +25,68 @@ import { resolveSourceKind, buildToolFailureObservation } from './raw-observatio
 import { evaluateEvidenceTriage } from './triage-adapter.js';
 import { evaluateTriggerController } from '@principles/core/runtime-v2';
 import { buildTrajectoryEvidence } from './trajectory-evidence.js';
+const RESULT_PREVIEW_MAX_LENGTH = 500;
+/**
+ * Extract a preview string from tool call result for diagnostic evidence.
+ * Pure function — no I/O, no side effects. ERR-001 / ERR-014 compliant.
+ */
+export function extractToolResultPreview(result) {
+    if (result === null || result === undefined)
+        return null;
+    try {
+        // String result: truncate directly
+        if (typeof result === 'string') {
+            return result.length > RESULT_PREVIEW_MAX_LENGTH
+                ? `${result.slice(0, RESULT_PREVIEW_MAX_LENGTH - 3)}...`
+                : result;
+        }
+        // Object with content array (e.g., Anthropic content blocks)
+        if (typeof result === 'object' && !Array.isArray(result)) {
+            const obj = result;
+            if (Array.isArray(obj.content)) {
+                const textParts = [];
+                for (const block of obj.content) {
+                    if (block && typeof block === 'object' && !Array.isArray(block)) {
+                        const blockObj = block;
+                        if (blockObj.type === 'text' && typeof blockObj.text === 'string') {
+                            textParts.push(blockObj.text);
+                        }
+                    }
+                }
+                if (textParts.length > 0) {
+                    const joined = textParts.join('\n');
+                    return joined.length > RESULT_PREVIEW_MAX_LENGTH
+                        ? `${joined.slice(0, RESULT_PREVIEW_MAX_LENGTH - 3)}...`
+                        : joined;
+                }
+            }
+            // Object without content array: JSON.stringify with depth limiter (ERR-014)
+            const serialized = JSON.stringify(obj, (_key, value) => {
+                if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+                    const keys = Object.keys(value);
+                    if (keys.length > 10) {
+                        const truncated = {};
+                        for (const k of keys.slice(0, 10)) {
+                            truncated[k] = value[k];
+                        }
+                        truncated['__truncated__'] = true;
+                        return truncated;
+                    }
+                }
+                return value;
+            }, 2);
+            if (serialized && serialized !== '{}') {
+                return serialized.length > RESULT_PREVIEW_MAX_LENGTH
+                    ? `${serialized.slice(0, RESULT_PREVIEW_MAX_LENGTH - 3)}...`
+                    : serialized;
+            }
+        }
+        return null;
+    }
+    catch {
+        return '[result_preview_extraction_failed]';
+    }
+}
 // ── Stage 1: Classify ───────────────────────────────────────────────────────
 /**
  * Classify the outcome of a tool call event.
@@ -150,6 +212,7 @@ export function handleFrictionTrackingForFailure(sessionId, event, outcome, obse
         gfiBefore,
         gfiAfter: updatedState.currentGfi,
         paramsJson: sanitizeToolParamsForEvidence(event.params, workspaceDir),
+        resultPreview: extractToolResultPreview(event.result),
     });
     return updatedState;
 }
@@ -188,6 +251,7 @@ export function handleFrictionTrackingForSuccess(sessionId, event, outcome, obse
         gfiBefore,
         gfiAfter: resetState.currentGfi,
         paramsJson: sanitizeToolParamsForEvidence(event.params, workspaceDir),
+        resultPreview: extractToolResultPreview(event.result),
     });
     wctx.eventLog.recordToolCall(sessionId, {
         toolName: event.toolName,

package/dist/hooks/llm.d.ts

@@ -8,6 +8,14 @@ export interface EmpathySignal {
 }
 export declare function extractEmpathySignal(text: string): EmpathySignal;
 export declare function isEmpathyAuditPayload(text: string): boolean;
+/**
+ * Extract enhanced fields from lastAssistant (complete AssistantMessage) in hook payload.
+ * Pure function — no I/O, no side effects. ERR-001 compliant.
+ */
+export declare function extractAssistantEnhancedFields(lastAssistant: unknown): {
+    stopReason: string | null;
+    thinkingBlocksCount: number | null;
+};
 export declare function handleLlmOutput(event: PluginHookLlmOutputEvent, ctx: PluginHookAgentContext & {
     workspaceDir?: string;
 }): void;

package/dist/hooks/llm.js

@@ -124,6 +124,33 @@ export function isEmpathyAuditPayload(text) {
         return true;
     return false;
 }
+/**
+ * Extract enhanced fields from lastAssistant (complete AssistantMessage) in hook payload.
+ * Pure function — no I/O, no side effects. ERR-001 compliant.
+ */
+export function extractAssistantEnhancedFields(lastAssistant) {
+    if (!lastAssistant || typeof lastAssistant !== 'object' || Array.isArray(lastAssistant)) {
+        return { stopReason: null, thinkingBlocksCount: null };
+    }
+    const obj = lastAssistant;
+    // stopReason: typeof guard
+    const stopReason = typeof obj.stopReason === 'string' ? obj.stopReason : null;
+    // thinkingBlocksCount: iterate content array, count thinking/redacted_thinking blocks
+    let thinkingBlocksCount = null;
+    if (Array.isArray(obj.content)) {
+        let count = 0;
+        for (const block of obj.content) {
+            if (block && typeof block === 'object' && !Array.isArray(block)) {
+                const blockType = block.type;
+                if (blockType === 'thinking' || blockType === 'redacted_thinking') {
+                    count++;
+                }
+            }
+        }
+        thinkingBlocksCount = count;
+    }
+    return { stopReason, thinkingBlocksCount };
+}
 export function handleLlmOutput(event, ctx) {
     if (!ctx.workspaceDir || !ctx.sessionId)
         return;
@@ -142,6 +169,7 @@ export function handleLlmOutput(event, ctx) {
         return;
     const text = event.assistantTexts.join('\n');
     const signal = extractEmpathySignal(text);
+    const enhancedFields = extractAssistantEnhancedFields(event.lastAssistant);
     const createdAt = new Date().toISOString();
     let assistantTurnId = null;
     try {
@@ -154,6 +182,8 @@ export function handleLlmOutput(event, ctx) {
             sanitizedText: sanitizeAssistantText(text),
             usageJson: event.usage || {},
             empathySignalJson: signal,
+            stopReason: enhancedFields.stopReason,
+            thinkingBlocksCount: enhancedFields.thinkingBlocksCount,
             createdAt,
         });
     }

package/dist/hooks/trajectory-evidence.js

@@ -41,9 +41,11 @@ export function buildTrajectoryEvidence(wctx, sessionId) {
             if (evidence.length >= MAX_EVIDENCE_ENTRIES)
                 break;
             const sanitizedNote = sanitizeAssistantText((turn.sanitizedText ?? '').slice(0, MAX_EVIDENCE_NOTE_CHARS));
+            // Enhanced: append truncation warning when stop_reason=length
+            const truncationWarning = turn.stopReason === 'length' ? ' [TRUNCATED: output cut off by length limit]' : '';
             evidence.push({
                 sourceRef: `agent_turn:${turn.createdAt}`,
-                note: sanitizedNote,
+                note: sanitizedNote + truncationWarning,
             });
         }
     }
@@ -62,7 +64,9 @@ export function buildTrajectoryEvidence(wctx, sessionId) {
         for (const tc of failedToolCalls) {
             if (evidence.length >= MAX_EVIDENCE_ENTRIES)
                 break;
-            const note = `Tool ${tc.toolName} failed: ${tc.errorType ?? 'unknown'} (exitCode: ${tc.exitCode ?? 'N/A'})`;
+            // Enhanced: append resultPreview when available
+            const previewSuffix = tc.resultPreview ? ` | ${tc.resultPreview.slice(0, 200)}` : '';
+            const note = `Tool ${tc.toolName} failed: ${tc.errorType ?? 'unknown'} (exitCode: ${tc.exitCode ?? 'N/A'})${previewSuffix}`;
             evidence.push({
                 sourceRef: `tool_call_failure:${tc.createdAt}`,
                 note: sanitizeAssistantText(note.slice(0, MAX_EVIDENCE_NOTE_CHARS)),

package/dist/openclaw-sdk.d.ts

@@ -231,6 +231,7 @@ export interface PluginHookLlmOutputEvent {
     usage?: TokenUsage;
     assistantTexts?: string[];
     trigger?: string;
+    lastAssistant?: unknown;
     [key: string]: unknown;
 }
 export interface PluginHookSubagentSpawningEvent {

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "principles-disciple",
   "name": "Principles Disciple",
   "description": "Evolutionary programming agent framework with strategic guardrails and reflection loops.",
-  "version": "1.133.0",
+  "version": "1.134.0",
   "activation": {
     "onCapabilities": [
       "hook"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "principles-disciple",
-  "version": "1.133.0",
+  "version": "1.134.0",
   "description": "Native OpenClaw plugin for Principles Disciple",
   "type": "module",
   "main": "./dist/bundle.js",