@redis-iris/agent-memory 0.2.1 → 0.3.1

package/src/models/namespace-ref-input.ts

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 579f1de8ca44
+ */
+
+import * as z from "zod/v3";
+
+/**
+ * Reference to an existing namespace resource for a write or namespace-scoped operation.
+ */
+export type NamespaceRefInput = {
+  /**
+   * Stable namespace resource identifier.
+   */
+  namespaceId: string;
+};
+
+/** @internal */
+export type NamespaceRefInput$Outbound = {
+  namespaceId: string;
+};
+
+/** @internal */
+export const NamespaceRefInput$outboundSchema: z.ZodType<
+  NamespaceRefInput$Outbound,
+  z.ZodTypeDef,
+  NamespaceRefInput
+> = z.object({
+  namespaceId: z.string(),
+});
+
+export function namespaceRefInputToJSON(
+  namespaceRefInput: NamespaceRefInput,
+): string {
+  return JSON.stringify(
+    NamespaceRefInput$outboundSchema.parse(namespaceRefInput),
+  );
+}

package/src/models/namespace-ref.ts

@@ -0,0 +1,48 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 85b9168a3c90
+ */
+
+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";
+
+/**
+ * Reference to a namespace resource with its stable identifier and current display data.
+ */
+export type NamespaceRef = {
+  /**
+   * Stable namespace resource identifier.
+   */
+  namespaceId: string;
+  /**
+   * Current namespace name.
+   */
+  name: string;
+  /**
+   * Current namespace path.
+   */
+  path: string;
+};
+
+/** @internal */
+export const NamespaceRef$inboundSchema: z.ZodType<
+  NamespaceRef,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  namespaceId: z.string(),
+  name: z.string(),
+  path: z.string(),
+});
+
+export function namespaceRefFromJSON(
+  jsonString: string,
+): SafeParseResult<NamespaceRef, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => NamespaceRef$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'NamespaceRef' from JSON`,
+  );
+}

package/src/models/namespace-scope.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 85918589963b
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+/**
+ * The root scope of a namespace hierarchy.
+ */
+export const NamespaceScope = {
+  Personal: "PERSONAL",
+  Shared: "SHARED",
+} as const;
+/**
+ * The root scope of a namespace hierarchy.
+ */
+export type NamespaceScope = OpenEnum<typeof NamespaceScope>;
+
+/** @internal */
+export const NamespaceScope$inboundSchema: z.ZodType<
+  NamespaceScope,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(NamespaceScope);
+/** @internal */
+export const NamespaceScope$outboundSchema: z.ZodType<
+  string,
+  z.ZodTypeDef,
+  NamespaceScope
+> = openEnums.outboundSchema(NamespaceScope);

package/src/models/namespace-state.ts

@@ -0,0 +1,27 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: eb2a9204cde0
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+/**
+ * Whether a namespace accepts new children and placements.
+ */
+export const NamespaceState = {
+  Active: "ACTIVE",
+  Archived: "ARCHIVED",
+} as const;
+/**
+ * Whether a namespace accepts new children and placements.
+ */
+export type NamespaceState = OpenEnum<typeof NamespaceState>;
+
+/** @internal */
+export const NamespaceState$inboundSchema: z.ZodType<
+  NamespaceState,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(NamespaceState);

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

@@ -0,0 +1,23 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 1cc42dde2d20
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * The archive-only state transition accepted by UpdateNamespace.
+ */
+export const NamespaceUpdateState = {
+  Archived: "ARCHIVED",
+} as const;
+/**
+ * The archive-only state transition accepted by UpdateNamespace.
+ */
+export type NamespaceUpdateState = ClosedEnum<typeof NamespaceUpdateState>;
+
+/** @internal */
+export const NamespaceUpdateState$outboundSchema: z.ZodNativeEnum<
+  typeof NamespaceUpdateState
+> = z.nativeEnum(NamespaceUpdateState);

package/src/models/namespace.ts

@@ -0,0 +1,87 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 6c3790de26b6
+ */
+
+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 {
+  NamespaceScope,
+  NamespaceScope$inboundSchema,
+} from "./namespace-scope.js";
+import {
+  NamespaceState,
+  NamespaceState$inboundSchema,
+} from "./namespace-state.js";
+
+/**
+ * A namespace hierarchy record.
+ */
+export type Namespace = {
+  /**
+   * Server-generated namespace identifier.
+   */
+  namespaceId: string;
+  /**
+   * One case-sensitive namespace path segment.
+   */
+  name: string;
+  /**
+   * Server-generated namespace identifier.
+   */
+  parentId?: string | undefined;
+  /**
+   * Server-generated namespace identifier.
+   */
+  rootId: string;
+  /**
+   * An opaque application-user ID selected by the platform for a namespace root.
+   */
+  ownerId?: string | undefined;
+  /**
+   * The root scope of a namespace hierarchy.
+   */
+  scope: NamespaceScope;
+  /**
+   * Whether a namespace accepts new children and placements.
+   */
+  state: NamespaceState;
+  revision: number;
+  createdAt: Date;
+  updatedAt: Date;
+  /**
+   * Current case-sensitive path, derived from the live hierarchy.
+   */
+  path: string;
+};
+
+/** @internal */
+export const Namespace$inboundSchema: z.ZodType<
+  Namespace,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  namespaceId: z.string(),
+  name: z.string(),
+  parentId: z.string().optional(),
+  rootId: z.string(),
+  ownerId: z.string().optional(),
+  scope: NamespaceScope$inboundSchema,
+  state: NamespaceState$inboundSchema,
+  revision: z.number().int(),
+  createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  updatedAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  path: z.string(),
+});
+
+export function namespaceFromJSON(
+  jsonString: string,
+): SafeParseResult<Namespace, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Namespace$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Namespace' from JSON`,
+  );
+}

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

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

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

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 2245f245c50c
+ */
+
+import * as z from "zod/v3";
+
+export type DeleteNamespaceGlobals = {
+  storeId?: string | undefined;
+};
+
+export type DeleteNamespaceRequest = {
+  /**
+   * Server-generated namespace identifier.
+   */
+  namespaceId: string;
+};
+
+/** @internal */
+export type DeleteNamespaceRequest$Outbound = {
+  namespaceId: string;
+};
+
+/** @internal */
+export const DeleteNamespaceRequest$outboundSchema: z.ZodType<
+  DeleteNamespaceRequest$Outbound,
+  z.ZodTypeDef,
+  DeleteNamespaceRequest
+> = z.object({
+  namespaceId: z.string(),
+});
+
+export function deleteNamespaceRequestToJSON(
+  deleteNamespaceRequest: DeleteNamespaceRequest,
+): string {
+  return JSON.stringify(
+    DeleteNamespaceRequest$outboundSchema.parse(deleteNamespaceRequest),
+  );
+}

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

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 6f90902c2837
+ */
+
+import * as z from "zod/v3";
+
+export type GetNamespaceGlobals = {
+  storeId?: string | undefined;
+};
+
+export type GetNamespaceRequest = {
+  /**
+   * Server-generated namespace identifier.
+   */
+  namespaceId: string;
+};
+
+/** @internal */
+export type GetNamespaceRequest$Outbound = {
+  namespaceId: string;
+};
+
+/** @internal */
+export const GetNamespaceRequest$outboundSchema: z.ZodType<
+  GetNamespaceRequest$Outbound,
+  z.ZodTypeDef,
+  GetNamespaceRequest
+> = z.object({
+  namespaceId: z.string(),
+});
+
+export function getNamespaceRequestToJSON(
+  getNamespaceRequest: GetNamespaceRequest,
+): string {
+  return JSON.stringify(
+    GetNamespaceRequest$outboundSchema.parse(getNamespaceRequest),
+  );
+}

