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

package/src/models/operations/add-session-event.ts

@@ -3,6 +3,41 @@
  * @generated-id: de9c1b204447
  */
 
+import * as z from "zod/v3";
+import * as models from "../index.js";
+
 export type AddSessionEventGlobals = {
   storeId?: string | undefined;
 };
+
+export type AddSessionEventRequest = {
+  /**
+   * The session ID.
+   */
+  sessionId: string;
+  body: models.AddSessionEventRequestContent;
+};
+
+/** @internal */
+export type AddSessionEventRequest$Outbound = {
+  sessionId: string;
+  body: models.AddSessionEventRequestContent$Outbound;
+};
+
+/** @internal */
+export const AddSessionEventRequest$outboundSchema: z.ZodType<
+  AddSessionEventRequest$Outbound,
+  z.ZodTypeDef,
+  AddSessionEventRequest
+> = z.object({
+  sessionId: z.string(),
+  body: models.AddSessionEventRequestContent$outboundSchema,
+});
+
+export function addSessionEventRequestToJSON(
+  addSessionEventRequest: AddSessionEventRequest,
+): string {
+  return JSON.stringify(
+    AddSessionEventRequest$outboundSchema.parse(addSessionEventRequest),
+  );
+}

package/src/models/operations/create-session.ts

@@ -0,0 +1,8 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: d02c88572628
+ */
+
+export type CreateSessionGlobals = {
+  storeId?: string | undefined;
+};

package/src/models/operations/delete-namespace.ts

