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

package/src/models/list-memory-source-links-response-content.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 6cf8946f2a7d
+ */
+
+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 {
+  MemorySourceLink,
+  MemorySourceLink$inboundSchema,
+} from "./memory-source-link.js";
+
+export type ListMemorySourceLinksResponseContent = {
+  items: Array<MemorySourceLink>;
+  nextPageToken?: string | undefined;
+};
+
+/** @internal */
+export const ListMemorySourceLinksResponseContent$inboundSchema: z.ZodType<
+  ListMemorySourceLinksResponseContent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  items: z.array(MemorySourceLink$inboundSchema),
+  nextPageToken: z.string().optional(),
+});
+
+export function listMemorySourceLinksResponseContentFromJSON(
+  jsonString: string,
+): SafeParseResult<ListMemorySourceLinksResponseContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      ListMemorySourceLinksResponseContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListMemorySourceLinksResponseContent' from JSON`,
+  );
+}

package/src/models/list-session-summaries-response-content.ts

@@ -0,0 +1,44 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: c23ade06b10a
+ */
+
+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 {
+  SessionListItem,
+  SessionListItem$inboundSchema,
+} from "./session-list-item.js";
+
+/**
+ * Paginated session rows for a store.
+ */
+export type ListSessionSummariesResponseContent = {
+  items: Array<SessionListItem>;
+  total: number;
+  nextPageToken?: string | undefined;
+};
+
+/** @internal */
+export const ListSessionSummariesResponseContent$inboundSchema: z.ZodType<
+  ListSessionSummariesResponseContent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  items: z.array(SessionListItem$inboundSchema),
+  total: z.number().int(),
+  nextPageToken: z.string().optional(),
+});
+
+export function listSessionSummariesResponseContentFromJSON(
+  jsonString: string,
+): SafeParseResult<ListSessionSummariesResponseContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      ListSessionSummariesResponseContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListSessionSummariesResponseContent' from JSON`,
+  );
+}

package/src/models/list-source-memories-response-content.ts

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: e2bf9992e361
+ */
+
+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 { MemoryRecord, MemoryRecord$inboundSchema } from "./memory-record.js";
+
+export type ListSourceMemoriesResponseContent = {
+  items: Array<MemoryRecord>;
+  nextPageToken?: string | undefined;
+};
+
+/** @internal */
+export const ListSourceMemoriesResponseContent$inboundSchema: z.ZodType<
+  ListSourceMemoriesResponseContent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  items: z.array(MemoryRecord$inboundSchema),
+  nextPageToken: z.string().optional(),
+});
+
+export function listSourceMemoriesResponseContentFromJSON(
+  jsonString: string,
+): SafeParseResult<ListSourceMemoriesResponseContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ListSourceMemoriesResponseContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListSourceMemoriesResponseContent' from JSON`,
+  );
+}

package/src/models/list-summary-views-response-content.ts

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 441ee2d11eed
+ */
+
+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 { SummaryView, SummaryView$inboundSchema } from "./summary-view.js";
+
+export type ListSummaryViewsResponseContent = {
+  items: Array<SummaryView>;
+  nextPageToken?: string | undefined;
+};
+
+/** @internal */
+export const ListSummaryViewsResponseContent$inboundSchema: z.ZodType<
+  ListSummaryViewsResponseContent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  items: z.array(SummaryView$inboundSchema),
+  nextPageToken: z.string().optional(),
+});
+
+export function listSummaryViewsResponseContentFromJSON(
+  jsonString: string,
+): SafeParseResult<ListSummaryViewsResponseContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ListSummaryViewsResponseContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListSummaryViewsResponseContent' from JSON`,
+  );
+}

package/src/models/llm-prompt-spec.ts