package/src/models/operations/index.ts

@@ -6,13 +6,19 @@
 export * from "./add-session-event.js";
 export * from "./bulk-create-long-term-memories.js";
 export * from "./bulk-delete-long-term-memories.js";
+export * from "./create-namespace.js";
+export * from "./delete-namespace.js";
 export * from "./delete-session-event.js";
 export * from "./delete-session-memory.js";
 export * from "./get-long-term-memory.js";
+export * from "./get-namespace.js";
 export * from "./get-session-event.js";
 export * from "./get-session-memory.js";
+export * from "./list-namespaces.js";
 export * from "./list-sessions.js";
+export * from "./move-long-term-memories.js";
 export * from "./search-long-term-memory.js";
 export * from "./store-health.js";
 export * from "./update-long-term-memory-fields.js";
 export * from "./update-long-term-memory.js";
+export * from "./update-namespace.js";

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

@@ -0,0 +1,64 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ca8e6e071b4b
+ */
+
+import * as z from "zod/v3";
+import * as models from "../index.js";
+
+export type ListNamespacesGlobals = {
+  storeId?: string | undefined;
+};
+
+export type ListNamespacesRequest = {
+  /**
+   * List direct children of this namespace. Omit to list roots.
+   */
+  parentId?: string | undefined;
+  /**
+   * Restrict root results to one scope. Cannot be combined with parentId.
+   */
+  scope?: models.NamespaceScope | undefined;
+  /**
+   * Restrict personal root results to an owner. Cannot be combined with parentId; ignored for shared roots.
+   */
+  ownerId?: string | undefined;
+  /**
+   * Maximum number of namespaces to return. Defaults to 100. Allowed range: 1-1000.
+   */
+  limit?: number | undefined;
+  /**
+   * Opaque token from a previous response for the next page.
+   */
+  pageToken?: string | undefined;
+};
+
+/** @internal */
+export type ListNamespacesRequest$Outbound = {
+  parentId?: string | undefined;
+  scope?: string | undefined;
+  ownerId?: string | undefined;
+  limit: number;
+  pageToken?: string | undefined;
+};
+
+/** @internal */
+export const ListNamespacesRequest$outboundSchema: z.ZodType<
+  ListNamespacesRequest$Outbound,
+  z.ZodTypeDef,
+  ListNamespacesRequest
+> = z.object({
+  parentId: z.string().optional(),
+  scope: models.NamespaceScope$outboundSchema.optional(),
+  ownerId: z.string().optional(),
+  limit: z.number().int().default(100),
+  pageToken: z.string().optional(),
+});
+
+export function listNamespacesRequestToJSON(
+  listNamespacesRequest: ListNamespacesRequest,
+): string {
+  return JSON.stringify(
+    ListNamespacesRequest$outboundSchema.parse(listNamespacesRequest),
+  );
+}

