@motebit/sdk 2.0.0 → 2.2.0

package/dist/session-state.d.ts

@@ -33,6 +33,44 @@ export interface BrowserSessionInfo {
      */
     readonly control?: ControlState;
 }
+/**
+ * Memory self-state — the typed truth about the motebit's own
+ * memory store THIS turn, surfaced so the AI reads it instead of
+ * inferring continuity from its architecture description.
+ *
+ * The hallucination this closes is the self-state sibling of the
+ * browser-state one: asked "are you forming memories?", the AI
+ * reads the `[INTERNAL REFERENCE]` line ("Memory graph: semantic
+ * memory with decay, consolidation…") and confabulates "yes, I'm
+ * forming memories" — even when zero formed this session and the
+ * newest is days old. The capability description is true; the
+ * runtime claim was not. The fix is the same as `BrowserSessionInfo`:
+ * give the AI the typed runtime signal so the answer is grounded in
+ * what the store actually holds, not what the architecture can do.
+ *
+ * Doctrine: `typed-truth-perception.md` — same four-part shape as
+ * the browser line (wire field + runtime producer + prompt clause +
+ * dispatch/test). The `[Now]` block is where the AI reads it.
+ */
+export interface MemorySelfState {
+    /** Total non-tombstoned memory nodes this motebit currently holds. */
+    readonly total: number;
+    /**
+     * Age in ms of the most-recently-formed memory, or null when the
+     * store is empty. Lets the AI answer "how fresh is my memory?"
+     * from a number, not a guess ("9 days old", not "recently").
+     */
+    readonly newestAgeMs: number | null;
+    /**
+     * Memories formed since the current conversation began (the runtime
+     * stamps this at boot and re-stamps it on each `resetConversation`,
+     * so "this session" tracks what the user perceives when they ask
+     * "are you remembering this?" — not runtime uptime). The
+     * load-bearing field: a `0` here is the typed contradiction to
+     * "yes, I'm forming memories" when nothing has been written.
+     */
+    readonly formedThisSession: number;
+}
 /**
  * Full runtime session-state snapshot — composed by the runtime
  * from per-surface browser info plus its own sensitivity and
@@ -79,5 +117,14 @@ export interface SessionStateSnapshot {
      * staleness, the AI doesn't have to cross-reference history).
      */
     readonly staleBytesOmissionReason?: import("./pixel-consent.js").PixelOmittedReason;
+    /**
+     * Memory self-state — runtime-owned. Present when the runtime has
+     * a memory store wired (it always does in production; absent only
+     * on surfaces/tests that construct a snapshot without one). When
+     * present, the `[Now]` block emits a `Memory:` line the AI reads to
+     * ground self-claims about its own memory instead of inferring them
+     * from the architecture description. See {@link MemorySelfState}.
+     */
+    readonly memory?: MemorySelfState;
 }
 //# sourceMappingURL=session-state.d.ts.map

package/dist/session-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../src/session-state.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,mFAAmF;IACnF,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,oBAAoB,EAAE,kBAAkB,CAAC;CACrF"}
+{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../src/session-state.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC;;;;;;;OAOG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,mFAAmF;IACnF,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,oBAAoB,EAAE,kBAAkB,CAAC;IACpF;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;CACnC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@motebit/sdk",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "description": "Developer contract for building Motebit-powered agents, services, and integrations — stable types, adapter interfaces, governance config. Re-exports @motebit/protocol.",
   "type": "module",
   "main": "./dist/index.js",
@@ -47,12 +47,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@motebit/protocol": "2.0.0"
+    "@motebit/protocol": "3.0.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "typescript": "^5.6.0",
-    "vitest": "^2.1.0"
+    "vitest": "^4.1.8"
   },
   "engines": {
     "node": ">=20"