@redis-iris/agent-memory 0.2.1 → 0.3.1

package/src/lib/encodings.ts

@@ -13,10 +13,41 @@ export class EncodingError extends Error {
   }
 }
 
+export type CharEncoding = "percent" | "percentExceptReserved" | "none";
+
+const reservedEscapes = /%(2[346bcf]|3[abdf]|40|5[bd])/gi;
+
+function encodeKeyChars(
+  v: string,
+  charEncoding: CharEncoding | undefined,
+): string {
+  return encodeChars(
+    v,
+    charEncoding === "percentExceptReserved" ? "percent" : charEncoding,
+  );
+}
+
+function encodeChars(
+  v: string,
+  charEncoding: CharEncoding | undefined,
+): string {
+  switch (charEncoding) {
+    case "percent":
+      return encodeURIComponent(v);
+    case "percentExceptReserved":
+      return encodeURIComponent(v).replace(
+        reservedEscapes,
+        (m) => decodeURIComponent(m),
+      );
+    default:
+      return v;
+  }
+}
+
 export function encodeMatrix(
   key: string,
   value: unknown,
-  options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+  options?: { explode?: boolean; charEncoding?: CharEncoding },
 ): string | undefined {
   let out = "";
   const pairs: [string, unknown][] = options?.explode
@@ -28,7 +59,7 @@ export function encodeMatrix(
   }
 
   const encodeString = (v: string) => {
-    return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    return encodeChars(v, options?.charEncoding);
   };
   const encodeValue = (v: unknown) => encodeString(serializeValue(v));
 
@@ -53,7 +84,7 @@ export function encodeMatrix(
       return;
     }
 
-    const keyPrefix = encodeString(pk);
+    const keyPrefix = encodeKeyChars(pk, options?.charEncoding);
     tmp = `${keyPrefix}=${encValue}`;
     // trim trailing '=' if value was empty
     if (tmp === `${keyPrefix}=`) {
@@ -74,7 +105,7 @@ export function encodeMatrix(
 export function encodeLabel(
   key: string,
   value: unknown,
-  options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+  options?: { explode?: boolean; charEncoding?: CharEncoding },
 ): string | undefined {
   let out = "";
   const pairs: [string, unknown][] = options?.explode
@@ -86,7 +117,7 @@ export function encodeLabel(
   }
 
   const encodeString = (v: string) => {
-    return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    return encodeChars(v, options?.charEncoding);
   };
   const encodeValue = (v: unknown) => encodeString(serializeValue(v));
 
@@ -104,7 +135,7 @@ export function encodeLabel(
       encValue = mapped?.join("").slice(1);
     } else {
       const k = options?.explode && isPlainObject(value)
-        ? `${encodeString(pk)}=`
+        ? `${encodeKeyChars(pk, options?.charEncoding)}=`
         : "";
       encValue = `${k}${encodeValue(pv)}`;
     }
@@ -118,14 +149,14 @@ export function encodeLabel(
 type FormEncoder = (
   key: string,
   value: unknown,
-  options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+  options?: { explode?: boolean; charEncoding?: CharEncoding },
 ) => string | undefined;
 
 function formEncoder(sep: string): FormEncoder {
   return (
     key: string,
     value: unknown,
-    options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+    options?: { explode?: boolean; charEncoding?: CharEncoding },
   ) => {
     let out = "";
     const pairs: [string, unknown][] = options?.explode
@@ -137,7 +168,7 @@ function formEncoder(sep: string): FormEncoder {
     }
 
     const encodeString = (v: string) => {
-      return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+      return encodeChars(v, options?.charEncoding);
     };
 
     const encodeValue = (v: unknown) => encodeString(serializeValue(v));
@@ -164,7 +195,7 @@ function formEncoder(sep: string): FormEncoder {
         return;
       }
 
-      tmp = `${encodeString(pk)}=${encValue}`;
+      tmp = `${encodeKeyChars(pk, options?.charEncoding)}=${encValue}`;
 
       // If we end up with the nothing then skip forward
       if (!tmp || tmp === "=") {
@@ -185,7 +216,7 @@ export const encodePipeDelimited = formEncoder("|");
 export function encodeBodyForm(
   key: string,
   value: unknown,
-  options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+  options?: { explode?: boolean; charEncoding?: CharEncoding },
 ): string {
   let out = "";
   const pairs: [string, unknown][] = options?.explode
@@ -193,7 +224,7 @@ export function encodeBodyForm(
     : [[key, value]];
 
   const encodeString = (v: string) => {
-    return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    return encodeChars(v, options?.charEncoding);
   };
 
   const encodeValue = (v: unknown) => encodeString(serializeValue(v));
@@ -212,7 +243,7 @@ export function encodeBodyForm(
       encValue = `${encodeValue(pv)}`;
     }
 
-    tmp = `${encodeString(pk)}=${encValue}`;
+    tmp = `${encodeKeyChars(pk, options?.charEncoding)}=${encValue}`;
 
     // If we end up with the nothing then skip forward
     if (!tmp || tmp === "=") {
@@ -228,7 +259,7 @@ export function encodeBodyForm(
 export function encodeDeepObject(
   key: string,
   value: unknown,
-  options?: { charEncoding?: "percent" | "none" },
+  options?: { charEncoding?: CharEncoding },
 ): string | undefined {
   if (value == null) {
     return;
@@ -246,7 +277,7 @@ export function encodeDeepObject(
 export function encodeDeepObjectObject(
   key: string,
   value: unknown,
-  options?: { charEncoding?: "percent" | "none" },
+  options?: { charEncoding?: CharEncoding },
 ): string | undefined {
   if (value == null) {
     return;
@@ -255,7 +286,7 @@ export function encodeDeepObjectObject(
   let out = "";
 
   const encodeString = (v: string) => {
-    return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    return encodeChars(v, options?.charEncoding);
   };
 
   if (!isPlainObject(value)) {
@@ -279,7 +310,9 @@ export function encodeDeepObjectObject(
 
     const pairs: unknown[] = Array.isArray(cv) ? cv : [cv];
     const encoded = mapDefined(pairs, (v) => {
-      return `${encodeString(pk)}=${encodeString(serializeValue(v))}`;
+      return `${encodeKeyChars(pk, options?.charEncoding)}=${
+        encodeString(serializeValue(v))
+      }`;
     })?.join("&");
 
     out += encoded == null ? "" : `&${encoded}`;
@@ -291,25 +324,27 @@ export function encodeDeepObjectObject(
 export function encodeJSON(
   key: string,
   value: unknown,
-  options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+  options?: { explode?: boolean; charEncoding?: CharEncoding },
 ): string | undefined {
   if (typeof value === "undefined") {
     return;
   }
 
   const encodeString = (v: string) => {
-    return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    return encodeChars(v, options?.charEncoding);
   };
 
   const encVal = encodeString(JSON.stringify(value, jsonReplacer));
 
-  return options?.explode ? encVal : `${encodeString(key)}=${encVal}`;
+  return options?.explode
+    ? encVal
+    : `${encodeKeyChars(key, options?.charEncoding)}=${encVal}`;
 }
 
 export const encodeSimple = (
   key: string,
   value: unknown,
-  options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+  options?: { explode?: boolean; charEncoding?: CharEncoding },
 ): string | undefined => {
   let out = "";
   const pairs: [string, unknown][] = options?.explode
@@ -321,7 +356,7 @@ export const encodeSimple = (
   }
 
   const encodeString = (v: string) => {
-    return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    return encodeChars(v, options?.charEncoding);
   };
   const encodeValue = (v: unknown) => encodeString(serializeValue(v));
 
@@ -427,7 +462,7 @@ export function queryJoin(...args: (string | undefined)[]): string {
 
 type QueryEncoderOptions = {
   explode?: boolean;
-  charEncoding?: "percent" | "none";
+  charEncoding?: CharEncoding;
   allowEmptyValue?: string[];
 };
 

package/src/models/add-session-event-request-content.ts

@@ -10,6 +10,11 @@ import {
   Content$outboundSchema,
 } from "./content.js";
 import { MessageRole, MessageRole$outboundSchema } from "./message-role.js";
+import {
+  NamespaceRefInput,
+  NamespaceRefInput$Outbound,
+  NamespaceRefInput$outboundSchema,
+} from "./namespace-ref-input.js";
 
 export type AddSessionEventRequestContent = {
   /**
@@ -21,13 +26,19 @@ export type AddSessionEventRequestContent = {
    */
   actorId: string;
   /**
-   * Optional namespace for the session, used as the namespace of every long-term memory extracted from it.
+   * Optional deprecated namespace label for the session. This label does not create or resolve a namespace resource. Do not supply it with namespaceRef.
    *
    * @remarks
    *
    * Like `ownerId`, this is a session-level value taken from the first event: the value sent with the first event of a session is stored on the session, and values sent with later events are ignored. Omit it to leave extracted memories without a namespace.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   namespace?: string | undefined;
+  /**
+   * Reference to an existing namespace resource for a write or namespace-scoped operation.
+   */
+  namespaceRef?: NamespaceRefInput | undefined;
   /**
    * Message role for session events.
    */
@@ -51,6 +62,7 @@ export type AddSessionEventRequestContent$Outbound = {
   sessionId?: string | undefined;
   actorId: string;
   namespace?: string | undefined;
+  namespaceRef?: NamespaceRefInput$Outbound | undefined;
   role: string;
   content: Array<Content$Outbound>;
   createdAt: string;
@@ -66,6 +78,7 @@ export const AddSessionEventRequestContent$outboundSchema: z.ZodType<
   sessionId: z.string().optional(),
   actorId: z.string(),
   namespace: z.string().optional(),
+  namespaceRef: NamespaceRefInput$outboundSchema.optional(),
   role: MessageRole$outboundSchema,
   content: z.array(Content$outboundSchema),
   createdAt: z.date().transform(v => v.toISOString()),

package/src/models/conflict-error-type.ts

@@ -0,0 +1,23 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 171147267a90
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Problem type URI for conflict errors.
+ */
+export const ConflictErrorType = {
+  RootErrorsConflict: "/errors/conflict",
+} as const;
+/**
+ * Problem type URI for conflict errors.
+ */
+export type ConflictErrorType = ClosedEnum<typeof ConflictErrorType>;
+
+/** @internal */
+export const ConflictErrorType$inboundSchema: z.ZodNativeEnum<
+  typeof ConflictErrorType
+> = z.nativeEnum(ConflictErrorType);

package/src/models/create-memory-record.ts

@@ -4,6 +4,11 @@
  */
 
 import * as z from "zod/v3";
+import {
+  NamespaceRefInput,
+  NamespaceRefInput$Outbound,
+  NamespaceRefInput$outboundSchema,
+} from "./namespace-ref-input.js";
 
 /**
  * A memory record to create.
@@ -30,9 +35,15 @@ export type CreateMemoryRecord = {
    */
   ownerId: string;
   /**
-   * Optional namespace for logical grouping (1-64 chars, alphanumeric and dashes). Omit to create the record without a namespace. Records created here are explicit writes, so this value is taken as given; extraction instead inherits the source session's namespace.
+   * Optional deprecated namespace label. It does not create or resolve a namespace resource. Omit it to create the record without a namespace, and do not supply it with namespaceRef.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   namespace?: string | undefined;
+  /**
+   * Reference to an existing namespace resource for a write or namespace-scoped operation.
+   */
+  namespaceRef?: NamespaceRefInput | undefined;
   /**
    * Topic tags for categorization (max 50 topics, each 1-100 chars).
    */
@@ -51,6 +62,7 @@ export type CreateMemoryRecord$Outbound = {
   sessionId?: string | undefined;
   ownerId: string;
   namespace?: string | undefined;
+  namespaceRef?: NamespaceRefInput$Outbound | undefined;
   topics?: Array<string> | undefined;
   attributes?: { [k: string]: any } | undefined;
 };
@@ -67,6 +79,7 @@ export const CreateMemoryRecord$outboundSchema: z.ZodType<
   sessionId: z.string().optional(),
   ownerId: z.string(),
   namespace: z.string().optional(),
+  namespaceRef: NamespaceRefInput$outboundSchema.optional(),
   topics: z.array(z.string()).optional(),
   attributes: z.record(z.any()).optional(),
 });

package/src/models/create-namespace-request-content.ts

@@ -0,0 +1,65 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 761f3e77ddd5
+ */
+
+import * as z from "zod/v3";
+import {
+  NamespaceScope,
+  NamespaceScope$outboundSchema,
+} from "./namespace-scope.js";
+
+export type CreateNamespaceRequestContent = {
+  /**
+   * One namespace segment. Use with scope for a root or parentId for a child.
+   */
+  name?: string | undefined;
+  /**
+   * A complete hierarchy path to create. Missing segments are created as needed. Mutually exclusive with name and parentId. The path does not encode scope.
+   */
+  path?: string | undefined;
+  /**
+   * The root scope of a namespace hierarchy.
+   */
+  scope?: NamespaceScope | undefined;
+  /**
+   * Parent namespace for a direct child.
+   */
+  parentId?: string | undefined;
+  /**
+   * Owner for a personal root or path. Required for personal scope; omit for shared roots and children.
+   */
+  ownerId?: string | undefined;
+};
+
+/** @internal */
+export type CreateNamespaceRequestContent$Outbound = {
+  name?: string | undefined;
+  path?: string | undefined;
+  scope?: string | undefined;
+  parentId?: string | undefined;
+  ownerId?: string | undefined;
+};
+
+/** @internal */
+export const CreateNamespaceRequestContent$outboundSchema: z.ZodType<
+  CreateNamespaceRequestContent$Outbound,
+  z.ZodTypeDef,
+  CreateNamespaceRequestContent
+> = z.object({
+  name: z.string().optional(),
+  path: z.string().optional(),
+  scope: NamespaceScope$outboundSchema.optional(),
+  parentId: z.string().optional(),
+  ownerId: z.string().optional(),
+});
+
+export function createNamespaceRequestContentToJSON(
+  createNamespaceRequestContent: CreateNamespaceRequestContent,
+): string {
+  return JSON.stringify(
+    CreateNamespaceRequestContent$outboundSchema.parse(
+      createNamespaceRequestContent,
+    ),
+  );
+}

package/src/models/create-namespace-response-content.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: d08a2b835733
+ */
+
+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 { Namespace, Namespace$inboundSchema } from "./namespace.js";
+
+export type CreateNamespaceResponseContent = {
+  /**
+   * A namespace hierarchy record.
+   */
+  namespace: Namespace;
+};
+
+/** @internal */
+export const CreateNamespaceResponseContent$inboundSchema: z.ZodType<
+  CreateNamespaceResponseContent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  namespace: Namespace$inboundSchema,
+});
+
+export function createNamespaceResponseContentFromJSON(
+  jsonString: string,
+): SafeParseResult<CreateNamespaceResponseContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CreateNamespaceResponseContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreateNamespaceResponseContent' from JSON`,
+  );
+}

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

@@ -0,0 +1,114 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 17d3db835fb5
+ */
+
+import * as z from "zod/v3";
+import * as models from "../index.js";
+import { AgentMemoryError } from "./agent-memory-error.js";
+
+/**
+ * The request conflicts with the current state of the resource.
+ */
+export type ConflictErrorResponseContentData = {
+  /**
+   * A short, human-readable summary of the problem
+   *
+   * @remarks
+   *                                       type.  It SHOULD NOT change from occurrence to occurrence of the
+   *                                       problem, except for purposes of localization (e.g., using
+   *                                       proactive content negotiation; see [RFC7231], Section 3.4).
+   */
+  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.
+   */
+  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 conflict errors.
+   */
+  type: models.ConflictErrorType;
+};
+
+/**
+ * The request conflicts with the current state of the resource.
+ */
+export class ConflictErrorResponseContent extends AgentMemoryError {
+  /**
+   * A short, human-readable summary of the problem
+   *
+   * @remarks
+   *                                       type.  It SHOULD NOT change from occurrence to occurrence of the
+   *                                       problem, except for purposes of localization (e.g., using
+   *                                       proactive content negotiation; see [RFC7231], Section 3.4).
+   */
+  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.
+   */
+  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 conflict errors.
+   */
+  type: models.ConflictErrorType;
+
+  /** The original data that was passed to this error instance. */
+  data$: ConflictErrorResponseContentData;
+
+  constructor(
+    err: ConflictErrorResponseContentData,
+    httpMeta: { response: Response; request: Request; body: string },
+  ) {
+    const message = "message" in err && typeof err.message === "string"
+      ? err.message
+      : `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.instance != null) this.instance = err.instance;
+    this.type = err.type;
+
+    this.name = "ConflictErrorResponseContent";
+  }
+}
+
+/** @internal */
+export const ConflictErrorResponseContent$inboundSchema: z.ZodType<
+  ConflictErrorResponseContent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  title: z.string(),
+  status: z.number().int().default(409),
+  detail: z.string().optional(),
+  instance: z.string().optional(),
+  type: models.ConflictErrorType$inboundSchema,
+  request$: z.instanceof(Request),
+  response$: z.instanceof(Response),
+  body$: z.string(),
+})
+  .transform((v) => {
+    return new ConflictErrorResponseContent(v, {
+      request: v.request$,
+      response: v.response$,
+      body: v.body$,
+    });
+  });

package/src/models/errors/index.ts

@@ -7,11 +7,14 @@ export * from "./agent-memory-default-error.js";
 export * from "./agent-memory-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-failed-dependency-error-response-content.js";
 export * from "./not-found-error-response-content.js";
 export * from "./payload-too-large-error-response-content.js";
+export * from "./resource-suspended-error-response-content.js";
 export * from "./response-validation-error.js";
 export * from "./sdk-validation-error.js";
 export * from "./timeout-error-response-content.js";