@nexusm/sdk 3.0.0 → 5.0.0

package/README.md

@@ -165,10 +165,13 @@ const graph = await nexus.knowledge.query({
 
 | Method | Description |
 |--------|-------------|
-| `createEntity(data)` | Create a new entity in the knowledge graph |
-| `listEntities(params?)` | List entities with optional filtering |
+| `listEntities(params)` | List entities for a user (`user_id` required) |
 | `query(request)` | BFS graph traversal from a named entity |
-| `extract(request)` | Extract entities and relationships from text |
+| `extract(request)` | Extract entities and relationships from text (also how entities are created) |
+
+> v3.0.0: `createEntity()` was removed — the backend has no
+> `POST /knowledge/entities` route (the SDK method 404'd at runtime).
+> Entities are created via `extract()`.
 
 ### Activity Service
 
@@ -202,14 +205,14 @@ Tenant profile and usage management. Identity is derived from the API key.
 const tenant = await nexus.tenants.me();
 console.log(tenant.name, tenant.tier);
 
-const usage = await nexus.tenants.usage();
-console.log('Memories:', usage.memories_count);
+const usage = await nexus.tenants.usage('week');
+console.log(`API calls: ${usage.api_calls} (${usage.success_rate}% ok)`);
 ```
 
 | Method | Description |
 |--------|-------------|
-| `me()` | Retrieve the current tenant profile |
-| `usage()` | Retrieve resource usage statistics |
+| `me()` | Retrieve the current tenant profile (flat counts + `quota_remaining`) |
+| `usage(period?)` | Usage statistics for `'day'` (default) / `'week'` / `'month'` — 13-field `UsageStats` |
 
 ## Error Handling
 

package/dist/index.d.mts

@@ -802,13 +802,26 @@ declare class ContextService extends BaseService {
 type MemoryType = 'episodic' | 'semantic' | 'procedural';
 /**
  * A memory record stored in the Nexus platform.
- * Represents a single piece of user knowledge managed by Mem0.
+ *
+ * Mirrors backend `MemoryResponse` (schemas/memory.py, 14 fields).
+ *
+ * v4.0.0 (memory-conversation-contract-reconciliation): adds the
+ * compound-identifier trio (`memory_id` / `tenant_id` / `agent_id`) and the
+ * US-035 temporal-validity window (`valid_from` / `valid_until` /
+ * `valid_until_source`) — all emitted by the backend but previously missing
+ * from this type (readers got `undefined`).
  */
 interface Memory {
+    /** Compound memory ID ("tenant::user::uuid") — needed for multi-tenant ops */
+    memory_id: string;
     /** Unique memory identifier (UUID) */
     id: string;
+    /** Tenant identifier */
+    tenant_id: string;
     /** User ID that owns this memory */
     user_id: string;
+    /** Originating agent (null when not agent-written) */
+    agent_id?: string | null;
     /** Memory content text */
     content: string;
     /** Classification of the memory */
@@ -816,7 +829,13 @@ interface Memory {
     /** Additional metadata key-value pairs */
     metadata?: Record<string, unknown>;
     /** Relevance score (present in search results) */
-    score?: number;
+    score?: number | null;
+    /** Start of the temporal validity window (inclusive; server-managed) */
+    valid_from?: string | null;
+    /** End of the temporal validity window (exclusive; null = permanent) */
+    valid_until?: string | null;
+    /** Provenance of valid_until (permanent / extracted / sdk_provided / ...) */
+    valid_until_source?: string | null;
     /** Timestamp when the memory was created (ISO 8601) */
     created_at: string;
     /** Timestamp when the memory was last updated (ISO 8601) */
@@ -920,22 +939,25 @@ interface MemorySearchResult {
 /**
  * Paginated list of memories.
  *
- * GET /memories?user_id=...
+ * GET /memories?user_id=... — mirrors backend `MemoryListResponse` (FLAT
+ * container).
+ *
+ * v5.0.0 BREAKING: was nested `{data, pagination:{total, limit, offset,
+ * has_more}}` — that shape never existed on the wire. The backend response
+ * is flat `{memories, total_count, limit, offset, has_next}`; the old nested
+ * shape meant `result.data` was always `undefined` at runtime.
  */
 interface MemoryList {
     /** Array of memory records */
-    data: Memory[];
-    /** Pagination metadata */
-    pagination: {
-        /** Total number of memories */
-        total: number;
-        /** Current page size limit */
-        limit: number;
-        /** Current offset */
-        offset: number;
-        /** Whether more results exist */
-        has_more: boolean;
-    };
+    memories: Memory[];
+    /** Total number of memories matching the query */
+    total_count: number;
+    /** Current page size limit */
+    limit: number;
+    /** Current offset */
+    offset: number;
+    /** Whether more results exist beyond this page */
+    has_next: boolean;
 }
 /**
  * A single journal entry representing a memory on a specific date.
@@ -985,8 +1007,13 @@ interface JournalResponse {
  * Parameters for listing memories with optional filtering and pagination.
  */
 interface MemoryListParams {
-    /** Filter memories by user ID */
-    user_id?: string;
+    /**
+     * User ID within the tenant whose memories to list.
+     *
+     * v5.0.0 BREAKING: now required — backend `GET /memories` declares
+     * `user_id` as `Query(..., min_length=1)`; omitting it returns 422.
+     */
+    user_id: string;
     /** Filter by memory type classification */
     memory_type?: MemoryType;
     /** Maximum number of results per page */
@@ -1008,8 +1035,9 @@ interface MemoryJournalParams {
     user_id?: string;
 }
 /**
- * Service for managing long-term memories via Mem0.
+ * Service for managing long-term memories.
  *
+ * Backed by the Nexus Memory Service (Native pgvector + ProfileWorker).
  * Provides full CRUD operations, semantic search, and the chronological
  * Memory Journal view for reviewing memories over time.
  *
@@ -1097,10 +1125,17 @@ declare class MemoryService extends BaseService {
 /**
  * @nexusm/sdk - Conversation Types
  *
- * Type definitions for the Conversation Service powered by Zep OSS.
+ * Type definitions for the Conversation Service.
  * Manages conversation history, messages, and auto-generated summaries.
  *
- * Based on Nexus API v2.0 OpenAPI specification.
+ * v4.0.0 BREAKING (memory-conversation-contract-reconciliation, 2026-06-11):
+ * canonical = backend Pydantic response models (`schemas/conversation.py`)
+ * serialized wire names. The previous shapes were drifted: nested
+ * `{data, pagination}` containers never existed on the wire (backend lists
+ * are FLAT), the conversation identifier wire key is `conversation_id` (the
+ * old `session_id` was a phantom), `ConversationDetail` described a response
+ * no endpoint emits, and `ConversationSummary` declared phantom
+ * `key_points`/`generated_at` while missing the real count fields.
  */
 /** Valid message roles in a conversation */
 type MessageRole = 'user' | 'assistant' | 'system' | 'tool';
@@ -1108,21 +1143,39 @@ type MessageRole = 'user' | 'assistant' | 'system' | 'tool';
 type ConversationStatus = 'active' | 'archived' | 'deleted';
 /**
  * A conversation session between a user and an AI agent.
- * Managed by Zep OSS for temporal graph and auto-summary.
+ *
+ * GET /conversations/{conversation_id} — mirrors backend
+ * `ConversationResponse` (11 fields, flat).
+ *
+ * v4.0.0 BREAKING: `session_id` → `conversation_id` (the real wire key —
+ * backend field `compound_session_id` serializes via alias); adds
+ * `tenant_id` / `agent_id` / `status` (previously missing).
  */
 interface Conversation {
     /** Unique conversation identifier (UUID) */
     id: string;
+    /** Compound session ID ("tenant::user::session") — the wire key */
+    conversation_id: string;
+    /** Tenant identifier */
+    tenant_id: string;
     /** User ID that owns this conversation */
     user_id: string;
-    /** Session identifier for the conversation */
-    session_id?: string;
-    /** Auto-generated conversation summary */
-    summary?: string;
+    /**
+     * Originating agent (null when not agent-created).
+     *
+     * v5.0.0: required-nullable convention — always emitted by the backend
+     * (`ConversationResponse.agent_id: str | None`), value may be null. Was
+     * `agent_id?: string | null` (optional); now `string | null` (required dict).
+     */
+    agent_id: string | null;
+    /** Conversation status (e.g. active / archived) */
+    status: string;
+    /** Auto-generated conversation summary (null until first summary worker run) */
+    summary: string | null;
     /** Total number of messages in the conversation */
     message_count: number;
-    /** Additional metadata key-value pairs */
-    metadata?: Record<string, unknown>;
+    /** Additional metadata key-value pairs (always emitted, defaults to {}) */
+    metadata: Record<string, unknown>;
     /** Timestamp when the conversation was created (ISO 8601) */
     created_at: string;
     /** Timestamp when the conversation was last updated (ISO 8601) */
@@ -1131,30 +1184,45 @@ interface Conversation {
 /**
  * Request payload for creating a new conversation.
  *
- * POST /conversations
+ * POST /conversations — mirrors backend `CreateConversationRequest`.
+ *
+ * v5.0.0 BREAKING: removed phantom `session_id` — the backend
+ * (`CreateConversationRequest`) does not accept it; it was silently dropped
+ * by Pydantic `extra=ignore`, and the session id is ALWAYS auto-generated
+ * server-side regardless of input (the old "auto-generated if not provided"
+ * doc was false). Added `agent_id` — the backend accepts it but the SDK had
+ * no way to send it.
  */
 interface ConversationCreate {
     /** User ID to associate the conversation with */
     user_id: string;
-    /** Custom session ID (auto-generated if not provided) */
-    session_id?: string;
+    /** Optional agent identifier to associate the conversation with */
+    agent_id?: string;
     /** Additional metadata key-value pairs */
     metadata?: Record<string, unknown>;
 }
-/**
- * Conversation with its messages included.
- * Returned when include_messages=true.
- */
-interface ConversationDetail extends Conversation {
-    /** Messages in the conversation */
-    messages: Message[];
-}
 /**
  * A single message within a conversation.
+ *
+ * Mirrors backend `MessageResponse` (11 fields).
+ *
+ * v4.0.0 BREAKING: adds `message_id` / `conversation_id` /
+ * `conversation_compound_id` / `tenant_id` / `user_id` correlation fields
+ * (previously missing from the SDK type while present on the wire).
  */
 interface Message {
     /** Unique message identifier (UUID) */
     id: string;
+    /** Compound message ID */
+    message_id: string;
+    /** Owning conversation UUID (NOT the compound id — see conversation_compound_id) */
+    conversation_id: string;
+    /** Owning conversation compound ID ("tenant::user::session") */
+    conversation_compound_id: string;
+    /** Tenant identifier */
+    tenant_id: string;
+    /** User identifier */
+    user_id: string;
     /** Message role (user, assistant, system, or tool) */
     role: MessageRole;
     /** Message content text */
@@ -1162,7 +1230,7 @@ interface Message {
     /** Additional metadata key-value pairs */
     metadata?: Record<string, unknown>;
     /** Message sequence number within the conversation */
-    sequence?: number;
+    sequence: number;
     /** Timestamp when the message was created (ISO 8601) */
     created_at: string;
 }
@@ -1182,68 +1250,93 @@ interface MessageCreate {
 /**
  * Paginated list of conversations.
  *
- * GET /conversations?user_id=...
+ * GET /conversations?user_id=... — mirrors backend
+ * `ConversationListResponse` (FLAT container).
+ *
+ * v4.0.0 BREAKING: was nested `{data, pagination:{total, limit, offset,
+ * has_more}}` — that shape never existed on the wire.
  */
 interface ConversationList {
     /** Array of conversation records */
-    data: Conversation[];
-    /** Pagination metadata */
-    pagination: {
-        /** Total number of conversations */
-        total: number;
-        /** Current page size limit */
-        limit: number;
-        /** Current offset */
-        offset: number;
-        /** Whether more results exist */
-        has_more: boolean;
-    };
+    conversations: Conversation[];
+    /** Total number of conversations */
+    total_count: number;
+    /** Current page size limit */
+    limit: number;
+    /** Current offset */
+    offset: number;
+    /** Whether more results exist */
+    has_next: boolean;
 }
 /**
  * Paginated list of messages within a conversation.
  *
- * GET /conversations/:conversation_id/messages
+ * GET /conversations/:conversation_id/messages — mirrors backend
+ * `MessageListResponse` (FLAT container).
+ *
+ * v4.0.0 BREAKING: was `{data, has_more}` — missing
+ * total_count/limit/offset and using a phantom container key.
  */
 interface MessageList {
     /** Array of message records */
-    data: Message[];
-    /** Whether more messages exist before the current page */
-    has_more: boolean;
+    messages: Message[];
+    /** Total number of messages */
+    total_count: number;
+    /** Current page size limit */
+    limit: number;
+    /** Current offset */
+    offset: number;
+    /** Whether more messages exist */
+    has_next: boolean;
 }
 /**
  * Auto-generated summary of a conversation.
- * Generated by Zep OSS temporal graph analysis.
  *
- * GET /conversations/:conversation_id/summary
+ * GET /conversations/:conversation_id/summary — mirrors backend
+ * `SummaryResponse` (5 fields).
+ *
+ * v4.0.0 BREAKING: the previous shape declared phantom `key_points[]` /
+ * `generated_at`; the backend emits message counts + `created_at`. The wire
+ * id key is `conversation_id` (unified 2026-06-11 — the endpoint previously
+ * emitted `compound_session_id`, an internal third id variant).
  */
 interface ConversationSummary {
-    /** Conversation identifier (UUID) */
+    /** Compound conversation ID (same key as Conversation.conversation_id) */
     conversation_id: string;
-    /** Generated summary text */
-    summary?: string;
-    /** Key points extracted from the conversation */
-    key_points?: string[];
-    /** Timestamp when the summary was generated (ISO 8601) */
-    generated_at: string;
+    /** Generated summary text (null until first summary) */
+    summary?: string | null;
+    /** Number of messages already folded into the summary */
+    summary_message_count: number;
+    /** Total number of messages in the conversation */
+    message_count: number;
+    /** Timestamp when the conversation was created (ISO 8601) */
+    created_at: string;
 }
 
 /**
  * @module services/conversations
  * @description Conversation Service - Conversation history and auto-summary management.
  *
- * Wraps the Nexus Conversation API powered by Zep OSS. Supports
- * conversation lifecycle management, message operations, and
- * auto-generated summaries via temporal graph analysis.
+ * Wraps the Nexus Conversation API (Native implementation: incremental
+ * summaries produced by the backend SummaryWorker, NOT Zep OSS). Supports
+ * conversation lifecycle management, message operations, and access to
+ * auto-generated summaries.
  *
- * Based on Nexus API v2.0 - /conversations endpoints
+ * v5.0.0: corrected stale "Zep OSS"/"temporal graph"/"API v2.0" docs — the
+ * backend has always used a Native SummaryWorker.
  */
 
 /**
  * Parameters for listing conversations with optional filtering and pagination.
  */
 interface ConversationListParams {
-    /** Filter conversations by user ID */
-    user_id?: string;
+    /**
+     * User ID within the tenant whose conversations to list.
+     *
+     * v5.0.0 BREAKING: now required — backend `GET /conversations` declares
+     * `user_id` as `Query(..., min_length=1)`; omitting it returns 422.
+     */
+    user_id: string;
     /** Maximum number of results per page */
     limit?: number;
     /** Offset for pagination */
@@ -1259,11 +1352,11 @@ interface MessageListParams {
     offset?: number;
 }
 /**
- * Service for managing conversations and messages via Zep OSS.
+ * Service for managing conversations and messages.
  *
  * Provides conversation lifecycle management (create, list, get, delete),
  * message operations (add, list), and access to auto-generated summaries
- * produced by Zep's temporal graph analysis.
+ * produced by the backend SummaryWorker (Native, incremental).
  *
  * @example
  * ```typescript
@@ -1301,21 +1394,25 @@ declare class ConversationService extends BaseService {
      */
     list(params?: ConversationListParams, options?: RequestOptions): Promise<ConversationList>;
     /**
-     * Retrieve a conversation with its messages included.
+     * Retrieve a conversation.
+     *
+     * v4.0.0 BREAKING: returns `Conversation` — the backend response has no
+     * `messages` array (the previous `ConversationDetail` shape was a
+     * phantom). Fetch messages via {@link getMessages}.
      *
-     * @param conversationId - UUID of the conversation to retrieve.
-     * @returns Conversation detail including the full message list.
+     * @param conversationId - Compound conversation ID to retrieve.
+     * @returns The conversation record.
      * @throws {ApiError} 404 if the conversation does not exist.
      */
-    get(conversationId: string, options?: RequestOptions): Promise<ConversationDetail>;
+    get(conversationId: string, options?: RequestOptions): Promise<Conversation>;
     /**
      * Add a message to an existing conversation.
      *
-     * The message is appended to the conversation's message sequence.
-     * Zep will asynchronously update the conversation summary after
-     * new messages are added.
+     * The message is appended to the conversation's message sequence. The
+     * backend SummaryWorker asynchronously updates the conversation summary
+     * after new messages are added.
      *
-     * @param conversationId - UUID of the target conversation.
+     * @param conversationId - Compound conversation ID ("tenant::user::session").
      * @param message - Message payload including role and content.
      * @returns The newly created message with generated ID and sequence number.
      * @throws {ApiError} 404 if the conversation does not exist.
@@ -1326,7 +1423,7 @@ declare class ConversationService extends BaseService {
      *
      * Messages are returned in chronological order (oldest first).
      *
-     * @param conversationId - UUID of the conversation.
+     * @param conversationId - Compound conversation ID ("tenant::user::session").
      * @param params - Optional pagination controls (limit, offset).
      * @returns Paginated list of messages.
      * @throws {ApiError} 404 if the conversation does not exist.
@@ -1335,21 +1432,24 @@ declare class ConversationService extends BaseService {
     /**
      * Retrieve the auto-generated summary of a conversation.
      *
-     * Summaries are produced by Zep OSS temporal graph analysis and
-     * include key points extracted from the conversation history.
+     * Summaries are produced incrementally by the backend SummaryWorker from
+     * the conversation history.
      *
-     * @param conversationId - UUID of the conversation.
-     * @returns The conversation summary with key points and generation timestamp.
+     * @param conversationId - Compound conversation ID ("tenant::user::session").
+     * @returns The conversation summary ({@link ConversationSummary}: summary
+     *   text + message counts + created_at). Note: no "key points" or
+     *   "generated_at" fields — those were phantom (removed in v4.0.0).
      * @throws {ApiError} 404 if the conversation does not exist.
      */
     getSummary(conversationId: string, options?: RequestOptions): Promise<ConversationSummary>;
     /**
-     * Delete a conversation and all its messages.
+     * Delete a conversation.
      *
-     * This operation is irreversible. The conversation, all associated
-     * messages, and the generated summary will be permanently removed.
+     * Soft-delete: the backend sets `deleted_at` (the conversation stops
+     * appearing in list/get) rather than physically removing the row and its
+     * messages.
      *
-     * @param conversationId - UUID of the conversation to delete.
+     * @param conversationId - Compound conversation ID ("tenant::user::session").
      * @throws {ApiError} 404 if the conversation does not exist.
      */
     delete(conversationId: string, options?: RequestOptions): Promise<void>;
@@ -1758,6 +1858,8 @@ interface TenantQuotas {
     max_memories?: number;
     /** Maximum number of conversations allowed */
     max_conversations?: number;
+    /** Maximum number of knowledge graph nodes allowed */
+    max_graph_nodes?: number;
     /** Maximum API calls per day */
     max_api_calls_per_day?: number;
     /** Forward-compatible: any additional quota dimensions */
@@ -1833,9 +1935,12 @@ interface ApiKeyCreate {
     /** Human-readable name for the API key (1-255 characters) */
     name: string;
     /**
-     * Permission scopes for the key (known values: read, write, admin, "*").
-     * @default ["*"] — the backend default grants the full wildcard; tightening
-     * the default is a separate backend security follow-up.
+     * Permission scopes for the key (known values: read, write, admin,
+     * admin:dashboard, feedback:diagnose, "*" wildcard).
+     * @default ["read", "write"] — least-privilege default (backend tightened
+     * in security-scopes-admin-hardening, 2026-06-11). The "*" wildcard must be
+     * requested explicitly; the default intentionally omits admin:dashboard /
+     * feedback:diagnose.
      */
     scopes?: string[];
     /**
@@ -2505,16 +2610,16 @@ declare const memorySearchSchema: z.ZodObject<{
 
 declare const conversationCreateSchema: z.ZodObject<{
     user_id: z.ZodString;
-    session_id: z.ZodOptional<z.ZodString>;
+    agent_id: z.ZodOptional<z.ZodString>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     user_id: string;
     metadata?: Record<string, unknown> | undefined;
-    session_id?: string | undefined;
+    agent_id?: string | undefined;
 }, {
     user_id: string;
     metadata?: Record<string, unknown> | undefined;
-    session_id?: string | undefined;
+    agent_id?: string | undefined;
 }>;
 declare const messageCreateSchema: z.ZodObject<{
     role: z.ZodEnum<["user", "assistant", "system", "tool"]>;
@@ -2571,4 +2676,4 @@ declare const apiKeyCreateSchema: z.ZodObject<{
     expires_in_days?: number | undefined;
 }>;
 
-export { type Activity, type ActivityProcessingStatus, ActivityService, type ActivityStats, type ActivityStatusResponse, type ActivityStreamRequest, type ActivityStreamResponse, type ActivityType, ApiError, type ApiErrorDetail, type ApiKey, type ApiKeyCreate, type ApiKeyCreated, type ApiResponse, AuthenticationError, type CacheConfig, type CompoundId, ConfigurationError, type ContextDepth, type ContextDepthPreset, type ContextGraphEntity, type ContextLayer, type ContextRequest, type ContextRetrieveResponse, ContextService, type Conversation, type ConversationCreate, type ConversationDetail, type ConversationList, type ConversationListParams, type ConversationMessage, ConversationService, type ConversationStatus, type ConversationSummary, DEFAULT_CONFIG, DEPTH_PRESETS, type EntityListParams, type EntityListResponse, type ErrorReportRequest, type ErrorReportResponse, ErrorService, type ErrorSeverity, type ErrorType, type ExtractionRequest, type ExtractionResult, type FeedbackItemRequest, type FeedbackListItem, type FeedbackListParams, type FeedbackListResponse, type FeedbackResponse, FeedbackService, type FeedbackSubmitRequest, type GraphPath, type GraphPathEntity, type GraphPathRelationship, type GraphQueryRequest, type GraphQueryResponse, type HealthResponse, type HealthStatus, InputValidationError, type JournalEntry, type JournalResponse, type KnowledgeEntity, type KnowledgeRelationship, KnowledgeService, type Memory, type MemoryCreate, type MemoryJournalParams, type MemoryList, type MemoryListParams, type MemorySearch, type MemorySearchResult, MemoryService, type MemoryType, type MemoryUpdate, type Message, type MessageCreate, type MessageList, type MessageListParams, type MessageRole, NetworkError, NexusClient, type NexusConfig, NexusError, NotFoundError, type OfflineConfig, OfflineQueue, type PaginatedResponse, type Pagination, type ProfileMemory, type QueuedRequest, RateLimitError, type RequestOptions, type ResolvedCacheConfig, type ResolvedConfig, type ResolvedRetryConfig, type RetryConfig, type SearchResult, type ServiceStatus, type SortOrder, type Tenant, type TenantQuotas, TenantService, type TenantTier, TimeoutError, type UsageStats, ValidationError, apiKeyCreateSchema, contextRequestSchema, conversationCreateSchema, extractionRequestSchema, graphQueryRequestSchema, memoryCreateSchema, memorySearchSchema, memoryUpdateSchema, messageCreateSchema, resolveConfig };
+export { type Activity, type ActivityProcessingStatus, ActivityService, type ActivityStats, type ActivityStatusResponse, type ActivityStreamRequest, type ActivityStreamResponse, type ActivityType, ApiError, type ApiErrorDetail, type ApiKey, type ApiKeyCreate, type ApiKeyCreated, type ApiResponse, AuthenticationError, type CacheConfig, type CompoundId, ConfigurationError, type ContextDepth, type ContextDepthPreset, type ContextGraphEntity, type ContextLayer, type ContextRequest, type ContextRetrieveResponse, ContextService, type Conversation, type ConversationCreate, type ConversationList, type ConversationListParams, type ConversationMessage, ConversationService, type ConversationStatus, type ConversationSummary, DEFAULT_CONFIG, DEPTH_PRESETS, type EntityListParams, type EntityListResponse, type ErrorReportRequest, type ErrorReportResponse, ErrorService, type ErrorSeverity, type ErrorType, type ExtractionRequest, type ExtractionResult, type FeedbackItemRequest, type FeedbackListItem, type FeedbackListParams, type FeedbackListResponse, type FeedbackResponse, FeedbackService, type FeedbackSubmitRequest, type GraphPath, type GraphPathEntity, type GraphPathRelationship, type GraphQueryRequest, type GraphQueryResponse, type HealthResponse, type HealthStatus, InputValidationError, type JournalEntry, type JournalResponse, type KnowledgeEntity, type KnowledgeRelationship, KnowledgeService, type Memory, type MemoryCreate, type MemoryJournalParams, type MemoryList, type MemoryListParams, type MemorySearch, type MemorySearchResult, MemoryService, type MemoryType, type MemoryUpdate, type Message, type MessageCreate, type MessageList, type MessageListParams, type MessageRole, NetworkError, NexusClient, type NexusConfig, NexusError, NotFoundError, type OfflineConfig, OfflineQueue, type PaginatedResponse, type Pagination, type ProfileMemory, type QueuedRequest, RateLimitError, type RequestOptions, type ResolvedCacheConfig, type ResolvedConfig, type ResolvedRetryConfig, type RetryConfig, type SearchResult, type ServiceStatus, type SortOrder, type Tenant, type TenantQuotas, TenantService, type TenantTier, TimeoutError, type UsageStats, ValidationError, apiKeyCreateSchema, contextRequestSchema, conversationCreateSchema, extractionRequestSchema, graphQueryRequestSchema, memoryCreateSchema, memorySearchSchema, memoryUpdateSchema, messageCreateSchema, resolveConfig };