@redis-iris/agent-memory 0.1.1 → 0.2.0

package/src/models/session-summary.ts

@@ -0,0 +1,67 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 1dc482213cab
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+/**
+ * Compacted summary of older session history for a session.
+ *
+ * @remarks
+ *
+ * This is derived session state maintained by the background summarization workflow, not a conversation event. It is present only after at least one summarization cycle has completed.
+ */
+export type SessionSummary = {
+  /**
+   * The summary text, a single coherent block.
+   */
+  text: string;
+  /**
+   * Boundary event ID. This event and all events before it (by array position) are covered by the summary; `events` contains the retained turns after this boundary.
+   */
+  summarizedUpToEventId: string;
+  /**
+   * Timestamp when the summary was first created (UTC). Preserved across re-summarization cycles.
+   */
+  createdAt: Date;
+  /**
+   * Timestamp when the summary was last regenerated (UTC). Updated on every summarization cycle. Equal to createdAt on the first cycle.
+   */
+  updatedAt: Date;
+  /**
+   * Metadata as a JSON object (e.g., model name, token count). Always present; defaults to an empty object when no metadata was supplied.
+   */
+  metadata?: any | undefined;
+  /**
+   * Cumulative number of session events folded into this summary across all summarization cycles. Always positive. A value of 1 may indicate a summary created before this field was tracked; it self-corrects to a real count on the next summarization cycle.
+   */
+  summarizedEvents: number;
+};
+
+/** @internal */
+export const SessionSummary$inboundSchema: z.ZodType<
+  SessionSummary,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  text: z.string(),
+  summarizedUpToEventId: z.string(),
+  createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  updatedAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  metadata: z.any().optional(),
+  summarizedEvents: z.number().int(),
+});
+
+export function sessionSummaryFromJSON(
+  jsonString: string,
+): SafeParseResult<SessionSummary, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SessionSummary$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SessionSummary' from JSON`,
+  );
+}

package/src/models/store-health-feature.ts

@@ -0,0 +1,42 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b5d2d2b8c673
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import {
+  StoreHealthStatus,
+  StoreHealthStatus$inboundSchema,
+} from "./store-health-status.js";
+
+/**
+ * Feature-level store health.
+ */
+export type StoreHealthFeature = {
+  /**
+   * Store health status.
+   */
+  status: StoreHealthStatus;
+};
+
+/** @internal */
+export const StoreHealthFeature$inboundSchema: z.ZodType<
+  StoreHealthFeature,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  status: StoreHealthStatus$inboundSchema,
+});
+
+export function storeHealthFeatureFromJSON(
+  jsonString: string,
+): SafeParseResult<StoreHealthFeature, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => StoreHealthFeature$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'StoreHealthFeature' from JSON`,
+  );
+}

package/src/models/store-health-response-content.ts

@@ -0,0 +1,48 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b8bf87d488ff
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import {
+  StoreHealthFeature,
+  StoreHealthFeature$inboundSchema,
+} from "./store-health-feature.js";
+import {
+  StoreHealthStatus,
+  StoreHealthStatus$inboundSchema,
+} from "./store-health-status.js";
+
+/**
+ * Store-scoped RAM feature health.
+ */
+export type StoreHealthResponseContent = {
+  /**
+   * Store health status.
+   */
+  status: StoreHealthStatus;
+  features: { [k: string]: StoreHealthFeature };
+};
+
+/** @internal */
+export const StoreHealthResponseContent$inboundSchema: z.ZodType<
+  StoreHealthResponseContent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  status: StoreHealthStatus$inboundSchema,
+  features: z.record(StoreHealthFeature$inboundSchema),
+});
+
+export function storeHealthResponseContentFromJSON(
+  jsonString: string,
+): SafeParseResult<StoreHealthResponseContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => StoreHealthResponseContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'StoreHealthResponseContent' from JSON`,
+  );
+}

package/src/models/store-health-status.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: d59e984c90e9
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+/**
+ * Store health status.
+ */
+export const StoreHealthStatus = {
+  Healthy: "healthy",
+  Degraded: "degraded",
+  Unavailable: "unavailable",
+} as const;
+/**
+ * Store health status.
+ */
+export type StoreHealthStatus = OpenEnum<typeof StoreHealthStatus>;
+
+/** @internal */
+export const StoreHealthStatus$inboundSchema: z.ZodType<
+  StoreHealthStatus,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(StoreHealthStatus);

package/src/models/topics-filter.ts

