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/CHANGELOG.md +42 -0
- package/README.md +61 -732
- package/dist/index.d.mts +143 -37
- package/dist/index.d.ts +143 -37
- package/dist/index.js +313 -139
- package/dist/index.mjs +311 -138
- package/package.json +5 -8
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
|
-
|
|
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
|
|
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,
|
|
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
|
|
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,
|
|
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
|
-
|
|
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
|
|
644
|
-
*
|
|
645
|
-
*
|
|
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,
|
|
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
|
-
|
|
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
|
|
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,
|
|
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
|
|
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,
|
|
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
|
-
|
|
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
|
|
644
|
-
*
|
|
645
|
-
*
|
|
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,
|
|
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 };
|