@memnexus-ai/typescript-sdk 1.42.12 → 1.42.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -244,133 +244,6 @@ declare class BaseService {
244
244
  set token(token: string);
245
245
  }
246
246
 
247
- /**
248
- * AdminService - Admin management endpoints for invite codes and platform configuration API operations.
249
- * Auto-generated by sdk-generator - do not edit manually.
250
- */
251
-
252
- /**
253
- * Admin management endpoints for invite codes and platform configuration
254
- */
255
- declare class AdminService extends BaseService {
256
- /**
257
- * List invite codes
258
- * List all invite codes with optional status filter
259
- * @param status - Filter by status
260
- * @param limit -
261
- * @param offset -
262
- */
263
- adminListInviteCodes(options?: {
264
- status?: 'active' | 'exhausted' | 'revoked' | 'expired';
265
- limit?: number;
266
- offset?: number;
267
- }): Promise<HttpResponse<{
268
- invites?: {
269
- id?: string;
270
- code?: string;
271
- email?: string;
272
- label?: string;
273
- maxUses?: number;
274
- currentUses?: number;
275
- status?: string;
276
- expiresAt?: string;
277
- createdAt?: string;
278
- }[];
279
- total?: number;
280
- }>>;
281
- /**
282
- * Create invite code
283
- * Create a new invite code for the gated preview
284
- * @param body - Request body
285
- */
286
- adminCreateInviteCode(body: {
287
- email: string;
288
- label: string;
289
- maxUses?: number;
290
- code?: string;
291
- expiresAt?: string;
292
- metadata?: Record<string, unknown>;
293
- }): Promise<HttpResponse<{
294
- id?: string;
295
- code?: string;
296
- label?: string;
297
- maxUses?: number;
298
- currentUses?: number;
299
- status?: string;
300
- expiresAt?: string;
301
- createdAt?: string;
302
- shareUrl?: string;
303
- }>>;
304
- /**
305
- * Get invite system statistics
306
- * Aggregate statistics for the invite system
307
- */
308
- adminGetInviteStats(): Promise<HttpResponse<{
309
- totalCodes?: number;
310
- activeCodes?: number;
311
- totalRedemptions?: number;
312
- totalCapacity?: number;
313
- utilizationRate?: number;
314
- recentRedemptions?: {
315
- code?: string;
316
- email?: string;
317
- redeemedAt?: string;
318
- }[];
319
- }>>;
320
- /**
321
- * Get invite code details
322
- * Get details for a single invite code including redemptions
323
- * @param code - The invite code
324
- */
325
- adminGetInviteCode(code: string): Promise<HttpResponse<{
326
- id?: string;
327
- code?: string;
328
- email?: string;
329
- label?: string;
330
- maxUses?: number;
331
- currentUses?: number;
332
- status?: string;
333
- redemptions?: {
334
- userId?: string;
335
- email?: string;
336
- redeemedAt?: string;
337
- }[];
338
- }>>;
339
- /**
340
- * Revoke an invite code
341
- * Revoke an invite code. Existing accounts created with this code are unaffected.
342
- * @param code -
343
- */
344
- adminRevokeInviteCode(code: string): Promise<HttpResponse<{
345
- code?: string;
346
- status?: string;
347
- message?: string;
348
- }>>;
349
- /**
350
- * Get gate status with audit info
351
- * Get current invite gate state with audit information
352
- */
353
- adminGetGateStatus(): Promise<HttpResponse<{
354
- gated?: boolean;
355
- updatedAt?: string;
356
- updatedBy?: string;
357
- }>>;
358
- /**
359
- * Toggle invite gate
360
- * Toggle the invite gate. When enabled (true), new signups require a valid invite code.
361
- When disabled (false), registration is open. Takes effect immediately.
362
-
363
- * @param body - Request body
364
- */
365
- adminSetGateStatus(body: {
366
- enabled: boolean;
367
- }): Promise<HttpResponse<{
368
- gated?: boolean;
369
- updatedAt?: string;
370
- message?: string;
371
- }>>;
372
- }
373
-
374
247
  /**
375
248
  * Zod schemas for API models.
376
249
  * Auto-generated by sdk-generator - do not edit manually.
@@ -5341,352 +5214,372 @@ type DigestSource = z.infer<typeof digestSource>;
5341
5214
  type DigestResponse = z.infer<typeof digestResponse>;
5342
5215
 
5343
5216
  /**
5344
- * ApiKeysService - API key management endpoints API operations.
5217
+ * UsersService - User management and profile endpoints API operations.
5345
5218
  * Auto-generated by sdk-generator - do not edit manually.
5346
5219
  */
5347
5220
 
5348
5221
  /**
5349
- * API key management endpoints
5222
+ * User management and profile endpoints
5350
5223
  */
