principles-disciple 1.138.0 → 1.140.0

package/dist/hooks/prompt-types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Type definitions for prompt assembly.
+ *
+ * Extracted from hooks/prompt.ts per PRI-444 to enable independent testing
+ * of pure-logic helpers without importing the full hook module.
+ *
+ * ERR checklist:
+ * EP-01: All unknown inputs use typeof/Object.hasOwn guards, never `as`
+ * EP-03: Pure functions never swallow errors silently
+ * EP-09: Pure functions are independently unit-testable without mocks
+ */
+import type { PluginLogger, OpenClawPluginApi } from '../openclaw-sdk.js';
+/** Cached file entry for TTL-based file reading. */
+export interface CachedFile {
+    content: string;
+    mtime: number;
+    loadedAt: number;
+}
+/** Per-workspace empathy session state. */
+export interface EmpathySessionState {
+    turnCounter: number;
+    keywordCache: {
+        store: unknown;
+        lang: string;
+    } | null;
+}
+/** API surface exposed to the prompt hook by the plugin runtime. */
+export interface PromptHookApi {
+    config?: {
+        empathy_engine?: {
+            enabled?: boolean;
+        };
+    };
+    runtime: OpenClawPluginApi['runtime'];
+    logger: PluginLogger;
+}
+/** Result of extracting the user message from the raw prompt text. */
+export interface ExtractedUserMessage {
+    /** Cleaned user message (empty string for boot checks). */
+    message: string;
+    /** True if the message appears to be from another agent (skip empathy). */
+    isAgentToAgent: boolean;
+    /** True if the message looks like empathy observer output (prevent recursion). */
+    isEmpathyPrompt: boolean;
+}
+/** Input for formatting core principles into prompt text. */
+export interface CorePrincipleEntry {
+    id: string;
+    text: string;
+}
+/** Input for formatting evolution principles (active + probation). */
+export interface EvolutionPrincipleEntry extends CorePrincipleEntry {
+}
+/** Parts assembled into appendSystemContext. Order = priority (low → high). */
+export interface AppendSystemContextParts {
+    behavioralConstraints?: string;
+    projectContext?: string;
+    workingMemory?: string;
+    thinkingOs?: string;
+    evolutionPrinciples?: string;
+    corePrinciples?: string;
+}
+/** Input for the heartbeat checklist wrapper. */
+export interface HeartbeatChecklistInput {
+    content: string;
+}

package/dist/hooks/prompt-types.js

@@ -0,0 +1,12 @@
+/**
+ * Type definitions for prompt assembly.
+ *
+ * Extracted from hooks/prompt.ts per PRI-444 to enable independent testing
+ * of pure-logic helpers without importing the full hook module.
+ *
+ * ERR checklist:
+ * EP-01: All unknown inputs use typeof/Object.hasOwn guards, never `as`
+ * EP-03: Pure functions never swallow errors silently
+ * EP-09: Pure functions are independently unit-testable without mocks
+ */
+export {};

package/dist/hooks/prompt.d.ts

@@ -1,52 +1,21 @@
-import type { PluginHookBeforePromptBuildEvent, PluginHookAgentContext, PluginHookBeforePromptBuildResult, PluginLogger, OpenClawPluginApi } from '../openclaw-sdk.js';
+import type { PluginHookBeforePromptBuildEvent, PluginHookAgentContext, PluginHookBeforePromptBuildResult } from '../openclaw-sdk.js';
 import type { ContextInjectionConfig } from '../types.js';
+import type { PromptHookApi } from './prompt-types.js';
 /**
- * Default model configuration for OpenClaw agents
+ * Reset all module-level prompt state for a workspace.
+ * Intended for test isolation — call in beforeEach().
  */
-interface AgentsDefaultsConfig {
-    model?: unknown;
-    subagents?: {
-        model?: unknown;
-    };
-}
-interface PromptHookApi {
-    config?: {
-        agents?: {
-            defaults?: AgentsDefaultsConfig;
-        };
-        empathy_engine?: {
-            enabled?: boolean;
-        };
-    };
-    runtime: OpenClawPluginApi['runtime'];
-    logger: PluginLogger;
-}
+export declare function resetPromptStateForTest(workspaceDir?: string): void;
 /**
- * Resolves model configuration for OpenClaw agents, supporting string and object formats
- * @param modelConfig - Model config: string (e.g. "provider/model") or { primary, fallbacks } object
- * @internal Helper for model configuration resolution
+ * OpenClaw API Prompt Hook
+ * Constructs the system prompt injected into LLM context for Principles Disciple
  */
-export declare function resolveModelFromConfig(modelConfig: unknown, logger?: PluginLogger): string | null;
 /**
  * Loads context injection config from .principles/PROFILE.json
  * Parses contextInjection configuration from PROFILE.json for context injection
  * @internal Used by evolution engine for context settings
  */
 export declare function loadContextInjectionConfig(workspaceDir: string): ContextInjectionConfig;
-/**
- * Gets the diagnostician model - the model used for AI self-diagnosis and reflection
- * Priority: subagents.model > subagents.model > env.OPENCLAW_MODEL
- * Falls back to main model if no diagnostician model is configured
- * @internal Helper for model configuration resolution
- */
-export declare function getDiagnosticianModel(api: PromptHookApi | null, logger?: PluginLogger): string;
-/**
- * Extract recent user messages for keyword optimization context.
- */
-/**
- * Build prompt for keyword optimization subagent.
- */
 export declare function handleBeforePromptBuild(event: PluginHookBeforePromptBuildEvent, ctx: PluginHookAgentContext & {
     api?: PromptHookApi;
 }): Promise<PluginHookBeforePromptBuildResult | void>;
-export {};