package/src/models/operations/move-long-term-memories.ts

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

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

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ce89b83250d6
+ */
+
+import * as z from "zod/v3";
+import * as models from "../index.js";
+
+export type UpdateNamespaceGlobals = {
+  storeId?: string | undefined;
+};
+
+export type UpdateNamespaceRequest = {
+  /**
+   * Server-generated namespace identifier.
+   */
+  namespaceId: string;
+  body?: models.UpdateNamespaceRequestContent | undefined;
+};
+
+/** @internal */
+export type UpdateNamespaceRequest$Outbound = {
+  namespaceId: string;
+  body?: models.UpdateNamespaceRequestContent$Outbound | undefined;
+};
+
+/** @internal */
+export const UpdateNamespaceRequest$outboundSchema: z.ZodType<
+  UpdateNamespaceRequest$Outbound,
+  z.ZodTypeDef,
+  UpdateNamespaceRequest
+> = z.object({
+  namespaceId: z.string(),
+  body: models.UpdateNamespaceRequestContent$outboundSchema.optional(),
+});
+
+export function updateNamespaceRequestToJSON(
+  updateNamespaceRequest: UpdateNamespaceRequest,
+): string {
+  return JSON.stringify(
+    UpdateNamespaceRequest$outboundSchema.parse(updateNamespaceRequest),
+  );
+}

package/src/models/resource-suspended-error-type.ts

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

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

@@ -4,6 +4,11 @@
  */
 
 import * as z from "zod/v3";
+import {
+  NamespaceRefInput,
+  NamespaceRefInput$Outbound,
+  NamespaceRefInput$outboundSchema,
+} from "./namespace-ref-input.js";
 
 /**
  * Type- and namespace-scoped field update request for a custom-typed long-term memory record.
@@ -14,13 +19,19 @@ export type UpdateLongTermMemoryFieldsRequestContent = {
    */
   memoryType: string;
   /**
-   * The caller's namespace. The update is rejected with 409 unless the record's stored namespace matches exactly.
+   * The caller's current deprecated namespace label. The update is rejected with 409 unless the record still stores that label. Do not supply it with namespaceRef.
    *
    * @remarks
    *
-   * Omit it to assert that the record has no namespace — an omitted value matches only records stored without one, it does not mean "any namespace". The check is applied atomically with the update, so a record cannot be re-filed into another namespace between the check and the write.
+   * Omit both namespace and namespaceRef to assert that the record has no namespace placement. Omission does not mean "any 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;
   /**
    * Updated text content (1-50000 chars). Omit to leave the text unchanged.
    */
