soulbridge 0.0.11 → 0.0.12

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

@@ -31,6 +31,14 @@ export interface SoulOptions {
     deviceId?: string;
     /** Defaults to the lexicon analyzer; pass an LLM-backed one to opt in (ADR 0015). */
     analyzer?: AffectAnalyzer;
+    /**
+     * Optional model access, injected the same way as `analyzer`. Adapters supply
+     * it from their host's own model (an in-process service, a CLI subprocess, an
+     * HTTP endpoint). Omit it and every verb stays rule-only.
+     */
+    llm?: LlmFn;
+    /** Messages longer than this are not sent to the model. Defaults to 2000. */
+    llmMaxChars?: number;
 }
 export declare class Soul {
     readonly store: SoulStore;
@@ -39,6 +47,8 @@ export declare class Soul {
     readonly name: string;
     readonly deviceId: string;
     readonly analyzer: AffectAnalyzer;
+    readonly llm?: LlmFn;
+    readonly llmMaxChars: number;
     constructor(options: SoulOptions);
     /** Verb 1: session start. */
     context(request?: Partial<ContextRequest>): ContextResult;
@@ -56,10 +66,7 @@ export declare class Soul {
      * The analyzer may be async (a model); any failure degrades to the lexicon
      * analyzer. Emotion is computed from the turn only — never from affect.
      */
-    observe(turn: Turn, options?: {
-        llm?: LlmFn;
-        maxLlmChars?: number;
-    }): Promise<ObserveResult>;
+    observe(turn: Turn): Promise<ObserveResult>;
     /**
      * Explicit form of `observe`: the host decided this is worth keeping.
      * Same write path, no extraction heuristics.
@@ -71,7 +78,6 @@ export declare class Soul {
     }): string;
     /** Verb 4: session end. */
     reflect(turns: Turn[], options?: {
-        llm?: LlmFn;
         updateEmotion?: boolean;
     }): Promise<ReflectResult>;
     stats(): {

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

@@ -27,6 +27,8 @@ export class Soul {
     name;
     deviceId;
     analyzer;
+    llm;
+    llmMaxChars;
     constructor(options) {
         this.store = options.store;
         this.soulId = options.soulId;
@@ -34,6 +36,8 @@ export class Soul {
         this.name = options.name ?? '小灵';
         this.deviceId = options.deviceId ?? 'dev_local';
         this.analyzer = options.analyzer ?? lexiconAnalyzer;
+        this.llm = options.llm;
+        this.llmMaxChars = options.llmMaxChars ?? 2000;
         if (!this.store.identity(this.soulId)) {
             this.store.ensureSoul({
                 soulId: this.soulId,
@@ -80,7 +84,7 @@ export class Soul {
      * The analyzer may be async (a model); any failure degrades to the lexicon
      * analyzer. Emotion is computed from the turn only — never from affect.
      */
-    async observe(turn, options = {}) {
+    async observe(turn) {
         const now = turn.at ?? Date.now();
         const affect = turn.role === 'user' ? await this.analyzeTurn(turn.content) : emptyAffect();
         // Rules first: they are precise and cheap. Only when they find nothing does
@@ -88,11 +92,10 @@ export class Soul {
         // a rule that already fired.
         let drafts = ruleExtract([turn]);
         let extractedBy = drafts.length > 0 ? 'rules' : 'none';
-        if (drafts.length === 0 && turn.role === 'user' && options.llm) {
-            const limit = options.maxLlmChars ?? 2000;
-            if (turn.content.length <= limit) {
+        if (drafts.length === 0 && turn.role === 'user' && this.llm) {
+            if (turn.content.length <= this.llmMaxChars) {
                 try {
-                    const draft = await llmExtractTurn(turn.content, options.llm);
+                    const draft = await llmExtractTurn(turn.content, this.llm);
                     if (draft) {
                         drafts = [draft];
                         extractedBy = 'llm';
@@ -172,7 +175,7 @@ export class Soul {
             soulId: this.soulId,
             userId: this.userId,
             turns,
-            llm: options.llm,
+            llm: this.llm,
             updateEmotion: options.updateEmotion,
         });
     }

package/package.json

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