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

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

@@ -0,0 +1,71 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: c3565f600224
+ */
+
+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 {
+  SummaryViewRefreshMode,
+  SummaryViewRefreshMode$inboundSchema,
+  SummaryViewRefreshMode$outboundSchema,
+} from "./summary-view-refresh-mode.js";
+
+/**
+ * Refresh policy. Continuous views require reconcileIntervalSeconds; manual views omit both interval fields.
+ */
+export type SummaryViewRefreshPolicy = {
+  /**
+   * Summary View refresh mode.
+   */
+  mode: SummaryViewRefreshMode;
+  debounceSeconds?: number | undefined;
+  reconcileIntervalSeconds?: number | undefined;
+};
+
+/** @internal */
+export const SummaryViewRefreshPolicy$inboundSchema: z.ZodType<
+  SummaryViewRefreshPolicy,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  mode: SummaryViewRefreshMode$inboundSchema,
+  debounceSeconds: z.number().int().optional(),
+  reconcileIntervalSeconds: z.number().int().optional(),
+});
+/** @internal */
+export type SummaryViewRefreshPolicy$Outbound = {
+  mode: string;
+  debounceSeconds?: number | undefined;
+  reconcileIntervalSeconds?: number | undefined;
+};
+
+/** @internal */
+export const SummaryViewRefreshPolicy$outboundSchema: z.ZodType<
+  SummaryViewRefreshPolicy$Outbound,
+  z.ZodTypeDef,
+  SummaryViewRefreshPolicy
+> = z.object({
+  mode: SummaryViewRefreshMode$outboundSchema,
+  debounceSeconds: z.number().int().optional(),
+  reconcileIntervalSeconds: z.number().int().optional(),
+});
+
+export function summaryViewRefreshPolicyToJSON(
+  summaryViewRefreshPolicy: SummaryViewRefreshPolicy,
+): string {
+  return JSON.stringify(
+    SummaryViewRefreshPolicy$outboundSchema.parse(summaryViewRefreshPolicy),
+  );
+}
+export function summaryViewRefreshPolicyFromJSON(
+  jsonString: string,
+): SafeParseResult<SummaryViewRefreshPolicy, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SummaryViewRefreshPolicy$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SummaryViewRefreshPolicy' from JSON`,
+  );
+}

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

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 60feda0900f8
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+/**
+ * Manual refresh target. Partition refreshes require an exact configured scope; full refreshes reconcile every current and prior partition.
+ */
+export const SummaryViewRefreshTarget = {
+  Partition: "partition",
+  Full: "full",
+} as const;
+/**
+ * Manual refresh target. Partition refreshes require an exact configured scope; full refreshes reconcile every current and prior partition.
+ */
+export type SummaryViewRefreshTarget = OpenEnum<
+  typeof SummaryViewRefreshTarget
+>;
+
+/** @internal */
+export const SummaryViewRefreshTarget$inboundSchema: z.ZodType<
+  SummaryViewRefreshTarget,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(SummaryViewRefreshTarget);
+/** @internal */
+export const SummaryViewRefreshTarget$outboundSchema: z.ZodType<
+  string,
+  z.ZodTypeDef,
+  SummaryViewRefreshTarget
+> = openEnums.outboundSchema(SummaryViewRefreshTarget);

package/src/models/summary-view-result-error-code.ts

@@ -0,0 +1,32 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 073d8f9874a4
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+/**
+ * Customer-safe refresh failure code. Provider details and source content are never returned.
+ */
+export const SummaryViewResultErrorCode = {
+  SourceLimitExceeded: "SOURCE_LIMIT_EXCEEDED",
+  GenerationFailed: "GENERATION_FAILED",
+  OutputValidationFailed: "OUTPUT_VALIDATION_FAILED",
+  RefreshRetriesExhausted: "REFRESH_RETRIES_EXHAUSTED",
+  InternalError: "INTERNAL_ERROR",
+} as const;
+/**
+ * Customer-safe refresh failure code. Provider details and source content are never returned.
+ */
+export type SummaryViewResultErrorCode = OpenEnum<
+  typeof SummaryViewResultErrorCode
+>;
+
+/** @internal */
+export const SummaryViewResultErrorCode$inboundSchema: z.ZodType<
+  SummaryViewResultErrorCode,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(SummaryViewResultErrorCode);

package/src/models/summary-view-result-status.ts

