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

package/src/models/owner-id-filter.ts

@@ -4,6 +4,9 @@
  */
 
 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";
 
 /**
  * Filter by the long-term memory ownerId field. Matching is case-sensitive.
@@ -27,6 +30,17 @@ export type OwnerIdFilter = {
   all?: Array<string> | undefined;
 };
 
+/** @internal */
+export const OwnerIdFilter$inboundSchema: z.ZodType<
+  OwnerIdFilter,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  eq: z.string().optional(),
+  ne: z.string().optional(),
+  in: z.array(z.string()).optional(),
+  all: z.array(z.string()).optional(),
+});
 /** @internal */
 export type OwnerIdFilter$Outbound = {
   eq?: string | undefined;
@@ -50,3 +64,12 @@ export const OwnerIdFilter$outboundSchema: z.ZodType<
 export function ownerIdFilterToJSON(ownerIdFilter: OwnerIdFilter): string {
   return JSON.stringify(OwnerIdFilter$outboundSchema.parse(ownerIdFilter));
 }
+export function ownerIdFilterFromJSON(
+  jsonString: string,
+): SafeParseResult<OwnerIdFilter, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => OwnerIdFilter$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'OwnerIdFilter' from JSON`,
+  );
+}

package/src/models/put-namespace-routing-request-content.ts

@@ -0,0 +1,42 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 9e40b687cb8e
+ */
+
+import * as z from "zod/v3";
+import {
+  NamespaceRoutingPolicy,
+  NamespaceRoutingPolicy$Outbound,
+  NamespaceRoutingPolicy$outboundSchema,
+} from "./namespace-routing-policy.js";
+
+export type PutNamespaceRoutingRequestContent = {
+  /**
+   * Store-level automatic namespace routing and admission policy. Global rules target shared namespaces only. Accept rules select candidates in list order. All enabled reject rules for a destination apply regardless of their position or how the destination was selected.
+   */
+  policy: NamespaceRoutingPolicy;
+};
+
+/** @internal */
+export type PutNamespaceRoutingRequestContent$Outbound = {
+  policy: NamespaceRoutingPolicy$Outbound;
+};
+
+/** @internal */
+export const PutNamespaceRoutingRequestContent$outboundSchema: z.ZodType<
+  PutNamespaceRoutingRequestContent$Outbound,
+  z.ZodTypeDef,
+  PutNamespaceRoutingRequestContent
+> = z.object({
+  policy: NamespaceRoutingPolicy$outboundSchema,
+});
+
+export function putNamespaceRoutingRequestContentToJSON(
+  putNamespaceRoutingRequestContent: PutNamespaceRoutingRequestContent,
+): string {
+  return JSON.stringify(
+    PutNamespaceRoutingRequestContent$outboundSchema.parse(
+      putNamespaceRoutingRequestContent,
+    ),
+  );
+}

package/src/models/put-namespace-routing-response-content.ts

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 16738dd8a508
+ */
+
+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 {
+  NamespaceRoutingPolicy,
+  NamespaceRoutingPolicy$inboundSchema,
+} from "./namespace-routing-policy.js";
+
+export type PutNamespaceRoutingResponseContent = {
+  /**
+   * Store-level automatic namespace routing and admission policy. Global rules target shared namespaces only. Accept rules select candidates in list order. All enabled reject rules for a destination apply regardless of their position or how the destination was selected.
+   */
+  policy: NamespaceRoutingPolicy;
+};
+
+/** @internal */
+export const PutNamespaceRoutingResponseContent$inboundSchema: z.ZodType<
+  PutNamespaceRoutingResponseContent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  policy: NamespaceRoutingPolicy$inboundSchema,
+});
+
+export function putNamespaceRoutingResponseContentFromJSON(
+  jsonString: string,
+): SafeParseResult<PutNamespaceRoutingResponseContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      PutNamespaceRoutingResponseContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PutNamespaceRoutingResponseContent' from JSON`,
+  );
+}

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