@@ -11,7 +11,7 @@ export type DeleteNamespaceGlobals = {
 
 export type DeleteNamespaceRequest = {
   /**
-   * Server-generated namespace identifier.
+   * Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters.
    */
   namespaceId: string;
 };

package/src/models/operations/delete-summary-view.ts

@@ -11,7 +11,7 @@ export type DeleteSummaryViewGlobals = {
 
 export type DeleteSummaryViewRequest = {
   /**
-   * Server-generated Summary View identifier.
+   * Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters.
    */
   viewId: string;
 };

package/src/models/operations/get-document-ingestion.ts

@@ -11,7 +11,7 @@ export type GetDocumentIngestionGlobals = {
 
 export type GetDocumentIngestionRequest = {
   /**
-   * Server-generated document ingestion identifier.
+   * Server-generated document ingestion identifier: ing_ followed by 32 lowercase hex characters.
    */
   ingestionId: string;
 };

package/src/models/operations/get-namespace.ts

@@ -11,7 +11,7 @@ export type GetNamespaceGlobals = {
 
 export type GetNamespaceRequest = {
   /**
-   * Server-generated namespace identifier.
+   * Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters.
    */
   namespaceId: string;
 };

package/src/models/operations/get-summary-view-result.ts

@@ -11,27 +11,30 @@ export type GetSummaryViewResultGlobals = {
 
 export type GetSummaryViewResultRequest = {
   /**
-   * Server-generated Summary View identifier.
+   * Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters.
    */
   viewId: string;
   /**
-   * Actor/owner identifier (1-64 chars, alphanumeric and dashes). Used for users, agents, or other participants.
+   * Actor/owner identifier: a user ID, so it follows the Iris identifier rule (1-64 chars: letters, digits and _+=.@-, not . or .., case-sensitive). Used for users, agents, or other participants.
    */
   ownerId?: string | undefined;
   /**
-   * Session identifier (1-64 chars, alphanumeric and dashes). When the server generates one, it uses a 32-character UUID without dashes.
+   * Session identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). When the server generates one, it uses 32 lowercase hex characters.
    */
   sessionId?: string | undefined;
   /**
-   * Server-generated namespace identifier.
+   * Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters.
    */
-  namespaceRef?: string | undefined;
+  namespaceId?: string | undefined;
   /**
    * Identifier of a long-term memory type.
    *
    * @remarks
    *
-   * Built-in types include `semantic`, `episodic`, `message`, and `session_summary_view`.
+   * Built-in types include `semantic`, `episodic`, `message`, and `session_summary`.
+   * The legacy `session_summary_view` name remains reserved. Search filters for either
+   * summary name match both, except on stores with an existing custom `session_summary`
+   * type, where each name retains its separate meaning.
    * Stores may also register custom memory types; this open string accepts any
    * registered type name.
    *
@@ -47,7 +50,7 @@ export type GetSummaryViewResultRequest$Outbound = {
   viewId: string;
   ownerId?: string | undefined;
   sessionId?: string | undefined;
-  namespaceRef?: string | undefined;
+  namespaceId?: string | undefined;
   memoryType?: string | undefined;
   includeSourceMemoryIds?: boolean | undefined;
 };
@@ -61,7 +64,7 @@ export const GetSummaryViewResultRequest$outboundSchema: z.ZodType<
   viewId: z.string(),
   ownerId: z.string().optional(),
   sessionId: z.string().optional(),
-  namespaceRef: z.string().optional(),
+  namespaceId: z.string().optional(),
   memoryType: z.string().optional(),
   includeSourceMemoryIds: z.boolean().optional(),
 });

package/src/models/operations/get-summary-view.ts

@@ -11,7 +11,7 @@ export type GetSummaryViewGlobals = {
 
 export type GetSummaryViewRequest = {
   /**
-   * Server-generated Summary View identifier.
+   * Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters.
    */
   viewId: string;
 };

package/src/models/operations/index.ts

@@ -8,6 +8,7 @@ export * from "./bulk-create-long-term-memories.js";
 export * from "./bulk-delete-long-term-memories.js";
 export * from "./create-document-ingestion.js";
 export * from "./create-namespace.js";
+export * from "./create-session.js";
 export * from "./create-summary-view.js";
 export * from "./delete-namespace.js";
 export * from "./delete-session-event.js";
@@ -27,7 +28,6 @@ export * from "./list-ingestion-hook-statuses.js";
 export * from "./list-memory-source-evidence.js";
 export * from "./list-memory-source-links.js";
 export * from "./list-namespaces.js";
-export * from "./list-session-summaries.js";
 export * from "./list-sessions.js";
 export * from "./list-source-memories.js";
 export * from "./list-summary-views.js";

package/src/models/operations/list-document-ingestion-outputs.ts

@@ -11,18 +11,24 @@ export type ListDocumentIngestionOutputsGlobals = {
 
 export type ListDocumentIngestionOutputsRequest = {
   /**
-   * Server-generated document ingestion identifier.
+   * Server-generated document ingestion identifier: ing_ followed by 32 lowercase hex characters.
    */
   ingestionId: string;
+  /**
+   * Maximum number of memory IDs to return. Defaults to 50. Allowed range: 1-100.
+   */
   limit?: number | undefined;
-  offset?: number | undefined;
+  /**
+   * Opaque position in a list, returned as `nextCursor` and passed back as `cursor`.
+   */
+  cursor?: string | undefined;
 };
 
 /** @internal */
 export type ListDocumentIngestionOutputsRequest$Outbound = {
   ingestionId: string;
   limit?: number | undefined;
-  offset?: number | undefined;
+  cursor?: string | undefined;
 };
 
 /** @internal */
@@ -33,7 +39,7 @@ export const ListDocumentIngestionOutputsRequest$outboundSchema: z.ZodType<
 > = z.object({
   ingestionId: z.string(),
   limit: z.number().int().optional(),
-  offset: z.number().int().optional(),
+  cursor: z.string().optional(),
 });
 
 export function listDocumentIngestionOutputsRequestToJSON(

package/src/models/operations/list-ingestion-hook-statuses.ts

@@ -11,6 +11,9 @@ export type ListIngestionHookStatusesGlobals = {
 
 export type ListIngestionHookStatusesRequest = {
   limit?: number | undefined;
+  /**
+   * Opaque position in a list, returned as `nextCursor` and passed back as `cursor`.
+   */
   cursor?: string | undefined;
 };
 

package/src/models/operations/list-memory-source-evidence.ts

@@ -11,7 +11,7 @@ export type ListMemorySourceEvidenceGlobals = {
 
 export type ListMemorySourceEvidenceRequest = {
   /**
-   * Memory record identifier (1-64 chars, alphanumeric and dashes). Client-provided for idempotent long-term memory creation.
+   * Memory record identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). Client-provided for idempotent long-term memory creation.
    */
   memoryId: string;
   /**
@@ -19,7 +19,10 @@ export type ListMemorySourceEvidenceRequest = {
    */
   sourceId: string;
   limit?: number | undefined;
-  pageToken?: string | undefined;
+  /**
+   * Opaque position in a list, returned as `nextCursor` and passed back as `cursor`.
+   */
+  cursor?: string | undefined;
 };
 
 /** @internal */
@@ -27,7 +30,7 @@ export type ListMemorySourceEvidenceRequest$Outbound = {
   memoryId: string;
   sourceId: string;
   limit?: number | undefined;
-  pageToken?: string | undefined;
+  cursor?: string | undefined;
 };
 
 /** @internal */
@@ -39,7 +42,7 @@ export const ListMemorySourceEvidenceRequest$outboundSchema: z.ZodType<
   memoryId: z.string(),
   sourceId: z.string(),
   limit: z.number().int().optional(),
-  pageToken: z.string().optional(),
+  cursor: z.string().optional(),
 });
 
 export function listMemorySourceEvidenceRequestToJSON(

package/src/models/operations/list-memory-source-links.ts

@@ -11,18 +11,21 @@ export type ListMemorySourceLinksGlobals = {
 
 export type ListMemorySourceLinksRequest = {
   /**
-   * Memory record identifier (1-64 chars, alphanumeric and dashes). Client-provided for idempotent long-term memory creation.
+   * Memory record identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). Client-provided for idempotent long-term memory creation.
    */
   memoryId: string;
   limit?: number | undefined;
-  pageToken?: string | undefined;
+  /**
+   * Opaque position in a list, returned as `nextCursor` and passed back as `cursor`.
+   */
+  cursor?: string | undefined;
 };
 
 /** @internal */
 export type ListMemorySourceLinksRequest$Outbound = {
   memoryId: string;
   limit?: number | undefined;
-  pageToken?: string | undefined;
+  cursor?: string | undefined;
 };
 
 /** @internal */
@@ -33,7 +36,7 @@ export const ListMemorySourceLinksRequest$outboundSchema: z.ZodType<
 > = z.object({
   memoryId: z.string(),
   limit: z.number().int().optional(),
-  pageToken: z.string().optional(),
+  cursor: z.string().optional(),
 });
 
 export function listMemorySourceLinksRequestToJSON(

package/src/models/operations/list-namespaces.ts

@@ -32,13 +32,13 @@ export type ListNamespacesRequest = {
    */
   sortOrder?: models.NamespaceSortOrder | undefined;
   /**
-   * Maximum number of namespaces to return. Defaults to 100. Allowed range: 1-1000.
+   * Maximum number of namespaces to return. Defaults to 100. Allowed range: 1-200.
    */
   limit?: number | undefined;
   /**
    * Opaque token from a previous response for the next page.
    */
-  pageToken?: string | undefined;
+  cursor?: string | undefined;
 };
 
 /** @internal */
@@ -49,7 +49,7 @@ export type ListNamespacesRequest$Outbound = {
   sortBy?: string | undefined;
   sortOrder?: string | undefined;
   limit: number;
-  pageToken?: string | undefined;
+  cursor?: string | undefined;
 };
 
 /** @internal */
@@ -64,7 +64,7 @@ export const ListNamespacesRequest$outboundSchema: z.ZodType<
   sortBy: models.NamespaceSortBy$outboundSchema.optional(),
   sortOrder: models.NamespaceSortOrder$outboundSchema.optional(),
   limit: z.number().int().default(100),
-  pageToken: z.string().optional(),
+  cursor: z.string().optional(),
 });
 
 export function listNamespacesRequestToJSON(

package/src/models/operations/list-sessions.ts

@@ -4,6 +4,7 @@
  */
 
 import * as z from "zod/v3";
+import * as models from "../index.js";
 
 export type ListSessionsGlobals = {
   storeId?: string | undefined;
@@ -11,34 +12,44 @@ export type ListSessionsGlobals = {
 
 export type ListSessionsRequest = {
   /**
-   * Maximum number of sessions to return. Defaults to 100. Allowed range: 1-1000.
+   * Maximum number of sessions to return. Defaults to 100. Allowed range: 1-200.
    */
   limit?: number | undefined;
   /**
-   * Opaque token from a previous response for the next page.
+   * Opaque token from a previous response for the next page. Bound to the effective filters and sort.
    */
-  pageToken?: string | undefined;
+  cursor?: string | undefined;
   /**
-   * Filter sessions by owner. The owner of a session is the actorId of its first event. Matching is exact and case-sensitive. Mutually exclusive with includeAll.
+   * Filter sessions by owner. The owner of a session is the actorId of its first event. Matching is exact and case-sensitive. Combined with namespaceId using AND. Mutually exclusive with includeAll.
    */
-  filterOwnerId?: string | undefined;
+  ownerId?: string | undefined;
   /**
-   * Filter sessions by stable namespace ID. Matching is exact and case-sensitive, excludes deprecated namespace labels and sessions without a namespace resource, and does not include descendants. Combined with filterOwnerId using AND. Mutually exclusive with includeAll.
+   * Filter by stable namespace ID. Combined with ownerId using AND. Mutually exclusive with includeAll.
    */
-  namespaceRef?: string | undefined;
+  namespaceId?: string | undefined;
   /**
-   * Set to true to list all sessions. Required when no filter is given; mutually exclusive with filters.
+   * Set to true to list all visible sessions. Required when no filter is given; mutually exclusive with filters.
    */
   includeAll?: boolean | undefined;
+  /**
+   * Sort field. Defaults to updatedAt.
+   */
+  sortBy?: models.SessionListSortBy | undefined;
+  /**
+   * Sort direction. Defaults to desc for timestamps and asc for sessionId.
+   */
+  sortOrder?: models.SessionListSortOrder | undefined;
 };
 
 /** @internal */
 export type ListSessionsRequest$Outbound = {
   limit: number;
-  pageToken?: string | undefined;
-  filterOwnerId?: string | undefined;
-  namespaceRef?: string | undefined;
+  cursor?: string | undefined;
+  ownerId?: string | undefined;
+  namespaceId?: string | undefined;
   includeAll?: boolean | undefined;
+  sortBy?: string | undefined;
+  sortOrder?: string | undefined;
 };
 
 /** @internal */
@@ -48,10 +59,12 @@ export const ListSessionsRequest$outboundSchema: z.ZodType<
   ListSessionsRequest
 > = z.object({
   limit: z.number().int().default(100),
-  pageToken: z.string().optional(),
-  filterOwnerId: z.string().optional(),
-  namespaceRef: z.string().optional(),
+  cursor: z.string().optional(),
+  ownerId: z.string().optional(),
+  namespaceId: z.string().optional(),
   includeAll: z.boolean().optional(),
+  sortBy: models.SessionListSortBy$outboundSchema.optional(),
+  sortOrder: models.SessionListSortOrder$outboundSchema.optional(),
 });
 
 export function listSessionsRequestToJSON(

package/src/models/operations/list-source-memories.ts

@@ -15,11 +15,14 @@ export type ListSourceMemoriesRequest = {
    */
   sourceId: string;
   /**
-   * Actor/owner identifier (1-64 chars, alphanumeric and dashes). Used for users, agents, or other participants.
+   * Actor/owner identifier: a user ID, so it follows the Iris identifier rule (1-64 chars: letters, digits and _+=.@-, not . or .., case-sensitive). Used for users, agents, or other participants.
    */
   ownerId: string;
   limit?: number | undefined;
-  pageToken?: string | undefined;
+  /**
+   * Opaque position in a list, returned as `nextCursor` and passed back as `cursor`.
+   */
+  cursor?: string | undefined;
 };
 
 /** @internal */
@@ -27,7 +30,7 @@ export type ListSourceMemoriesRequest$Outbound = {
   sourceId: string;
   ownerId: string;
   limit?: number | undefined;
-  pageToken?: string | undefined;
+  cursor?: string | undefined;
 };
 
 /** @internal */
@@ -39,7 +42,7 @@ export const ListSourceMemoriesRequest$outboundSchema: z.ZodType<
   sourceId: z.string(),
   ownerId: z.string(),
   limit: z.number().int().optional(),
-  pageToken: z.string().optional(),
+  cursor: z.string().optional(),
 });
 
 export function listSourceMemoriesRequestToJSON(

package/src/models/operations/list-summary-views.ts

@@ -11,13 +11,16 @@ export type ListSummaryViewsGlobals = {
 
 export type ListSummaryViewsRequest = {
   limit?: number | undefined;
-  pageToken?: string | undefined;
+  /**
+   * Opaque position in a list, returned as `nextCursor` and passed back as `cursor`.
+   */
+  cursor?: string | undefined;
 };
 
 /** @internal */
 export type ListSummaryViewsRequest$Outbound = {
   limit: number;
-  pageToken?: string | undefined;
+  cursor?: string | undefined;
 };
 
 /** @internal */
@@ -27,7 +30,7 @@ export const ListSummaryViewsRequest$outboundSchema: z.ZodType<
   ListSummaryViewsRequest
 > = z.object({
   limit: z.number().int().default(100),
-  pageToken: z.string().optional(),
+  cursor: z.string().optional(),
 });
 
 export function listSummaryViewsRequestToJSON(

package/src/models/operations/refresh-summary-view.ts

@@ -12,7 +12,7 @@ export type RefreshSummaryViewGlobals = {
 
 export type RefreshSummaryViewRequest = {
   /**
-   * Server-generated Summary View identifier.
+   * Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters.
    */
   viewId: string;
   body: models.RefreshSummaryViewRequestContent;

package/src/models/operations/update-namespace.ts

@@ -12,7 +12,7 @@ export type UpdateNamespaceGlobals = {
 
 export type UpdateNamespaceRequest = {
   /**
-   * Server-generated namespace identifier.
+   * Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters.
    */
   namespaceId: string;
   body?: models.UpdateNamespaceRequestContent | undefined;

package/src/models/operations/update-summary-view.ts

@@ -12,7 +12,7 @@ export type UpdateSummaryViewGlobals = {
 
 export type UpdateSummaryViewRequest = {
   /**
-   * Server-generated Summary View identifier.
+   * Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters.
    */
   viewId: string;
   body?: models.UpdateSummaryViewRequestContent | undefined;

package/src/models/refresh-summary-view-response-content.ts

@@ -14,7 +14,7 @@ import {
 
 export type RefreshSummaryViewResponseContent = {
   /**
-   * Server-generated Summary View identifier.
+   * Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters.
    */
   viewId: string;
   /**

package/src/models/route-strategy-kind.ts

@@ -11,8 +11,8 @@ import { OpenEnum } from "../types/enums.js";
  * Routing strategy kinds. Unknown kinds are rejected. New kinds register on the evaluator without changing namespace records.
  */
 export const RouteStrategyKind = {
-  LlmPrompt: "llm_prompt",
-  MatcherSpec: "matcher_spec",
+  LlmPrompt: "LLM_PROMPT",
+  MatcherSpec: "MATCHER_SPEC",
 } as const;
 /**
  * Routing strategy kinds. Unknown kinds are rejected. New kinds register on the evaluator without changing namespace records.

package/src/models/routing-rule-action.ts

@@ -11,8 +11,8 @@ import { OpenEnum } from "../types/enums.js";
  * Whether the rule accepts into the destination or rejects that destination.
  */
 export const RoutingRuleAction = {
-  Accept: "accept",
-  Reject: "reject",
+  Accept: "ACCEPT",
+  Reject: "REJECT",
 } as const;
 /**
  * Whether the rule accepts into the destination or rejects that destination.

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

@@ -4,10 +4,6 @@
  */
 
 import * as z from "zod/v3";
-import {
-  FilterConjunction,
-  FilterConjunction$outboundSchema,
-} from "./filter-conjunction.js";
 import {
   LongTermMemoryFilter,
   LongTermMemoryFilter$Outbound,
@@ -29,11 +25,11 @@ export type SearchLongTermMemoryRequestContent = {
   /**
    * Text to use for semantic search.
    */
-  text?: string | undefined;
+  query?: string | undefined;
   /**
-   * The minimum similarity threshold for vector search results (normalized cosine similarity). Allowed range: 0-1.
+   * The minimum score for vector search results: (2 - cosine distance) / 2. Allowed range: 0-1.
    */
-  similarityThreshold?: number | undefined;
+  minScore?: number | undefined;
   /**
    * Grouping of filter conditions for long-term memory search.
    */
@@ -42,10 +38,6 @@ export type SearchLongTermMemoryRequestContent = {
    * When true, omit document-managed memories from results. Automatic session reconciliation uses this; public search omits it so document memories remain visible.
    */
   excludeDocumentManaged?: boolean | undefined;
-  /**
-   * Filter conjunction mode.
-   */
-  filterOp?: FilterConjunction | undefined;
   /**
    * Timestamp field used to order long-term memory search results.
    */
@@ -55,26 +47,25 @@ export type SearchLongTermMemoryRequestContent = {
    */
   sortOrder?: LongTermMemorySearchSortOrder | undefined;
   /**
-   * Maximum number of results to return. Defaults to 10. Allowed range: 1-100.
+   * Maximum number of results to return. Defaults to 50. Allowed range: 1-100.
    */
   limit?: number | undefined;
   /**
    * Opaque token from a previous response for the next page.
    */
-  pageToken?: string | undefined;
+  cursor?: string | undefined;
 };
 
 /** @internal */
 export type SearchLongTermMemoryRequestContent$Outbound = {
-  text?: string | undefined;
-  similarityThreshold?: number | undefined;
+  query?: string | undefined;
+  minScore?: number | undefined;
   filter?: LongTermMemoryFilter$Outbound | undefined;
   excludeDocumentManaged?: boolean | undefined;
-  filterOp?: string | undefined;
   sortBy?: string | undefined;
   sortOrder?: string | undefined;
   limit: number;
-  pageToken?: string | undefined;
+  cursor?: string | undefined;
 };
 
 /** @internal */
@@ -83,15 +74,14 @@ export const SearchLongTermMemoryRequestContent$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   SearchLongTermMemoryRequestContent
 > = z.object({
-  text: z.string().optional(),
-  similarityThreshold: z.number().optional(),
+  query: z.string().optional(),
+  minScore: z.number().optional(),
   filter: LongTermMemoryFilter$outboundSchema.optional(),
   excludeDocumentManaged: z.boolean().optional(),
-  filterOp: FilterConjunction$outboundSchema.optional(),
   sortBy: LongTermMemorySearchSortBy$outboundSchema.optional(),
   sortOrder: LongTermMemorySearchSortOrder$outboundSchema.optional(),
-  limit: z.number().int().default(10),
-  pageToken: z.string().optional(),
+  limit: z.number().int().default(50),
+  cursor: z.string().optional(),
 });
 
 export function searchLongTermMemoryRequestContentToJSON(

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

@@ -20,7 +20,7 @@ export type SearchLongTermMemoryResponseContent = {
   /**
    * Opaque token for fetching the next page. Omitted when no more results.
    */
-  nextPageToken?: string | undefined;
+  nextCursor?: string | undefined;
 };
 
 /** @internal */
@@ -30,7 +30,7 @@ export const SearchLongTermMemoryResponseContent$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   items: z.array(MemoryRecord$inboundSchema),
-  nextPageToken: z.string().optional(),
+  nextCursor: z.string().optional(),
 });
 
 export function searchLongTermMemoryResponseContentFromJSON(