@@ -0,0 +1,31 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b901f537cbc9
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+/**
+ * Materialization refresh state.
+ */
+export const SummaryViewResultStatus = {
+  Cold: "cold",
+  Pending: "pending",
+  Ready: "ready",
+  Empty: "empty",
+  Refreshing: "refreshing",
+  Failed: "failed",
+} as const;
+/**
+ * Materialization refresh state.
+ */
+export type SummaryViewResultStatus = OpenEnum<typeof SummaryViewResultStatus>;
+
+/** @internal */
+export const SummaryViewResultStatus$inboundSchema: z.ZodType<
+  SummaryViewResultStatus,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(SummaryViewResultStatus);

package/src/models/summary-view-result-value.ts

@@ -0,0 +1,80 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ae168587e9bb
+ */
+
+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";
+
+export type SummaryViewData = {
+  data?: any | undefined;
+};
+
+export type SummaryViewText = {
+  text: string;
+};
+
+/**
+ * Exactly one generated result value. It is omitted for cold, pending, and empty results, and may be omitted for failed results with no last good value.
+ */
+export type SummaryViewResultValue = SummaryViewText | SummaryViewData;
+
+/** @internal */
+export const SummaryViewData$inboundSchema: z.ZodType<
+  SummaryViewData,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  data: z.any().optional(),
+});
+
+export function summaryViewDataFromJSON(
+  jsonString: string,
+): SafeParseResult<SummaryViewData, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SummaryViewData$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SummaryViewData' from JSON`,
+  );
+}
+
+/** @internal */
+export const SummaryViewText$inboundSchema: z.ZodType<
+  SummaryViewText,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  text: z.string(),
+});
+
+export function summaryViewTextFromJSON(
+  jsonString: string,
+): SafeParseResult<SummaryViewText, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SummaryViewText$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SummaryViewText' from JSON`,
+  );
+}
+
+/** @internal */
+export const SummaryViewResultValue$inboundSchema: z.ZodType<
+  SummaryViewResultValue,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  z.lazy(() => SummaryViewText$inboundSchema),
+  z.lazy(() => SummaryViewData$inboundSchema),
+]);
+
+export function summaryViewResultValueFromJSON(
+  jsonString: string,
+): SafeParseResult<SummaryViewResultValue, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SummaryViewResultValue$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SummaryViewResultValue' from JSON`,
+  );
+}

package/src/models/summary-view-schema.ts

@@ -0,0 +1,61 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 118995c2df24
+ */
+
+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 {
+  SummaryViewField,
+  SummaryViewField$inboundSchema,
+  SummaryViewField$Outbound,
+  SummaryViewField$outboundSchema,
+} from "./summary-view-field.js";
+
+/**
+ * Bounded structured-output schema. Nested object schemas, required fields, and arbitrary JSON Schema are not supported in the MVP.
+ */
+export type SummaryViewSchema = {
+  fields: Array<SummaryViewField>;
+};
+
+/** @internal */
+export const SummaryViewSchema$inboundSchema: z.ZodType<
+  SummaryViewSchema,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  fields: z.array(SummaryViewField$inboundSchema),
+});
+/** @internal */
+export type SummaryViewSchema$Outbound = {
+  fields: Array<SummaryViewField$Outbound>;
+};
+
+/** @internal */
+export const SummaryViewSchema$outboundSchema: z.ZodType<
+  SummaryViewSchema$Outbound,
+  z.ZodTypeDef,
+  SummaryViewSchema
+> = z.object({
+  fields: z.array(SummaryViewField$outboundSchema),
+});
+
+export function summaryViewSchemaToJSON(
+  summaryViewSchema: SummaryViewSchema,
+): string {
+  return JSON.stringify(
+    SummaryViewSchema$outboundSchema.parse(summaryViewSchema),
+  );
+}
+export function summaryViewSchemaFromJSON(
+  jsonString: string,
+): SafeParseResult<SummaryViewSchema, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SummaryViewSchema$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SummaryViewSchema' from JSON`,
+  );
+}

package/src/models/summary-view-scope.ts