@@ -0,0 +1,52 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: c9646f128159
+ */
+
+import * as z from "zod/v3";
+import {
+  SummaryViewRefreshTarget,
+  SummaryViewRefreshTarget$outboundSchema,
+} from "./summary-view-refresh-target.js";
+import {
+  SummaryViewScope,
+  SummaryViewScope$Outbound,
+  SummaryViewScope$outboundSchema,
+} from "./summary-view-scope.js";
+
+export type RefreshSummaryViewRequestContent = {
+  /**
+   * Manual refresh target. Partition refreshes require an exact configured scope; full refreshes reconcile every current and prior partition.
+   */
+  target: SummaryViewRefreshTarget;
+  /**
+   * An exact partition scope. The service requires exactly the fields configured by groupBy; singleton views accept none.
+   */
+  scope?: SummaryViewScope | undefined;
+};
+
+/** @internal */
+export type RefreshSummaryViewRequestContent$Outbound = {
+  target: string;
+  scope?: SummaryViewScope$Outbound | undefined;
+};
+
+/** @internal */
+export const RefreshSummaryViewRequestContent$outboundSchema: z.ZodType<
+  RefreshSummaryViewRequestContent$Outbound,
+  z.ZodTypeDef,
+  RefreshSummaryViewRequestContent
+> = z.object({
+  target: SummaryViewRefreshTarget$outboundSchema,
+  scope: SummaryViewScope$outboundSchema.optional(),
+});
+
+export function refreshSummaryViewRequestContentToJSON(
+  refreshSummaryViewRequestContent: RefreshSummaryViewRequestContent,
+): string {
+  return JSON.stringify(
+    RefreshSummaryViewRequestContent$outboundSchema.parse(
+      refreshSummaryViewRequestContent,
+    ),
+  );
+}

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

@@ -0,0 +1,46 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 18776ff46003
+ */
+
+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 {
+  SummaryViewRefreshTarget,
+  SummaryViewRefreshTarget$inboundSchema,
+} from "./summary-view-refresh-target.js";
+
+export type RefreshSummaryViewResponseContent = {
+  /**
+   * Server-generated Summary View identifier.
+   */
+  viewId: string;
+  /**
+   * Manual refresh target. Partition refreshes require an exact configured scope; full refreshes reconcile every current and prior partition.
+   */
+  target: SummaryViewRefreshTarget;
+  accepted: boolean;
+};
+
+/** @internal */
+export const RefreshSummaryViewResponseContent$inboundSchema: z.ZodType<
+  RefreshSummaryViewResponseContent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  viewId: z.string(),
+  target: SummaryViewRefreshTarget$inboundSchema,
+  accepted: z.boolean(),
+});
+
+export function refreshSummaryViewResponseContentFromJSON(
+  jsonString: string,
+): SafeParseResult<RefreshSummaryViewResponseContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RefreshSummaryViewResponseContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RefreshSummaryViewResponseContent' from JSON`,
+  );
+}

package/src/models/regex-spec.ts

@@ -0,0 +1,62 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: e852dff87756
+ */
+
+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";
+
+/**
+ * A regular expression to match against.
+ *
+ * @remarks
+ *
+ * Evaluated by RE2, which runs in linear time — so an expensive pattern is not a
+ * denial-of-service risk, but lookaround and backreferences are unavailable.
+ * Rejected on write if it does not compile, or if it can match without consuming
+ * text: such a pattern matches at every position, so it would exclude every memory
+ * the store writes.
+ */
+export type RegexSpec = {
+  /**
+   * The pattern, in RE2 syntax.
+   */
+  pattern: string;
+};
+
+/** @internal */
+export const RegexSpec$inboundSchema: z.ZodType<
+  RegexSpec,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  pattern: z.string(),
+});
+/** @internal */
+export type RegexSpec$Outbound = {
+  pattern: string;
+};
+
+/** @internal */
+export const RegexSpec$outboundSchema: z.ZodType<
+  RegexSpec$Outbound,
+  z.ZodTypeDef,
+  RegexSpec
+> = z.object({
+  pattern: z.string(),
+});
+
+export function regexSpecToJSON(regexSpec: RegexSpec): string {
+  return JSON.stringify(RegexSpec$outboundSchema.parse(regexSpec));
+}
+export function regexSpecFromJSON(
+  jsonString: string,
+): SafeParseResult<RegexSpec, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RegexSpec$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RegexSpec' from JSON`,
+  );
+}

package/src/models/route-condition.ts

