@redis-iris/agent-memory 0.4.0-beta.2 → 1.0.0-beta.1

package/src/controlplane/models/create-store-response-content.ts

@@ -6,12 +6,120 @@ 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 {
+  ExtractionCadenceConfig,
+  ExtractionCadenceConfig$inboundSchema,
+} from "./extraction-cadence-config.js";
+import {
+  ExtractionStrategy,
+  ExtractionStrategy$inboundSchema,
+} from "./extraction-strategy.js";
+import {
+  LongTermMemoryConfigStatus,
+  LongTermMemoryConfigStatus$inboundSchema,
+} from "./long-term-memory-config-status.js";
+import {
+  LongTermMemoryExclusionsConfig,
+  LongTermMemoryExclusionsConfig$inboundSchema,
+} from "./long-term-memory-exclusions-config.js";
+import {
+  ResourceState,
+  ResourceState$inboundSchema,
+} from "./resource-state.js";
+import {
+  ShortMemoryConfigStatus,
+  ShortMemoryConfigStatus$inboundSchema,
+} from "./short-memory-config-status.js";
+import {
+  StoreDatabase,
+  StoreDatabase$inboundSchema,
+} from "./store-database.js";
+import {
+  StoreEndpoint,
+  StoreEndpoint$inboundSchema,
+} from "./store-endpoint.js";
+import { StoreFailure, StoreFailure$inboundSchema } from "./store-failure.js";
+import {
+  SummarizationConfig,
+  SummarizationConfig$inboundSchema,
+} from "./summarization-config.js";
 
+/**
+ * Memory store configuration and status.
+ */
 export type CreateStoreResponseContent = {
   /**
-   * The ID of the created memory store.
+   * The UTC timestamp when the memory store was created.
+   */
+  createdAt: Date;
+  /**
+   * The database a memory store's data is stored in.
+   */
+  database: StoreDatabase;
+  /**
+   * Redis Cloud only. API endpoints for accessing the memory store.
+   */
+  endpoints?: Array<StoreEndpoint> | undefined;
+  /**
+   * Cadence configuration for the extraction pipeline.
+   */
+  extractionCadence?: ExtractionCadenceConfig | undefined;
+  /**
+   * Extraction strategy for promoting short-term memory to long-term memory. Defaults
+   *
+   * @remarks
+   * to `INSTRUCT`.
+   */
+  extractionStrategy: ExtractionStrategy;
+  /**
+   * Why the store failed to provision. Present only when the store's `state` is
+   *
+   * @remarks
+   * `UNAVAILABLE`. Not returned by ListStores.
+   */
+  failure?: StoreFailure | undefined;
+  /**
+   * Long-term memory configuration. On Redis Cloud, `embedding`, `llm`, and
+   *
+   * @remarks
+   * `classification` are present only when the store selected its own models.
+   */
+  longTermMemory: LongTermMemoryConfigStatus;
+  /**
+   * Store-level sensitive-data exclusions policy.
+   */
+  longTermMemoryExclusions?: LongTermMemoryExclusionsConfig | undefined;
+  /**
+   * Human-readable name of the memory store.
+   */
+  name: string;
+  /**
+   * Short-term memory configuration. Omitted when no TTL is set.
+   */
+  shortMemory?: ShortMemoryConfigStatus | undefined;
+  /**
+   * The condition of a provisioned resource, returned as `state`. Code that waits for a
+   *
+   * @remarks
+   * resource to be usable waits for `READY` on every product. A resource reports only the
+   * values it can reach.
+   */
+  state: ResourceState;
+  /**
+   * Unique identifier for the memory store.
    */
   storeId: string;
+  /**
+   * Redis Cloud only. The memory store's database subscription ID.
+   */
+  subscriptionId?: string | undefined;
+  /**
+   * Configuration for session summarization. When enabled, long sessions are
+   *
+   * @remarks
+   * periodically condensed into a running summary while retaining the most recent events.
+   */
+  summarization?: SummarizationConfig | undefined;
 };
 
 /** @internal */