@@ -0,0 +1,51 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 36fcd99097d9
+ */
+
+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";
+
+/**
+ * Customer-authored prompt evaluated by the LLM routing strategy.
+ */
+export type LlmPromptSpec = {
+  prompt: string;
+};
+
+/** @internal */
+export const LlmPromptSpec$inboundSchema: z.ZodType<
+  LlmPromptSpec,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  prompt: z.string(),
+});
+/** @internal */
+export type LlmPromptSpec$Outbound = {
+  prompt: string;
+};
+
+/** @internal */
+export const LlmPromptSpec$outboundSchema: z.ZodType<
+  LlmPromptSpec$Outbound,
+  z.ZodTypeDef,
+  LlmPromptSpec
+> = z.object({
+  prompt: z.string(),
+});
+
+export function llmPromptSpecToJSON(llmPromptSpec: LlmPromptSpec): string {
+  return JSON.stringify(LlmPromptSpec$outboundSchema.parse(llmPromptSpec));
+}
+export function llmPromptSpecFromJSON(
+  jsonString: string,
+): SafeParseResult<LlmPromptSpec, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => LlmPromptSpec$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'LlmPromptSpec' from JSON`,
+  );
+}

package/src/models/long-term-memory-filter.ts

@@ -4,43 +4,54 @@
  */
 
 import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
 import {
   AttributeFilterClause,
+  AttributeFilterClause$inboundSchema,
   AttributeFilterClause$Outbound,
   AttributeFilterClause$outboundSchema,
 } from "./attribute-filter-clause.js";
 import {
   CreatedAtFilter,
+  CreatedAtFilter$inboundSchema,
   CreatedAtFilter$Outbound,
   CreatedAtFilter$outboundSchema,
 } from "./created-at-filter.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
 import {
   MemoryTypeFilter,
+  MemoryTypeFilter$inboundSchema,
   MemoryTypeFilter$Outbound,
   MemoryTypeFilter$outboundSchema,
 } from "./memory-type-filter.js";
 import {
   NamespaceFilter,
+  NamespaceFilter$inboundSchema,
   NamespaceFilter$Outbound,
   NamespaceFilter$outboundSchema,
 } from "./namespace-filter.js";
 import {
   NamespaceRefFilter,
+  NamespaceRefFilter$inboundSchema,
   NamespaceRefFilter$Outbound,
   NamespaceRefFilter$outboundSchema,
 } from "./namespace-ref-filter.js";
 import {
   OwnerIdFilter,
+  OwnerIdFilter$inboundSchema,
   OwnerIdFilter$Outbound,
   OwnerIdFilter$outboundSchema,
 } from "./owner-id-filter.js";
 import {
   SessionIdFilter,
+  SessionIdFilter$inboundSchema,
   SessionIdFilter$Outbound,
   SessionIdFilter$outboundSchema,
 } from "./session-id-filter.js";
 import {
   TopicsFilter,
+  TopicsFilter$inboundSchema,
   TopicsFilter$Outbound,
   TopicsFilter$outboundSchema,
 } from "./topics-filter.js";
@@ -93,6 +104,22 @@ export type LongTermMemoryFilter = {
   attributes?: { [k: string]: AttributeFilterClause } | undefined;
 };
 
+/** @internal */
+export const LongTermMemoryFilter$inboundSchema: z.ZodType<
+  LongTermMemoryFilter,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  sessionId: SessionIdFilter$inboundSchema.optional(),
+  ownerId: OwnerIdFilter$inboundSchema.optional(),
+  namespace: NamespaceFilter$inboundSchema.optional(),
+  namespaceRef: NamespaceRefFilter$inboundSchema.optional(),
+  unnamespaced: z.boolean().optional(),
+  topics: TopicsFilter$inboundSchema.optional(),
+  memoryType: MemoryTypeFilter$inboundSchema.optional(),
+  createdAt: CreatedAtFilter$inboundSchema.optional(),
+  attributes: z.record(AttributeFilterClause$inboundSchema).optional(),
+});
 /** @internal */
 export type LongTermMemoryFilter$Outbound = {
   sessionId?: SessionIdFilter$Outbound | undefined;
@@ -130,3 +157,12 @@ export function longTermMemoryFilterToJSON(
     LongTermMemoryFilter$outboundSchema.parse(longTermMemoryFilter),
   );
 }
+export function longTermMemoryFilterFromJSON(
+  jsonString: string,
+): SafeParseResult<LongTermMemoryFilter, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => LongTermMemoryFilter$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'LongTermMemoryFilter' from JSON`,
+  );
+}

package/src/models/long-term-memory-search-sort-by.ts

@@ -0,0 +1,26 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 75e46f2a8949
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Timestamp field used to order long-term memory search results.
+ */
+export const LongTermMemorySearchSortBy = {
+  CreatedAt: "createdAt",
+  UpdatedAt: "updatedAt",
+} as const;
+/**
+ * Timestamp field used to order long-term memory search results.
+ */
+export type LongTermMemorySearchSortBy = ClosedEnum<
+  typeof LongTermMemorySearchSortBy
+>;
+
+/** @internal */
+export const LongTermMemorySearchSortBy$outboundSchema: z.ZodNativeEnum<
+  typeof LongTermMemorySearchSortBy
+> = z.nativeEnum(LongTermMemorySearchSortBy);