@@ -6,7 +6,7 @@
 import * as z from "zod/v3";
 
 /**
- * Filter by topics.
+ * Filter by topics. Matching is case-insensitive.
  */
 export type TopicsFilter = {
   /**

package/src/models/update-long-term-memory-fields-request-content.ts

@@ -0,0 +1,63 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3e5d9fd9c7a3
+ */
+
+import * as z from "zod/v3";
+
+/**
+ * Type- and namespace-scoped field update request for a custom-typed long-term memory record.
+ */
+export type UpdateLongTermMemoryFieldsRequestContent = {
+  /**
+   * The caller's bound memory type. The update is rejected unless the record's stored memoryType matches.
+   */
+  memoryType: string;
+  /**
+   * The caller's namespace. The update is rejected with 409 unless the record's stored namespace matches exactly.
+   *
+   * @remarks
+   *
+   * Omit it to assert that the record has no namespace — an omitted value matches only records stored without one, it does not mean "any namespace". The check is applied atomically with the update, so a record cannot be re-filed into another namespace between the check and the write.
+   */
+  namespace?: string | undefined;
+  /**
+   * Updated text content (1-50000 chars). Omit to leave the text unchanged.
+   */
+  text?: string | undefined;
+  /**
+   * Structured record attributes: a map from the custom memory type's field name to that field's value. Values are arbitrary JSON matching the field's declared type (str, int, float, bool, list[str], list[float], or object).
+   */
+  attributes?: { [k: string]: any } | undefined;
+};
+
+/** @internal */
+export type UpdateLongTermMemoryFieldsRequestContent$Outbound = {
+  memoryType: string;
+  namespace?: string | undefined;
+  text?: string | undefined;
+  attributes?: { [k: string]: any } | undefined;
+};
+
+/** @internal */
+export const UpdateLongTermMemoryFieldsRequestContent$outboundSchema: z.ZodType<
+  UpdateLongTermMemoryFieldsRequestContent$Outbound,
+  z.ZodTypeDef,
+  UpdateLongTermMemoryFieldsRequestContent
+> = z.object({
+  memoryType: z.string(),
+  namespace: z.string().optional(),
+  text: z.string().optional(),
+  attributes: z.record(z.any()).optional(),
+});
+
+export function updateLongTermMemoryFieldsRequestContentToJSON(
+  updateLongTermMemoryFieldsRequestContent:
+    UpdateLongTermMemoryFieldsRequestContent,
+): string {
+  return JSON.stringify(
+    UpdateLongTermMemoryFieldsRequestContent$outboundSchema.parse(
+      updateLongTermMemoryFieldsRequestContent,
+    ),
+  );
+}

package/src/models/update-long-term-memory-request-content.ts

@@ -4,7 +4,6 @@
  */
 
 import * as z from "zod/v3";
-import { MemoryType, MemoryType$outboundSchema } from "./memory-type.js";
 
 /**
  * Partial update request for a long-term memory record.
@@ -15,19 +14,23 @@ export type UpdateLongTermMemoryRequestContent = {
    */
   text?: string | undefined;
   /**
-   * Type of long-term memory.
+   * Updated memory type. Built-in or a custom type registered on the store.
    */
-  memoryType?: MemoryType | undefined;
+  memoryType?: string | undefined;
   /**
    * Updated topics (max 50 topics, each 1-100 chars).
    */
   topics?: Array<string> | undefined;
   /**
    * Updated namespace. When provided, must be 1-64 chars alphanumeric and dashes; omit the field or send an empty string to clear.
+   *
+   * @remarks
+   *
+   * This is the only way to change the namespace of an existing record, including one produced by extraction: a record inherits its session's namespace at creation and is not revised afterwards, so use this to re-file a record or to add a namespace to one created before the session had any.
    */
   namespace?: string | undefined;
   /**
-   * Updated owner ID. When provided, must be 1-64 chars alphanumeric and dashes; omit the field or send an empty string to clear.
+   * Updated owner ID. When provided, must be 1-64 chars alphanumeric and dashes and non-empty; omit the field to leave unchanged. Clearing is not supported because ownerId is required.
    */
   ownerId?: string | undefined;
   /**
@@ -53,7 +56,7 @@ export const UpdateLongTermMemoryRequestContent$outboundSchema: z.ZodType<
   UpdateLongTermMemoryRequestContent
 > = z.object({
   text: z.string().optional(),
-  memoryType: MemoryType$outboundSchema.optional(),
+  memoryType: z.string().optional(),
   topics: z.array(z.string()).optional(),
   namespace: z.string().optional(),
   ownerId: z.string().optional(),

package/src/models/update-long-term-memory-response-content.ts

@@ -7,7 +7,6 @@ import * as z from "zod/v3";
 import { safeParse } from "../lib/schemas.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
-import { MemoryType, MemoryType$inboundSchema } from "./memory-type.js";
 
 /**
  * A long-term memory record.
@@ -22,9 +21,9 @@ export type UpdateLongTermMemoryResponseContent = {
    */
   text: string;
   /**
-   * Type of long-term memory.
+   * Type of memory. Built-in or a custom type registered on the store.
    */
-  memoryType?: MemoryType | undefined;
+  memoryType?: string | undefined;
   /**
    * Session ID associated with this memory.
    */
@@ -34,13 +33,17 @@ export type UpdateLongTermMemoryResponseContent = {
    */
   ownerId?: string | undefined;
   /**
-   * Namespace for logical grouping.
+   * Namespace for logical grouping. Absent when the record has none: either it was written directly without one, or it was extracted from a session that has no namespace.
    */
   namespace?: string | undefined;
   /**
    * Topic tags for categorization.
    */
   topics?: Array<string> | undefined;
+  /**
+   * Structured record attributes: a map from the custom memory type's field name to that field's value. Values are arbitrary JSON matching the field's declared type (str, int, float, bool, list[str], list[float], or object).
+   */
+  attributes?: { [k: string]: any } | undefined;
   /**
    * Timestamp when the memory was created (UTC).
    */
@@ -59,11 +62,12 @@ export const UpdateLongTermMemoryResponseContent$inboundSchema: z.ZodType<
 > = z.object({
   id: z.string(),
   text: z.string(),
-  memoryType: MemoryType$inboundSchema.optional(),
+  memoryType: z.string().optional(),
   sessionId: z.string().optional(),
   ownerId: z.string().optional(),
   namespace: z.string().optional(),
   topics: z.array(z.string()).optional(),
+  attributes: z.record(z.any()).optional(),
   createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
   updatedAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
 });

package/src/sdk/sdk.ts

@@ -14,9 +14,12 @@ import { getSessionMemory } from "../funcs/get-session-memory.js";
 import { health } from "../funcs/health.js";
 import { listSessions } from "../funcs/list-sessions.js";
 import { searchLongTermMemory } from "../funcs/search-long-term-memory.js";
+import { storeHealth } from "../funcs/store-health.js";
+import { updateLongTermMemoryFields } from "../funcs/update-long-term-memory-fields.js";
 import { updateLongTermMemory } from "../funcs/update-long-term-memory.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
 
 export class AgentMemory extends ClientSDK {
@@ -32,6 +35,20 @@ export class AgentMemory extends ClientSDK {
     ));
   }
 
+  /**
+   * Returns read-only health for applicable store-scoped RAM features.
+   */
+  async storeHealth(
+    request?: operations.StoreHealthRequest | undefined,
+    options?: RequestOptions,
+  ): Promise<models.StoreHealthResponseContent> {
+    return unwrapAsync(storeHealth(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * Deletes long-term memories in bulk by their IDs.
    */
@@ -104,6 +121,22 @@ export class AgentMemory extends ClientSDK {
     ));
   }
 
+  /**
+   * Atomically updates a custom-typed long-term memory's text and/or attributes, scoped to the caller's bound memory type. Used by the custom-extraction worker.
+   */
+  async updateLongTermMemoryFields(
+    memoryId: string,
+    body: models.UpdateLongTermMemoryFieldsRequestContent,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(updateLongTermMemoryFields(
+      this,
+      memoryId,
+      body,
+      options,
+    ));
+  }
+
   /**
    * Returns a paginated list of session IDs for a store.
    */
@@ -157,11 +190,13 @@ export class AgentMemory extends ClientSDK {
    */
   async getSessionMemory(
     sessionId: string,
+    includeSummarisedEvents?: boolean | undefined,
     options?: RequestOptions,
   ): Promise<models.GetSessionMemoryResponseContent> {
     return unwrapAsync(getSessionMemory(
       this,
       sessionId,
+      includeSummarisedEvents,
       options,
     ));
   }

package/dist/commonjs/models/memory-type.d.ts

@@ -1,19 +0,0 @@
-import * as z from "zod/v3";
-import { OpenEnum } from "../types/enums.js";
-/**
- * Type of long-term memory.
- */
-export declare const MemoryType: {
-    readonly Semantic: "semantic";
-    readonly Episodic: "episodic";
-    readonly Message: "message";
-};
-/**
- * Type of long-term memory.
- */
-export type MemoryType = OpenEnum<typeof MemoryType>;
-/** @internal */
-export declare const MemoryType$inboundSchema: z.ZodType<MemoryType, z.ZodTypeDef, unknown>;
-/** @internal */
-export declare const MemoryType$outboundSchema: z.ZodType<string, z.ZodTypeDef, MemoryType>;
-//# sourceMappingURL=memory-type.d.ts.map

package/dist/commonjs/models/memory-type.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory-type.d.ts","sourceRoot":"","sources":["../../../src/models/memory-type.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,UAAU;;;;CAIb,CAAC;AACX;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,UAAU,CAAC,CAAC;AAErD,gBAAgB;AAChB,eAAO,MAAM,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAC9C,UAAU,EACV,CAAC,CAAC,UAAU,EACZ,OAAO,CAC8B,CAAC;AACxC,gBAAgB;AAChB,eAAO,MAAM,yBAAyB,EAAE,CAAC,CAAC,OAAO,CAC/C,MAAM,EACN,CAAC,CAAC,UAAU,EACZ,UAAU,CAC4B,CAAC"}

package/dist/commonjs/models/memory-type.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory-type.js","sourceRoot":"","sources":["../../../src/models/memory-type.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGH,MAAY,SAAS,8CAA0B;AAG/C;;GAEG;AACU,QAAA,UAAU,GAAG;IACxB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;CACV,CAAC;AAMX,gBAAgB;AACH,QAAA,wBAAwB,GAIjC,SAAS,CAAC,aAAa,CAAC,QAAA,UAAU,CAAC,CAAC;AACxC,gBAAgB;AACH,QAAA,yBAAyB,GAIlC,SAAS,CAAC,cAAc,CAAC,QAAA,UAAU,CAAC,CAAC"}

package/dist/esm/models/memory-type.d.ts

@@ -1,19 +0,0 @@
-import * as z from "zod/v3";
-import { OpenEnum } from "../types/enums.js";
-/**
- * Type of long-term memory.
- */
-export declare const MemoryType: {
-    readonly Semantic: "semantic";
-    readonly Episodic: "episodic";
-    readonly Message: "message";
-};
-/**
- * Type of long-term memory.
- */
-export type MemoryType = OpenEnum<typeof MemoryType>;
-/** @internal */
-export declare const MemoryType$inboundSchema: z.ZodType<MemoryType, z.ZodTypeDef, unknown>;
-/** @internal */
-export declare const MemoryType$outboundSchema: z.ZodType<string, z.ZodTypeDef, MemoryType>;
-//# sourceMappingURL=memory-type.d.ts.map

package/dist/esm/models/memory-type.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory-type.d.ts","sourceRoot":"","sources":["../../../src/models/memory-type.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,UAAU;;;;CAIb,CAAC;AACX;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,UAAU,CAAC,CAAC;AAErD,gBAAgB;AAChB,eAAO,MAAM,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAC9C,UAAU,EACV,CAAC,CAAC,UAAU,EACZ,OAAO,CAC8B,CAAC;AACxC,gBAAgB;AAChB,eAAO,MAAM,yBAAyB,EAAE,CAAC,CAAC,OAAO,CAC/C,MAAM,EACN,CAAC,CAAC,UAAU,EACZ,UAAU,CAC4B,CAAC"}

package/dist/esm/models/memory-type.js

@@ -1,18 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- * @generated-id: 3a8e06afc770
- */
-import * as openEnums from "../types/enums.js";
-/**
- * Type of long-term memory.
- */
-export const MemoryType = {
-    Semantic: "semantic",
-    Episodic: "episodic",
-    Message: "message",
-};
-/** @internal */
-export const MemoryType$inboundSchema = openEnums.inboundSchema(MemoryType);
-/** @internal */
-export const MemoryType$outboundSchema = openEnums.outboundSchema(MemoryType);
-//# sourceMappingURL=memory-type.js.map

package/dist/esm/models/memory-type.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory-type.js","sourceRoot":"","sources":["../../../src/models/memory-type.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAG/C;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;CACV,CAAC;AAMX,gBAAgB;AAChB,MAAM,CAAC,MAAM,wBAAwB,GAIjC,SAAS,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;AACxC,gBAAgB;AAChB,MAAM,CAAC,MAAM,yBAAyB,GAIlC,SAAS,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC"}

package/src/models/memory-type.ts

@@ -1,34 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- * @generated-id: 3a8e06afc770
- */
-
-import * as z from "zod/v3";
-import * as openEnums from "../types/enums.js";
-import { OpenEnum } from "../types/enums.js";
-
-/**
- * Type of long-term memory.
- */
-export const MemoryType = {
-  Semantic: "semantic",
-  Episodic: "episodic",
-  Message: "message",
-} as const;
-/**
- * Type of long-term memory.
- */
-export type MemoryType = OpenEnum<typeof MemoryType>;
-
-/** @internal */
-export const MemoryType$inboundSchema: z.ZodType<
-  MemoryType,
-  z.ZodTypeDef,
-  unknown
-> = openEnums.inboundSchema(MemoryType);
-/** @internal */
-export const MemoryType$outboundSchema: z.ZodType<
-  string,
-  z.ZodTypeDef,
-  MemoryType
-> = openEnums.outboundSchema(MemoryType);