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

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

@@ -0,0 +1,139 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 54e1255b499a
+ */
+
+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 UpdateSummaryViewResponseContent = {
+  /**
+   * 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 UpdateSummaryViewResponseContent$inboundSchema: z.ZodType<
+  UpdateSummaryViewResponseContent,
+  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 updateSummaryViewResponseContentFromJSON(
+  jsonString: string,
+): SafeParseResult<UpdateSummaryViewResponseContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => UpdateSummaryViewResponseContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'UpdateSummaryViewResponseContent' from JSON`,
+  );
+}

package/src/sdk/sdk.ts

@@ -6,23 +6,41 @@
 import { addSessionEvent } from "../funcs/add-session-event.js";
 import { bulkCreateLongTermMemories } from "../funcs/bulk-create-long-term-memories.js";
 import { bulkDeleteLongTermMemories } from "../funcs/bulk-delete-long-term-memories.js";
+import { createDocumentIngestion } from "../funcs/create-document-ingestion.js";
 import { createNamespace } from "../funcs/create-namespace.js";
+import { createSummaryView } from "../funcs/create-summary-view.js";
 import { deleteNamespace } from "../funcs/delete-namespace.js";
 import { deleteSessionEvent } from "../funcs/delete-session-event.js";
 import { deleteSessionMemory } from "../funcs/delete-session-memory.js";
+import { deleteSummaryView } from "../funcs/delete-summary-view.js";
+import { getDocumentIngestion } from "../funcs/get-document-ingestion.js";
+import { getIngestionHookStatus } from "../funcs/get-ingestion-hook-status.js";
 import { getLongTermMemory } from "../funcs/get-long-term-memory.js";
+import { getNamespaceRouting } from "../funcs/get-namespace-routing.js";
 import { getNamespace } from "../funcs/get-namespace.js";
 import { getSessionEvent } from "../funcs/get-session-event.js";
 import { getSessionMemory } from "../funcs/get-session-memory.js";
+import { getSummaryViewResult } from "../funcs/get-summary-view-result.js";
+import { getSummaryView } from "../funcs/get-summary-view.js";
 import { health } from "../funcs/health.js";
+import { listDocumentIngestionOutputs } from "../funcs/list-document-ingestion-outputs.js";
+import { listIngestionHookStatuses } from "../funcs/list-ingestion-hook-statuses.js";
+import { listMemorySourceEvidence } from "../funcs/list-memory-source-evidence.js";
+import { listMemorySourceLinks } from "../funcs/list-memory-source-links.js";
 import { listNamespaces } from "../funcs/list-namespaces.js";
+import { listSessionSummaries } from "../funcs/list-session-summaries.js";
 import { listSessions } from "../funcs/list-sessions.js";
+import { listSourceMemories } from "../funcs/list-source-memories.js";
+import { listSummaryViews } from "../funcs/list-summary-views.js";
 import { moveLongTermMemories } from "../funcs/move-long-term-memories.js";
+import { putNamespaceRouting } from "../funcs/put-namespace-routing.js";
+import { refreshSummaryView } from "../funcs/refresh-summary-view.js";
 import { searchLongTermMemory } from "../funcs/search-long-term-memory.js";
 import { storeHealth } from "../funcs/store-health.js";
 import { updateLongTermMemoryFields } from "../funcs/update-long-term-memory-fields.js";
 import { updateLongTermMemory } from "../funcs/update-long-term-memory.js";
 import { updateNamespace } from "../funcs/update-namespace.js";
+import { updateSummaryView } from "../funcs/update-summary-view.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as models from "../models/index.js";
 import * as operations from "../models/operations/index.js";
@@ -41,6 +59,46 @@ export class AgentMemory extends ClientSDK {
     ));
   }
 
+  /**
+   * Submit one revisioned document for extraction.
+   */
+  async createDocumentIngestion(
+    request: models.CreateDocumentIngestionRequestContent,
+    options?: RequestOptions,
+  ): Promise<operations.CreateDocumentIngestionResponse> {
+    return unwrapAsync(createDocumentIngestion(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  async getDocumentIngestion(
+    ingestionId: string,
+    options?: RequestOptions,
+  ): Promise<models.GetDocumentIngestionResponseContent> {
+    return unwrapAsync(getDocumentIngestion(
+      this,
+      ingestionId,
+      options,
+    ));
+  }
+
+  async listDocumentIngestionOutputs(
+    ingestionId: string,
+    limit?: number | undefined,
+    offset?: number | undefined,
+    options?: RequestOptions,
+  ): Promise<models.ListDocumentIngestionOutputsResponseContent> {
+    return unwrapAsync(listDocumentIngestionOutputs(
+      this,
+      ingestionId,
+      limit,
+      offset,
+      options,
+    ));
+  }
+
   /**
    * Returns read-only health for applicable store-scoped RAM features.
    */
@@ -55,6 +113,36 @@ export class AgentMemory extends ClientSDK {
     ));
   }
 
+  /**
+   * List hook decisions in stable newest-first order. Pages can be empty after owner filtering; continue while nextCursor is present. Internal run reservations are omitted.
+   */
+  async listIngestionHookStatuses(
+    limit?: number | undefined,
+    cursor?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<models.ListIngestionHookStatusesResponseContent> {
+    return unwrapAsync(listIngestionHookStatuses(
+      this,
+      limit,
+      cursor,
+      options,
+    ));
+  }
+
+  /**
+   * Read a hook decision and application status. Requires authenticated store access and, when enforced, matching owner scope. Content and secrets are never returned.
+   */
+  async getIngestionHookStatus(
+    eventId: string,
+    options?: RequestOptions,
+  ): Promise<models.GetIngestionHookStatusResponseContent> {
+    return unwrapAsync(getIngestionHookStatus(
+      this,
+      eventId,
+      options,
+    ));
+  }
+
   /**
    * Deletes long-term memories in bulk by their IDs.
    */
@@ -70,7 +158,7 @@ export class AgentMemory extends ClientSDK {
   }
 
   /**
-   * Creates long-term memories in bulk.
+   * Creates long-term memories in bulk. Records without namespace or namespaceRef stay un-namespaced. Automatic routing does not place them in a shared namespace. An explicit namespaceRef must pass destination admission and is never rerouted. Admission failures are reported per record in errors.
    */
   async bulkCreateLongTermMemories(
     request: models.BulkCreateLongTermMemoriesRequestContent,
@@ -84,7 +172,7 @@ export class AgentMemory extends ClientSDK {
   }
 
   /**
-   * Moves long-term memories to one existing namespace resource. Returns 409 when the destination namespace is archived.
+   * Moves long-term memories to an explicit namespaceRef, or automatically routes a memory that is already in a shared namespace when namespaceRef is omitted. Personal and un-namespaced memories are not automatic-routing candidates and keep their current placement with a per-item error. If routing is disabled or no shared destination qualifies, the memory also keeps its current placement and receives a per-item error. An explicit destination must pass admission and is never rerouted. Returns 409 when the explicit destination is archived; automatic routing and admission failures are reported per item in errors.
    */
   async moveLongTermMemories(
     request: models.MoveLongTermMemoriesRequestContent,
@@ -126,7 +214,7 @@ export class AgentMemory extends ClientSDK {
   }
 
   /**
-   * Partially updates a long-term memory by its ID.
+   * Partially updates a long-term memory by its ID. The merged record must pass admission at its destination. Updates never select a different destination automatically.
    */
   async updateLongTermMemory(
     memoryId: string,
@@ -142,7 +230,7 @@ export class AgentMemory extends ClientSDK {
   }
 
   /**
-   * Atomically updates a custom-typed long-term memory's text and/or attributes, scoped to the caller's bound memory type. Used by the custom-extraction worker.
+   * Atomically updates a custom-typed long-term memory's text and/or attributes, scoped to the caller's bound memory type. Used by the custom-extraction worker. New text must pass destination admission before the update is applied.
    */
   async updateLongTermMemoryFields(
     memoryId: string,
@@ -157,6 +245,72 @@ export class AgentMemory extends ClientSDK {
     ));
   }
 
+  /**
+   * Pages source links for one long-term memory. Tokens bind this query and expire.
+   */
+  async listMemorySourceLinks(
+    memoryId: string,
+    limit?: number | undefined,
+    pageToken?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<models.ListMemorySourceLinksResponseContent> {
+    return unwrapAsync(listMemorySourceLinks(
+      this,
+      memoryId,
+      limit,
+      pageToken,
+      options,
+    ));
+  }
+
+  /**
+   * Pages extraction evidence for one source of a memory, in append order. Tokens bind the store, current owner, memory and source, and expire.
+   */
+  async listMemorySourceEvidence(
+    memoryId: string,
+    sourceId: string,
+    limit?: number | undefined,
+    pageToken?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<models.ListMemorySourceEvidenceResponseContent> {
+    return unwrapAsync(listMemorySourceEvidence(
+      this,
+      memoryId,
+      sourceId,
+      limit,
+      pageToken,
+      options,
+    ));
+  }
+
+  /**
+   * Returns the store's namespace routing policy. An empty disabled policy is returned when none has been saved.
+   */
+  async getNamespaceRouting(
+    request?: operations.GetNamespaceRoutingRequest | undefined,
+    options?: RequestOptions,
+  ): Promise<models.GetNamespaceRoutingResponseContent> {
+    return unwrapAsync(getNamespaceRouting(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Replaces the store's namespace routing policy. Namespaces remain hierarchy records; routing is an ordered store-level document of plug-in strategies.
+   */
+  async putNamespaceRouting(
+    request: models.PutNamespaceRoutingRequestContent,
+    options?: RequestOptions,
+  ): Promise<models.PutNamespaceRoutingResponseContent> {
+    return unwrapAsync(putNamespaceRouting(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * Lists namespace roots or direct children.
    */
@@ -167,6 +321,8 @@ export class AgentMemory extends ClientSDK {
     limit?: number | undefined,
     pageToken?: string | undefined,
     options?: RequestOptions,
+    sortBy?: models.NamespaceSortBy | undefined,
+    sortOrder?: models.NamespaceSortOrder | undefined,
   ): Promise<models.ListNamespacesResponseContent> {
     return unwrapAsync(listNamespaces(
       this,
@@ -176,6 +332,8 @@ export class AgentMemory extends ClientSDK {
       limit,
       pageToken,
       options,
+      sortBy,
+      sortOrder,
     ));
   }
 
@@ -246,6 +404,7 @@ export class AgentMemory extends ClientSDK {
     filterOwnerId?: string | undefined,
     includeAll?: boolean | undefined,
     options?: RequestOptions,
+    namespaceRef?: string | undefined,
   ): Promise<models.ListSessionsResponseContent> {
     return unwrapAsync(listSessions(
       this,
@@ -254,6 +413,7 @@ export class AgentMemory extends ClientSDK {
       filterOwnerId,
       includeAll,
       options,
+      namespaceRef,
     ));
   }
 
@@ -332,4 +492,164 @@ export class AgentMemory extends ClientSDK {
       options,
     ));
   }
+
+  /**
+   * Returns paginated session rows with metadata and caller-selected order. The ID-only ListSessions operation remains unchanged.
+   */
+  async listSessionSummaries(
+    limit?: number | undefined,
+    pageToken?: string | undefined,
+    filterOwnerId?: string | undefined,
+    namespaceRef?: string | undefined,
+    includeAll?: boolean | undefined,
+    sortBy?: models.SessionListSortBy | undefined,
+    sortOrder?: models.SessionListSortOrder | undefined,
+    options?: RequestOptions,
+  ): Promise<models.ListSessionSummariesResponseContent> {
+    return unwrapAsync(listSessionSummaries(
+      this,
+      limit,
+      pageToken,
+      filterOwnerId,
+      namespaceRef,
+      includeAll,
+      sortBy,
+      sortOrder,
+      options,
+    ));
+  }
+
+  /**
+   * Pages memories linked to one source. A source link does not grant access to a memory in another owner or namespace.
+   */
+  async listSourceMemories(
+    sourceId: string,
+    ownerId: string,
+    limit?: number | undefined,
+    pageToken?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<models.ListSourceMemoriesResponseContent> {
+    return unwrapAsync(listSourceMemories(
+      this,
+      sourceId,
+      ownerId,
+      limit,
+      pageToken,
+      options,
+    ));
+  }
+
+  /**
+   * Lists Summary View definitions and high-level state. Partition values are not included.
+   */
+  async listSummaryViews(
+    limit?: number | undefined,
+    pageToken?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<models.ListSummaryViewsResponseContent> {
+    return unwrapAsync(listSummaryViews(
+      this,
+      limit,
+      pageToken,
+      options,
+    ));
+  }
+
+  /**
+   * Creates a Summary View definition and asynchronously enqueues its initial reconciliation.
+   */
+  async createSummaryView(
+    request: models.CreateSummaryViewRequestContent,
+    options?: RequestOptions,
+  ): Promise<models.CreateSummaryViewResponseContent> {
+    return unwrapAsync(createSummaryView(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Marks a Summary View deleting and asynchronously removes its schedule and materializations in bounded batches. Repeated requests are idempotent.
+   */
+  async deleteSummaryView(
+    viewId: string,
+    options?: RequestOptions,
+  ): Promise<models.DeleteSummaryViewResponseContent> {
+    return unwrapAsync(deleteSummaryView(
+      this,
+      viewId,
+      options,
+    ));
+  }
+
+  /**
+   * Returns one Summary View definition without partition values.
+   */
+  async getSummaryView(
+    viewId: string,
+    options?: RequestOptions,
+  ): Promise<models.GetSummaryViewResponseContent> {
+    return unwrapAsync(getSummaryView(
+      this,
+      viewId,
+      options,
+    ));
+  }
+
+  /**
+   * Updates mutable Summary View fields. Source is immutable. Material changes increment definitionVersion; name- or description-only changes do not enqueue refresh work.
+   */
+  async updateSummaryView(
+    viewId: string,
+    body?: models.UpdateSummaryViewRequestContent | undefined,
+    options?: RequestOptions,
+  ): Promise<models.UpdateSummaryViewResponseContent> {
+    return unwrapAsync(updateSummaryView(
+      this,
+      viewId,
+      body,
+      options,
+    ));
+  }
+
+  /**
+   * Asynchronously enqueues one exact partition refresh or a complete view reconciliation. It never performs generation synchronously.
+   */
+  async refreshSummaryView(
+    viewId: string,
+    body: models.RefreshSummaryViewRequestContent,
+    options?: RequestOptions,
+  ): Promise<models.RefreshSummaryViewResponseContent> {
+    return unwrapAsync(refreshSummaryView(
+      this,
+      viewId,
+      body,
+      options,
+    ));
+  }
+
+  /**
+   * Returns one authorized exact Summary View partition after validating its contributing source records. Invalid output is withheld while repair is pending.
+   */
+  async getSummaryViewResult(
+    viewId: string,
+    ownerId?: string | undefined,
+    sessionId?: string | undefined,
+    namespaceRef?: string | undefined,
+    memoryType?: string | undefined,
+    includeSourceMemoryIds?: boolean | undefined,
+    options?: RequestOptions,
+  ): Promise<models.GetSummaryViewResultResponseContent> {
+    return unwrapAsync(getSummaryViewResult(
+      this,
+      viewId,
+      ownerId,
+      sessionId,
+      namespaceRef,
+      memoryType,
+      includeSourceMemoryIds,
+      options,
+    ));
+  }
 }

package/tests/list-sessions-compatibility.ts

@@ -0,0 +1,25 @@
+// Keep these pre-0.4 call shapes unchanged when regenerating the SDK.
+import { AgentMemory } from "../dist/esm/index.js";
+import { AgentMemoryCore } from "../dist/esm/core.js";
+import { listSessions } from "../dist/esm/funcs/list-sessions.js";
+import type { RequestOptions } from "../dist/esm/lib/sdks.js";
+
+declare const sdk: AgentMemory;
+declare const core: AgentMemoryCore;
+const options: RequestOptions = { headers: { "X-Request-ID": "compatibility" } };
+
+sdk.listSessions();
+sdk.listSessions(10, "next", "owner-1");
+sdk.listSessions(10, undefined, undefined, true);
+sdk.listSessions(10, undefined, "owner-1", false, options);
+sdk.listSessions(undefined, undefined, "owner-1", undefined, options);
+
+listSessions(core);
+listSessions(core, 10, "next", "owner-1");
+listSessions(core, 10, undefined, undefined, true);
+listSessions(core, 10, undefined, "owner-1", false, options);
+listSessions(core, undefined, undefined, "owner-1", undefined, options);
+
+// New namespace filtering leaves every existing argument in place.
+sdk.listSessions(10, undefined, undefined, false, options, "namespace-1");
+listSessions(core, 10, undefined, undefined, false, options, "namespace-1");