soulbridge 0.0.18 → 0.0.20

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,
@@ -132,11 +134,13 @@ export class Soul {
         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';
+        let llmOutcome = this.llm
+            ? 'skipped-rules'
+            : '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';
@@ -153,7 +157,7 @@ export class Soul {
                 }
             }
             else {
-                llmOutcome = 'skipped';
+                llmOutcome = 'skipped-long';
             }
         }
         // Deterministic write gates: shape -> semantics -> per-turn budget. Whatever

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

@@ -133,7 +133,7 @@ export interface ObserveResult {
      * 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';
+    llmOutcome: 'off' | 'skipped-rules' | 'skipped-long' | '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.18",
+  "version": "0.0.20",
   "description": "A personality layer for any agent: continuity, forgetting, and growth across tools.",
   "license": "Apache-2.0",
   "type": "module",