package/src/models/long-term-memory-search-sort-order.ts

@@ -0,0 +1,26 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: cfda33badb6c
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Direction used to order long-term memory search results.
+ */
+export const LongTermMemorySearchSortOrder = {
+  Asc: "asc",
+  Desc: "desc",
+} as const;
+/**
+ * Direction used to order long-term memory search results.
+ */
+export type LongTermMemorySearchSortOrder = ClosedEnum<
+  typeof LongTermMemorySearchSortOrder
+>;
+
+/** @internal */
+export const LongTermMemorySearchSortOrder$outboundSchema: z.ZodNativeEnum<
+  typeof LongTermMemorySearchSortOrder
+> = z.nativeEnum(LongTermMemorySearchSortOrder);

package/src/models/matcher-kind.ts

@@ -0,0 +1,25 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 04cc9eeb89cd
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * The matching techniques this API supports.
+ */
+export const MatcherKind = {
+  Regex: "regex",
+} as const;
+/**
+ * The matching techniques this API supports.
+ */
+export type MatcherKind = ClosedEnum<typeof MatcherKind>;
+
+/** @internal */
+export const MatcherKind$inboundSchema: z.ZodNativeEnum<typeof MatcherKind> = z
+  .nativeEnum(MatcherKind);
+/** @internal */
+export const MatcherKind$outboundSchema: z.ZodNativeEnum<typeof MatcherKind> =
+  MatcherKind$inboundSchema;

package/src/models/matcher-spec.ts

@@ -0,0 +1,85 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ca4433582278
+ */
+
+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 {
+  MatcherKind,
+  MatcherKind$inboundSchema,
+  MatcherKind$outboundSchema,
+} from "./matcher-kind.js";
+import {
+  RegexSpec,
+  RegexSpec$inboundSchema,
+  RegexSpec$Outbound,
+  RegexSpec$outboundSchema,
+} from "./regex-spec.js";
+
+/**
+ * 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.
+ */
+export type MatcherSpec = {
+  /**
+   * The matching techniques this API supports.
+   */
+  kind: MatcherKind;
+  /**
+   * 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.
+   */
+  regex?: RegexSpec | undefined;
+};
+
+/** @internal */
+export const MatcherSpec$inboundSchema: z.ZodType<
+  MatcherSpec,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  kind: MatcherKind$inboundSchema,
+  regex: RegexSpec$inboundSchema.optional(),
+});
+/** @internal */
+export type MatcherSpec$Outbound = {
+  kind: string;
+  regex?: RegexSpec$Outbound | undefined;
+};
+
+/** @internal */
+export const MatcherSpec$outboundSchema: z.ZodType<
+  MatcherSpec$Outbound,
+  z.ZodTypeDef,
+  MatcherSpec
+> = z.object({
+  kind: MatcherKind$outboundSchema,
+  regex: RegexSpec$outboundSchema.optional(),
+});
+
+export function matcherSpecToJSON(matcherSpec: MatcherSpec): string {
+  return JSON.stringify(MatcherSpec$outboundSchema.parse(matcherSpec));
+}
+export function matcherSpecFromJSON(
+  jsonString: string,
+): SafeParseResult<MatcherSpec, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => MatcherSpec$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'MatcherSpec' from JSON`,
+  );
+}

package/src/models/memory-record.ts

@@ -7,6 +7,10 @@ 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 {
+  MemorySourceLink,
+  MemorySourceLink$inboundSchema,
+} from "./memory-source-link.js";
 import { NamespaceRef, NamespaceRef$inboundSchema } from "./namespace-ref.js";
 
 /**
@@ -59,6 +63,18 @@ export type MemoryRecord = {
    * Timestamp when the memory was last updated (UTC).
    */
   updatedAt: Date;
+  /**
+   * Generic source links for this memory. Document sources include the customer document ID and revision that produced the memory.
+   */
+  sources?: Array<MemorySourceLink> | undefined;
+  /**
+   * Opaque token for additional source links when this response truncated attribution. Absent when every link is included.
+   */
+  sourcesNextPageToken?: string | undefined;
+  /**
+   * True when this memory was created by document ingestion and is protected from generic overwrite.
+   */
+  documentManaged?: boolean | undefined;
 };
 
 /** @internal */
@@ -78,6 +94,9 @@ export const MemoryRecord$inboundSchema: z.ZodType<
   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)),
+  sources: z.array(MemorySourceLink$inboundSchema).optional(),
+  sourcesNextPageToken: z.string().optional(),
+  documentManaged: z.boolean().optional(),
 });
 
 export function memoryRecordFromJSON(

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

@@ -0,0 +1,63 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 7685f341554f
+ */
+
+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 {
+  EvidenceProducer,
+  EvidenceProducer$inboundSchema,
+} from "./evidence-producer.js";
+
+export type MemorySourceEvidence = {
+  /**
+   * Identity of a logical extraction occurrence. Delivery retries retain this ID; a new extraction receives a new ID. Absent on legacy evidence.
+   */
+  evidenceId?: string | undefined;
+  /**
+   * Version of the evidence metadata contract, currently 1. Absent on legacy evidence.
+   */
+  schemaVersion?: number | undefined;
+  /**
+   * UTC time when the producer prepared the input for extraction, before model invocation. Preserved through checkpoint replay. This is not the source event time.
+   */
+  capturedAt?: Date | undefined;
+  producer?: EvidenceProducer | undefined;
+  /**
+   * Server-generated document ingestion identifier.
+   */
+  ingestionId: string;
+  chunkId: string;
+  start?: number | undefined;
+  end?: number | undefined;
+};
+
+/** @internal */
+export const MemorySourceEvidence$inboundSchema: z.ZodType<
+  MemorySourceEvidence,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  evidenceId: z.string().optional(),
+  schemaVersion: z.number().int().optional(),
+  capturedAt: z.string().datetime({ offset: true }).transform(v => new Date(v))
+    .optional(),
+  producer: EvidenceProducer$inboundSchema.optional(),
+  ingestionId: z.string(),
+  chunkId: z.string(),
+  start: z.number().int().optional(),
+  end: z.number().int().optional(),
+});
+
+export function memorySourceEvidenceFromJSON(
+  jsonString: string,
+): SafeParseResult<MemorySourceEvidence, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => MemorySourceEvidence$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'MemorySourceEvidence' from JSON`,
+  );
+}

