psyche-ai 9.1.1 → 9.1.2

package/dist/adapters/http.js

@@ -7,7 +7,7 @@
 //   const server = createPsycheServer(engine, { port: 3210 });
 //
 // Endpoints:
-//   POST /process-input  { text, userId? }  → { systemContext, dynamicContext, stimulus }
+//   POST /process-input  { text, userId? }  → { systemContext, dynamicContext, stimulus, policyModifiers?, policyContext }
 //   POST /process-output { text, userId? }  → { cleanedText, stateChanged }
 //   GET  /state                             → PsycheState
 //   GET  /protocol?locale=zh                → { protocol }

package/dist/core.d.ts

@@ -33,6 +33,20 @@ export interface ProcessInputResult {
     stimulus: StimulusType | null;
     /** v9: Structured behavioral policy modifiers — machine-readable "off baseline" signals */
     policyModifiers?: PolicyModifiers;
+    /**
+     * v9: Ready-to-use LLM prompt fragment summarizing current behavioral policy.
+     *
+     * This is the output of `buildPolicyContext(policyModifiers, locale)` —
+     * a human-readable string like "[行为策略] 简短回复、被动应答为主".
+     * Inject this into the LLM system prompt directly.
+     *
+     * Empty string when all modifiers are at baseline (no deviations to report).
+     *
+     * Note: `dynamicContext` already includes this text. This field is provided
+     * separately for callers who build their own prompt and only need the policy
+     * fragment without the full emotional context.
+     */
+    policyContext: string;
 }
 export interface ProcessOutputResult {
     /** LLM output with <psyche_update> tags stripped */

package/dist/core.js

@@ -427,6 +427,7 @@ export class PsycheEngine {
                 }),
                 stimulus: appliedStimulus,
                 policyModifiers,
+                policyContext: policyCtx,
             };
         }
         return {
@@ -443,6 +444,7 @@ export class PsycheEngine {
             }),
             stimulus: appliedStimulus,
             policyModifiers,
+            policyContext: policyCtx,
         };
     }
     /**

package/dist/decision-bias.d.ts

@@ -66,5 +66,25 @@ export declare function computePolicyModifiers(state: PsycheState): PolicyModifi
 /**
  * Build a compact policy summary string for prompt injection.
  * Only includes significant deviations from neutral policy.
+ *
+ * **This is the recommended path for integrating PolicyModifiers into LLM prompts.**
+ *
+ * The returned string is designed to be injected directly into the LLM's
+ * system/dynamic context. Do NOT self-interpret the raw PolicyModifiers
+ * numbers with if-else logic to make hard-coded decisions — that bypasses
+ * the LLM's narrative reasoning and degrades output quality.
+ *
+ * Correct usage:
+ *   const result = await engine.processInput(text);
+ *   // Inject result.policyContext (or result.dynamicContext which already
+ *   // includes it) into the LLM prompt. Let the LLM interpret the policy.
+ *
+ * Anti-pattern (leads to LLM bypass):
+ *   if (result.policyModifiers.proactivity < 0.3) { pickAction("wait"); }
+ *   // ^ This replaces LLM reasoning with hard-coded logic.
+ *
+ * Raw policyModifiers are exposed for mechanical enforcement only
+ * (e.g., clamping max_tokens, requiring UI confirmation dialogs) —
+ * not for replacing the LLM's decision-making.
  */
 export declare function buildPolicyContext(modifiers: PolicyModifiers, locale: Locale): string;

package/dist/decision-bias.js

@@ -365,6 +365,26 @@ export function computePolicyModifiers(state) {
 /**
  * Build a compact policy summary string for prompt injection.
  * Only includes significant deviations from neutral policy.
+ *
+ * **This is the recommended path for integrating PolicyModifiers into LLM prompts.**
+ *
+ * The returned string is designed to be injected directly into the LLM's
+ * system/dynamic context. Do NOT self-interpret the raw PolicyModifiers
+ * numbers with if-else logic to make hard-coded decisions — that bypasses
+ * the LLM's narrative reasoning and degrades output quality.
+ *
+ * Correct usage:
+ *   const result = await engine.processInput(text);
+ *   // Inject result.policyContext (or result.dynamicContext which already
+ *   // includes it) into the LLM prompt. Let the LLM interpret the policy.
+ *
+ * Anti-pattern (leads to LLM bypass):
+ *   if (result.policyModifiers.proactivity < 0.3) { pickAction("wait"); }
+ *   // ^ This replaces LLM reasoning with hard-coded logic.
+ *
+ * Raw policyModifiers are exposed for mechanical enforcement only
+ * (e.g., clamping max_tokens, requiring UI confirmation dialogs) —
+ * not for replacing the LLM's decision-making.
  */
 export function buildPolicyContext(modifiers, locale) {
     const parts = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "psyche-ai",
-  "version": "9.1.1",
+  "version": "9.1.2",
   "description": "Artificial Psyche — universal emotional intelligence plugin for any AI agent",
   "type": "module",
   "main": "dist/index.js",