@@ -0,0 +1,90 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: d036f7cf5fda
+ */
+
+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 {
+  LlmPromptSpec,
+  LlmPromptSpec$inboundSchema,
+  LlmPromptSpec$Outbound,
+  LlmPromptSpec$outboundSchema,
+} from "./llm-prompt-spec.js";
+import {
+  MatcherSpec,
+  MatcherSpec$inboundSchema,
+  MatcherSpec$Outbound,
+  MatcherSpec$outboundSchema,
+} from "./matcher-spec.js";
+import {
+  RouteStrategyKind,
+  RouteStrategyKind$inboundSchema,
+  RouteStrategyKind$outboundSchema,
+} from "./route-strategy-kind.js";
+
+/**
+ * One plug-in strategy invocation. Exactly the block naming the declared kind must be present. List order is evaluation order.
+ */
+export type RouteCondition = {
+  /**
+   * Routing strategy kinds. Unknown kinds are rejected. New kinds register on the evaluator without changing namespace records.
+   */
+  kind: RouteStrategyKind;
+  /**
+   * Customer-authored prompt evaluated by the LLM routing strategy.
+   */
+  llmPrompt?: LlmPromptSpec | undefined;
+  /**
+   * How a detector matches, as a tagged union of techniques.
+   *
+   * @remarks
+   *
+   * Exactly the block naming the declared kind must be present; a block belonging to
+   * any other kind is rejected rather than guessed at. Further kinds are additive.
+   */
+  matcher?: MatcherSpec | undefined;
+};
+
+/** @internal */
+export const RouteCondition$inboundSchema: z.ZodType<
+  RouteCondition,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  kind: RouteStrategyKind$inboundSchema,
+  llmPrompt: LlmPromptSpec$inboundSchema.optional(),
+  matcher: MatcherSpec$inboundSchema.optional(),
+});
+/** @internal */
+export type RouteCondition$Outbound = {
+  kind: string;
+  llmPrompt?: LlmPromptSpec$Outbound | undefined;
+  matcher?: MatcherSpec$Outbound | undefined;
+};
+
+/** @internal */
+export const RouteCondition$outboundSchema: z.ZodType<
+  RouteCondition$Outbound,
+  z.ZodTypeDef,
+  RouteCondition
+> = z.object({
+  kind: RouteStrategyKind$outboundSchema,
+  llmPrompt: LlmPromptSpec$outboundSchema.optional(),
+  matcher: MatcherSpec$outboundSchema.optional(),
+});
+
+export function routeConditionToJSON(routeCondition: RouteCondition): string {
+  return JSON.stringify(RouteCondition$outboundSchema.parse(routeCondition));
+}
+export function routeConditionFromJSON(
+  jsonString: string,
+): SafeParseResult<RouteCondition, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RouteCondition$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RouteCondition' from JSON`,
+  );
+}

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

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3f304a7dbfc3
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../types/enums.js";
+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",
+} as const;
+/**
+ * Routing strategy kinds. Unknown kinds are rejected. New kinds register on the evaluator without changing namespace records.
+ */
+export type RouteStrategyKind = OpenEnum<typeof RouteStrategyKind>;
+
+/** @internal */
+export const RouteStrategyKind$inboundSchema: z.ZodType<
+  RouteStrategyKind,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(RouteStrategyKind);
+/** @internal */
+export const RouteStrategyKind$outboundSchema: z.ZodType<
+  string,
+  z.ZodTypeDef,
+  RouteStrategyKind
+> = openEnums.outboundSchema(RouteStrategyKind);

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

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ab3603783716
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+/**
+ * Whether the rule accepts into the destination or rejects that destination.
+ */
+export const RoutingRuleAction = {
+  Accept: "accept",
+  Reject: "reject",
+} as const;
+/**
+ * Whether the rule accepts into the destination or rejects that destination.
+ */
+export type RoutingRuleAction = OpenEnum<typeof RoutingRuleAction>;
+
+/** @internal */
+export const RoutingRuleAction$inboundSchema: z.ZodType<
+  RoutingRuleAction,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(RoutingRuleAction);
+/** @internal */
+export const RoutingRuleAction$outboundSchema: z.ZodType<
+  string,
+  z.ZodTypeDef,
+  RoutingRuleAction
+> = openEnums.outboundSchema(RoutingRuleAction);

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

@@ -13,6 +13,14 @@ import {
   LongTermMemoryFilter$Outbound,
   LongTermMemoryFilter$outboundSchema,
 } from "./long-term-memory-filter.js";
+import {
+  LongTermMemorySearchSortBy,
+  LongTermMemorySearchSortBy$outboundSchema,
+} from "./long-term-memory-search-sort-by.js";
+import {
+  LongTermMemorySearchSortOrder,
+  LongTermMemorySearchSortOrder$outboundSchema,
+} from "./long-term-memory-search-sort-order.js";
 
 /**
  * Semantic search request for long-term memory records.
@@ -30,10 +38,22 @@ export type SearchLongTermMemoryRequestContent = {
    * Grouping of filter conditions for long-term memory search.
    */
   filter?: LongTermMemoryFilter | undefined;
+  /**
+   * 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.
+   */
+  sortBy?: LongTermMemorySearchSortBy | undefined;
+  /**
+   * Direction used to order long-term memory search results.
+   */
+  sortOrder?: LongTermMemorySearchSortOrder | undefined;
   /**
    * Maximum number of results to return. Defaults to 10. Allowed range: 1-100.
    */
