soulbridge 0.0.15 → 0.0.16

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

@@ -20,6 +20,7 @@ export * from './storage/transcript.ts';
 import type { AffectSignal, ContextRequest, Correction, Memory, ContextResult, Emotion, LlmFn, MemoryType, ObserveResult, ReflectResult, ScoredMemory, Turn, Visibility } from './types.ts';
 import type { SoulStore } from './store.ts';
 import type { AffectAnalyzer } from './affect/port.ts';
+export { gateDrafts } from './reflect.ts';
 export interface SoulOptions {
     store: SoulStore;
     soulId: string;
@@ -91,6 +92,21 @@ export declare class Soul {
         importance?: number;
         visibility?: Visibility;
     }): string;
+    /**
+     * Explicit write requested by a host or its model (RFC 0005). Unlike
+     * `remember`, it passes the same gates as `observe` and dedupes by content,
+     * so a tool cannot bypass shape/semantics or flood duplicates.
+     */
+    rememberExplicit(input: {
+        content: string;
+        type?: MemoryType;
+        importance?: number;
+    }): {
+        ok: boolean;
+        id?: string;
+        duplicate?: boolean;
+        reason?: string;
+    };
     /** Verb 4: session end. */
     reflect(turns: Turn[], options?: {
         updateEmotion?: boolean;

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

@@ -20,6 +20,7 @@ import { reflect, ruleExtract, nextEmotion } from './reflect.js';
 import { rank, tokenize } from './scoring.js';
 import { analyzeAffect, emptyAffect, lexiconAnalyzer } from './affect/analyze.js';
 import { gateDrafts, llmExtractTurn } from './reflect.js';
+export { gateDrafts } from './reflect.js';
 export class Soul {
     store;
     soulId;
@@ -214,6 +215,33 @@ export class Soul {
         });
         return id;
     }
+    /**
+     * Explicit write requested by a host or its model (RFC 0005). Unlike
+     * `remember`, it passes the same gates as `observe` and dedupes by content,
+     * so a tool cannot bypass shape/semantics or flood duplicates.
+     */
+    rememberExplicit(input) {
+        const type = input.type ?? 'fact';
+        const importance = Math.min(10, Math.max(1, input.importance ?? 7));
+        const { accepted, rejected } = gateDrafts([{ type, content: input.content, importance }]);
+        if (accepted.length === 0) {
+            return { ok: false, reason: rejected[0]?.reason ?? 'rejected by write gates' };
+        }
+        const content = accepted[0].content;
+        const existing = this.store
+            .query({
+            soulId: this.soulId,
+            userId: this.userId,
+            status: ['active'],
+            includeExpired: true,
+            limit: 10_000,
+        })
+            .find((memory) => memory.content.trim() === content);
+        if (existing)
+            return { ok: true, id: existing.id, duplicate: true };
+        const id = this.remember(content, { type, importance });
+        return { ok: true, id };
+    }
     /** Verb 4: session end. */
     async reflect(turns, options = {}) {
         return reflect(this.store, {

package/package.json

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