@@ -0,0 +1,88 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 8ffe0168dbd4
+ */
+
+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";
+
+/**
+ * An exact partition scope. The service requires exactly the fields configured by groupBy; singleton views accept none.
+ */
+export type SummaryViewScope = {
+  /**
+   * Actor/owner identifier (1-64 chars, alphanumeric and dashes). 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.
+   */
+  sessionId?: string | undefined;
+  /**
+   * Server-generated namespace identifier.
+   */
+  namespaceRef?: string | undefined;
+  /**
+   * Identifier of a long-term memory type.
+   *
+   * @remarks
+   *
+   * Built-in types include `semantic`, `episodic`, `message`, and `session_summary_view`.
+   * Stores may also register custom memory types; this open string accepts any
+   * registered type name.
+   *
+   * Constraints: 1-64 chars, must start with a letter, followed by letters, digits,
+   * underscores, or dashes.
+   */
+  memoryType?: string | undefined;
+};
+
+/** @internal */
+export const SummaryViewScope$inboundSchema: z.ZodType<
+  SummaryViewScope,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  ownerId: z.string().optional(),
+  sessionId: z.string().optional(),
+  namespaceRef: z.string().optional(),
+  memoryType: z.string().optional(),
+});
+/** @internal */
+export type SummaryViewScope$Outbound = {
+  ownerId?: string | undefined;
+  sessionId?: string | undefined;
+  namespaceRef?: string | undefined;
+  memoryType?: string | undefined;
+};
+
+/** @internal */
+export const SummaryViewScope$outboundSchema: z.ZodType<
+  SummaryViewScope$Outbound,
+  z.ZodTypeDef,
+  SummaryViewScope
+> = z.object({
+  ownerId: z.string().optional(),
+  sessionId: z.string().optional(),
+  namespaceRef: z.string().optional(),
+  memoryType: z.string().optional(),
+});
+
+export function summaryViewScopeToJSON(
+  summaryViewScope: SummaryViewScope,
+): string {
+  return JSON.stringify(
+    SummaryViewScope$outboundSchema.parse(summaryViewScope),
+  );
+}
+export function summaryViewScopeFromJSON(
+  jsonString: string,
+): SafeParseResult<SummaryViewScope, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SummaryViewScope$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SummaryViewScope' from JSON`,
+  );
+}

package/src/models/summary-view-source.ts

@@ -0,0 +1,27 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: c43fbea27a4f
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * The source record family summarized by a Summary View. The MVP supports long-term memory only.
+ */
+export const SummaryViewSource = {
+  LongTerm: "long_term",
+} as const;
+/**
+ * The source record family summarized by a Summary View. The MVP supports long-term memory only.
+ */
+export type SummaryViewSource = ClosedEnum<typeof SummaryViewSource>;
+
+/** @internal */
+export const SummaryViewSource$inboundSchema: z.ZodNativeEnum<
+  typeof SummaryViewSource
+> = z.nativeEnum(SummaryViewSource);
+/** @internal */
+export const SummaryViewSource$outboundSchema: z.ZodNativeEnum<
+  typeof SummaryViewSource
+> = SummaryViewSource$inboundSchema;

package/src/models/summary-view-state.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 66b182a4a1eb
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+/**
+ * Summary View definition lifecycle state.
+ */
+export const SummaryViewState = {
+  Active: "active",
+  Disabled: "disabled",
+  Deleting: "deleting",
+} as const;
+/**
+ * Summary View definition lifecycle state.
+ */
+export type SummaryViewState = OpenEnum<typeof SummaryViewState>;
+
+/** @internal */
+export const SummaryViewState$inboundSchema: z.ZodType<
+  SummaryViewState,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(SummaryViewState);

package/src/models/summary-view-visibility.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 70b0339fd043
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+/**
+ * The immutable audience of a Summary View.
+ */
+export const SummaryViewVisibility = {
+  Private: "PRIVATE",
+  Shared: "SHARED",
+} as const;
+/**
+ * The immutable audience of a Summary View.
+ */
+export type SummaryViewVisibility = OpenEnum<typeof SummaryViewVisibility>;
+
+/** @internal */
+export const SummaryViewVisibility$inboundSchema: z.ZodType<
+  SummaryViewVisibility,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(SummaryViewVisibility);
+/** @internal */
+export const SummaryViewVisibility$outboundSchema: z.ZodType<
+  string,
+  z.ZodTypeDef,
+  SummaryViewVisibility
+> = openEnums.outboundSchema(SummaryViewVisibility);

package/src/models/summary-view.ts