@@ -35,6 +46,7 @@ export type UpdateLongTermMemoryFieldsRequestContent = {
 export type UpdateLongTermMemoryFieldsRequestContent$Outbound = {
   memoryType: string;
   namespace?: string | undefined;
+  namespaceRef?: NamespaceRefInput$Outbound | undefined;
   text?: string | undefined;
   attributes?: { [k: string]: any } | undefined;
 };
@@ -47,6 +59,7 @@ export const UpdateLongTermMemoryFieldsRequestContent$outboundSchema: z.ZodType<
 > = z.object({
   memoryType: z.string(),
   namespace: z.string().optional(),
+  namespaceRef: NamespaceRefInput$outboundSchema.optional(),
   text: z.string().optional(),
   attributes: z.record(z.any()).optional(),
 });

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

@@ -4,6 +4,11 @@
  */
 
 import * as z from "zod/v3";
+import {
+  NamespaceRefInput,
+  NamespaceRefInput$Outbound,
+  NamespaceRefInput$outboundSchema,
+} from "./namespace-ref-input.js";
 
 /**
  * Partial update request for a long-term memory record.
@@ -22,13 +27,20 @@ export type UpdateLongTermMemoryRequestContent = {
    */
   topics?: Array<string> | undefined;
   /**
-   * Updated namespace. When provided, must be 1-64 chars alphanumeric and dashes; omit the field or send an empty string to clear.
+   * Updated deprecated namespace label. When provided, it must be 1-64 alphanumeric characters or dashes. Send an empty string to clear it.
    *
    * @remarks
+   * Do not supply it with namespaceRef.
    *
-   * This is the only way to change the namespace of an existing record, including one produced by extraction: a record inherits its session's namespace at creation and is not revised afterwards, so use this to re-file a record or to add a namespace to one created before the session had any.
+   * This shape is deprecated: Use namespaceRef to reference a namespace resource.
+   *
+   * @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;
   /**
    * Updated owner ID. When provided, must be 1-64 chars alphanumeric and dashes and non-empty; omit the field to leave unchanged. Clearing is not supported because ownerId is required.
    */
@@ -45,6 +57,7 @@ export type UpdateLongTermMemoryRequestContent$Outbound = {
   memoryType?: string | undefined;
   topics?: Array<string> | undefined;
   namespace?: string | undefined;
+  namespaceRef?: NamespaceRefInput$Outbound | undefined;
   ownerId?: string | undefined;
   sessionId?: string | undefined;
 };
@@ -59,6 +72,7 @@ export const UpdateLongTermMemoryRequestContent$outboundSchema: z.ZodType<
   memoryType: z.string().optional(),
   topics: z.array(z.string()).optional(),
   namespace: z.string().optional(),
+  namespaceRef: NamespaceRefInput$outboundSchema.optional(),
   ownerId: z.string().optional(),
   sessionId: z.string().optional(),
 });

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

@@ -7,6 +7,7 @@ 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";
 
 /**
  * A long-term memory record.
@@ -33,9 +34,15 @@ export type UpdateLongTermMemoryResponseContent = {
    */
   ownerId?: string | undefined;
   /**
-   * Namespace for logical grouping. Absent when the record has none: either it was written directly without one, or it was extracted from a session that has no namespace.
+   * Deprecated namespace label. Absent when the record uses namespaceRef or has no 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 a namespace resource with its stable identifier and current display data.
+   */
+  namespaceRef?: NamespaceRef | undefined;
   /**
    * Topic tags for categorization.
    */
@@ -66,6 +73,7 @@ export const UpdateLongTermMemoryResponseContent$inboundSchema: z.ZodType<
   sessionId: z.string().optional(),
   ownerId: z.string().optional(),
   namespace: z.string().optional(),
+  namespaceRef: NamespaceRef$inboundSchema.optional(),
   topics: z.array(z.string()).optional(),
   attributes: z.record(z.any()).optional(),
   createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),