hebbrix 2.2.0 → 2.3.0

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.mts CHANGED
@@ -175,6 +175,53 @@ interface MemoryAddResponse {
175
175
  updated_count: number;
176
176
  skipped_count: number;
177
177
  }
178
+ interface BatchMemoryItemParams {
179
+ content: string;
180
+ collection_id?: string;
181
+ importance?: number;
182
+ user_id?: string;
183
+ agent_id?: string;
184
+ run_id?: string;
185
+ tags?: string[];
186
+ metadata?: Record<string, any>;
187
+ }
188
+ interface BatchMemoryCreateParams {
189
+ memories: BatchMemoryItemParams[];
190
+ collection_id?: string;
191
+ user_id?: string;
192
+ agent_id?: string;
193
+ run_id?: string;
194
+ app_id?: string;
195
+ namespace?: string;
196
+ wait_for_index?: boolean;
197
+ /** Stable retry key sent as the Idempotency-Key transport header. */
198
+ idempotency_key?: string;
199
+ /** Optional caller cancellation signal; it is never serialized. */
200
+ signal?: AbortSignal;
201
+ /** Client-side readiness deadline used only when wait_for_index=true. */
202
+ index_timeout_ms?: number;
203
+ /** Poll interval for a durable 202 receipt. */
204
+ index_poll_interval_ms?: number;
205
+ }
206
+ interface BatchMemoryResponse {
207
+ created: number;
208
+ failed: number;
209
+ accepted: boolean;
210
+ durable: boolean;
211
+ memory_ids: string[];
212
+ errors: string[];
213
+ results: Array<{
214
+ id: string;
215
+ memory_id?: string;
216
+ processing_status: string;
217
+ }>;
218
+ processing_status: string;
219
+ searchable: boolean;
220
+ outbox_event_id?: string;
221
+ status_url?: string;
222
+ idempotency_replay?: boolean;
223
+ request_id?: string;
224
+ }
178
225
  interface UpdateMemoryParams {
179
226
  content?: string;
180
227
  importance?: number;
@@ -207,8 +254,10 @@ interface ReasonParams {
207
254
  facets?: string[];
208
255
  }
209
256
  interface ListParams {
210
- skip?: number;
257
+ cursor?: string;
211
258
  limit?: number;
259
+ name?: string;
260
+ name_prefix?: string;
212
261
  }
213
262
  interface MemoryListParams {
214
263
  collection_id?: string;
@@ -305,7 +354,7 @@ declare class CollectionsResource extends BaseResource {
305
354
  /**
306
355
  * List all collections
307
356
  */
308
- list(params?: ListParams): Promise<Collection[]>;
357
+ list(params?: ListParams): Promise<CursorPage<Collection>>;
309
358
  /**
310
359
  * Get a specific collection
311
360
  */
@@ -324,6 +373,19 @@ declare class MemoriesResource extends BaseResource {
324
373
  * Create a new memory
325
374
  */
326
375
  create(params: CreateMemoryParams): Promise<MemoryAddResponse>;
376
+ /**
377
+ * Create up to 100 memories with one unambiguous readiness contract.
378
+ * `wait_for_index=true` resolves only for a fully searchable batch. A durable
379
+ * server-side 202 is polled to the caller's deadline; expiry raises a typed
380
+ * `IndexingTimeoutError` carrying the original durable receipt.
381
+ */
382
+ createBatch(params: BatchMemoryCreateParams): Promise<BatchMemoryResponse>;
383
+ /** Poll every item in an asynchronous batch receipt until it is searchable. */
384
+ waitForBatchSearchable(receipt: BatchMemoryResponse, options?: {
385
+ timeoutMs?: number;
386
+ pollIntervalMs?: number;
387
+ signal?: AbortSignal;
388
+ }): Promise<BatchMemoryResponse>;
327
389
  /**
328
390
  * List memories
329
391
  */
@@ -407,7 +469,6 @@ declare class RLResource extends BaseResource {
407
469
  * Train the Memory Manager agent using RL
408
470
  */
409
471
  trainMemoryManager(params: {
410
- collection_id?: string;
411
472
  num_episodes?: number;
412
473
  [key: string]: any;
413
474
  }): Promise<any>;
@@ -415,7 +476,6 @@ declare class RLResource extends BaseResource {
415
476
  * Train the Answer Agent using RL
416
477
  */
417
478
  trainAnswerAgent(params: {
418
- collection_id?: string;
419
479
  num_episodes?: number;
420
480
  [key: string]: any;
421
481
  }): Promise<any>;
@@ -429,6 +489,7 @@ declare class RLResource extends BaseResource {
429
489
  evaluate(agentType: string, collectionId?: string): Promise<any>;
430
490
  }
431
491
  declare class ProceduralResource extends BaseResource {
492
+ private unwrapProcedure;
432
493
  /**
433
494
  * Create a new procedure
434
495
  */
@@ -481,8 +542,11 @@ declare class TemporalResource extends BaseResource {
481
542
  subject: string;
482
543
  predicate: string;
483
544
  object: string;
484
- valid_from?: string;
545
+ valid_from: string;
485
546
  valid_until?: string;
547
+ observed_at?: string;
548
+ subject_type?: string;
549
+ object_type?: string;
486
550
  confidence?: number;
487
551
  source_memory_id?: string;
488
552
  metadata?: Record<string, any>;
@@ -490,18 +554,30 @@ declare class TemporalResource extends BaseResource {
490
554
  /**
491
555
  * Query temporal facts
492
556
  */
493
- queryFacts(params?: {
557
+ queryFacts(params: {
494
558
  subject?: string;
495
559
  predicate?: string;
496
560
  object?: string;
497
561
  at_time?: string;
498
562
  }): Promise<any[]>;
563
+ queryAtTime(params: {
564
+ subject: string;
565
+ timestamp: string;
566
+ predicate?: string;
567
+ }): Promise<any>;
568
+ history(subject: string, predicate: string, limit?: number): Promise<any>;
569
+ conflicts(subject: string, predicate: string): Promise<any>;
570
+ invalidate(subject: string, predicate: string, object: string): Promise<any>;
499
571
  /**
500
572
  * Query knowledge state at a specific point in time
501
573
  */
502
574
  pointInTime(timestamp: string, entity?: string): Promise<any>;
575
+ /** Permanently delete a tenant-scoped temporal fact by stable ID. */
576
+ deleteFact(factId: string): Promise<any>;
503
577
  }
504
578
  declare class WorkingMemoryResource extends BaseResource {
579
+ readonly sessionId: string;
580
+ constructor(client: MemoryClient);
505
581
  /**
506
582
  * Add item to working memory buffer
507
583
  */
@@ -509,33 +585,30 @@ declare class WorkingMemoryResource extends BaseResource {
509
585
  role: string;
510
586
  content: string;
511
587
  metadata?: Record<string, any>;
588
+ session_id?: string;
512
589
  }): Promise<any>;
513
590
  /**
514
591
  * Get current working memory context
515
592
  */
516
- getContext(): Promise<any>;
593
+ getContext(sessionId?: string, includeCompressed?: boolean): Promise<any>;
517
594
  /**
518
595
  * Compress working memory buffer
519
596
  */
520
- compress(): Promise<any>;
597
+ compress(sessionId?: string): Promise<any>;
521
598
  /**
522
599
  * Clear working memory buffer
523
600
  */
524
- clear(): Promise<any>;
601
+ clear(sessionId?: string): Promise<any>;
525
602
  }
526
603
  declare class ConsolidationResource extends BaseResource {
527
604
  /**
528
605
  * Trigger memory consolidation
529
606
  */
530
- consolidate(collectionId: string, threshold?: number): Promise<any>;
607
+ consolidate(collectionId: string, lookbackDays?: number, utilityThreshold?: number): Promise<any>;
531
608
  /**
532
609
  * Get consolidation statistics
533
610
  */
534
611
  getStats(collectionId: string): Promise<any>;
535
- /**
536
- * Archive old memories
537
- */
538
- archive(collectionId: string, beforeDate?: string): Promise<any>;
539
612
  }
540
613
  declare class MemoryToolsResource extends BaseResource {
541
614
  /**
@@ -543,7 +616,9 @@ declare class MemoryToolsResource extends BaseResource {
543
616
  */
544
617
  replace(params: {
545
618
  memory_id: string;
619
+ old_content: string;
546
620
  new_content: string;
621
+ collection_id: string;
547
622
  reason?: string;
548
623
  }): Promise<any>;
549
624
  /**
@@ -552,23 +627,15 @@ declare class MemoryToolsResource extends BaseResource {
552
627
  insert(params: {
553
628
  collection_id: string;
554
629
  content: string;
555
- position: number;
630
+ position?: number;
556
631
  reason?: string;
632
+ importance?: number;
633
+ metadata?: Record<string, any>;
557
634
  }): Promise<any>;
558
635
  /**
559
636
  * Re-evaluate memory in light of new information
560
637
  */
561
- rethink(memoryId: string, query: string): Promise<any>;
562
- }
563
- declare class WorldModelResource extends BaseResource {
564
- /**
565
- * Simulate retrieval without actually retrieving
566
- */
567
- imagineRetrieval(query: string, collectionId?: string): Promise<any>;
568
- /**
569
- * Plan memory operations to achieve goal
570
- */
571
- plan(goal: string, collectionId?: string): Promise<any>;
638
+ rethink(memoryId: string, collectionId: string): Promise<any>;
572
639
  }
573
640
 
574
641
  declare class MemoryClient {
@@ -587,7 +654,6 @@ declare class MemoryClient {
587
654
  workingMemory: WorkingMemoryResource;
588
655
  consolidation: ConsolidationResource;
589
656
  memoryTools: MemoryToolsResource;
590
- worldModel: WorldModelResource;
591
657
  proofloop: ProofLoopResource;
592
658
  constructor(config?: ClientConfig);
593
659
  private getHeaders;
@@ -607,23 +673,63 @@ declare class MemoryClient {
607
673
  */
608
674
  declare class HebbrixError extends Error {
609
675
  statusCode?: number;
610
- constructor(message: string, statusCode?: number);
676
+ code?: string;
677
+ requestId?: string;
678
+ details?: Record<string, any>;
679
+ constructor(message: string, statusCode?: number, options?: {
680
+ code?: string;
681
+ requestId?: string;
682
+ details?: Record<string, any>;
683
+ });
684
+ }
685
+ declare class EntitlementError extends HebbrixError {
686
+ constructor(message: string, statusCode: number, options?: {
687
+ code?: string;
688
+ requestId?: string;
689
+ details?: Record<string, any>;
690
+ });
691
+ }
692
+ declare class IndexingTimeoutError extends Error {
693
+ receipt: Record<string, any>;
694
+ memoryIds: string[];
695
+ statusUrl?: string;
696
+ constructor(message: string, receipt: Record<string, any>);
611
697
  }
612
698
  declare class AuthenticationError extends HebbrixError {
613
- constructor(message?: string);
699
+ constructor(message?: string, options?: {
700
+ code?: string;
701
+ requestId?: string;
702
+ details?: Record<string, any>;
703
+ });
614
704
  }
615
705
  declare class ValidationError extends HebbrixError {
616
706
  errors?: any[];
617
- constructor(message: string, errors?: any[]);
707
+ constructor(message: string, errors?: any[], options?: {
708
+ code?: string;
709
+ requestId?: string;
710
+ details?: Record<string, any>;
711
+ });
618
712
  }
619
713
  declare class NotFoundError extends HebbrixError {
620
- constructor(message?: string);
714
+ constructor(message?: string, options?: {
715
+ code?: string;
716
+ requestId?: string;
717
+ details?: Record<string, any>;
718
+ });
621
719
  }
622
720
  declare class RateLimitError extends HebbrixError {
623
- constructor(message?: string);
721
+ constructor(message?: string, options?: {
722
+ code?: string;
723
+ requestId?: string;
724
+ details?: Record<string, any>;
725
+ });
624
726
  }
625
727
  declare class ServerError extends HebbrixError {
626
- constructor(message?: string);
728
+ constructor(message?: string, options?: {
729
+ code?: string;
730
+ requestId?: string;
731
+ details?: Record<string, any>;
732
+ });
627
733
  }
628
734
 
629
735
  interface SafetyEnvelope {
@@ -640,10 +746,10 @@ interface SafetyEnvelope {
640
746
  }
641
747
  /**
642
748
  * Validate the API-owned grounding receipt before exposing evidence to an agent.
643
- * A malformed, degraded, abstaining, or ungrounded response is converted into
644
- * one deterministic no-match envelope. This prevents SDK/API contract drift
645
- * from turning a nearest neighbour into verified evidence.
749
+ * A malformed or explicit no-match response is converted into one deterministic
750
+ * no-match envelope. Degraded, evidence-bound rows remain visible together with
751
+ * the API's abstention signal so the SDK cannot introduce a false negative.
646
752
  */
647
753
  declare function enforceSearchSafety<T extends object>(response: T, rowsKey?: "results" | "sources"): T & SafetyEnvelope;
648
754
 
649
- export { type APIKeyResponse, AuthResource, type AuthResponse, AuthenticationError, type ClientConfig, type Collection, CollectionsResource, ConsolidationResource, type CorrectionCreateParams, type CorrectionSearchParams, CorrectionsResource, type CreateCollectionParams, type CreateMemoryParams, type CursorPage, type EvidenceClaim, type GroundingReceipt, HebbrixError, type ListParams, MemoriesResource, type Memory, type MemoryAddResponse, type MemoryAddResult, MemoryClient, type MemoryJobReceipt, MemoryJobsResource, type MemoryListParams, MemoryToolsResource, type MemoryWithMetadata, NotFoundError, ProceduralResource, type ProofContext, type ProofLoopCandidate, type ProofLoopDecisionParams, type ProofLoopMetricParams, ProofLoopResource, RLResource, RateLimitError, type ReasonParams, type ReasoningResponse, type ReasoningSource, type SafetyEnvelope, type SearchParams, SearchResource, type SearchResponse, type SearchResult, ServerError, TemporalResource, type UpdateCollectionParams, type UpdateMemoryParams, type User, ValidationError, WorkingMemoryResource, WorldModelResource, enforceSearchSafety };
755
+ export { type APIKeyResponse, AuthResource, type AuthResponse, AuthenticationError, type BatchMemoryCreateParams, type BatchMemoryItemParams, type BatchMemoryResponse, type ClientConfig, type Collection, CollectionsResource, ConsolidationResource, type CorrectionCreateParams, type CorrectionSearchParams, CorrectionsResource, type CreateCollectionParams, type CreateMemoryParams, type CursorPage, EntitlementError, type EvidenceClaim, type GroundingReceipt, HebbrixError, IndexingTimeoutError, type ListParams, MemoriesResource, type Memory, type MemoryAddResponse, type MemoryAddResult, MemoryClient, type MemoryJobReceipt, MemoryJobsResource, type MemoryListParams, MemoryToolsResource, type MemoryWithMetadata, NotFoundError, ProceduralResource, type ProofContext, type ProofLoopCandidate, type ProofLoopDecisionParams, type ProofLoopMetricParams, ProofLoopResource, RLResource, RateLimitError, type ReasonParams, type ReasoningResponse, type ReasoningSource, type SafetyEnvelope, type SearchParams, SearchResource, type SearchResponse, type SearchResult, ServerError, TemporalResource, type UpdateCollectionParams, type UpdateMemoryParams, type User, ValidationError, WorkingMemoryResource, enforceSearchSafety };
package/dist/index.d.ts CHANGED
@@ -175,6 +175,53 @@ interface MemoryAddResponse {
175
175
  updated_count: number;
176
176
  skipped_count: number;
177
177
  }
178
+ interface BatchMemoryItemParams {
179
+ content: string;
180
+ collection_id?: string;
181
+ importance?: number;
182
+ user_id?: string;
183
+ agent_id?: string;
184
+ run_id?: string;
185
+ tags?: string[];
186
+ metadata?: Record<string, any>;
187
+ }
188
+ interface BatchMemoryCreateParams {
189
+ memories: BatchMemoryItemParams[];
190
+ collection_id?: string;
191
+ user_id?: string;
192
+ agent_id?: string;
193
+ run_id?: string;
194
+ app_id?: string;
195
+ namespace?: string;
196
+ wait_for_index?: boolean;
197
+ /** Stable retry key sent as the Idempotency-Key transport header. */
198
+ idempotency_key?: string;
199
+ /** Optional caller cancellation signal; it is never serialized. */
200
+ signal?: AbortSignal;
201
+ /** Client-side readiness deadline used only when wait_for_index=true. */
202
+ index_timeout_ms?: number;
203
+ /** Poll interval for a durable 202 receipt. */
204
+ index_poll_interval_ms?: number;
205
+ }
206
+ interface BatchMemoryResponse {
207
+ created: number;
208
+ failed: number;
209
+ accepted: boolean;
210
+ durable: boolean;
211
+ memory_ids: string[];
212
+ errors: string[];
213
+ results: Array<{
214
+ id: string;
215
+ memory_id?: string;
216
+ processing_status: string;
217
+ }>;
218
+ processing_status: string;
219
+ searchable: boolean;
220
+ outbox_event_id?: string;
221
+ status_url?: string;
222
+ idempotency_replay?: boolean;
223
+ request_id?: string;
224
+ }
178
225
  interface UpdateMemoryParams {
179
226
  content?: string;
180
227
  importance?: number;
@@ -207,8 +254,10 @@ interface ReasonParams {
207
254
  facets?: string[];
208
255
  }
209
256
  interface ListParams {
210
- skip?: number;
257
+ cursor?: string;
211
258
  limit?: number;
259
+ name?: string;
260
+ name_prefix?: string;
212
261
  }
213
262
  interface MemoryListParams {
214
263
  collection_id?: string;
@@ -305,7 +354,7 @@ declare class CollectionsResource extends BaseResource {
305
354
  /**
306
355
  * List all collections
307
356
  */
308
- list(params?: ListParams): Promise<Collection[]>;
357
+ list(params?: ListParams): Promise<CursorPage<Collection>>;
309
358
  /**
310
359
  * Get a specific collection
311
360
  */
@@ -324,6 +373,19 @@ declare class MemoriesResource extends BaseResource {
324
373
  * Create a new memory
325
374
  */
326
375
  create(params: CreateMemoryParams): Promise<MemoryAddResponse>;
376
+ /**
377
+ * Create up to 100 memories with one unambiguous readiness contract.
378
+ * `wait_for_index=true` resolves only for a fully searchable batch. A durable
379
+ * server-side 202 is polled to the caller's deadline; expiry raises a typed
380
+ * `IndexingTimeoutError` carrying the original durable receipt.
381
+ */
382
+ createBatch(params: BatchMemoryCreateParams): Promise<BatchMemoryResponse>;
383
+ /** Poll every item in an asynchronous batch receipt until it is searchable. */
384
+ waitForBatchSearchable(receipt: BatchMemoryResponse, options?: {
385
+ timeoutMs?: number;
386
+ pollIntervalMs?: number;
387
+ signal?: AbortSignal;
388
+ }): Promise<BatchMemoryResponse>;
327
389
  /**
328
390
  * List memories
329
391
  */
@@ -407,7 +469,6 @@ declare class RLResource extends BaseResource {
407
469
  * Train the Memory Manager agent using RL
408
470
  */
409
471
  trainMemoryManager(params: {
410
- collection_id?: string;
411
472
  num_episodes?: number;
412
473
  [key: string]: any;
413
474
  }): Promise<any>;
@@ -415,7 +476,6 @@ declare class RLResource extends BaseResource {
415
476
  * Train the Answer Agent using RL
416
477
  */
417
478
  trainAnswerAgent(params: {
418
- collection_id?: string;
419
479
  num_episodes?: number;
420
480
  [key: string]: any;
421
481
  }): Promise<any>;
@@ -429,6 +489,7 @@ declare class RLResource extends BaseResource {
429
489
  evaluate(agentType: string, collectionId?: string): Promise<any>;
430
490
  }
431
491
  declare class ProceduralResource extends BaseResource {
492
+ private unwrapProcedure;
432
493
  /**
433
494
  * Create a new procedure
434
495
  */
@@ -481,8 +542,11 @@ declare class TemporalResource extends BaseResource {
481
542
  subject: string;
482
543
  predicate: string;
483
544
  object: string;
484
- valid_from?: string;
545
+ valid_from: string;
485
546
  valid_until?: string;
547
+ observed_at?: string;
548
+ subject_type?: string;
549
+ object_type?: string;
486
550
  confidence?: number;
487
551
  source_memory_id?: string;
488
552
  metadata?: Record<string, any>;
@@ -490,18 +554,30 @@ declare class TemporalResource extends BaseResource {
490
554
  /**
491
555
  * Query temporal facts
492
556
  */
493
- queryFacts(params?: {
557
+ queryFacts(params: {
494
558
  subject?: string;
495
559
  predicate?: string;
496
560
  object?: string;
497
561
  at_time?: string;
498
562
  }): Promise<any[]>;
563
+ queryAtTime(params: {
564
+ subject: string;
565
+ timestamp: string;
566
+ predicate?: string;
567
+ }): Promise<any>;
568
+ history(subject: string, predicate: string, limit?: number): Promise<any>;
569
+ conflicts(subject: string, predicate: string): Promise<any>;
570
+ invalidate(subject: string, predicate: string, object: string): Promise<any>;
499
571
  /**
500
572
  * Query knowledge state at a specific point in time
501
573
  */
502
574
  pointInTime(timestamp: string, entity?: string): Promise<any>;
575
+ /** Permanently delete a tenant-scoped temporal fact by stable ID. */
576
+ deleteFact(factId: string): Promise<any>;
503
577
  }
504
578
  declare class WorkingMemoryResource extends BaseResource {
579
+ readonly sessionId: string;
580
+ constructor(client: MemoryClient);
505
581
  /**
506
582
  * Add item to working memory buffer
507
583
  */
@@ -509,33 +585,30 @@ declare class WorkingMemoryResource extends BaseResource {
509
585
  role: string;
510
586
  content: string;
511
587
  metadata?: Record<string, any>;
588
+ session_id?: string;
512
589
  }): Promise<any>;
513
590
  /**
514
591
  * Get current working memory context
515
592
  */
516
- getContext(): Promise<any>;
593
+ getContext(sessionId?: string, includeCompressed?: boolean): Promise<any>;
517
594
  /**
518
595
  * Compress working memory buffer
519
596
  */
520
- compress(): Promise<any>;
597
+ compress(sessionId?: string): Promise<any>;
521
598
  /**
522
599
  * Clear working memory buffer
523
600
  */
524
- clear(): Promise<any>;
601
+ clear(sessionId?: string): Promise<any>;
525
602
  }
526
603
  declare class ConsolidationResource extends BaseResource {
527
604
  /**
528
605
  * Trigger memory consolidation
529
606
  */
530
- consolidate(collectionId: string, threshold?: number): Promise<any>;
607
+ consolidate(collectionId: string, lookbackDays?: number, utilityThreshold?: number): Promise<any>;
531
608
  /**
532
609
  * Get consolidation statistics
533
610
  */
534
611
  getStats(collectionId: string): Promise<any>;
535
- /**
536
- * Archive old memories
537
- */
538
- archive(collectionId: string, beforeDate?: string): Promise<any>;
539
612
  }
540
613
  declare class MemoryToolsResource extends BaseResource {
541
614
  /**
@@ -543,7 +616,9 @@ declare class MemoryToolsResource extends BaseResource {
543
616
  */
544
617
  replace(params: {
545
618
  memory_id: string;
619
+ old_content: string;
546
620
  new_content: string;
621
+ collection_id: string;
547
622
  reason?: string;
548
623
  }): Promise<any>;
549
624
  /**
@@ -552,23 +627,15 @@ declare class MemoryToolsResource extends BaseResource {
552
627
  insert(params: {
553
628
  collection_id: string;
554
629
  content: string;
555
- position: number;
630
+ position?: number;
556
631
  reason?: string;
632
+ importance?: number;
633
+ metadata?: Record<string, any>;
557
634
  }): Promise<any>;
558
635
  /**
559
636
  * Re-evaluate memory in light of new information
560
637
  */
561
- rethink(memoryId: string, query: string): Promise<any>;
562
- }
563
- declare class WorldModelResource extends BaseResource {
564
- /**
565
- * Simulate retrieval without actually retrieving
566
- */
567
- imagineRetrieval(query: string, collectionId?: string): Promise<any>;
568
- /**
569
- * Plan memory operations to achieve goal
570
- */
571
- plan(goal: string, collectionId?: string): Promise<any>;
638
+ rethink(memoryId: string, collectionId: string): Promise<any>;
572
639
  }
573
640
 
574
641
  declare class MemoryClient {
@@ -587,7 +654,6 @@ declare class MemoryClient {
587
654
  workingMemory: WorkingMemoryResource;
588
655
  consolidation: ConsolidationResource;
589
656
  memoryTools: MemoryToolsResource;
590
- worldModel: WorldModelResource;
591
657
  proofloop: ProofLoopResource;
592
658
  constructor(config?: ClientConfig);
593
659
  private getHeaders;
@@ -607,23 +673,63 @@ declare class MemoryClient {
607
673
  */
608
674
  declare class HebbrixError extends Error {
609
675
  statusCode?: number;
610
- constructor(message: string, statusCode?: number);
676
+ code?: string;
677
+ requestId?: string;
678
+ details?: Record<string, any>;
679
+ constructor(message: string, statusCode?: number, options?: {
680
+ code?: string;
681
+ requestId?: string;
682
+ details?: Record<string, any>;
683
+ });
684
+ }
685
+ declare class EntitlementError extends HebbrixError {
686
+ constructor(message: string, statusCode: number, options?: {
687
+ code?: string;
688
+ requestId?: string;
689
+ details?: Record<string, any>;
690
+ });
691
+ }
692
+ declare class IndexingTimeoutError extends Error {
693
+ receipt: Record<string, any>;
694
+ memoryIds: string[];
695
+ statusUrl?: string;
696
+ constructor(message: string, receipt: Record<string, any>);
611
697
  }
612
698
  declare class AuthenticationError extends HebbrixError {
613
- constructor(message?: string);
699
+ constructor(message?: string, options?: {
700
+ code?: string;
701
+ requestId?: string;
702
+ details?: Record<string, any>;
703
+ });
614
704
  }
615
705
  declare class ValidationError extends HebbrixError {
616
706
  errors?: any[];
617
- constructor(message: string, errors?: any[]);
707
+ constructor(message: string, errors?: any[], options?: {
708
+ code?: string;
709
+ requestId?: string;
710
+ details?: Record<string, any>;
711
+ });
618
712
  }
619
713
  declare class NotFoundError extends HebbrixError {
620
- constructor(message?: string);
714
+ constructor(message?: string, options?: {
715
+ code?: string;
716
+ requestId?: string;
717
+ details?: Record<string, any>;
718
+ });
621
719
  }
622
720
  declare class RateLimitError extends HebbrixError {
623
- constructor(message?: string);
721
+ constructor(message?: string, options?: {
722
+ code?: string;
723
+ requestId?: string;
724
+ details?: Record<string, any>;
725
+ });
624
726
  }
625
727
  declare class ServerError extends HebbrixError {
626
- constructor(message?: string);
728
+ constructor(message?: string, options?: {
729
+ code?: string;
730
+ requestId?: string;
731
+ details?: Record<string, any>;
732
+ });
627
733
  }
628
734
 
629
735
  interface SafetyEnvelope {
@@ -640,10 +746,10 @@ interface SafetyEnvelope {
640
746
  }
641
747
  /**
642
748
  * Validate the API-owned grounding receipt before exposing evidence to an agent.
643
- * A malformed, degraded, abstaining, or ungrounded response is converted into
644
- * one deterministic no-match envelope. This prevents SDK/API contract drift
645
- * from turning a nearest neighbour into verified evidence.
749
+ * A malformed or explicit no-match response is converted into one deterministic
750
+ * no-match envelope. Degraded, evidence-bound rows remain visible together with
751
+ * the API's abstention signal so the SDK cannot introduce a false negative.
646
752
  */
647
753
  declare function enforceSearchSafety<T extends object>(response: T, rowsKey?: "results" | "sources"): T & SafetyEnvelope;
648
754
 
649
- export { type APIKeyResponse, AuthResource, type AuthResponse, AuthenticationError, type ClientConfig, type Collection, CollectionsResource, ConsolidationResource, type CorrectionCreateParams, type CorrectionSearchParams, CorrectionsResource, type CreateCollectionParams, type CreateMemoryParams, type CursorPage, type EvidenceClaim, type GroundingReceipt, HebbrixError, type ListParams, MemoriesResource, type Memory, type MemoryAddResponse, type MemoryAddResult, MemoryClient, type MemoryJobReceipt, MemoryJobsResource, type MemoryListParams, MemoryToolsResource, type MemoryWithMetadata, NotFoundError, ProceduralResource, type ProofContext, type ProofLoopCandidate, type ProofLoopDecisionParams, type ProofLoopMetricParams, ProofLoopResource, RLResource, RateLimitError, type ReasonParams, type ReasoningResponse, type ReasoningSource, type SafetyEnvelope, type SearchParams, SearchResource, type SearchResponse, type SearchResult, ServerError, TemporalResource, type UpdateCollectionParams, type UpdateMemoryParams, type User, ValidationError, WorkingMemoryResource, WorldModelResource, enforceSearchSafety };
755
+ export { type APIKeyResponse, AuthResource, type AuthResponse, AuthenticationError, type BatchMemoryCreateParams, type BatchMemoryItemParams, type BatchMemoryResponse, type ClientConfig, type Collection, CollectionsResource, ConsolidationResource, type CorrectionCreateParams, type CorrectionSearchParams, CorrectionsResource, type CreateCollectionParams, type CreateMemoryParams, type CursorPage, EntitlementError, type EvidenceClaim, type GroundingReceipt, HebbrixError, IndexingTimeoutError, type ListParams, MemoriesResource, type Memory, type MemoryAddResponse, type MemoryAddResult, MemoryClient, type MemoryJobReceipt, MemoryJobsResource, type MemoryListParams, MemoryToolsResource, type MemoryWithMetadata, NotFoundError, ProceduralResource, type ProofContext, type ProofLoopCandidate, type ProofLoopDecisionParams, type ProofLoopMetricParams, ProofLoopResource, RLResource, RateLimitError, type ReasonParams, type ReasoningResponse, type ReasoningSource, type SafetyEnvelope, type SearchParams, SearchResource, type SearchResponse, type SearchResult, ServerError, TemporalResource, type UpdateCollectionParams, type UpdateMemoryParams, type User, ValidationError, WorkingMemoryResource, enforceSearchSafety };