@@ -20,7 +128,21 @@ export const CreateStoreResponseContent$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
+  createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  database: StoreDatabase$inboundSchema,
+  endpoints: z.array(StoreEndpoint$inboundSchema).optional(),
+  extractionCadence: ExtractionCadenceConfig$inboundSchema.optional(),
+  extractionStrategy: ExtractionStrategy$inboundSchema,
+  failure: StoreFailure$inboundSchema.optional(),
+  longTermMemory: LongTermMemoryConfigStatus$inboundSchema,
+  longTermMemoryExclusions: LongTermMemoryExclusionsConfig$inboundSchema
+    .optional(),
+  name: z.string(),
+  shortMemory: ShortMemoryConfigStatus$inboundSchema.optional(),
+  state: ResourceState$inboundSchema,
   storeId: z.string(),
+  subscriptionId: z.string().optional(),
+  summarization: SummarizationConfig$inboundSchema.optional(),
 });
 
 export function createStoreResponseContentFromJSON(

package/src/controlplane/models/custom-extraction-strategy-update.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+
+/**
+ * A change to a memory type's extraction strategy. Omitted members are unchanged.
+ */
+export type CustomExtractionStrategyUpdate = {
+  /**
+   * Replacement enabled flag.
+   */
+  enabled?: boolean | undefined;
+  /**
+   * Replacement extraction prompt.
+   */
+  prompt?: string | undefined;
+};
+
+/** @internal */
+export type CustomExtractionStrategyUpdate$Outbound = {
+  enabled?: boolean | undefined;
+  prompt?: string | undefined;
+};
+
+/** @internal */
+export const CustomExtractionStrategyUpdate$outboundSchema: z.ZodType<
+  CustomExtractionStrategyUpdate$Outbound,
+  z.ZodTypeDef,
+  CustomExtractionStrategyUpdate
+> = z.object({
+  enabled: z.boolean().optional(),
+  prompt: z.string().optional(),
+});
+
+export function customExtractionStrategyUpdateToJSON(
+  customExtractionStrategyUpdate: CustomExtractionStrategyUpdate,
+): string {
+  return JSON.stringify(
+    CustomExtractionStrategyUpdate$outboundSchema.parse(
+      customExtractionStrategyUpdate,
+    ),
+  );
+}

package/src/controlplane/models/custom-field-type.ts

@@ -10,13 +10,13 @@ import { OpenEnum } from "../types/enums.js";
  * Supported custom field data types.
  */
 export const CustomFieldType = {
-  Str: "str",
-  Int: "int",
-  Float: "float",
-  Bool: "bool",
-  ListStr: "list[str]",
-  ListFloat: "list[float]",
-  Object: "object",
+  String: "STRING",
+  Integer: "INTEGER",
+  Float: "FLOAT",
+  Boolean: "BOOLEAN",
+  StringList: "STRING_LIST",
+  FloatList: "FLOAT_LIST",
+  Object: "OBJECT",
 } as const;
 /**
  * Supported custom field data types.

package/src/controlplane/models/custom-memory-type.ts

@@ -45,7 +45,7 @@ export type CustomMemoryType = {
    * Unique type name within the store. Must not collide with built-in types
    *
    * @remarks
-   * (semantic, episodic, message, session_summary_view).
+   * (semantic, episodic, message, session_summary, session_summary_view).
    */
   name: string;
 };

package/src/controlplane/models/database-ref.ts

@@ -11,12 +11,12 @@ export type DatabaseRef = {
   /**
    * The database ID.
    */
-  id: string;
+  databaseId: string;
 };
 
 /** @internal */
 export type DatabaseRef$Outbound = {
-  id: string;
+  databaseId: string;
 };
 
 /** @internal */