@@ -0,0 +1,139 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: baf2a4a0aaa7
+ */
+
+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 {
+  FilterConjunction,
+  FilterConjunction$inboundSchema,
+} from "./filter-conjunction.js";
+import {
+  LongTermMemoryFilter,
+  LongTermMemoryFilter$inboundSchema,
+} from "./long-term-memory-filter.js";
+import {
+  SummaryViewEvictionPolicy,
+  SummaryViewEvictionPolicy$inboundSchema,
+} from "./summary-view-eviction-policy.js";
+import {
+  SummaryViewGroupField,
+  SummaryViewGroupField$inboundSchema,
+} from "./summary-view-group-field.js";
+import {
+  SummaryViewOutputConfig,
+  SummaryViewOutputConfig$inboundSchema,
+} from "./summary-view-output-config.js";
+import {
+  SummaryViewRefreshPolicy,
+  SummaryViewRefreshPolicy$inboundSchema,
+} from "./summary-view-refresh-policy.js";
+import {
+  SummaryViewSource,
+  SummaryViewSource$inboundSchema,
+} from "./summary-view-source.js";
+import {
+  SummaryViewState,
+  SummaryViewState$inboundSchema,
+} from "./summary-view-state.js";
+import {
+  SummaryViewVisibility,
+  SummaryViewVisibility$inboundSchema,
+} from "./summary-view-visibility.js";
+
+/**
+ * An owned Summary View definition. Results are separate derived state and never enter long-term-memory search.
+ */
+export type SummaryView = {
+  /**
+   * Server-generated Summary View identifier.
+   */
+  id: string;
+  /**
+   * Immutable canonical user ID assigned by the server. Clients cannot set ownership.
+   */
+  ownerId: string;
+  /**
+   * The immutable audience of a Summary View.
+   */
+  visibility: SummaryViewVisibility;
+  /**
+   * Customer-visible Summary View name (1-100 characters).
+   */
+  name: string;
+  /**
+   * Optional Summary View description (up to 200 characters).
+   */
+  description?: string | undefined;
+  /**
+   * The source record family summarized by a Summary View. The MVP supports long-term memory only.
+   */
+  source: SummaryViewSource;
+  /**
+   * Grouping of filter conditions for long-term memory search.
+   */
+  filter?: LongTermMemoryFilter | undefined;
+  /**
+   * Filter conjunction mode.
+   */
+  filterOp: FilterConjunction;
+  groupBy: Array<SummaryViewGroupField>;
+  /**
+   * Selects the bounded set of grouped results. Matching long-term-memory mutations make a scope recent.
+   */
+  evictionPolicy?: SummaryViewEvictionPolicy | undefined;
+  timeWindowSeconds?: number | undefined;
+  /**
+   * Text or structured generation configuration. Schema is required exactly when format is structured.
+   */
+  output: SummaryViewOutputConfig;
+  /**
+   * Refresh policy. Continuous views require reconcileIntervalSeconds; manual views omit both interval fields.
+   */
+  refreshPolicy: SummaryViewRefreshPolicy;
+  definitionVersion: number;
+  /**
+   * Summary View definition lifecycle state.
+   */
+  state: SummaryViewState;
+  createdAt: Date;
+  updatedAt: Date;
+};
+
+/** @internal */
+export const SummaryView$inboundSchema: z.ZodType<
+  SummaryView,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  ownerId: z.string(),
+  visibility: SummaryViewVisibility$inboundSchema,
+  name: z.string(),
+  description: z.string().optional(),
+  source: SummaryViewSource$inboundSchema,
+  filter: LongTermMemoryFilter$inboundSchema.optional(),
+  filterOp: FilterConjunction$inboundSchema,
+  groupBy: z.array(SummaryViewGroupField$inboundSchema),
+  evictionPolicy: SummaryViewEvictionPolicy$inboundSchema.optional(),
+  timeWindowSeconds: z.number().int().optional(),
+  output: SummaryViewOutputConfig$inboundSchema,
+  refreshPolicy: SummaryViewRefreshPolicy$inboundSchema,
+  definitionVersion: z.number().int(),
+  state: SummaryViewState$inboundSchema,
+  createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  updatedAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+});
+
+export function summaryViewFromJSON(
+  jsonString: string,
+): SafeParseResult<SummaryView, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SummaryView$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SummaryView' from JSON`,
+  );
+}

package/src/models/topics-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 topics. Matching is case-insensitive.
@@ -27,6 +30,17 @@ export type TopicsFilter = {
   all?: Array<string> | undefined;
 };
 
+/** @internal */
+export const TopicsFilter$inboundSchema: z.ZodType<
+  TopicsFilter,
+  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 TopicsFilter$Outbound = {
   eq?: string | undefined;
@@ -50,3 +64,12 @@ export const TopicsFilter$outboundSchema: z.ZodType<
 export function topicsFilterToJSON(topicsFilter: TopicsFilter): string {
   return JSON.stringify(TopicsFilter$outboundSchema.parse(topicsFilter));
 }
+export function topicsFilterFromJSON(
+  jsonString: string,
+): SafeParseResult<TopicsFilter, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => TopicsFilter$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'TopicsFilter' from JSON`,
+  );
+}