5351
- declare class ApiKeysService extends BaseService {
5224
+ declare class UsersService extends BaseService {
5352
5225
  /**
5353
- * Get user information for current API key
5354
- * Debug endpoint to retrieve user ID and authentication method from the current API key
5226
+ * Sync user from WorkOS
5227
+ * Called by the customer portal after WorkOS authentication.
5228
+ Creates a new user if they don't exist, or updates their profile if they do.
5229
+ This is the main entry point for user provisioning.
5230
+ When the invite gate is closed and a new user is created, the inviteCode
5231
+ is redeemed atomically to track which code was used for registration.
5232
+
5233
+ * @param body - Request body
5355
5234
  */
5356
- debugUser(): Promise<HttpResponse<{
5357
- data?: {
5358
- userId?: string;
5359
- authMethod?: string;
5360
- };
5235
+ syncUser(body: {
5236
+ workosId: string;
5237
+ email: string;
5238
+ firstName?: string;
5239
+ lastName?: string;
5240
+ profilePictureUrl?: string;
5241
+ inviteCode?: string;
5242
+ }): Promise<HttpResponse<{
5243
+ data?: User;
5244
+ created?: boolean;
5361
5245
  }>>;
5362
5246
  /**
5363
- * List API keys
5364
- * List all API keys for the authenticated user
5247
+ * Get current user
5248
+ * Get the currently authenticated user's profile and usage information
5365
5249
  */
5366
- listApiKeys(): Promise<HttpResponse<{
5367
- data?: ApiKey[];
5250
+ getCurrentUser(): Promise<HttpResponse<{
5251
+ data?: User;
5252
+ usage?: UserUsage;
5368
5253
  }>>;
5369
5254
  /**
5370
- * Create API key
5371
- * Create a new API key for the authenticated user
5255
+ * Update current user
5256
+ * Update the currently authenticated user's profile
5372
5257
  * @param body - Request body
5373
5258
  */
5374
- createApiKey(options?: {
5259
+ updateCurrentUser(options?: {
5375
5260
  body?: {
5376
- label?: string;
5377
- expiresAt?: string;
5261
+ firstName?: string;
5262
+ lastName?: string;
5263
+ profilePictureUrl?: string;
5378
5264
  };
5379
5265
  }): Promise<HttpResponse<{
5380
- data?: {
5381
- apiKey?: string;
5382
- keyInfo?: ApiKey;
5266
+ data?: User;
5267
+ }>>;
5268
+ /**
5269
+ * Get current user's usage
5270
+ * Get the currently authenticated user's memory usage statistics
5271
+ */
5272
+ getCurrentUserUsage(): Promise<HttpResponse<{
5273
+ data?: UserUsage;
5274
+ }>>;
5275
+ /**
5276
+ * Export all user data
5277
+ * Export all user data as a JSON archive. Includes profile, memories,
5278
+ conversations, facts, and patterns. Supports GDPR Article 20
5279
+ (right to data portability). Sensitive fields (Stripe customer ID,
5280
+ WorkOS ID, embeddings) are excluded.
5281
+
5282
+ */
5283
+ exportUserData(): Promise<HttpResponse<{
5284
+ exportVersion?: string;
5285
+ exportedAt?: string;
5286
+ counts?: {
5287
+ memories?: number;
5288
+ conversations?: number;
5289
+ facts?: number;
5290
+ patterns?: number;
5383
5291
  };
5292
+ profile?: Record<string, unknown>;
5293
+ memories?: Memory[];
5294
+ conversations?: Conversation[];
5295
+ facts?: Fact[];
5296
+ patterns?: Pattern[];
5384
5297
  }>>;
5385
5298
  /**
5386
- * Delete API key
5387
- * Delete (revoke) an API key by its ID
5388
- * @param id - The API key ID
5299
+ * Initiate account deletion
5300
+ * Schedule the current user's account for deletion after a 7-day grace period.
5301
+ Requires email confirmation. Immediately revokes API keys and cancels
5302
+ any active subscription. The account enters read-only mode.
5303
+
5304
+ * @param body - Request body
5389
5305
  */
5390
- deleteApiKey(id: string): Promise<HttpResponse<void>>;
5306
+ initiateAccountDeletion(body: {
5307
+ confirmationEmail: string;
5308
+ }): Promise<HttpResponse<{
5309
+ data?: User;
5310
+ message?: string;
5311
+ }>>;
5312
+ /**
5313
+ * Cancel account deletion
5314
+ * Cancel a pending account deletion during the grace period.
5315
+ Note: Previously revoked API keys are not restored — new keys must be created.
5316
+ Stripe subscription may need manual reactivation via the billing portal.
5317
+
5318
+ */
5319
+ cancelAccountDeletion(): Promise<HttpResponse<{
5320
+ data?: User;
5321
+ message?: string;
5322
+ }>>;
5323
+ /**
5324
+ * Get user by ID
5325
+ * Get a user by their internal ID (admin only)
5326
+ * @param id -
5327
+ */
5328
+ getUserById(id: string): Promise<HttpResponse<{
5329
+ data?: User;
5330
+ }>>;
5391
5331
  }
5392
5332
 
5393
5333
  /**
5394
- * ArtifactsService - Artifact storage and retrieval endpoints API operations.
5334
+ * TopicsService - Topic detection, clustering, and management endpoints API operations.
5395
5335
  * Auto-generated by sdk-generator - do not edit manually.
5396
5336
  */
5397
5337
 
5398
5338
  /**
5399
- * Artifact storage and retrieval endpoints
5339
+ * Topic detection, clustering, and management endpoints
5400
5340
  */
5401
- declare class ArtifactsService extends BaseService {
5341
+ declare class TopicsService extends BaseService {
5402
5342
  /**
5403
- * List artifacts
5404
- * List all artifacts for the authenticated user with optional filters
5405
- * @param limit - Maximum number of artifacts to return
5406
- * @param offset - Number of artifacts to skip
5407
- * @param memoryId - Filter by memory ID
5408
- * @param conversationId - Filter by conversation ID
5409
- * @param type - Filter by artifact type
5343
+ * List topics
5344
+ * List all topics with pagination
5345
+ * @param limit - Maximum number of topics to return
5346
+ * @param offset - Number of topics to skip
5410
5347
  */
5411
- listArtifacts(options?: {
5348
+ listTopics(options?: {
5412
5349
  limit?: number;
5413
5350
  offset?: number;
5414
- memoryId?: string;
5415
- conversationId?: string;
5416
- type?: string;
5417
- }): Promise<HttpResponse<{
5418
- data?: Artifact[];
5419
- count?: number;
5420
- }>>;
5421
- /**
5422
- * Create artifact
5423
- * Create a new artifact for the authenticated user
5424
- * @param body - Request body
5425
- */
5426
- createArtifact(body: {
5427
- content: string;
5428
- type: string;
5429
- name?: string;
5430
- description?: string;
5431
- memoryId?: string;
5432
- conversationId?: string;
5433
- metadata?: Record<string, unknown>;
5434
5351
  }): Promise<HttpResponse<{
5435
- data?: Artifact;
5352
+ data?: Topic[];
5353
+ pagination?: {
5354
+ limit?: number;
5355
+ offset?: number;
5356
+ count?: number;
5357
+ };
5436
5358
  }>>;
5437
5359
  /**
5438
- * Get artifact by ID
5439
- * Retrieve a specific artifact by its ID
5440
- * @param id - The artifact ID
5360
+ * Get topic by ID
5361
+ * Retrieve a specific topic by its ID
5362
+ * @param id - The topic ID
5441
5363
  */
5442
- getArtifactById(id: string): Promise<HttpResponse<{
5443
- data?: Artifact;
5364
+ getTopicById(id: string): Promise<HttpResponse<{
5365
+ data?: Topic;
5444
5366
  }>>;
5445
5367
  /**
5446
- * Delete artifact
5447
- * Delete an artifact by its ID
5448
- * @param id - The artifact ID
5449
- */
5450
- deleteArtifact(id: string): Promise<HttpResponse<void>>;
5451
- /**
5452
- * Update artifact
5453
- * Update an existing artifact with partial data
5454
- * @param id - The artifact ID
5368
+ * Merge topics
5369
+ * Merge two topics into one
5455
5370
  * @param body - Request body
5456
5371
  */
5457
- updateArtifact(id: string, body: {
5458
- content?: string;
5459
- type?: string;
5460
- name?: string;
5461
- description?: string;
5462
- metadata?: Record<string, unknown>;
5372
+ mergeTopics(body: {
5373
+ sourceTopicId: string;
5374
+ targetTopicId: string;
5463
5375
  }): Promise<HttpResponse<{
5464
- data?: Artifact;
5465
- }>>;
5466
- }
5467
-
5468
- /**
5469
- * BillingService - Subscription billing and payment management endpoints API operations.
5470
- * Auto-generated by sdk-generator - do not edit manually.
5471
- */
5472
-
5473
- /**
5474
- * Subscription billing and payment management endpoints
5475
- */
5476
- declare class BillingService extends BaseService {
5477
- /**
5478
- * Get billing overview
5479
- * Get subscription, payment method, and upcoming invoice information
5480
- */
5481
- getBillingOverview(): Promise<HttpResponse<{
5482
- data?: BillingOverview;
5376
+ data?: Topic;
5483
5377
  }>>;
5484
5378
  /**
5485
- * Create checkout session
5486
- * Create a Stripe checkout session for subscription upgrade
5379
+ * Discover related topics
5380
+ * Discover topics related to a given topic
5487
5381
  * @param body - Request body
5488
5382
  */
5489
- createCheckoutSession(body: {
5490
- priceId?: string;
5491
- successUrl: string;
5492
- cancelUrl: string;
5383
+ discoverRelatedTopics(body: {
5384
+ topicId: string;
5385
+ limit?: number;
5493
5386
  }): Promise<HttpResponse<{
5494
- data?: CheckoutSessionResponse;
5387
+ data?: Topic[];
5495
5388
  }>>;
5496
5389
  /**
5497
- * Create billing portal session
5498
- * Create a Stripe billing portal session for managing subscription
5390
+ * Calculate topic similarity
5391
+ * Calculate similarity score between two topics
5499
5392
  * @param body - Request body
5500
5393
  */
5501
- createPortalSession(body: {
5502
- returnUrl: string;
5394
+ calculateTopicSimilarity(body: {
5395
+ topicId1: string;
5396
+ topicId2: string;
5503
5397
  }): Promise<HttpResponse<{
5504
- data?: PortalSessionResponse;
5505
- }>>;
5506
- /**
5507
- * Get current subscription
5508
- * Get the current subscription details for the authenticated user
5509
- */
5510
- getSubscription(): Promise<HttpResponse<{
5511
- data?: Subscription;
5398
+ data?: {
5399
+ similarity?: number;
5400
+ };
5512
5401
  }>>;
5513
5402
  /**
5514
- * Cancel subscription
5515
- * Cancel the current subscription at the end of the billing period
5403
+ * Find similar topics
5404
+ * Find topics similar to a given topic
5516
5405
  * @param body - Request body
5517
5406
  */
5518
- cancelSubscription(options?: {
5519
- body?: Record<string, unknown>;
5407
+ findSimilarTopics(body: {
5408
+ topicId: string;
5409
+ threshold?: number;
5410
+ limit?: number;
5520
5411
  }): Promise<HttpResponse<{
5521
- data?: Subscription;
5412
+ data?: {
5413
+ topic?: Topic;
5414
+ similarity?: number;
5415
+ }[];
5522
5416
  }>>;
5523
5417
  /**
5524
- * Reactivate subscription
5525
- * Reactivate a subscription that was scheduled for cancellation
5418
+ * Cluster topics
5419
+ * Cluster topics using community detection algorithms
5526
5420
  * @param body - Request body
5527
5421
  */
5528
- reactivateSubscription(options?: {
5529
- body?: Record<string, unknown>;
5530
- }): Promise<HttpResponse<{
5531
- data?: Subscription;
5532
- }>>;
5533
- /**
5534
- * List invoices
5535
- * Get a list of invoices for the authenticated user
5536
- * @param limit - Maximum number of invoices to return
5537
- */
5538
- listInvoices(options?: {
5539
- limit?: number;
5422
+ clusterTopics(options?: {
5423
+ body?: {
5424
+ minClusterSize?: number;
5425
+ };
5540
5426
  }): Promise<HttpResponse<{
5541
- data?: ListInvoicesResponse;
5542
- }>>;
5543
- /**
5544
- * List payment methods
5545
- * Get a list of payment methods for the authenticated user
5546
- */
5547
- listPaymentMethods(): Promise<HttpResponse<{
5548
- data?: ListPaymentMethodsResponse;
5427
+ data?: {
5428
+ clusters?: Record<string, unknown>[];
5429
+ clusterCount?: number;
5430
+ };
5549
5431
  }>>;
5550
5432
  /**
5551
- * Set default payment method
5552
- * Set a payment method as the default for future payments
5553
- * @param id - The payment method ID
5433
+ * Detect communities
5434
+ * Detect communities in the topic graph using specified algorithm
5554
5435
  * @param body - Request body
5555
5436
  */
5556
- setDefaultPaymentMethod(id: string, options?: {
5557
- body?: Record<string, unknown>;
5437
+ detectCommunities(options?: {
5438
+ body?: {
5439
+ algorithm?: string;
5440
+ };
5558
5441
  }): Promise<HttpResponse<{
5559
- message?: string;
5442
+ data?: {
5443
+ communities?: Community[];
5444
+ communityCount?: number;
5445
+ };
5560
5446
  }>>;
5561
5447
  /**
5562
- * Delete payment method
5563
- * Remove a payment method from the account
5564
- * @param id - The payment method ID
5565
- */
5566
- deletePaymentMethod(id: string): Promise<HttpResponse<void>>;
5567
- /**
5568
- * Stripe webhook endpoint
5569
- * Receive and process Stripe webhook events
5448
+ * Search topics
5449
+ * Search topics by query string using fulltext search
5570
5450
  * @param body - Request body
5571
5451
  */
5572
- stripeWebhook(body: Record<string, unknown>): Promise<HttpResponse<{
5573
- received?: boolean;
5452
+ searchTopics(body: {
5453
+ query: string;
5454
+ limit?: number;
5455
+ offset?: number;
5456
+ }): Promise<HttpResponse<{
5457
+ data?: Record<string, unknown>[];
5458
+ total?: number;
5459
+ limit?: number;
5460
+ offset?: number;
5574
5461
  }>>;
5575
5462
  }
5576
5463
 
5577
5464
  /**
5578
- * ConversationsService - Conversation tracking and analysis endpoints API operations.
5465
+ * SystemService - System health, monitoring, and configuration endpoints API operations.
5579
5466
  * Auto-generated by sdk-generator - do not edit manually.
5580
5467
  */
5581
5468
 
5582
5469
  /**
5583
- * Conversation tracking and analysis endpoints
5470
+ * System health, monitoring, and configuration endpoints
5584
5471
  */
5585
- declare class ConversationsService extends BaseService {
5472
+ declare class SystemService extends BaseService {
5586
5473
  /**
5587
- * List conversations
5588
- * List all conversations for the authenticated user with pagination
5589
- * @param limit - Maximum number of conversations to return
5590
- * @param offset - Number of conversations to skip
5591
- * @param since - Return only conversations created after this timestamp (ISO 8601 format)
5474
+ * Get system health status
5475
+ * Get the current health status of the system including database connectivity
5592
5476
  */
5593
- listConversations(options?: {
5594
- limit?: number;
5595
- offset?: number;
5596
- since?: string;
5597
- }): Promise<HttpResponse<{
5598
- data?: Conversation[];
5599
- pagination?: {
5600
- limit?: number;
5601
- offset?: number;
5602
- count?: number;
5477
+ getSystemHealth(): Promise<HttpResponse<{
5478
+ data?: {
5479
+ status?: 'healthy' | 'unhealthy';
5480
+ database?: Record<string, unknown>;
5481
+ uptime?: number;
5603
5482
  };
5604
5483
  }>>;
5605
5484
  /**
5606
- * Create conversation
5607
- * Create a new conversation for the authenticated user
5608
- * @param body - Request body
5485
+ * Get context status
5486
+ * Get database statistics and context information
5609
5487
  */
5610
- createConversation(body: {
5611
- title: string;
5612
- summary?: string;
5613
- }): Promise<HttpResponse<{
5614
- data?: Conversation;
5488
+ getContextStatus(): Promise<HttpResponse<{
5489
+ data?: Record<string, unknown>;
5615
5490
  }>>;
5616
5491
  /**
5617
- * Get conversation summary
5618
- * Retrieve a conversation summary by its ID
5619
- * @param conversationId - The conversation ID
5492
+ * Get feature flags
5493
+ * Get all feature flags for the authenticated user
5620
5494
  */
5621
- getConversationSummary(conversationId: string): Promise<HttpResponse<{
5622
- data?: Conversation;
5495
+ getFeatureFlags(): Promise<HttpResponse<{
5496
+ data?: Record<string, unknown>;
5623
5497
  }>>;
5624
5498
  /**
5625
- * Delete conversation
5626
- * Delete a conversation and soft-delete all associated memories
5627
- * @param conversationId - The conversation ID
5628
- */
5629
- deleteConversation(conversationId: string): Promise<HttpResponse<void>>;
5630
- /**
5631
- * Get conversation timeline
5632
- * Get all memories in a conversation in chronological order
5633
- * @param conversationId - The conversation ID
5499
+ * Evaluate feature flag
5500
+ * Evaluate a specific feature flag for the authenticated user
5501
+ * @param body - Request body
5634
5502
  */
5635
- getConversationTimeline(conversationId: string): Promise<HttpResponse<{
5636
- data?: Memory[];
5637
- count?: number;
5503
+ evaluateFeatureFlag(body: {
5504
+ flagName: string;
5505
+ context?: Record<string, unknown>;
5506
+ }): Promise<HttpResponse<{
5507
+ data?: {
5508
+ enabled?: boolean;
5509
+ flagName?: string;
5510
+ };
5638
5511
  }>>;
5639
5512
  /**
5640
- * Search conversations
5641
- * Search conversations by query string
5642
- * @param body - Request body
5513
+ * Analyze memory quality distribution
5514
+ * Analyze the quality distribution of memories for the authenticated user
5515
+ * @param includeDetails - Include detailed pruning candidate information
5516
+ * @param minQualityThreshold - Minimum quality threshold for pruning candidates (default 0.4)
5643
5517
  */
5644
- searchConversations(body: {
5645
- query: string;
5646
- limit?: number;
5518
+ analyzeMemoryQuality(options?: {
5519
+ includeDetails?: boolean;
5520
+ minQualityThreshold?: number;
5647
5521
  }): Promise<HttpResponse<{
5648
- data?: Conversation[];
5649
- count?: number;
5522
+ data?: {
5523
+ totalMemories?: number;
5524
+ qualityDistribution?: {
5525
+ high?: number;
5526
+ medium?: number;
5527
+ low?: number;
5528
+ };
5529
+ averageQuality?: number;
5530
+ pruningCandidates?: number;
5531
+ };
5650
5532
  }>>;
5651
5533
  /**
5652
- * Find conversations by topic
5653
- * Find conversations that contain a specific topic
5534
+ * Prune low-quality memories
5535
+ * Prune (soft delete) low-quality memories for the authenticated user
5654
5536
  * @param body - Request body
5655
5537
  */
5656
- findConversationsByTopic(body: {
5657
- topicId: string;
5658
- limit?: number;
5538
+ pruneMemories(options?: {
5539
+ body?: {
5540
+ targetReduction?: number;
5541
+ minQualityThreshold?: number;
5542
+ preserveRecent?: boolean;
5543
+ recentDaysToPreserve?: number;
5544
+ dryRun?: boolean;
5545
+ };
5659
5546
  }): Promise<HttpResponse<{
5660
- data?: Conversation[];
5661
- count?: number;
5662
- metadata?: {
5663
- topicId?: string;
5547
+ data?: {
5548
+ prunedCount?: number;
5549
+ prunedIds?: string[];
5550
+ dryRun?: boolean;
5664
5551
  };
5665
5552
  }>>;
5553
+ /**
5554
+ * Get OpenAPI specification
5555
+ * Returns the OpenAPI 3.x specification for the entire API. This endpoint is used by CI/CD to sync the API Gateway.
5556
+ * @param noCache - Bypass cache and regenerate specification
5557
+ */
5558
+ getOpenApiSpec(options?: {
5559
+ noCache?: '1' | 'true';
5560
+ }): Promise<HttpResponse<Record<string, unknown>>>;
5666
5561
  }
5667
5562
 
5668
5563
  /**
5669
- * EntitiesService - Entity extraction and discovery endpoints API operations.
5564
+ * PatternsService - Pattern detection and behavioral analysis endpoints API operations.
5670
5565
  * Auto-generated by sdk-generator - do not edit manually.
5671
5566
  */
5672
5567
 
5673
5568
  /**
5674
- * Entity extraction and discovery endpoints
5569
+ * Pattern detection and behavioral analysis endpoints
5675
5570
  */
5676
- declare class EntitiesService extends BaseService {
5571
+ declare class PatternsService extends BaseService {
5677
5572
  /**
5678
- * List entities
5679
- * List all entities for the authenticated user, optionally filtered by type
5680
- * @param type - Filter by entity type (e.g., PERSON, TECHNOLOGY)
5681
- * @param limit - Maximum number of entities to return
5682
- * @param offset - Number of entities to skip
5573
+ * List patterns
5574
+ * List all patterns for the authenticated user
5575
+ * @param limit - Maximum number of patterns to return
5576
+ * @param offset - Number of patterns to skip
5683
5577
  */
5684
- listEntities(options?: {
5685
- type?: string;
5578
+ listPatterns(options?: {
5686
5579
  limit?: number;
5687
5580
  offset?: number;
5688
5581
  }): Promise<HttpResponse<{
5689
- data?: EntityNode[];
5582
+ data?: Pattern[];
5690
5583
  pagination?: {
5691
5584
  limit?: number;
5692
5585
  offset?: number;
@@ -5694,221 +5587,267 @@ declare class EntitiesService extends BaseService {
5694
5587
  };
5695
5588
  }>>;
5696
5589
  /**
5697
- * Get entity by ID
5698
- * Retrieve a specific entity by its ID
5699
- * @param id - The entity ID
5590
+ * Compile patterns
5591
+ * Compile patterns from user's memories
5592
+ * @param body - Request body
5700
5593
  */
5701
- getEntityById(id: string): Promise<HttpResponse<{
5702
- data?: EntityNode;
5594
+ compilePatterns(options?: {
5595
+ body?: {
5596
+ minOccurrences?: number;
5597
+ timeWindow?: string;
5598
+ };
5599
+ }): Promise<HttpResponse<{
5600
+ data?: Pattern[];
5601
+ count?: number;
5703
5602
  }>>;
5704
5603
  /**
5705
- * Get memories mentioning entity
5706
- * Get all memories that mention a specific entity
5707
- * @param id - The entity ID
5708
- * @param limit - Maximum number of memories to return
5709
- * @param offset - Number of memories to skip
5604
+ * Detect behavioral patterns
5605
+ * Run pattern detection algorithms to identify recurring behavioral patterns
5606
+ * @param body - Request body
5710
5607
  */
5711
- getEntityMemories(id: string, options?: {
5712
- limit?: number;
5713
- offset?: number;
5608
+ detectPatterns(options?: {
5609
+ body?: {
5610
+ contextFilter?: string;
5611
+ timeframeStart?: string;
5612
+ timeframeEnd?: string;
5613
+ minConfidence?: number;
5614
+ maxResults?: number;
5615
+ autoStore?: boolean;
5616
+ };
5714
5617
  }): Promise<HttpResponse<{
5715
5618
  data?: {
5716
- memory?: Memory;
5717
- confidence?: number;
5718
- }[];
5719
- pagination?: {
5720
- limit?: number;
5721
- offset?: number;
5619
+ detectedPatterns?: Pattern[];
5722
5620
  count?: number;
5621
+ stored?: number;
5622
+ confidence?: {
5623
+ average?: number;
5624
+ highest?: number;
5625
+ };
5723
5626
  };
5724
5627
  }>>;
5725
- }
5726
-
5727
- /**
5728
- * FactsService - Fact extraction and management endpoints API operations.
5729
- * Auto-generated by sdk-generator - do not edit manually.
5730
- */
5731
-
5732
- /**
5733
- * Fact extraction and management endpoints
5734
- */
5735
- declare class FactsService extends BaseService {
5736
- /**
5737
- * List facts
5738
- * List all facts for the authenticated user
5739
- * @param limit - Maximum number of facts to return
5740
- * @param offset - Number of facts to skip
5741
- */
5742
- listFacts(options?: {
5743
- limit?: number;
5744
- offset?: number;
5745
- }): Promise<HttpResponse<{
5746
- data?: Fact[];
5747
- count?: number;
5748
- }>>;
5749
5628
  /**
5750
- * Create fact
5751
- * Create a new semantic fact
5629
+ * Analyze pattern trends
5630
+ * Analyze pattern trends, correlations, and generate insights
5752
5631
  * @param body - Request body
5753
5632
  */
5754
- createFact(body: {
5755
- subject: string;
5756
- predicate: string;
5757
- object: string;
5633
+ analyzePatterns(options?: {
5634
+ body?: {
5635
+ timeRange?: number;
5636
+ groupBy?: 'type' | 'context' | 'confidence';
5637
+ includeDetails?: boolean;
5638
+ };
5758
5639
  }): Promise<HttpResponse<{
5759
- data?: Fact;
5760
- }>>;
5761
- /**
5762
- * Get fact by ID
5763
- * Retrieve a specific fact by its ID
5764
- * @param id - The fact ID
5765
- */
5766
- getFactById(id: string): Promise<HttpResponse<{
5767
- data?: Fact;
5640
+ data?: {
5641
+ analysis?: {
5642
+ totalPatterns?: number;
5643
+ recentPatterns?: number;
5644
+ trends?: Record<string, unknown>;
5645
+ insights?: string[];
5646
+ recommendations?: string[];
5647
+ };
5648
+ timeRange?: number;
5649
+ analyzedAt?: string;
5650
+ };
5768
5651
  }>>;
5769
5652
  /**
5770
- * Update fact
5771
- * Update an existing fact completely
5772
- * @param id - The fact ID
5653
+ * Update pattern
5654
+ * Update an existing pattern with partial data
5655
+ * @param id - The pattern ID
5773
5656
  * @param body - Request body
5774
5657
  */
5775
- updateFact(id: string, body: {
5776
- subject?: string;
5777
- predicate?: string;
5778
- object?: string;
5658
+ updatePattern(id: string, body: {
5659
+ name?: string;
5660
+ description?: string;
5779
5661
  confidence?: number;
5662
+ metadata?: Record<string, unknown>;
5780
5663
  }): Promise<HttpResponse<{
5781
- data?: Fact;
5664
+ data?: Pattern;
5782
5665
  }>>;
5783
5666
  /**
5784
- * Delete fact
5785
- * Delete a fact by its ID
5786
- * @param id - The fact ID
5787
- */
5788
- deleteFact(id: string): Promise<HttpResponse<void>>;
5789
- /**
5790
- * Search facts
5791
- * Search semantic facts by query string
5667
+ * Record pattern feedback
5668
+ * Record feedback on a pattern
5792
5669
  * @param body - Request body
5793
5670
  */
5794
- searchFacts(body: {
5795
- query: string;
5796
- limit?: number;
5671
+ recordPatternFeedback(body: {
5672
+ patternId: string;
5673
+ feedback: string;
5797
5674
  }): Promise<HttpResponse<{
5798
- data?: Fact[];
5799
- count?: number;
5800
- metadata?: {
5801
- query?: string;
5802
- };
5675
+ data?: Pattern;
5803
5676
  }>>;
5804
5677
  }
5805
5678
 
5806
5679
  /**
5807
- * GraphragService - Graph-based retrieval augmented generation endpoints API operations.
5680
+ * BehaviorService - Behavioral pattern tracking and state management endpoints API operations.
5808
5681
  * Auto-generated by sdk-generator - do not edit manually.
5809
5682
  */
5810
5683
 
5811
5684
  /**
5812
- * Graph-based retrieval augmented generation endpoints
5685
+ * Behavioral pattern tracking and state management endpoints
5813
5686
  */
5814
- declare class GraphragService extends BaseService {
5687
+ declare class BehaviorService extends BaseService {
5815
5688
  /**
5816
- * Explain a GraphRAG query
5817
- * Get explanation for a previously executed GraphRAG query result
5818
- * @param queryId - The query ID to explain
5689
+ * Get behavioral state
5690
+ * Get current behavioral state for the authenticated user
5819
5691
  */
5820
- explainGraphRAGQuery(options?: {
5821
- queryId?: string;
5822
- }): Promise<HttpResponse<{
5692
+ getBehavioralState(): Promise<HttpResponse<{
5823
5693
  data?: Record<string, unknown>;
5824
5694
  }>>;
5825
5695
  /**
5826
- * Query communities
5827
- * Query communities for relevant information using semantic search
5828
- * @param body - Request body
5829
- */
5830
- queryCommunities(body: {
5831
- query: string;
5832
- limit?: number;
5833
- }): Promise<HttpResponse<{
5834
- data?: Record<string, unknown>[];
5835
- }>>;
5836
- /**
5837
- * Execute a GraphRAG query
5838
- * Execute a graph-based retrieval augmented generation query
5696
+ * Update behavioral state
5697
+ * Update or mutate behavioral state
5839
5698
  * @param body - Request body
5840
5699
  */
5841
- executeGraphRAGQuery(body: {
5842
- query: string;
5843
- maxDepth?: number;
5844
- depth?: number;
5845
- limit?: number;
5846
- includeRelationships?: boolean;
5700
+ updateBehavioralState(options?: {
5701
+ body?: {
5702
+ state?: Record<string, unknown>;
5703
+ mutations?: Record<string, unknown>;
5704
+ };
5847
5705
  }): Promise<HttpResponse<{
5848
- data?: GraphRAGQueryResponse;
5706
+ data?: Record<string, unknown>;
5849
5707
  }>>;
5850
5708
  }
5851
5709
 
5852
5710
  /**
5853
- * HealthService - Health check endpoints API operations.
5711
+ * NarrativesService - Narrative thread management endpoints API operations.
5854
5712
  * Auto-generated by sdk-generator - do not edit manually.
5855
5713
  */
5856
5714
 
5857
5715
  /**
5858
- * Health check endpoints
5716
+ * Narrative thread management endpoints
5859
5717
  */
5860
- declare class HealthService extends BaseService {
5718
+ declare class NarrativesService extends BaseService {
5861
5719
  /**
5862
- * API health check endpoint
5863
- * Returns the health status and uptime of the API service.
5864
- This endpoint is public and requires no authentication.
5865
- Use this endpoint for monitoring, health checks, and service availability verification.
5866
- Returns 200 when healthy, 503 when the database is unreachable.
5720
+ * List narrative threads
5721
+ * List all narrative threads for the authenticated user.
5722
+ Narratives group related memories into coherent storylines.
5867
5723
 
5724
+ * @param limit - Maximum number of narratives to return
5725
+ * @param offset - Number of narratives to skip
5726
+ * @param state - Filter by narrative state
5727
+ * @param topics - Comma-separated list of topics to filter by
5868
5728
  */
5869
- healthCheck(): Promise<HttpResponse<{
5870
- status: 'healthy' | 'degraded' | 'unhealthy';
5871
- timestamp: string;
5872
- version: string;
5873
- uptime: number;
5874
- checks: Record<string, unknown>;
5729
+ listNarratives(options?: {
5730
+ limit?: number;
5731
+ offset?: number;
5732
+ state?: 'open' | 'resolved' | 'reopened' | 'superseded';
5733
+ topics?: string;
5734
+ }): Promise<HttpResponse<{
5735
+ data: NarrativeThread[];
5736
+ pagination: {
5737
+ limit: number;
5738
+ offset: number;
5739
+ count: number;
5740
+ };
5741
+ }>>;
5742
+ /**
5743
+ * Create a narrative thread
5744
+ * Create a new narrative thread starting from a root memory.
5745
+ Narratives help organize related memories into coherent storylines.
5746
+
5747
+ * @param body - Request body
5748
+ */
5749
+ createNarrative(body: {
5750
+ title: string;
5751
+ rootMemoryId: string;
5752
+ topics?: string[];
5753
+ }): Promise<HttpResponse<{
5754
+ data: NarrativeThread;
5755
+ }>>;
5756
+ /**
5757
+ * Get a narrative thread
5758
+ * Retrieve a specific narrative thread by ID
5759
+ * @param id - The narrative ID
5760
+ */
5761
+ getNarrative(id: string): Promise<HttpResponse<{
5762
+ data: NarrativeThread;
5763
+ }>>;
5764
+ /**
5765
+ * Delete a narrative thread
5766
+ * Delete a narrative thread.
5767
+ This does not delete the associated memories, only the narrative structure.
5768
+
5769
+ * @param id - The narrative ID
5770
+ */
5771
+ deleteNarrative(id: string): Promise<HttpResponse<void>>;
5772
+ /**
5773
+ * Update a narrative thread
5774
+ * Update a narrative thread's title, topics, or state.
5775
+ Use this to resolve, reopen, or modify narratives.
5776
+
5777
+ * @param id - The narrative ID
5778
+ * @param body - Request body
5779
+ */
5780
+ updateNarrative(id: string, body: {
5781
+ title?: string;
5782
+ state?: 'open' | 'resolved' | 'reopened' | 'superseded';
5783
+ resolutionMemoryId?: string;
5784
+ topics?: string[];
5785
+ }): Promise<HttpResponse<{
5786
+ data: NarrativeThread;
5787
+ }>>;
5788
+ /**
5789
+ * Get narrative timeline
5790
+ * Get all memories in a narrative, ordered by their position in the narrative.
5791
+ Each memory includes its position and effective state.
5792
+
5793
+ * @param id - The narrative ID
5794
+ * @param limit - Maximum number of memories to return
5795
+ * @param offset - Number of memories to skip
5796
+ */
5797
+ getNarrativeTimeline(id: string, options?: {
5798
+ limit?: number;
5799
+ offset?: number;
5800
+ }): Promise<HttpResponse<{
5801
+ data: NarrativeMemory[];
5802
+ narrative: NarrativeThread;
5803
+ pagination: {
5804
+ limit: number;
5805
+ offset: number;
5806
+ total: number;
5807
+ };
5808
+ }>>;
5809
+ /**
5810
+ * Add a memory to a narrative
5811
+ * Add an existing memory to a narrative thread.
5812
+ Optionally specify a position to insert the memory at.
5813
+
5814
+ * @param id - The narrative ID
5815
+ * @param body - Request body
5816
+ */
5817
+ addMemoryToNarrative(id: string, body: {
5818
+ memoryId: string;
5819
+ position?: number;
5820
+ }): Promise<HttpResponse<{
5821
+ data: NarrativeThread;
5875
5822
  }>>;
5823
+ /**
5824
+ * Remove a memory from a narrative
5825
+ * Remove a memory from a narrative thread.
5826
+ This does not delete the memory itself, only removes it from the narrative.
5827
+
5828
+ * @param id - The narrative ID
5829
+ * @param memoryId - The memory ID to remove
5830
+ */
5831
+ removeMemoryFromNarrative(id: string, memoryId: string): Promise<HttpResponse<void>>;
5876
5832
  }
5877
5833
 
5878
5834
  /**
5879
- * InvitesService - Invite code validation and gate status endpoints API operations.
5835
+ * MonitoringService - Observability and metrics endpoints for production monitoring API operations.
5880
5836
  * Auto-generated by sdk-generator - do not edit manually.
5881
5837
  */
5882
5838
 
5883
5839
  /**
5884
- * Invite code validation and gate status endpoints
5840
+ * Observability and metrics endpoints for production monitoring
5885
5841
  */
5886
- declare class InvitesService extends BaseService {
5887
- /**
5888
- * Check invite gate status
5889
- * Check whether the invite gate is currently open or closed.
5890
- When gated is true, new signups require a valid invite code.
5891
- Response is cached server-side (30-second TTL).
5892
-
5893
- */
5894
- getGateStatus(): Promise<HttpResponse<{
5895
- gated?: boolean;
5896
- }>>;
5842
+ declare class MonitoringService extends BaseService {
5897
5843
  /**
5898
- * Validate an invite code
5899
- * Validate an invite code without redeeming it.
5900
- Rate limited to 10 requests per minute per IP to prevent enumeration.
5901
- Error messages are intentionally generic.
5844
+ * Prometheus metrics endpoint
5845
+ * Returns Prometheus-formatted metrics for monitoring and observability.
5846
+ This endpoint is public and requires no authentication.
5847
+ Designed to be scraped by Prometheus at regular intervals.
5902
5848
 
5903
- * @param body - Request body
5904
5849
  */
5905
- validateInviteCode(body: {
5906
- code: string;
5907
- email: string;
5908
- }): Promise<HttpResponse<{
5909
- valid?: boolean;
5910
- error?: string;
5911
- }>>;
5850
+ getMetrics(): Promise<HttpResponse<unknown>>;
5912
5851
  }
5913
5852
 
5914
5853
  /**
@@ -6416,267 +6355,214 @@ declare class MemoriesService extends BaseService {
6416
6355
  }
6417
6356
 
6418
6357
  /**
6419
- * MonitoringService - Observability and metrics endpoints for production monitoring API operations.
6358
+ * InvitesService - Invite code validation and gate status endpoints API operations.
6420
6359
  * Auto-generated by sdk-generator - do not edit manually.
6421
6360
  */
6422
6361
 
6423
6362
  /**
6424
- * Observability and metrics endpoints for production monitoring
6363
+ * Invite code validation and gate status endpoints
6425
6364
  */
6426
- declare class MonitoringService extends BaseService {
6365
+ declare class InvitesService extends BaseService {
6427
6366
  /**
6428
- * Prometheus metrics endpoint
6429
- * Returns Prometheus-formatted metrics for monitoring and observability.
6430
- This endpoint is public and requires no authentication.
6431
- Designed to be scraped by Prometheus at regular intervals.
6367
+ * Check invite gate status
6368
+ * Check whether the invite gate is currently open or closed.
6369
+ When gated is true, new signups require a valid invite code.
6370
+ Response is cached server-side (30-second TTL).
6432
6371
 
6433
6372
  */
6434
- getMetrics(): Promise<HttpResponse<unknown>>;
6373
+ getGateStatus(): Promise<HttpResponse<{
6374
+ gated?: boolean;
6375
+ }>>;
6376
+ /**
6377
+ * Validate an invite code
6378
+ * Validate an invite code without redeeming it.
6379
+ Rate limited to 10 requests per minute per IP to prevent enumeration.
6380
+ Error messages are intentionally generic.
6381
+
6382
+ * @param body - Request body
6383
+ */
6384
+ validateInviteCode(body: {
6385
+ code: string;
6386
+ email: string;
6387
+ }): Promise<HttpResponse<{
6388
+ valid?: boolean;
6389
+ error?: string;
6390
+ }>>;
6435
6391
  }
6436
6392
 
6437
6393
  /**
6438
- * NarrativesService - Narrative thread management endpoints API operations.
6394
+ * HealthService - Health check endpoints API operations.
6439
6395
  * Auto-generated by sdk-generator - do not edit manually.
6440
6396
  */
6441
6397
 
6442
6398
  /**
6443
- * Narrative thread management endpoints
6399
+ * Health check endpoints
6444
6400
  */
6445
- declare class NarrativesService extends BaseService {
6401
+ declare class HealthService extends BaseService {
6446
6402
  /**
6447
- * List narrative threads
6448
- * List all narrative threads for the authenticated user.
6449
- Narratives group related memories into coherent storylines.
6403
+ * API health check endpoint
6404
+ * Returns the health status and uptime of the API service.
6405
+ This endpoint is public and requires no authentication.
6406
+ Use this endpoint for monitoring, health checks, and service availability verification.
6407
+ Returns 200 when healthy, 503 when the database is unreachable.
6450
6408
 
6451
- * @param limit - Maximum number of narratives to return
6452
- * @param offset - Number of narratives to skip
6453
- * @param state - Filter by narrative state
6454
- * @param topics - Comma-separated list of topics to filter by
6455
6409
  */
6456
- listNarratives(options?: {
6457
- limit?: number;
6458
- offset?: number;
6459
- state?: 'open' | 'resolved' | 'reopened' | 'superseded';
6460
- topics?: string;
6461
- }): Promise<HttpResponse<{
6462
- data: NarrativeThread[];
6463
- pagination: {
6464
- limit: number;
6465
- offset: number;
6466
- count: number;
6467
- };
6410
+ healthCheck(): Promise<HttpResponse<{
6411
+ status: 'healthy' | 'degraded' | 'unhealthy';
6412
+ timestamp: string;
6413
+ version: string;
6414
+ uptime: number;
6415
+ checks: Record<string, unknown>;
6468
6416
  }>>;
6417
+ }
6418
+
6419
+ /**
6420
+ * GraphragService - Graph-based retrieval augmented generation endpoints API operations.
6421
+ * Auto-generated by sdk-generator - do not edit manually.
6422
+ */
6423
+
6424
+ /**
6425
+ * Graph-based retrieval augmented generation endpoints
6426
+ */
6427
+ declare class GraphragService extends BaseService {
6469
6428
  /**
6470
- * Create a narrative thread
6471
- * Create a new narrative thread starting from a root memory.
6472
- Narratives help organize related memories into coherent storylines.
6473
-
6474
- * @param body - Request body
6475
- */
6476
- createNarrative(body: {
6477
- title: string;
6478
- rootMemoryId: string;
6479
- topics?: string[];
6480
- }): Promise<HttpResponse<{
6481
- data: NarrativeThread;
6482
- }>>;
6483
- /**
6484
- * Get a narrative thread
6485
- * Retrieve a specific narrative thread by ID
6486
- * @param id - The narrative ID
6487
- */
6488
- getNarrative(id: string): Promise<HttpResponse<{
6489
- data: NarrativeThread;
6490
- }>>;
6491
- /**
6492
- * Delete a narrative thread
6493
- * Delete a narrative thread.
6494
- This does not delete the associated memories, only the narrative structure.
6495
-
6496
- * @param id - The narrative ID
6497
- */
6498
- deleteNarrative(id: string): Promise<HttpResponse<void>>;
6499
- /**
6500
- * Update a narrative thread
6501
- * Update a narrative thread's title, topics, or state.
6502
- Use this to resolve, reopen, or modify narratives.
6503
-
6504
- * @param id - The narrative ID
6505
- * @param body - Request body
6429
+ * Explain a GraphRAG query
6430
+ * Get explanation for a previously executed GraphRAG query result
6431
+ * @param queryId - The query ID to explain
6506
6432
  */
6507
- updateNarrative(id: string, body: {
6508
- title?: string;
6509
- state?: 'open' | 'resolved' | 'reopened' | 'superseded';
6510
- resolutionMemoryId?: string;
6511
- topics?: string[];
6433
+ explainGraphRAGQuery(options?: {
6434
+ queryId?: string;
6512
6435
  }): Promise<HttpResponse<{
6513
- data: NarrativeThread;
6436
+ data?: Record<string, unknown>;
6514
6437
  }>>;
6515
6438
  /**
6516
- * Get narrative timeline
6517
- * Get all memories in a narrative, ordered by their position in the narrative.
6518
- Each memory includes its position and effective state.
6519
-
6520
- * @param id - The narrative ID
6521
- * @param limit - Maximum number of memories to return
6522
- * @param offset - Number of memories to skip
6439
+ * Query communities
6440
+ * Query communities for relevant information using semantic search
6441
+ * @param body - Request body
6523
6442
  */
6524
- getNarrativeTimeline(id: string, options?: {
6443
+ queryCommunities(body: {
6444
+ query: string;
6525
6445
  limit?: number;
6526
- offset?: number;
6527
6446
  }): Promise<HttpResponse<{
6528
- data: NarrativeMemory[];
6529
- narrative: NarrativeThread;
6530
- pagination: {
6531
- limit: number;
6532
- offset: number;
6533
- total: number;
6534
- };
6447
+ data?: Record<string, unknown>[];
6535
6448
  }>>;
6536
6449
  /**
6537
- * Add a memory to a narrative
6538
- * Add an existing memory to a narrative thread.
6539
- Optionally specify a position to insert the memory at.
6540
-
6541
- * @param id - The narrative ID
6450
+ * Execute a GraphRAG query
6451
+ * Execute a graph-based retrieval augmented generation query
6542
6452
  * @param body - Request body
6543
6453
  */
6544
- addMemoryToNarrative(id: string, body: {
6545
- memoryId: string;
6546
- position?: number;
6454
+ executeGraphRAGQuery(body: {
6455
+ query: string;
6456
+ maxDepth?: number;
6457
+ depth?: number;
6458
+ limit?: number;
6459
+ includeRelationships?: boolean;
6547
6460
  }): Promise<HttpResponse<{
6548
- data: NarrativeThread;
6461
+ data?: GraphRAGQueryResponse;
6549
6462
  }>>;
6550
- /**
6551
- * Remove a memory from a narrative
6552
- * Remove a memory from a narrative thread.
6553
- This does not delete the memory itself, only removes it from the narrative.
6554
-
6555
- * @param id - The narrative ID
6556
- * @param memoryId - The memory ID to remove
6557
- */
6558
- removeMemoryFromNarrative(id: string, memoryId: string): Promise<HttpResponse<void>>;
6559
6463
  }
6560
6464
 
6561
6465
  /**
6562
- * SystemService - System health, monitoring, and configuration endpoints API operations.
6466
+ * FactsService - Fact extraction and management endpoints API operations.
6563
6467
  * Auto-generated by sdk-generator - do not edit manually.
6564
6468
  */
6565
6469
 
6566
6470
  /**
6567
- * System health, monitoring, and configuration endpoints
6471
+ * Fact extraction and management endpoints
6568
6472
  */
6569
- declare class SystemService extends BaseService {
6570
- /**
6571
- * Get OpenAPI specification
6572
- * Returns the OpenAPI 3.x specification for the entire API. This endpoint is used by CI/CD to sync the API Gateway.
6573
- * @param noCache - Bypass cache and regenerate specification
6574
- */
6575
- getOpenApiSpec(options?: {
6576
- noCache?: '1' | 'true';
6577
- }): Promise<HttpResponse<Record<string, unknown>>>;
6473
+ declare class FactsService extends BaseService {
6578
6474
  /**
6579
- * Get system health status
6580
- * Get the current health status of the system including database connectivity
6475
+ * List facts
6476
+ * List all facts for the authenticated user
6477
+ * @param limit - Maximum number of facts to return
6478
+ * @param offset - Number of facts to skip
6581
6479
  */
6582
- getSystemHealth(): Promise<HttpResponse<{
6583
- data?: {
6584
- status?: 'healthy' | 'unhealthy';
6585
- database?: Record<string, unknown>;
6586
- uptime?: number;
6587
- };
6480
+ listFacts(options?: {
6481
+ limit?: number;
6482
+ offset?: number;
6483
+ }): Promise<HttpResponse<{
6484
+ data?: Fact[];
6485
+ count?: number;
6588
6486
  }>>;
6589
6487
  /**
6590
- * Get context status
6591
- * Get database statistics and context information
6488
+ * Create fact
6489
+ * Create a new semantic fact
6490
+ * @param body - Request body
6592
6491
  */
6593
- getContextStatus(): Promise<HttpResponse<{
6594
- data?: Record<string, unknown>;
6492
+ createFact(body: {
6493
+ subject: string;
6494
+ predicate: string;
6495
+ object: string;
6496
+ }): Promise<HttpResponse<{
6497
+ data?: Fact;
6595
6498
  }>>;
6596
6499
  /**
6597
- * Get feature flags
6598
- * Get all feature flags for the authenticated user
6500
+ * Get fact by ID
6501
+ * Retrieve a specific fact by its ID
6502
+ * @param id - The fact ID
6599
6503
  */
6600
- getFeatureFlags(): Promise<HttpResponse<{
6601
- data?: Record<string, unknown>;
6504
+ getFactById(id: string): Promise<HttpResponse<{
6505
+ data?: Fact;
6602
6506
  }>>;
6603
6507
  /**
6604
- * Evaluate feature flag
6605
- * Evaluate a specific feature flag for the authenticated user
6508
+ * Update fact
6509
+ * Update an existing fact completely
6510
+ * @param id - The fact ID
6606
6511
  * @param body - Request body
6607
6512
  */
6608
- evaluateFeatureFlag(body: {
6609
- flagName: string;
6610
- context?: Record<string, unknown>;
6513
+ updateFact(id: string, body: {
6514
+ subject?: string;
6515
+ predicate?: string;
6516
+ object?: string;
6517
+ confidence?: number;
6611
6518
  }): Promise<HttpResponse<{
6612
- data?: {
6613
- enabled?: boolean;
6614
- flagName?: string;
6615
- };
6519
+ data?: Fact;
6616
6520
  }>>;
6617
6521
  /**
6618
- * Analyze memory quality distribution
6619
- * Analyze the quality distribution of memories for the authenticated user
6620
- * @param includeDetails - Include detailed pruning candidate information
6621
- * @param minQualityThreshold - Minimum quality threshold for pruning candidates (default 0.4)
6522
+ * Delete fact
6523
+ * Delete a fact by its ID
6524
+ * @param id - The fact ID
6622
6525
  */
6623
- analyzeMemoryQuality(options?: {
6624
- includeDetails?: boolean;
6625
- minQualityThreshold?: number;
6626
- }): Promise<HttpResponse<{
6627
- data?: {
6628
- totalMemories?: number;
6629
- qualityDistribution?: {
6630
- high?: number;
6631
- medium?: number;
6632
- low?: number;
6633
- };
6634
- averageQuality?: number;
6635
- pruningCandidates?: number;
6636
- };
6637
- }>>;
6526
+ deleteFact(id: string): Promise<HttpResponse<void>>;
6638
6527
  /**
6639
- * Prune low-quality memories
6640
- * Prune (soft delete) low-quality memories for the authenticated user
6528
+ * Search facts
6529
+ * Search semantic facts by query string
6641
6530
  * @param body - Request body
6642
6531
  */
6643
- pruneMemories(options?: {
6644
- body?: {
6645
- targetReduction?: number;
6646
- minQualityThreshold?: number;
6647
- preserveRecent?: boolean;
6648
- recentDaysToPreserve?: number;
6649
- dryRun?: boolean;
6650
- };
6532
+ searchFacts(body: {
6533
+ query: string;
6534
+ limit?: number;
6651
6535
  }): Promise<HttpResponse<{
6652
- data?: {
6653
- prunedCount?: number;
6654
- prunedIds?: string[];
6655
- dryRun?: boolean;
6536
+ data?: Fact[];
6537
+ count?: number;
6538
+ metadata?: {
6539
+ query?: string;
6656
6540
  };
6657
6541
  }>>;
6658
6542
  }
6659
6543
 
6660
6544
  /**
6661
- * PatternsService - Pattern detection and behavioral analysis endpoints API operations.
6545
+ * EntitiesService - Entity extraction and discovery endpoints API operations.
6662
6546
  * Auto-generated by sdk-generator - do not edit manually.
6663
6547
  */
6664
6548
 
6665
6549
  /**
6666
- * Pattern detection and behavioral analysis endpoints
6550
+ * Entity extraction and discovery endpoints
6667
6551
  */
6668
- declare class PatternsService extends BaseService {
6552
+ declare class EntitiesService extends BaseService {
6669
6553
  /**
6670
- * List patterns
6671
- * List all patterns for the authenticated user
6672
- * @param limit - Maximum number of patterns to return
6673
- * @param offset - Number of patterns to skip
6554
+ * List entities
6555
+ * List all entities for the authenticated user, optionally filtered by type
6556
+ * @param type - Filter by entity type (e.g., PERSON, TECHNOLOGY)
6557
+ * @param limit - Maximum number of entities to return
6558
+ * @param offset - Number of entities to skip
6674
6559
  */
6675
- listPatterns(options?: {
6560
+ listEntities(options?: {
6561
+ type?: string;
6676
6562
  limit?: number;
6677
6563
  offset?: number;
6678
6564
  }): Promise<HttpResponse<{
6679
- data?: Pattern[];
6565
+ data?: EntityNode[];
6680
6566
  pagination?: {
6681
6567
  limit?: number;
6682
6568
  offset?: number;
@@ -6684,371 +6570,485 @@ declare class PatternsService extends BaseService {
6684
6570
  };
6685
6571
  }>>;
6686
6572
  /**
6687
- * Compile patterns
6688
- * Compile patterns from user's memories
6689
- * @param body - Request body
6573
+ * Get entity by ID
6574
+ * Retrieve a specific entity by its ID
6575
+ * @param id - The entity ID
6690
6576
  */
6691
- compilePatterns(options?: {
6692
- body?: {
6693
- minOccurrences?: number;
6694
- timeWindow?: string;
6695
- };
6696
- }): Promise<HttpResponse<{
6697
- data?: Pattern[];
6698
- count?: number;
6577
+ getEntityById(id: string): Promise<HttpResponse<{
6578
+ data?: EntityNode;
6699
6579
  }>>;
6700
6580
  /**
6701
- * Detect behavioral patterns
6702
- * Run pattern detection algorithms to identify recurring behavioral patterns
6703
- * @param body - Request body
6581
+ * Get memories mentioning entity
6582
+ * Get all memories that mention a specific entity
6583
+ * @param id - The entity ID
6584
+ * @param limit - Maximum number of memories to return
6585
+ * @param offset - Number of memories to skip
6704
6586
  */
6705
- detectPatterns(options?: {
6706
- body?: {
6707
- contextFilter?: string;
6708
- timeframeStart?: string;
6709
- timeframeEnd?: string;
6710
- minConfidence?: number;
6711
- maxResults?: number;
6712
- autoStore?: boolean;
6713
- };
6587
+ getEntityMemories(id: string, options?: {
6588
+ limit?: number;
6589
+ offset?: number;
6714
6590
  }): Promise<HttpResponse<{
6715
6591
  data?: {
6716
- detectedPatterns?: Pattern[];
6592
+ memory?: Memory;
6593
+ confidence?: number;
6594
+ }[];
6595
+ pagination?: {
6596
+ limit?: number;
6597
+ offset?: number;
6717
6598
  count?: number;
6718
- stored?: number;
6719
- confidence?: {
6720
- average?: number;
6721
- highest?: number;
6722
- };
6723
6599
  };
6724
6600
  }>>;
6601
+ }
6602
+
6603
+ /**
6604
+ * ConversationsService - Conversation tracking and analysis endpoints API operations.
6605
+ * Auto-generated by sdk-generator - do not edit manually.
6606
+ */
6607
+
6608
+ /**
6609
+ * Conversation tracking and analysis endpoints
6610
+ */
6611
+ declare class ConversationsService extends BaseService {
6725
6612
  /**
6726
- * Analyze pattern trends
6727
- * Analyze pattern trends, correlations, and generate insights
6728
- * @param body - Request body
6613
+ * List conversations
6614
+ * List all conversations for the authenticated user with pagination
6615
+ * @param limit - Maximum number of conversations to return
6616
+ * @param offset - Number of conversations to skip
6617
+ * @param since - Return only conversations created after this timestamp (ISO 8601 format)
6729
6618
  */
6730
- analyzePatterns(options?: {
6731
- body?: {
6732
- timeRange?: number;
6733
- groupBy?: 'type' | 'context' | 'confidence';
6734
- includeDetails?: boolean;
6735
- };
6619
+ listConversations(options?: {
6620
+ limit?: number;
6621
+ offset?: number;
6622
+ since?: string;
6736
6623
  }): Promise<HttpResponse<{
6737
- data?: {
6738
- analysis?: {
6739
- totalPatterns?: number;
6740
- recentPatterns?: number;
6741
- trends?: Record<string, unknown>;
6742
- insights?: string[];
6743
- recommendations?: string[];
6744
- };
6745
- timeRange?: number;
6746
- analyzedAt?: string;
6624
+ data?: Conversation[];
6625
+ pagination?: {
6626
+ limit?: number;
6627
+ offset?: number;
6628
+ count?: number;
6747
6629
  };
6748
6630
  }>>;
6749
6631
  /**
6750
- * Update pattern
6751
- * Update an existing pattern with partial data
6752
- * @param id - The pattern ID
6632
+ * Create conversation
6633
+ * Create a new conversation for the authenticated user
6753
6634
  * @param body - Request body
6754
6635
  */
6755
- updatePattern(id: string, body: {
6756
- name?: string;
6757
- description?: string;
6758
- confidence?: number;
6759
- metadata?: Record<string, unknown>;
6636
+ createConversation(body: {
6637
+ title: string;
6638
+ summary?: string;
6760
6639
  }): Promise<HttpResponse<{
6761
- data?: Pattern;
6640
+ data?: Conversation;
6762
6641
  }>>;
6763
6642
  /**
6764
- * Record pattern feedback
6765
- * Record feedback on a pattern
6766
- * @param body - Request body
6643
+ * Get conversation summary
6644
+ * Retrieve a conversation summary by its ID
6645
+ * @param conversationId - The conversation ID
6767
6646
  */
6768
- recordPatternFeedback(body: {
6769
- patternId: string;
6770
- feedback: string;
6771
- }): Promise<HttpResponse<{
6772
- data?: Pattern;
6647
+ getConversationSummary(conversationId: string): Promise<HttpResponse<{
6648
+ data?: Conversation;
6773
6649
  }>>;
6774
- }
6775
-
6776
- /**
6777
- * BehaviorService - Behavioral pattern tracking and state management endpoints API operations.
6778
- * Auto-generated by sdk-generator - do not edit manually.
6779
- */
6780
-
6781
- /**
6782
- * Behavioral pattern tracking and state management endpoints
6783
- */
6784
- declare class BehaviorService extends BaseService {
6785
6650
  /**
6786
- * Get behavioral state
6787
- * Get current behavioral state for the authenticated user
6651
+ * Delete conversation
6652
+ * Delete a conversation and soft-delete all associated memories
6653
+ * @param conversationId - The conversation ID
6788
6654
  */
6789
- getBehavioralState(): Promise<HttpResponse<{
6790
- data?: Record<string, unknown>;
6655
+ deleteConversation(conversationId: string): Promise<HttpResponse<void>>;
6656
+ /**
6657
+ * Get conversation timeline
6658
+ * Get all memories in a conversation in chronological order
6659
+ * @param conversationId - The conversation ID
6660
+ */
6661
+ getConversationTimeline(conversationId: string): Promise<HttpResponse<{
6662
+ data?: Memory[];
6663
+ count?: number;
6791
6664
  }>>;
6792
6665
  /**
6793
- * Update behavioral state
6794
- * Update or mutate behavioral state
6666
+ * Search conversations
6667
+ * Search conversations by query string
6795
6668
  * @param body - Request body
6796
6669
  */
6797
- updateBehavioralState(options?: {
6798
- body?: {
6799
- state?: Record<string, unknown>;
6800
- mutations?: Record<string, unknown>;
6801
- };
6670
+ searchConversations(body: {
6671
+ query: string;
6672
+ limit?: number;
6802
6673
  }): Promise<HttpResponse<{
6803
- data?: Record<string, unknown>;
6674
+ data?: Conversation[];
6675
+ count?: number;
6676
+ }>>;
6677
+ /**
6678
+ * Find conversations by topic
6679
+ * Find conversations that contain a specific topic
6680
+ * @param body - Request body
6681
+ */
6682
+ findConversationsByTopic(body: {
6683
+ topicId: string;
6684
+ limit?: number;
6685
+ }): Promise<HttpResponse<{
6686
+ data?: Conversation[];
6687
+ count?: number;
6688
+ metadata?: {
6689
+ topicId?: string;
6690
+ };
6804
6691
  }>>;
6805
6692
  }
6806
6693
 
6807
6694
  /**
6808
- * TopicsService - Topic detection, clustering, and management endpoints API operations.
6695
+ * BillingService - Subscription billing and payment management endpoints API operations.
6809
6696
  * Auto-generated by sdk-generator - do not edit manually.
6810
6697
  */
6811
6698
 
6812
6699
  /**
6813
- * Topic detection, clustering, and management endpoints
6700
+ * Subscription billing and payment management endpoints
6814
6701
  */
6815
- declare class TopicsService extends BaseService {
6702
+ declare class BillingService extends BaseService {
6816
6703
  /**
6817
- * List topics
6818
- * List all topics with pagination
6819
- * @param limit - Maximum number of topics to return
6820
- * @param offset - Number of topics to skip
6704
+ * Get billing overview
6705
+ * Get subscription, payment method, and upcoming invoice information
6821
6706
  */
6822
- listTopics(options?: {
6823
- limit?: number;
6824
- offset?: number;
6825
- }): Promise<HttpResponse<{
6826
- data?: Topic[];
6827
- pagination?: {
6828
- limit?: number;
6829
- offset?: number;
6830
- count?: number;
6831
- };
6707
+ getBillingOverview(): Promise<HttpResponse<{
6708
+ data?: BillingOverview;
6832
6709
  }>>;
6833
6710
  /**
6834
- * Get topic by ID
6835
- * Retrieve a specific topic by its ID
6836
- * @param id - The topic ID
6711
+ * Create checkout session
6712
+ * Create a Stripe checkout session for subscription upgrade
6713
+ * @param body - Request body
6837
6714
  */
6838
- getTopicById(id: string): Promise<HttpResponse<{
6839
- data?: Topic;
6715
+ createCheckoutSession(body: {
6716
+ priceId?: string;
6717
+ successUrl: string;
6718
+ cancelUrl: string;
6719
+ }): Promise<HttpResponse<{
6720
+ data?: CheckoutSessionResponse;
6840
6721
  }>>;
6841
6722
  /**
6842
- * Merge topics
6843
- * Merge two topics into one
6723
+ * Create billing portal session
6724
+ * Create a Stripe billing portal session for managing subscription
6844
6725
  * @param body - Request body
6845
6726
  */
6846
- mergeTopics(body: {
6847
- sourceTopicId: string;
6848
- targetTopicId: string;
6727
+ createPortalSession(body: {
6728
+ returnUrl: string;
6849
6729
  }): Promise<HttpResponse<{
6850
- data?: Topic;
6730
+ data?: PortalSessionResponse;
6851
6731
  }>>;
6852
6732
  /**
6853
- * Discover related topics
6854
- * Discover topics related to a given topic
6855
- * @param body - Request body
6733
+ * Get current subscription
6734
+ * Get the current subscription details for the authenticated user
6856
6735
  */
6857
- discoverRelatedTopics(body: {
6858
- topicId: string;
6859
- limit?: number;
6860
- }): Promise<HttpResponse<{
6861
- data?: Topic[];
6736
+ getSubscription(): Promise<HttpResponse<{
6737
+ data?: Subscription;
6862
6738
  }>>;
6863
6739
  /**
6864
- * Calculate topic similarity
6865
- * Calculate similarity score between two topics
6740
+ * Cancel subscription
6741
+ * Cancel the current subscription at the end of the billing period
6866
6742
  * @param body - Request body
6867
6743
  */
6868
- calculateTopicSimilarity(body: {
6869
- topicId1: string;
6870
- topicId2: string;
6744
+ cancelSubscription(options?: {
6745
+ body?: Record<string, unknown>;
6871
6746
  }): Promise<HttpResponse<{
6872
- data?: {
6873
- similarity?: number;
6874
- };
6747
+ data?: Subscription;
6875
6748
  }>>;
6876
6749
  /**
6877
- * Find similar topics
6878
- * Find topics similar to a given topic
6750
+ * Reactivate subscription
6751
+ * Reactivate a subscription that was scheduled for cancellation
6879
6752
  * @param body - Request body
6880
6753
  */
6881
- findSimilarTopics(body: {
6882
- topicId: string;
6883
- threshold?: number;
6884
- limit?: number;
6754
+ reactivateSubscription(options?: {
6755
+ body?: Record<string, unknown>;
6885
6756
  }): Promise<HttpResponse<{
6886
- data?: {
6887
- topic?: Topic;
6888
- similarity?: number;
6889
- }[];
6757
+ data?: Subscription;
6890
6758
  }>>;
6891
6759
  /**
6892
- * Cluster topics
6893
- * Cluster topics using community detection algorithms
6894
- * @param body - Request body
6760
+ * List invoices
6761
+ * Get a list of invoices for the authenticated user
6762
+ * @param limit - Maximum number of invoices to return
6895
6763
  */
6896
- clusterTopics(options?: {
6897
- body?: {
6898
- minClusterSize?: number;
6899
- };
6764
+ listInvoices(options?: {
6765
+ limit?: number;
6900
6766
  }): Promise<HttpResponse<{
6901
- data?: {
6902
- clusters?: Record<string, unknown>[];
6903
- clusterCount?: number;
6904
- };
6767
+ data?: ListInvoicesResponse;
6905
6768
  }>>;
6906
6769
  /**
6907
- * Detect communities
6908
- * Detect communities in the topic graph using specified algorithm
6770
+ * List payment methods
6771
+ * Get a list of payment methods for the authenticated user
6772
+ */
6773
+ listPaymentMethods(): Promise<HttpResponse<{
6774
+ data?: ListPaymentMethodsResponse;
6775
+ }>>;
6776
+ /**
6777
+ * Set default payment method
6778
+ * Set a payment method as the default for future payments
6779
+ * @param id - The payment method ID
6909
6780
  * @param body - Request body
6910
6781
  */
6911
- detectCommunities(options?: {
6912
- body?: {
6913
- algorithm?: string;
6914
- };
6782
+ setDefaultPaymentMethod(id: string, options?: {
6783
+ body?: Record<string, unknown>;
6915
6784
  }): Promise<HttpResponse<{
6916
- data?: {
6917
- communities?: Community[];
6918
- communityCount?: number;
6919
- };
6785
+ message?: string;
6920
6786
  }>>;
6921
6787
  /**
6922
- * Search topics
6923
- * Search topics by query string using fulltext search
6788
+ * Delete payment method
6789
+ * Remove a payment method from the account
6790
+ * @param id - The payment method ID
6791
+ */
6792
+ deletePaymentMethod(id: string): Promise<HttpResponse<void>>;
6793
+ /**
6794
+ * Stripe webhook endpoint
6795
+ * Receive and process Stripe webhook events
6924
6796
  * @param body - Request body
6925
6797
  */
6926
- searchTopics(body: {
6927
- query: string;
6798
+ stripeWebhook(body: Record<string, unknown>): Promise<HttpResponse<{
6799
+ received?: boolean;
6800
+ }>>;
6801
+ }
6802
+
6803
+ /**
6804
+ * ArtifactsService - Artifact storage and retrieval endpoints API operations.
6805
+ * Auto-generated by sdk-generator - do not edit manually.
6806
+ */
6807
+
6808
+ /**
6809
+ * Artifact storage and retrieval endpoints
6810
+ */
6811
+ declare class ArtifactsService extends BaseService {
6812
+ /**
6813
+ * List artifacts
6814
+ * List all artifacts for the authenticated user with optional filters
6815
+ * @param limit - Maximum number of artifacts to return
6816
+ * @param offset - Number of artifacts to skip
6817
+ * @param memoryId - Filter by memory ID
6818
+ * @param conversationId - Filter by conversation ID
6819
+ * @param type - Filter by artifact type
6820
+ */
6821
+ listArtifacts(options?: {
6928
6822
  limit?: number;
6929
6823
  offset?: number;
6824
+ memoryId?: string;
6825
+ conversationId?: string;
6826
+ type?: string;
6930
6827
  }): Promise<HttpResponse<{
6931
- data?: Record<string, unknown>[];
6932
- total?: number;
6933
- limit?: number;
6934
- offset?: number;
6828
+ data?: Artifact[];
6829
+ count?: number;
6830
+ }>>;
6831
+ /**
6832
+ * Create artifact
6833
+ * Create a new artifact for the authenticated user
6834
+ * @param body - Request body
6835
+ */
6836
+ createArtifact(body: {
6837
+ content: string;
6838
+ type: string;
6839
+ name?: string;
6840
+ description?: string;
6841
+ memoryId?: string;
6842
+ conversationId?: string;
6843
+ metadata?: Record<string, unknown>;
6844
+ }): Promise<HttpResponse<{
6845
+ data?: Artifact;
6846
+ }>>;
6847
+ /**
6848
+ * Get artifact by ID
6849
+ * Retrieve a specific artifact by its ID
6850
+ * @param id - The artifact ID
6851
+ */
6852
+ getArtifactById(id: string): Promise<HttpResponse<{
6853
+ data?: Artifact;
6854
+ }>>;
6855
+ /**
6856
+ * Delete artifact
6857
+ * Delete an artifact by its ID
6858
+ * @param id - The artifact ID
6859
+ */
6860
+ deleteArtifact(id: string): Promise<HttpResponse<void>>;
6861
+ /**
6862
+ * Update artifact
6863
+ * Update an existing artifact with partial data
6864
+ * @param id - The artifact ID
6865
+ * @param body - Request body
6866
+ */
6867
+ updateArtifact(id: string, body: {
6868
+ content?: string;
6869
+ type?: string;
6870
+ name?: string;
6871
+ description?: string;
6872
+ metadata?: Record<string, unknown>;
6873
+ }): Promise<HttpResponse<{
6874
+ data?: Artifact;
6935
6875
  }>>;
6936
6876
  }
6937
6877
 
6938
6878
  /**
6939
- * UsersService - User management and profile endpoints API operations.
6879
+ * ApiKeysService - API key management endpoints API operations.
6940
6880
  * Auto-generated by sdk-generator - do not edit manually.
6941
6881
  */
6942
6882
 
6943
6883
  /**
6944
- * User management and profile endpoints
6884
+ * API key management endpoints
6945
6885
  */
6946
- declare class UsersService extends BaseService {
6886
+ declare class ApiKeysService extends BaseService {
6947
6887
  /**
6948
- * Sync user from WorkOS
6949
- * Called by the customer portal after WorkOS authentication.
6950
- Creates a new user if they don't exist, or updates their profile if they do.
6951
- This is the main entry point for user provisioning.
6952
- When the invite gate is closed and a new user is created, the inviteCode
6953
- is redeemed atomically to track which code was used for registration.
6954
-
6955
- * @param body - Request body
6888
+ * Get user information for current API key
6889
+ * Debug endpoint to retrieve user ID and authentication method from the current API key
6956
6890
  */
6957
- syncUser(body: {
6958
- workosId: string;
6959
- email: string;
6960
- firstName?: string;
6961
- lastName?: string;
6962
- profilePictureUrl?: string;
6963
- inviteCode?: string;
6964
- }): Promise<HttpResponse<{
6965
- data?: User;
6966
- created?: boolean;
6891
+ debugUser(): Promise<HttpResponse<{
6892
+ data?: {
6893
+ userId?: string;
6894
+ authMethod?: string;
6895
+ };
6967
6896
  }>>;
6968
6897
  /**
6969
- * Get current user
6970
- * Get the currently authenticated user's profile and usage information
6898
+ * List API keys
6899
+ * List all API keys for the authenticated user
6971
6900
  */
6972
- getCurrentUser(): Promise<HttpResponse<{
6973
- data?: User;
6974
- usage?: UserUsage;
6901
+ listApiKeys(): Promise<HttpResponse<{
6902
+ data?: ApiKey[];
6975
6903
  }>>;
6976
6904
  /**
6977
- * Update current user
6978
- * Update the currently authenticated user's profile
6905
+ * Create API key
6906
+ * Create a new API key for the authenticated user
6979
6907
  * @param body - Request body
6980
6908
  */
6981
- updateCurrentUser(options?: {
6909
+ createApiKey(options?: {
6982
6910
  body?: {
6983
- firstName?: string;
6984
- lastName?: string;
6985
- profilePictureUrl?: string;
6911
+ label?: string;
6912
+ expiresAt?: string;
6986
6913
  };
6987
6914
  }): Promise<HttpResponse<{
6988
- data?: User;
6915
+ data?: {
6916
+ apiKey?: string;
6917
+ keyInfo?: ApiKey;
6918
+ };
6989
6919
  }>>;
6990
6920
  /**
6991
- * Get current user's usage
6992
- * Get the currently authenticated user's memory usage statistics
6921
+ * Delete API key
6922
+ * Delete (revoke) an API key by its ID
6923
+ * @param id - The API key ID
6993
6924
  */
6994
- getCurrentUserUsage(): Promise<HttpResponse<{
6995
- data?: UserUsage;
6996
- }>>;
6925
+ deleteApiKey(id: string): Promise<HttpResponse<void>>;
6926
+ }
6927
+
6928
+ /**
6929
+ * AdminService - Admin management endpoints for invite codes and platform configuration API operations.
6930
+ * Auto-generated by sdk-generator - do not edit manually.
6931
+ */
6932
+
6933
+ /**
6934
+ * Admin management endpoints for invite codes and platform configuration
6935
+ */
6936
+ declare class AdminService extends BaseService {
6997
6937
  /**
6998
- * Export all user data
6999
- * Export all user data as a JSON archive. Includes profile, memories,
7000
- conversations, facts, and patterns. Supports GDPR Article 20
7001
- (right to data portability). Sensitive fields (Stripe customer ID,
7002
- WorkOS ID, embeddings) are excluded.
7003
-
6938
+ * List invite codes
6939
+ * List all invite codes with optional status filter
6940
+ * @param status - Filter by status
6941
+ * @param limit -
6942
+ * @param offset -
7004
6943
  */
7005
- exportUserData(): Promise<HttpResponse<{
7006
- exportVersion?: string;
7007
- exportedAt?: string;
7008
- counts?: {
7009
- memories?: number;
7010
- conversations?: number;
7011
- facts?: number;
7012
- patterns?: number;
7013
- };
7014
- profile?: Record<string, unknown>;
7015
- memories?: Memory[];
7016
- conversations?: Conversation[];
7017
- facts?: Fact[];
7018
- patterns?: Pattern[];
6944
+ adminListInviteCodes(options?: {
6945
+ status?: 'active' | 'exhausted' | 'revoked' | 'expired';
6946
+ limit?: number;
6947
+ offset?: number;
6948
+ }): Promise<HttpResponse<{
6949
+ invites?: {
6950
+ id?: string;
6951
+ code?: string;
6952
+ email?: string;
6953
+ label?: string;
6954
+ maxUses?: number;
6955
+ currentUses?: number;
6956
+ status?: string;
6957
+ expiresAt?: string;
6958
+ createdAt?: string;
6959
+ }[];
6960
+ total?: number;
7019
6961
  }>>;
7020
6962
  /**
7021
- * Initiate account deletion
7022
- * Schedule the current user's account for deletion after a 7-day grace period.
7023
- Requires email confirmation. Immediately revokes API keys and cancels
7024
- any active subscription. The account enters read-only mode.
7025
-
6963
+ * Create invite code
6964
+ * Create a new invite code for the gated preview
7026
6965
  * @param body - Request body
7027
6966
  */
7028
- initiateAccountDeletion(body: {
7029
- confirmationEmail: string;
6967
+ adminCreateInviteCode(body: {
6968
+ email: string;
6969
+ label: string;
6970
+ maxUses?: number;
6971
+ code?: string;
6972
+ expiresAt?: string;
6973
+ metadata?: Record<string, unknown>;
7030
6974
  }): Promise<HttpResponse<{
7031
- data?: User;
7032
- message?: string;
6975
+ id?: string;
6976
+ code?: string;
6977
+ label?: string;
6978
+ maxUses?: number;
6979
+ currentUses?: number;
6980
+ status?: string;
6981
+ expiresAt?: string;
6982
+ createdAt?: string;
6983
+ shareUrl?: string;
7033
6984
  }>>;
7034
6985
  /**
7035
- * Cancel account deletion
7036
- * Cancel a pending account deletion during the grace period.
7037
- Note: Previously revoked API keys are not restored — new keys must be created.
7038
- Stripe subscription may need manual reactivation via the billing portal.
7039
-
6986
+ * Get invite system statistics
6987
+ * Aggregate statistics for the invite system
7040
6988
  */
7041
- cancelAccountDeletion(): Promise<HttpResponse<{
7042
- data?: User;
6989
+ adminGetInviteStats(): Promise<HttpResponse<{
6990
+ totalCodes?: number;
6991
+ activeCodes?: number;
6992
+ totalRedemptions?: number;
6993
+ totalCapacity?: number;
6994
+ utilizationRate?: number;
6995
+ recentRedemptions?: {
6996
+ code?: string;
6997
+ email?: string;
6998
+ redeemedAt?: string;
6999
+ }[];
7000
+ }>>;
7001
+ /**
7002
+ * Get invite code details
7003
+ * Get details for a single invite code including redemptions
7004
+ * @param code - The invite code
7005
+ */
7006
+ adminGetInviteCode(code: string): Promise<HttpResponse<{
7007
+ id?: string;
7008
+ code?: string;
7009
+ email?: string;
7010
+ label?: string;
7011
+ maxUses?: number;
7012
+ currentUses?: number;
7013
+ status?: string;
7014
+ redemptions?: {
7015
+ userId?: string;
7016
+ email?: string;
7017
+ redeemedAt?: string;
7018
+ }[];
7019
+ }>>;
7020
+ /**
7021
+ * Revoke an invite code
7022
+ * Revoke an invite code. Existing accounts created with this code are unaffected.
7023
+ * @param code -
7024
+ */
7025
+ adminRevokeInviteCode(code: string): Promise<HttpResponse<{
7026
+ code?: string;
7027
+ status?: string;
7043
7028
  message?: string;
7044
7029
  }>>;
7045
7030
  /**
7046
- * Get user by ID
7047
- * Get a user by their internal ID (admin only)
7048
- * @param id -
7031
+ * Get gate status with audit info
7032
+ * Get current invite gate state with audit information
7049
7033
  */
7050
- getUserById(id: string): Promise<HttpResponse<{
7051
- data?: User;
7034
+ adminGetGateStatus(): Promise<HttpResponse<{
7035
+ gated?: boolean;
7036
+ updatedAt?: string;
7037
+ updatedBy?: string;
7038
+ }>>;
7039
+ /**
7040
+ * Toggle invite gate
7041
+ * Toggle the invite gate. When enabled (true), new signups require a valid invite code.
7042
+ When disabled (false), registration is open. Takes effect immediately.
7043
+
7044
+ * @param body - Request body
7045
+ */
7046
+ adminSetGateStatus(body: {
7047
+ enabled: boolean;
7048
+ }): Promise<HttpResponse<{
7049
+ gated?: boolean;
7050
+ updatedAt?: string;
7051
+ message?: string;
7052
7052
  }>>;
7053
7053
  }
7054
7054
 
@@ -7063,42 +7063,42 @@ declare class UsersService extends BaseService {
7063
7063
  */
7064
7064
  declare class Memnexus {
7065
7065
  private readonly config;
7066
- /** Admin management endpoints for invite codes and platform configuration operations */
7067
- readonly admin: AdminService;
7068
- /** API key management endpoints operations */
7069
- readonly apiKeys: ApiKeysService;
7070
- /** Artifact storage and retrieval endpoints operations */
7071
- readonly artifacts: ArtifactsService;
7072
- /** Subscription billing and payment management endpoints operations */
7073
- readonly billing: BillingService;
7074
- /** Conversation tracking and analysis endpoints operations */
7075
- readonly conversations: ConversationsService;
7076
- /** Entity extraction and discovery endpoints operations */
7077
- readonly entities: EntitiesService;
7078
- /** Fact extraction and management endpoints operations */
7079
- readonly facts: FactsService;
7080
- /** Graph-based retrieval augmented generation endpoints operations */
7081
- readonly graphrag: GraphragService;
7082
- /** Health check endpoints operations */
7083
- readonly health: HealthService;
7084
- /** Invite code validation and gate status endpoints operations */
7085
- readonly invites: InvitesService;
7086
- /** Memory management and retrieval endpoints operations */
7087
- readonly memories: MemoriesService;
7088
- /** Observability and metrics endpoints for production monitoring operations */
7089
- readonly monitoring: MonitoringService;
7090
- /** Narrative thread management endpoints operations */
7091
- readonly narratives: NarrativesService;
7066
+ /** User management and profile endpoints operations */
7067
+ readonly users: UsersService;
7068
+ /** Topic detection, clustering, and management endpoints operations */
7069
+ readonly topics: TopicsService;
7092
7070
  /** System health, monitoring, and configuration endpoints operations */
7093
7071
  readonly system: SystemService;
7094
7072
  /** Pattern detection and behavioral analysis endpoints operations */
7095
7073
  readonly patterns: PatternsService;
7096
7074
  /** Behavioral pattern tracking and state management endpoints operations */
7097
7075
  readonly behavior: BehaviorService;
7098
- /** Topic detection, clustering, and management endpoints operations */
7099
- readonly topics: TopicsService;
7100
- /** User management and profile endpoints operations */
7101
- readonly users: UsersService;
7076
+ /** Narrative thread management endpoints operations */
7077
+ readonly narratives: NarrativesService;
7078
+ /** Observability and metrics endpoints for production monitoring operations */
7079
+ readonly monitoring: MonitoringService;
7080
+ /** Memory management and retrieval endpoints operations */
7081
+ readonly memories: MemoriesService;
7082
+ /** Invite code validation and gate status endpoints operations */
7083
+ readonly invites: InvitesService;
7084
+ /** Health check endpoints operations */
7085
+ readonly health: HealthService;
7086
+ /** Graph-based retrieval augmented generation endpoints operations */
7087
+ readonly graphrag: GraphragService;
7088
+ /** Fact extraction and management endpoints operations */
7089
+ readonly facts: FactsService;
7090
+ /** Entity extraction and discovery endpoints operations */
7091
+ readonly entities: EntitiesService;
7092
+ /** Conversation tracking and analysis endpoints operations */
7093
+ readonly conversations: ConversationsService;
7094
+ /** Subscription billing and payment management endpoints operations */
7095
+ readonly billing: BillingService;
7096
+ /** Artifact storage and retrieval endpoints operations */
7097
+ readonly artifacts: ArtifactsService;
7098
+ /** API key management endpoints operations */
7099
+ readonly apiKeys: ApiKeysService;
7100
+ /** Admin management endpoints for invite codes and platform configuration operations */
7101
+ readonly admin: AdminService;
7102
7102
  /**
7103
7103
  * Create a new SDK client.
7104
7104
  * @param config - SDK configuration