package/src/models/memory-source-kind.ts

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a06af6f24efe
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+export const MemorySourceKind = {
+  Document: "document",
+  Session: "session",
+} as const;
+export type MemorySourceKind = OpenEnum<typeof MemorySourceKind>;
+
+/** @internal */
+export const MemorySourceKind$inboundSchema: z.ZodType<
+  MemorySourceKind,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(MemorySourceKind);

package/src/models/memory-source-link.ts

@@ -0,0 +1,67 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 85acc8f73a38
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import {
+  DocumentSourceIdentity,
+  DocumentSourceIdentity$inboundSchema,
+} from "./document-source-identity.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import {
+  MemorySourceEvidence,
+  MemorySourceEvidence$inboundSchema,
+} from "./memory-source-evidence.js";
+import {
+  MemorySourceKind,
+  MemorySourceKind$inboundSchema,
+} from "./memory-source-kind.js";
+import {
+  SessionSourceEvidence,
+  SessionSourceEvidence$inboundSchema,
+} from "./session-source-evidence.js";
+import {
+  SessionSourceIdentity,
+  SessionSourceIdentity$inboundSchema,
+} from "./session-source-identity.js";
+
+export type MemorySourceLink = {
+  sourceId: string;
+  kind: MemorySourceKind;
+  identity?: DocumentSourceIdentity | undefined;
+  session?: SessionSourceIdentity | undefined;
+  evidence?: Array<MemorySourceEvidence> | undefined;
+  sessionEvidence?: Array<SessionSourceEvidence> | undefined;
+  /**
+   * Opaque token for GET /v1/stores/{storeId}/long-term-memory/{memoryId}/sources/{sourceId}/evidence. Continues evidence or sessionEvidence for this source; absent when every item is included.
+   */
+  evidenceNextPageToken?: string | undefined;
+};
+
+/** @internal */
+export const MemorySourceLink$inboundSchema: z.ZodType<
+  MemorySourceLink,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  sourceId: z.string(),
+  kind: MemorySourceKind$inboundSchema,
+  identity: DocumentSourceIdentity$inboundSchema.optional(),
+  session: SessionSourceIdentity$inboundSchema.optional(),
+  evidence: z.array(MemorySourceEvidence$inboundSchema).optional(),
+  sessionEvidence: z.array(SessionSourceEvidence$inboundSchema).optional(),
+  evidenceNextPageToken: z.string().optional(),
+});
+
+export function memorySourceLinkFromJSON(
+  jsonString: string,
+): SafeParseResult<MemorySourceLink, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => MemorySourceLink$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'MemorySourceLink' from JSON`,
+  );
+}