soulbridge 0.0.17 → 0.0.19

package/dist/packages/core/src/index.d.ts

@@ -45,6 +45,12 @@ export interface SoulOptions {
      * duplicate rather than a second row. Set 0 to disable. Defaults to 30s.
      */
     dedupeWindowMs?: number;
+    /**
+     * Receives the model's raw reply, complete. Diagnostics belong to the adapter,
+     * not to core, which stays free of I/O; the DSH adapter appends it to a file
+     * so a parse failure is explainable instead of silent.
+     */
+    onLlmRaw?: (raw: string) => void;
 }
 export declare class Soul {
     readonly store: SoulStore;
@@ -56,6 +62,7 @@ export declare class Soul {
     readonly llm?: LlmFn;
     readonly llmMaxChars: number;
     readonly dedupeWindowMs: number;
+    readonly onLlmRaw?: (raw: string) => void;
     constructor(options: SoulOptions);
     /** Verb 1: session start. */
     context(request?: Partial<ContextRequest>): ContextResult;

package/dist/packages/core/src/index.js

@@ -31,6 +31,7 @@ export class Soul {
     llm;
     llmMaxChars;
     dedupeWindowMs;
+    onLlmRaw;
     constructor(options) {
         this.store = options.store;
         this.soulId = options.soulId;
@@ -41,6 +42,7 @@ export class Soul {
         this.llm = options.llm;
         this.llmMaxChars = options.llmMaxChars ?? 2000;
         this.dedupeWindowMs = options.dedupeWindowMs ?? 30_000;
+        this.onLlmRaw = options.onLlmRaw;
         if (!this.store.identity(this.soulId)) {
             this.store.ensureSoul({
                 soulId: this.soulId,
@@ -130,20 +132,31 @@ export class Soul {
         // a rule that already fired.
         let drafts = ruleExtract([turn]);
         let extractedBy = drafts.length > 0 ? 'rules' : 'none';
+        // A model that says "nothing to keep" and a model that answers garbage used
+        // to be indistinguishable; keep them apart for measurement.
+        let llmOutcome = 'off';
         if (drafts.length === 0 && turn.role === 'user' && this.llm) {
             if (turn.content.length <= this.llmMaxChars) {
                 try {
-                    const draft = await llmExtractTurn(turn.content, this.llm);
+                    const draft = await llmExtractTurn(turn.content, this.llm, this.onLlmRaw);
                     if (draft) {
                         drafts = [draft];
                         extractedBy = 'llm';
+                        llmOutcome = 'stored';
+                    }
+                    else {
+                        llmOutcome = 'null';
                     }
                 }
                 catch {
                     // The model is an enhancement; a transport or parse failure leaves the
                     // rule result (nothing) in place.
+                    llmOutcome = 'failed';
                 }
             }
+            else {
+                llmOutcome = 'skipped';
+            }
         }
         // Deterministic write gates: shape -> semantics -> per-turn budget. Whatever
         // they refuse is reported, so written: 0 always has a reason.
@@ -187,6 +200,7 @@ export class Soul {
             written,
             committed: written > 0,
             rejections: gated.rejected,
+            llmOutcome,
             emotion,
             affect,
             extractedBy: written > 0 ? extractedBy : 'none',

package/dist/packages/core/src/reflect.d.ts

@@ -75,5 +75,5 @@ export interface LlmDraft {
  * "nothing worth storing"; throws when the transport or the output is unusable,
  * so the caller can fall back to rules.
  */
-export declare function llmExtractTurn(text: string, llm: LlmFn): Promise<LlmDraft | null>;
+export declare function llmExtractTurn(text: string, llm: LlmFn, onRaw?: (raw: string) => void): Promise<LlmDraft | null>;
 export {};

package/dist/packages/core/src/reflect.js

@@ -252,8 +252,9 @@ function parseLlmJson(raw) {
  * "nothing worth storing"; throws when the transport or the output is unusable,
  * so the caller can fall back to rules.
  */
-export async function llmExtractTurn(text, llm) {
+export async function llmExtractTurn(text, llm, onRaw) {
     const raw = await llm(`${LLM_PROMPT}\n\n用户：${text}`);
+    onRaw?.(String(raw));
     const parsed = parseLlmJson(String(raw));
     if (!parsed)
         throw new Error('llm returned no JSON');

package/dist/packages/core/src/types.d.ts

@@ -129,6 +129,11 @@ export interface ObserveResult {
     committed: boolean;
     /** Drafts refused before writing, with the gate that refused them. */
     rejections: DraftRejection[];
+    /**
+     * What the optional model did, kept apart from `extractedBy` because a null
+     * answer and a broken answer used to look identical in the logs.
+     */
+    llmOutcome: 'off' | 'skipped' | 'stored' | 'null' | 'failed';
     emotion: Emotion;
     /** Analysis of the user turn. Empty signal for assistant turns or on failure. */
     affect: AffectSignal;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soulbridge",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "description": "A personality layer for any agent: continuity, forgetting, and growth across tools.",
   "license": "Apache-2.0",
   "type": "module",