@maximem/synap-js-sdk 0.5.6 → 0.5.8

package/dist/index.d.cts

@@ -374,6 +374,16 @@ interface RawContextItem {
     extracted_at?: string | null;
     metadata?: Json;
     event_date?: string | null;
+    /**
+     * The day the words were SAID, which is not the day the event happened.
+     *
+     * `event_date` is empty unless somebody stated when the event took place, so
+     * without this field beside it an item whose turn stated no event date
+     * arrives with no machine-readable date at all. Empty when the client never
+     * told the server when the conversation happened; it is never the server's
+     * own ingest or extraction clock.
+     */
+    said_at?: string | null;
     valid_until?: string | null;
     temporal_category?: string | null;
     temporal_confidence?: number;
@@ -383,6 +393,15 @@ interface RawContextItem {
      * served from the prefetch cache.
      */
     matched_queries?: string[];
+    /**
+     * Anything the server sends that this SDK version has no named field for.
+     *
+     * This index signature already made unknown keys reachable in the TYPE; what
+     * dropped them was the normaliser, which built each item from a hand-picked
+     * list of keys. So `event_end` and `event_precision` were computed by the
+     * server, dropped by its own payload, and dropped a third time here, and a
+     * caller could not read "sometime in April" even once the server sent it.
+     */
     [key: string]: unknown;
 }
 interface RawConversationContext {
@@ -409,6 +428,27 @@ interface RawContext {
 }
 interface TemporalFields {
     eventDate: string | null;
+    /**
+     * The rest of the event window. `eventDate` is its START.
+     *
+     * "last month" is stored as 2023-04-01 to 2023-04-30 at precision "month",
+     * and reading only the start makes it look like the 1st, so arithmetic from
+     * it is wrong by up to the width of the window. `eventPrecision` carries the
+     * one distinction nothing else does: "approximate" has no end, so "around
+     * November 20" and "on November 20" differ only by this label.
+     */
+    eventEnd: string | null;
+    eventPrecision: string | null;
+    /**
+     * The day the words were SAID, which is not the day the event happened.
+     *
+     * `event_date` is empty unless somebody stated when the event took place, so
+     * without this field beside it an item whose turn stated no event date
+     * arrives with no machine-readable date at all. Empty when the client never
+     * told the server when the conversation happened; it is never the server's
+     * own ingest or extraction clock.
+     */
+    saidAt: string | null;
     validUntil: string | null;
     temporalCategory: string | null;
     temporalConfidence: number;
@@ -458,6 +498,11 @@ interface TemporalEvent extends QueryAttribution {
     id: string;
     content: string;
     eventDate: string | null;
+    /** The rest of the window. See the note on `TemporalFields.eventEnd`. */
+    eventEnd: string | null;
+    eventPrecision: string | null;
+    /** See the note on `TemporalFields.saidAt`. */
+    saidAt: string | null;
     validUntil: string | null;
     /**
      * Nullable despite the `''` default in the normaliser: `pickDefined` skips
@@ -595,6 +640,8 @@ interface FlatMemory {
     metadata: Json;
     context_type: 'fact' | 'preference' | 'episode' | 'emotion' | 'temporal_event';
     event_date: string | null;
+    /** See `TemporalFields.saidAt` in ./types. */
+    said_at: string | null;
     valid_until: string | null;
     temporal_category: string | null;
     temporal_confidence: number;
@@ -1654,7 +1701,7 @@ declare class SynapClient {
  * build when the two disagree, which is the only thing that makes a manual
  * publish safe.
  */
-declare const SDK_VERSION = "0.5.6";
+declare const SDK_VERSION = "0.5.8";
 
 /**
  * BM25 scorer for the anticipation cache.

package/dist/index.d.ts

@@ -374,6 +374,16 @@ interface RawContextItem {
     extracted_at?: string | null;
     metadata?: Json;
     event_date?: string | null;
+    /**
+     * The day the words were SAID, which is not the day the event happened.
+     *
+     * `event_date` is empty unless somebody stated when the event took place, so
+     * without this field beside it an item whose turn stated no event date
+     * arrives with no machine-readable date at all. Empty when the client never
+     * told the server when the conversation happened; it is never the server's
+     * own ingest or extraction clock.
+     */
+    said_at?: string | null;
     valid_until?: string | null;
     temporal_category?: string | null;
     temporal_confidence?: number;
@@ -383,6 +393,15 @@ interface RawContextItem {
      * served from the prefetch cache.
      */
     matched_queries?: string[];
+    /**
+     * Anything the server sends that this SDK version has no named field for.
+     *
+     * This index signature already made unknown keys reachable in the TYPE; what
+     * dropped them was the normaliser, which built each item from a hand-picked
+     * list of keys. So `event_end` and `event_precision` were computed by the
+     * server, dropped by its own payload, and dropped a third time here, and a
+     * caller could not read "sometime in April" even once the server sent it.
+     */
     [key: string]: unknown;
 }
 interface RawConversationContext {
@@ -409,6 +428,27 @@ interface RawContext {
 }
 interface TemporalFields {
     eventDate: string | null;
+    /**
+     * The rest of the event window. `eventDate` is its START.
+     *
+     * "last month" is stored as 2023-04-01 to 2023-04-30 at precision "month",
+     * and reading only the start makes it look like the 1st, so arithmetic from
+     * it is wrong by up to the width of the window. `eventPrecision` carries the
+     * one distinction nothing else does: "approximate" has no end, so "around
+     * November 20" and "on November 20" differ only by this label.
+     */
+    eventEnd: string | null;
+    eventPrecision: string | null;
+    /**
+     * The day the words were SAID, which is not the day the event happened.
+     *
+     * `event_date` is empty unless somebody stated when the event took place, so
+     * without this field beside it an item whose turn stated no event date
+     * arrives with no machine-readable date at all. Empty when the client never
+     * told the server when the conversation happened; it is never the server's
+     * own ingest or extraction clock.
+     */
+    saidAt: string | null;
     validUntil: string | null;
     temporalCategory: string | null;
     temporalConfidence: number;
@@ -458,6 +498,11 @@ interface TemporalEvent extends QueryAttribution {
     id: string;
     content: string;
     eventDate: string | null;
+    /** The rest of the window. See the note on `TemporalFields.eventEnd`. */
+    eventEnd: string | null;
+    eventPrecision: string | null;
+    /** See the note on `TemporalFields.saidAt`. */
+    saidAt: string | null;
     validUntil: string | null;
     /**
      * Nullable despite the `''` default in the normaliser: `pickDefined` skips
@@ -595,6 +640,8 @@ interface FlatMemory {
     metadata: Json;
     context_type: 'fact' | 'preference' | 'episode' | 'emotion' | 'temporal_event';
     event_date: string | null;
+    /** See `TemporalFields.saidAt` in ./types. */
+    said_at: string | null;
     valid_until: string | null;
     temporal_category: string | null;
     temporal_confidence: number;
@@ -1654,7 +1701,7 @@ declare class SynapClient {
  * build when the two disagree, which is the only thing that makes a manual
  * publish safe.
  */
-declare const SDK_VERSION = "0.5.6";
+declare const SDK_VERSION = "0.5.8";
 
 /**
  * BM25 scorer for the anticipation cache.

package/dist/index.js

@@ -638,6 +638,9 @@ function matchedQueries(item = {}) {
 function normalizeTemporalFields(item = {}) {
   return {
     eventDate: pick(item["eventDate"], item.event_date, null),
+    eventEnd: pick(item["eventEnd"], item.event_end, null),
+    eventPrecision: pick(item["eventPrecision"], item.event_precision, null),
+    saidAt: pick(item["saidAt"], item.said_at, null),
     validUntil: pick(item["validUntil"], item.valid_until, null),
     temporalCategory: pick(item["temporalCategory"], item.temporal_category, null),
     temporalConfidence: pick(item["temporalConfidence"], item.temporal_confidence, 0)
@@ -697,6 +700,9 @@ function normalizeTemporalEvent(item = {}) {
     id: item.id || "",
     content: item.content || "",
     eventDate: pick(item["eventDate"], item.event_date, null),
+    eventEnd: pick(item["eventEnd"], item.event_end, null),
+    eventPrecision: pick(item["eventPrecision"], item.event_precision, null),
+    saidAt: pick(item["saidAt"], item.said_at, null),
     validUntil: pick(item["validUntil"], item.valid_until, null),
     temporalCategory: pick(item["temporalCategory"], item.temporal_category, ""),
     temporalConfidence: pick(item["temporalConfidence"], item.temporal_confidence, 0),
@@ -760,6 +766,7 @@ var dt = (v) => v ? String(v) : null;
 function temporal(item) {
   return {
     event_date: dt(item["event_date"]),
+    said_at: dt(item["said_at"]),
     valid_until: dt(item["valid_until"]),
     temporal_category: item["temporal_category"] ?? null,
     temporal_confidence: n(item["temporal_confidence"], 0)
@@ -1511,7 +1518,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
       if (client !== null) {
         throw new ListeningAlreadyActiveError("Listening is already active on this instance");
       }
-      const { GrpcStreamClient } = await import("./stream-client-Y5NFAMIH.js");
+      const { GrpcStreamClient } = await import("./stream-client-VWKINE47.js");
       const onContext = options.on_context ?? options.onContext;
       const onDisconnect = options.on_disconnect ?? options.onDisconnect;
       const onReconnect = options.on_reconnect ?? options.onReconnect;
@@ -1683,7 +1690,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.5.6";
+var SDK_VERSION = "0.5.8";
 
 // src/registry.ts
 var instances = /* @__PURE__ */ new Map();
@@ -2112,6 +2119,7 @@ function normalise(item) {
     detected_at: pick2(item, "detected_at", "extracted_at", "created_at") ?? null,
     metadata: pick2(item, "metadata") ?? {},
     event_date: pick2(item, "event_date") ?? null,
+    said_at: pick2(item, "said_at") ?? null,
     valid_until: pick2(item, "valid_until") ?? null,
     temporal_category: pick2(item, "temporal_category") ?? null,
     temporal_confidence: Number(pick2(item, "temporal_confidence") ?? 0)