soulbridge 0.0.18 → 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,
@@ -136,7 +138,7 @@ export class Soul {
         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';

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/package.json

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