@@ -25,7 +25,7 @@ export const DatabaseRef$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   DatabaseRef
 > = z.object({
-  id: z.string(),
+  databaseId: z.string(),
 });
 
 export function databaseRefToJSON(databaseRef: DatabaseRef): string {

package/src/controlplane/models/database.ts

@@ -13,29 +13,25 @@ export type Database = {
    */
   accessCidrs?: Array<string> | undefined;
   /**
-   * Cloud provider of the database
-   */
-  databaseProvider?: string | undefined;
-  /**
-   * Cloud region of the database
+   * Whether the database is accessible from the control plane based on IP restrictions
    */
-  databaseRegion?: string | undefined;
+  controlPlaneAccessible: boolean;
   /**
    * ID of the database
    */
-  id: string;
+  databaseId: string;
   /**
-   * Whether the database is accessible from the control plane based on IP restrictions
+   * Cloud provider of the database
    */
-  isCPAccessible: boolean;
+  databaseProvider?: string | undefined;
   /**
-   * Whether the database is eligible for the service being onboarded
+   * Cloud region of the database
    */
-  isEligible: boolean;
+  databaseRegion?: string | undefined;
   /**
-   * Whether the database is active and ready to be used
+   * Whether the database is eligible for the service being onboarded
    */
-  isReady: boolean;
+  eligible: boolean;
   /**
    * Name of the database
    */
@@ -44,6 +40,10 @@ export type Database = {
    * Plan type of the database
    */
   planType?: string | undefined;
+  /**
+   * Whether the database is active and ready to be used
+   */
+  ready: boolean;
   /**
    * Subscription ID of the database
    */
@@ -61,14 +61,14 @@ export const Database$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   accessCidrs: z.array(z.string()).optional(),
+  controlPlaneAccessible: z.boolean(),
+  databaseId: z.string(),
   databaseProvider: z.string().optional(),
   databaseRegion: z.string().optional(),
-  id: z.string(),
-  isCPAccessible: z.boolean(),
-  isEligible: z.boolean(),
-  isReady: z.boolean(),
+  eligible: z.boolean(),
   name: z.string(),
   planType: z.string().optional(),
+  ready: z.boolean(),
   subscriptionId: z.string().optional(),
   tlsEnabled: z.boolean().optional(),
 });

package/src/{models/errors/summary-view-conflict-error-response-content.ts → controlplane/models/errors/bad-request-error-response-content.ts}

@@ -1,16 +1,31 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- * @generated-id: 0a2fed24590b
  */
 
 import * as z from "zod/v3";
 import * as models from "../index.js";
-import { AgentMemoryError } from "./agent-memory-error.js";
+import { AgentMemoryServiceError } from "./agent-memory-service-error.js";
 
 /**
- * A Summary View operation conflicts with the current definition or partition state.
+ * Request validation or input decoding failed.
  */
-export type SummaryViewConflictErrorResponseContentData = {
+export type BadRequestErrorResponseContentData = {
+  /**
+   * A human-readable explanation specific to this occurrence of the problem.
+   */
+  detail?: string | undefined;
+  /**
+   * Every invalid request member found, when the failure is about members.
+   */
+  errors?: Array<models.FieldError> | undefined;
+  /**
+   * A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced.
+   */
+  instance?: string | undefined;
+  /**
+   * The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.
+   */
+  status?: number | undefined;
   /**
    * A short, human-readable summary of the problem
    *
@@ -21,27 +36,31 @@ export type SummaryViewConflictErrorResponseContentData = {
    */
   title: string;
   /**
-   * The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.
+   * Problem type URI for bad request errors.
    */
-  status?: number | undefined;
+  type: models.BadRequestErrorType;
+};
+
+/**
+ * Request validation or input decoding failed.
+ */
+export class BadRequestErrorResponseContent extends AgentMemoryServiceError {
   /**
    * A human-readable explanation specific to this occurrence of the problem.
    */
   detail?: string | undefined;
+  /**
+   * Every invalid request member found, when the failure is about members.
+   */
+  errors?: Array<models.FieldError> | undefined;
   /**
    * A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced.
    */
   instance?: string | undefined;
   /**
-   * Problem type URI for Summary View conflicts.
+   * The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.
    */
-  type: models.SummaryViewConflictErrorType;
-};
-
-/**
- * A Summary View operation conflicts with the current definition or partition state.
- */
-export class SummaryViewConflictErrorResponseContent extends AgentMemoryError {
+  status?: number | undefined;
   /**
    * A short, human-readable summary of the problem
    *
@@ -52,27 +71,15 @@ export class SummaryViewConflictErrorResponseContent extends AgentMemoryError {
    */
   title: string;
   /**
-   * The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.
-   */
-  status?: number | undefined;
-  /**
-   * A human-readable explanation specific to this occurrence of the problem.
+   * Problem type URI for bad request errors.
    */
-  detail?: string | undefined;
-  /**
-   * A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced.
-   */
-  instance?: string | undefined;
-  /**
-   * Problem type URI for Summary View conflicts.
-   */
-  type: models.SummaryViewConflictErrorType;
+  type: models.BadRequestErrorType;
 
   /** The original data that was passed to this error instance. */
-  data$: SummaryViewConflictErrorResponseContentData;
+  data$: BadRequestErrorResponseContentData;
 
   constructor(
-    err: SummaryViewConflictErrorResponseContentData,
+    err: BadRequestErrorResponseContentData,
     httpMeta: { response: Response; request: Request; body: string },
   ) {
     const message = "message" in err && typeof err.message === "string"
@@ -80,33 +87,35 @@ export class SummaryViewConflictErrorResponseContent extends AgentMemoryError {
       : `API error occurred: ${JSON.stringify(err)}`;
     super(message, httpMeta);
     this.data$ = err;
-    this.title = err.title;
-    if (err.status != null) this.status = err.status;
     if (err.detail != null) this.detail = err.detail;
+    if (err.errors != null) this.errors = err.errors;
     if (err.instance != null) this.instance = err.instance;
+    if (err.status != null) this.status = err.status;
+    this.title = err.title;
     this.type = err.type;
 
-    this.name = "SummaryViewConflictErrorResponseContent";
+    this.name = "BadRequestErrorResponseContent";
   }
 }
 
 /** @internal */
-export const SummaryViewConflictErrorResponseContent$inboundSchema: z.ZodType<
-  SummaryViewConflictErrorResponseContent,
+export const BadRequestErrorResponseContent$inboundSchema: z.ZodType<
+  BadRequestErrorResponseContent,
   z.ZodTypeDef,
   unknown
 > = z.object({
-  title: z.string(),
-  status: z.number().int().default(409),
   detail: z.string().optional(),
+  errors: z.array(models.FieldError$inboundSchema).optional(),
   instance: z.string().optional(),
-  type: models.SummaryViewConflictErrorType$inboundSchema,
+  status: z.number().int().default(400),
+  title: z.string(),
+  type: models.BadRequestErrorType$inboundSchema,
   request$: z.instanceof(Request),
   response$: z.instanceof(Response),
   body$: z.string(),
 })
   .transform((v) => {
-    return new SummaryViewConflictErrorResponseContent(v, {
+    return new BadRequestErrorResponseContent(v, {
       request: v.request$,
       response: v.response$,
       body: v.body$,

package/src/controlplane/models/errors/conflict-error-response-content.ts

@@ -14,6 +14,10 @@ export type ConflictErrorResponseContentData = {
    * A human-readable explanation specific to this occurrence of the problem.
    */
   detail?: string | undefined;
+  /**
+   * The ID of the existing resource the request collided with, when the conflict names one.
+   */
+  existingId?: string | undefined;
   /**
    * A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced.
    */
@@ -45,6 +49,10 @@ export class ConflictErrorResponseContent extends AgentMemoryServiceError {
    * A human-readable explanation specific to this occurrence of the problem.
    */
   detail?: string | undefined;
+  /**
+   * The ID of the existing resource the request collided with, when the conflict names one.
+   */
+  existingId?: string | undefined;
   /**
    * A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced.
    */
@@ -80,6 +88,7 @@ export class ConflictErrorResponseContent extends AgentMemoryServiceError {
     super(message, httpMeta);
     this.data$ = err;
     if (err.detail != null) this.detail = err.detail;
+    if (err.existingId != null) this.existingId = err.existingId;
     if (err.instance != null) this.instance = err.instance;
     if (err.status != null) this.status = err.status;
     this.title = err.title;
@@ -96,6 +105,7 @@ export const ConflictErrorResponseContent$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   detail: z.string().optional(),
+  existingId: z.string().optional(),
   instance: z.string().optional(),
   status: z.number().int().default(409),
   title: z.string(),

package/src/controlplane/models/errors/index.ts

@@ -5,12 +5,14 @@
 export * from "./agent-memory-default-error.js";
 export * from "./agent-memory-service-error.js";
 export * from "./authentication-error-response-content.js";
+export * from "./bad-request-error-response-content.js";
 export * from "./conflict-error-response-content.js";
 export * from "./failed-dependency-error-response-content.js";
 export * from "./forbidden-error-response-content.js";
 export * from "./http-client-errors.js";
-export * from "./memory-bad-request-error-response-content.js";
 export * from "./not-found-error-response-content.js";
+export * from "./not-implemented-error-response-content.js";
+export * from "./precondition-failed-error-response-content.js";
 export * from "./response-validation-error.js";
 export * from "./sdk-validation-error.js";
 export * from "./service-unavailable-error-response-content.js";

package/src/controlplane/models/errors/{memory-bad-request-error-response-content.ts → not-implemented-error-response-content.ts}

@@ -7,14 +7,13 @@ import * as models from "../index.js";
 import { AgentMemoryServiceError } from "./agent-memory-service-error.js";
 
 /**
- * Agent Memory request validation or input decoding failed.
+ * The requested capability is recognized but not implemented.
  */
-export type MemoryBadRequestErrorResponseContentData = {
+export type NotImplementedErrorResponseContentData = {
   /**
    * A human-readable explanation specific to this occurrence of the problem.
    */
   detail?: string | undefined;
-  fields?: Array<models.FieldError> | undefined;
   /**
    * A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced.
    */
@@ -33,22 +32,21 @@ export type MemoryBadRequestErrorResponseContentData = {
    */
   title: string;
   /**
-   * Problem type URI for Agent Memory request errors.
+   * Problem type URI for not-implemented errors.
    */
-  type: models.MemoryBadRequestErrorType;
+  type: models.NotImplementedErrorType;
 };
 
 /**
- * Agent Memory request validation or input decoding failed.
+ * The requested capability is recognized but not implemented.
  */
-export class MemoryBadRequestErrorResponseContent
+export class NotImplementedErrorResponseContent
   extends AgentMemoryServiceError
 {
   /**
    * A human-readable explanation specific to this occurrence of the problem.
    */
   detail?: string | undefined;
-  fields?: Array<models.FieldError> | undefined;
   /**
    * A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced.
    */
@@ -67,15 +65,15 @@ export class MemoryBadRequestErrorResponseContent
    */
   title: string;
   /**
-   * Problem type URI for Agent Memory request errors.
+   * Problem type URI for not-implemented errors.
    */
-  type: models.MemoryBadRequestErrorType;
+  type: models.NotImplementedErrorType;
 
   /** The original data that was passed to this error instance. */
-  data$: MemoryBadRequestErrorResponseContentData;
+  data$: NotImplementedErrorResponseContentData;
 
   constructor(
-    err: MemoryBadRequestErrorResponseContentData,
+    err: NotImplementedErrorResponseContentData,
     httpMeta: { response: Response; request: Request; body: string },
   ) {
     const message = "message" in err && typeof err.message === "string"
@@ -84,34 +82,32 @@ export class MemoryBadRequestErrorResponseContent
     super(message, httpMeta);
     this.data$ = err;
     if (err.detail != null) this.detail = err.detail;
-    if (err.fields != null) this.fields = err.fields;
     if (err.instance != null) this.instance = err.instance;
     if (err.status != null) this.status = err.status;
     this.title = err.title;
     this.type = err.type;
 
-    this.name = "MemoryBadRequestErrorResponseContent";
+    this.name = "NotImplementedErrorResponseContent";
   }
 }
 
 /** @internal */
-export const MemoryBadRequestErrorResponseContent$inboundSchema: z.ZodType<
-  MemoryBadRequestErrorResponseContent,
+export const NotImplementedErrorResponseContent$inboundSchema: z.ZodType<
+  NotImplementedErrorResponseContent,
   z.ZodTypeDef,
   unknown
 > = z.object({
   detail: z.string().optional(),
-  fields: z.array(models.FieldError$inboundSchema).optional(),
   instance: z.string().optional(),
-  status: z.number().int().default(400),
+  status: z.number().int().default(501),
   title: z.string(),
-  type: models.MemoryBadRequestErrorType$inboundSchema,
+  type: models.NotImplementedErrorType$inboundSchema,
   request$: z.instanceof(Request),
   response$: z.instanceof(Response),
   body$: z.string(),
 })
   .transform((v) => {
-    return new MemoryBadRequestErrorResponseContent(v, {
+    return new NotImplementedErrorResponseContent(v, {
       request: v.request$,
       response: v.response$,
       body: v.body$,