@@ -49,7 +69,10 @@ export type SearchLongTermMemoryRequestContent$Outbound = {
   text?: string | undefined;
   similarityThreshold?: number | undefined;
   filter?: LongTermMemoryFilter$Outbound | undefined;
+  excludeDocumentManaged?: boolean | undefined;
   filterOp?: string | undefined;
+  sortBy?: string | undefined;
+  sortOrder?: string | undefined;
   limit: number;
   pageToken?: string | undefined;
 };
@@ -63,7 +86,10 @@ export const SearchLongTermMemoryRequestContent$outboundSchema: z.ZodType<
   text: z.string().optional(),
   similarityThreshold: 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(),
 });

package/src/models/session-id-filter.ts

@@ -4,6 +4,9 @@
  */
 
 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";
 
 /**
  * Filter by the long-term memory sessionId field. Matching is case-sensitive.
@@ -27,6 +30,17 @@ export type SessionIdFilter = {
   all?: Array<string> | undefined;
 };
 
+/** @internal */
+export const SessionIdFilter$inboundSchema: z.ZodType<
+  SessionIdFilter,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  eq: z.string().optional(),
+  ne: z.string().optional(),
+  in: z.array(z.string()).optional(),
+  all: z.array(z.string()).optional(),
+});
 /** @internal */
 export type SessionIdFilter$Outbound = {
   eq?: string | undefined;
@@ -52,3 +66,12 @@ export function sessionIdFilterToJSON(
 ): string {
   return JSON.stringify(SessionIdFilter$outboundSchema.parse(sessionIdFilter));
 }
+export function sessionIdFilterFromJSON(
+  jsonString: string,
+): SafeParseResult<SessionIdFilter, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SessionIdFilter$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SessionIdFilter' from JSON`,
+  );
+}

package/src/models/session-list-item.ts

@@ -0,0 +1,55 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 5e877d27387e
+ */
+
+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 { NamespaceRef, NamespaceRef$inboundSchema } from "./namespace-ref.js";
+
+/**
+ * One session row without events or summary text. Owner ID and timestamps are absent when unknown on legacy sessions.
+ */
+export type SessionListItem = {
+  /**
+   * Session identifier (1-64 chars, alphanumeric and dashes). When the server generates one, it uses a 32-character UUID without dashes.
+   */
+  sessionId: string;
+  /**
+   * The owner of the session, set from the actorId of the first event. Absent for a legacy session that has no recorded owner.
+   */
+  ownerId?: string | undefined;
+  createdAt?: Date | undefined;
+  updatedAt?: Date | undefined;
+  /**
+   * Reference to a namespace resource with its stable identifier and current display data.
+   */
+  namespaceRef?: NamespaceRef | undefined;
+};
+
+/** @internal */
+export const SessionListItem$inboundSchema: z.ZodType<
+  SessionListItem,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  sessionId: z.string(),
+  ownerId: z.string().optional(),
+  createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v))
+    .optional(),
+  updatedAt: z.string().datetime({ offset: true }).transform(v => new Date(v))
+    .optional(),
+  namespaceRef: NamespaceRef$inboundSchema.optional(),
+});
+
+export function sessionListItemFromJSON(
+  jsonString: string,
+): SafeParseResult<SessionListItem, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SessionListItem$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SessionListItem' from JSON`,
+  );
+}

package/src/models/session-list-sort-by.ts

@@ -0,0 +1,19 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: c1c0886e955e
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../types/enums.js";
+
+export const SessionListSortBy = {
+  SessionId: "sessionId",
+  CreatedAt: "createdAt",
+  UpdatedAt: "updatedAt",
+} as const;
+export type SessionListSortBy = ClosedEnum<typeof SessionListSortBy>;
+
+/** @internal */
+export const SessionListSortBy$outboundSchema: z.ZodNativeEnum<
+  typeof SessionListSortBy
+> = z.nativeEnum(SessionListSortBy);

package/src/models/session-list-sort-order.ts

@@ -0,0 +1,18 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 6b503ad926fd
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../types/enums.js";
+
+export const SessionListSortOrder = {
+  Asc: "asc",
+  Desc: "desc",
+} as const;
+export type SessionListSortOrder = ClosedEnum<typeof SessionListSortOrder>;
+
+/** @internal */
+export const SessionListSortOrder$outboundSchema: z.ZodNativeEnum<
+  typeof SessionListSortOrder
+> = z.nativeEnum(SessionListSortOrder);