hebbrix 2.0.0 → 2.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hebbrix
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -14,6 +14,7 @@ Official TypeScript/JavaScript SDK for the Hebbrix api - **the only memory API w
 - ✅ **Procedural Memory** - Store and execute learned skills
 - ✅ **Working Memory** - Short-term context buffer for conversations
 - ✅ **Memory Consolidation** - Automatic compression of episodic memories
+- ✅ **ProofLoop** - Learn from outcomes with automatic, verifiable evidence receipts
 - ✅ **Promise-based** - Native async/await support
 - ✅ **Type-safe** - Complete TypeScript type definitions
 - ✅ **Universal** - Works in Node.js and browsers
@@ -73,6 +74,28 @@ const main = async () => {
 main();
 ```
 
+## ProofLoop: search → decision → outcome → proof
+
+```typescript
+const search = await client.searchWithProof({
+  query: 'What should the agent do next?',
+  collection_id: 'collection-42',
+  user_id: 'customer-7',
+});
+const decision = await client.proofloop.decide({
+  policy_key: 'agent.next_action',
+  candidates: [{ action_key: 'act' }, { action_key: 'ask' }],
+  collection_id: 'collection-42',
+  user_id: 'customer-7',
+  proof_context: search.proof_context,
+});
+await client.proofloop.recordOutcome(decision.decision_id, {
+  success: true,
+  idempotency_key: 'run-123-result',
+});
+const proof = await client.proofloop.proof(decision.decision_id);
+```
+
 ## 📚 Complete API Guide
 
 ### 1. Authentication
@@ -554,18 +577,18 @@ await bot.trainOnConversations();
 async function buildKnowledgeGraph(client: MemoryClient, collectionId: string) {
   // Add entities and relationships
   await client.temporal.addFact({
-    subject: 'GPT-4',
+    subject: 'GPT-5',
     predicate: 'developed_by',
     object: 'OpenAI',
-    valid_from: '2023-03-14',
+    valid_from: '2025-08-01',
     confidence: 1.0,
   });
 
   await client.temporal.addFact({
-    subject: 'GPT-4',
+    subject: 'GPT-5',
     predicate: 'is_a',
     object: 'Large Language Model',
-    valid_from: '2023-03-14',
+    valid_from: '2025-08-01',
     confidence: 1.0,
   });
 
@@ -579,18 +602,18 @@ async function buildKnowledgeGraph(client: MemoryClient, collectionId: string) {
 
   // Query relationships
   const facts = await client.temporal.queryFacts({
-    subject: 'GPT-4',
+    subject: 'GPT-5',
   });
 
-  console.log(facts); // All facts about GPT-4
+  console.log(facts); // All facts about GPT-5
 
   // Historical query
   const snapshot = await client.temporal.pointInTime(
-    '2023-01-01T00:00:00Z',
+    '2025-01-01T00:00:00Z',
     'OpenAI'
   );
 
-  console.log(snapshot); // OpenAI's state before GPT-4 release
+  console.log(snapshot); // OpenAI's state before GPT-5 release
 }
 ```
 
@@ -632,7 +655,7 @@ const client = new MemoryClient({
   // Required: API key
   apiKey: 'hbx_...',
 
-  // Optional: Custom base URL (default: http://localhost:8000)
+  // Optional: Custom base URL (default: https://api.hebbrix.com)
   baseUrl: 'https://api.yourdomain.com',
 
   // Optional: Request timeout in milliseconds (default: 30000)

package/dist/index.d.mts

@@ -17,7 +17,7 @@ interface User {
     full_name: string;
     is_active: boolean;
     is_verified: boolean;
-    tier: 'free' | 'starter' | 'pro' | 'enterprise';
+    tier: "free" | "starter" | "pro" | "enterprise";
 }
 interface Collection {
     id: string;
@@ -57,6 +57,30 @@ interface SearchResponse {
     total: number;
     search_type: string;
     processing_time_ms: number;
+    proof_context?: ProofContext;
+}
+interface ProofContext {
+    schema_version: "proofloop-context-v1";
+    context_id: string;
+    token: string;
+    manifest_digest: string;
+    evidence_manifest: Record<string, any>;
+    trace_id?: string;
+    issued_at: string;
+    expires_at: string;
+}
+interface ProofLoopCandidate {
+    action_key: string;
+    description?: string;
+    features?: Record<string, any>;
+}
+interface ProofLoopDecisionParams {
+    policy_key: string;
+    candidates: ProofLoopCandidate[];
+    proof_context?: ProofContext | string;
+    collection_id?: string;
+    user_id?: string;
+    [key: string]: any;
 }
 interface ReasoningSource {
     memory_id: string;
@@ -96,13 +120,14 @@ interface SearchParams {
     query: string;
     collection_id?: string;
     limit?: number;
-    search_type?: 'hybrid' | 'vector' | 'bm25' | 'graph';
+    search_type?: "hybrid" | "vector" | "bm25" | "graph";
     filters?: Record<string, any>;
+    user_id?: string;
 }
 interface ReasonParams {
     query: string;
     collection_id?: string;
-    provider?: 'gemini' | 'openai' | 'anthropic';
+    provider?: "gemini" | "openai" | "anthropic";
     include_steps?: boolean;
 }
 interface ListParams {
@@ -194,6 +219,8 @@ declare class SearchResource extends BaseResource {
      * Search memories
      */
     search(params: SearchParams): Promise<SearchResult[]>;
+    /** Search while preserving the automatic ProofLoop evidence context. */
+    searchWithProof(params: SearchParams): Promise<SearchResponse>;
     /**
      * Find similar memories
      */
@@ -203,6 +230,18 @@ declare class SearchResource extends BaseResource {
      */
     reason(params: ReasonParams): Promise<ReasoningResponse>;
 }
+declare class ProofLoopResource extends BaseResource {
+    /** Create a causal decision bound to search/chat evidence automatically. */
+    decide(params: ProofLoopDecisionParams): Promise<Record<string, any>>;
+    recordOutcome(decisionId: string, body: {
+        observations?: Record<string, any>[];
+        reward?: number;
+        success?: boolean;
+        idempotency_key?: string;
+    }): Promise<Record<string, any>>;
+    proof(decisionId: string): Promise<Record<string, any>>;
+    publicKey(): Promise<Record<string, any>>;
+}
 declare class RLResource extends BaseResource {
     /**
      * Train the Memory Manager agent using RL
@@ -372,10 +411,6 @@ declare class WorldModelResource extends BaseResource {
     plan(goal: string, collectionId?: string): Promise<any>;
 }
 
-/**
- * Main Hebbrix client
- */
-
 declare class MemoryClient {
     private apiKey?;
     private baseUrl;
@@ -391,6 +426,7 @@ declare class MemoryClient {
     consolidation: ConsolidationResource;
     memoryTools: MemoryToolsResource;
     worldModel: WorldModelResource;
+    proofloop: ProofLoopResource;
     constructor(config?: ClientConfig);
     private getHeaders;
     private handleError;
@@ -400,6 +436,7 @@ declare class MemoryClient {
     patch<T = any>(path: string, body?: any): Promise<T>;
     delete<T = any>(path: string): Promise<T>;
     search(params: SearchParams): Promise<SearchResult[]>;
+    searchWithProof(params: SearchParams): Promise<SearchResponse>;
     reason(params: ReasonParams): Promise<ReasoningResponse>;
 }
 
@@ -427,4 +464,4 @@ declare class ServerError extends HebbrixError {
     constructor(message?: string);
 }
 
-export { type APIKeyResponse, AuthResource, type AuthResponse, AuthenticationError, type ClientConfig, type Collection, CollectionsResource, ConsolidationResource, type CreateCollectionParams, type CreateMemoryParams, HebbrixError, type ListParams, MemoriesResource, type Memory, MemoryClient, MemoryToolsResource, type MemoryWithMetadata, NotFoundError, ProceduralResource, RLResource, RateLimitError, type ReasonParams, type ReasoningResponse, type ReasoningSource, type SearchParams, SearchResource, type SearchResponse, type SearchResult, ServerError, TemporalResource, type UpdateCollectionParams, type UpdateMemoryParams, type User, ValidationError, WorkingMemoryResource, WorldModelResource };
+export { type APIKeyResponse, AuthResource, type AuthResponse, AuthenticationError, type ClientConfig, type Collection, CollectionsResource, ConsolidationResource, type CreateCollectionParams, type CreateMemoryParams, HebbrixError, type ListParams, MemoriesResource, type Memory, MemoryClient, MemoryToolsResource, type MemoryWithMetadata, NotFoundError, ProceduralResource, type ProofContext, type ProofLoopCandidate, type ProofLoopDecisionParams, ProofLoopResource, RLResource, RateLimitError, type ReasonParams, type ReasoningResponse, type ReasoningSource, type SearchParams, SearchResource, type SearchResponse, type SearchResult, ServerError, TemporalResource, type UpdateCollectionParams, type UpdateMemoryParams, type User, ValidationError, WorkingMemoryResource, WorldModelResource };

package/dist/index.d.ts

@@ -17,7 +17,7 @@ interface User {
     full_name: string;
     is_active: boolean;
     is_verified: boolean;
-    tier: 'free' | 'starter' | 'pro' | 'enterprise';
+    tier: "free" | "starter" | "pro" | "enterprise";
 }
 interface Collection {
     id: string;
@@ -57,6 +57,30 @@ interface SearchResponse {
     total: number;
     search_type: string;
     processing_time_ms: number;
+    proof_context?: ProofContext;
+}
+interface ProofContext {
+    schema_version: "proofloop-context-v1";
+    context_id: string;
+    token: string;
+    manifest_digest: string;
+    evidence_manifest: Record<string, any>;
+    trace_id?: string;
+    issued_at: string;
+    expires_at: string;
+}
+interface ProofLoopCandidate {
+    action_key: string;
+    description?: string;
+    features?: Record<string, any>;
+}
+interface ProofLoopDecisionParams {
+    policy_key: string;
+    candidates: ProofLoopCandidate[];
+    proof_context?: ProofContext | string;
+    collection_id?: string;
+    user_id?: string;
+    [key: string]: any;
 }
 interface ReasoningSource {
     memory_id: string;
@@ -96,13 +120,14 @@ interface SearchParams {
     query: string;
     collection_id?: string;
     limit?: number;
-    search_type?: 'hybrid' | 'vector' | 'bm25' | 'graph';
+    search_type?: "hybrid" | "vector" | "bm25" | "graph";
     filters?: Record<string, any>;
+    user_id?: string;
 }
 interface ReasonParams {
     query: string;
     collection_id?: string;
-    provider?: 'gemini' | 'openai' | 'anthropic';
+    provider?: "gemini" | "openai" | "anthropic";
     include_steps?: boolean;
 }
 interface ListParams {
@@ -194,6 +219,8 @@ declare class SearchResource extends BaseResource {
      * Search memories
      */
     search(params: SearchParams): Promise<SearchResult[]>;
+    /** Search while preserving the automatic ProofLoop evidence context. */
+    searchWithProof(params: SearchParams): Promise<SearchResponse>;
     /**
      * Find similar memories
      */
@@ -203,6 +230,18 @@ declare class SearchResource extends BaseResource {
      */
     reason(params: ReasonParams): Promise<ReasoningResponse>;
 }
+declare class ProofLoopResource extends BaseResource {
+    /** Create a causal decision bound to search/chat evidence automatically. */
+    decide(params: ProofLoopDecisionParams): Promise<Record<string, any>>;
+    recordOutcome(decisionId: string, body: {
+        observations?: Record<string, any>[];
+        reward?: number;
+        success?: boolean;
+        idempotency_key?: string;
+    }): Promise<Record<string, any>>;
+    proof(decisionId: string): Promise<Record<string, any>>;
+    publicKey(): Promise<Record<string, any>>;
+}
 declare class RLResource extends BaseResource {
     /**
      * Train the Memory Manager agent using RL
@@ -372,10 +411,6 @@ declare class WorldModelResource extends BaseResource {
     plan(goal: string, collectionId?: string): Promise<any>;
 }
 
-/**
- * Main Hebbrix client
- */
-
 declare class MemoryClient {
     private apiKey?;
     private baseUrl;
@@ -391,6 +426,7 @@ declare class MemoryClient {
     consolidation: ConsolidationResource;
     memoryTools: MemoryToolsResource;
     worldModel: WorldModelResource;
+    proofloop: ProofLoopResource;
     constructor(config?: ClientConfig);
     private getHeaders;
     private handleError;
@@ -400,6 +436,7 @@ declare class MemoryClient {
     patch<T = any>(path: string, body?: any): Promise<T>;
     delete<T = any>(path: string): Promise<T>;
     search(params: SearchParams): Promise<SearchResult[]>;
+    searchWithProof(params: SearchParams): Promise<SearchResponse>;
     reason(params: ReasonParams): Promise<ReasoningResponse>;
 }
 
@@ -427,4 +464,4 @@ declare class ServerError extends HebbrixError {
     constructor(message?: string);
 }
 
-export { type APIKeyResponse, AuthResource, type AuthResponse, AuthenticationError, type ClientConfig, type Collection, CollectionsResource, ConsolidationResource, type CreateCollectionParams, type CreateMemoryParams, HebbrixError, type ListParams, MemoriesResource, type Memory, MemoryClient, MemoryToolsResource, type MemoryWithMetadata, NotFoundError, ProceduralResource, RLResource, RateLimitError, type ReasonParams, type ReasoningResponse, type ReasoningSource, type SearchParams, SearchResource, type SearchResponse, type SearchResult, ServerError, TemporalResource, type UpdateCollectionParams, type UpdateMemoryParams, type User, ValidationError, WorkingMemoryResource, WorldModelResource };
+export { type APIKeyResponse, AuthResource, type AuthResponse, AuthenticationError, type ClientConfig, type Collection, CollectionsResource, ConsolidationResource, type CreateCollectionParams, type CreateMemoryParams, HebbrixError, type ListParams, MemoriesResource, type Memory, MemoryClient, MemoryToolsResource, type MemoryWithMetadata, NotFoundError, ProceduralResource, type ProofContext, type ProofLoopCandidate, type ProofLoopDecisionParams, ProofLoopResource, RLResource, RateLimitError, type ReasonParams, type ReasoningResponse, type ReasoningSource, type SearchParams, SearchResource, type SearchResponse, type SearchResult, ServerError, TemporalResource, type UpdateCollectionParams, type UpdateMemoryParams, type User, ValidationError, WorkingMemoryResource, WorldModelResource };

package/dist/index.js

@@ -30,6 +30,7 @@ __export(index_exports, {
   MemoryToolsResource: () => MemoryToolsResource,
   NotFoundError: () => NotFoundError,
   ProceduralResource: () => ProceduralResource,
+  ProofLoopResource: () => ProofLoopResource,
   RLResource: () => RLResource,
   RateLimitError: () => RateLimitError,
   SearchResource: () => SearchResource,
@@ -161,6 +162,17 @@ var SearchResource = class extends BaseResource {
     });
     return response.results;
   }
+  /** Search while preserving the automatic ProofLoop evidence context. */
+  async searchWithProof(params) {
+    return this.client.post("/v1/search", {
+      query: params.query,
+      collection_id: params.collection_id,
+      user_id: params.user_id,
+      limit: params.limit || 10,
+      search_type: params.search_type || "hybrid",
+      filters: params.filters || {}
+    });
+  }
   /**
    * Find similar memories
    */
@@ -183,6 +195,30 @@ var SearchResource = class extends BaseResource {
     });
   }
 };
+var ProofLoopResource = class extends BaseResource {
+  /** Create a causal decision bound to search/chat evidence automatically. */
+  async decide(params) {
+    const context = params.proof_context;
+    const token = typeof context === "string" ? context : context?.token;
+    const { proof_context: _context, ...body } = params;
+    return this.client.post("/v1/learning/decisions", {
+      ...body,
+      ...token ? { proof_context_token: token } : {}
+    });
+  }
+  async recordOutcome(decisionId, body) {
+    return this.client.post(`/v1/learning/decisions/${decisionId}/outcomes`, {
+      observations: [],
+      ...body
+    });
+  }
+  async proof(decisionId) {
+    return this.client.get(`/v1/learning/decisions/${decisionId}/proof`);
+  }
+  async publicKey() {
+    return this.client.get("/v1/learning/proof-key");
+  }
+};
 var RLResource = class extends BaseResource {
   /**
    * Train the Memory Manager agent using RL
@@ -471,7 +507,7 @@ var ServerError = class _ServerError extends HebbrixError {
 var MemoryClient = class {
   constructor(config = {}) {
     this.apiKey = config.apiKey;
-    this.baseUrl = config.baseUrl || "https://memory-api.livelystone-78e9a45c.centralus.azurecontainerapps.io";
+    this.baseUrl = config.baseUrl || "https://api.hebbrix.com";
     this.timeout = config.timeout || 12e4;
     this.baseUrl = this.baseUrl.replace(/\/$/, "");
     this.auth = new AuthResource(this);
@@ -485,11 +521,12 @@ var MemoryClient = class {
     this.consolidation = new ConsolidationResource(this);
     this.memoryTools = new MemoryToolsResource(this);
     this.worldModel = new WorldModelResource(this);
+    this.proofloop = new ProofLoopResource(this);
   }
   getHeaders() {
     const headers = {
       "Content-Type": "application/json",
-      "User-Agent": "hebbrix-typescript/2.0.0"
+      "User-Agent": "hebbrix-typescript/2.1.0"
     };
     if (this.apiKey) {
       headers["Authorization"] = `Bearer ${this.apiKey}`;
@@ -567,6 +604,9 @@ var MemoryClient = class {
   async search(params) {
     return this.searchResource.search(params);
   }
+  async searchWithProof(params) {
+    return this.searchResource.searchWithProof(params);
+  }
   async reason(params) {
     return this.searchResource.reason(params);
   }
@@ -583,6 +623,7 @@ var MemoryClient = class {
   MemoryToolsResource,
   NotFoundError,
   ProceduralResource,
+  ProofLoopResource,
   RLResource,
   RateLimitError,
   SearchResource,

package/dist/index.mjs

@@ -118,6 +118,17 @@ var SearchResource = class extends BaseResource {
     });
     return response.results;
   }
+  /** Search while preserving the automatic ProofLoop evidence context. */
+  async searchWithProof(params) {
+    return this.client.post("/v1/search", {
+      query: params.query,
+      collection_id: params.collection_id,
+      user_id: params.user_id,
+      limit: params.limit || 10,
+      search_type: params.search_type || "hybrid",
+      filters: params.filters || {}
+    });
+  }
   /**
    * Find similar memories
    */
@@ -140,6 +151,30 @@ var SearchResource = class extends BaseResource {
     });
   }
 };
+var ProofLoopResource = class extends BaseResource {
+  /** Create a causal decision bound to search/chat evidence automatically. */
+  async decide(params) {
+    const context = params.proof_context;
+    const token = typeof context === "string" ? context : context?.token;
+    const { proof_context: _context, ...body } = params;
+    return this.client.post("/v1/learning/decisions", {
+      ...body,
+      ...token ? { proof_context_token: token } : {}
+    });
+  }
+  async recordOutcome(decisionId, body) {
+    return this.client.post(`/v1/learning/decisions/${decisionId}/outcomes`, {
+      observations: [],
+      ...body
+    });
+  }
+  async proof(decisionId) {
+    return this.client.get(`/v1/learning/decisions/${decisionId}/proof`);
+  }
+  async publicKey() {
+    return this.client.get("/v1/learning/proof-key");
+  }
+};
 var RLResource = class extends BaseResource {
   /**
    * Train the Memory Manager agent using RL
@@ -428,7 +463,7 @@ var ServerError = class _ServerError extends HebbrixError {
 var MemoryClient = class {
   constructor(config = {}) {
     this.apiKey = config.apiKey;
-    this.baseUrl = config.baseUrl || "https://memory-api.livelystone-78e9a45c.centralus.azurecontainerapps.io";
+    this.baseUrl = config.baseUrl || "https://api.hebbrix.com";
     this.timeout = config.timeout || 12e4;
     this.baseUrl = this.baseUrl.replace(/\/$/, "");
     this.auth = new AuthResource(this);
@@ -442,11 +477,12 @@ var MemoryClient = class {
     this.consolidation = new ConsolidationResource(this);
     this.memoryTools = new MemoryToolsResource(this);
     this.worldModel = new WorldModelResource(this);
+    this.proofloop = new ProofLoopResource(this);
   }
   getHeaders() {
     const headers = {
       "Content-Type": "application/json",
-      "User-Agent": "hebbrix-typescript/2.0.0"
+      "User-Agent": "hebbrix-typescript/2.1.0"
     };
     if (this.apiKey) {
       headers["Authorization"] = `Bearer ${this.apiKey}`;
@@ -524,6 +560,9 @@ var MemoryClient = class {
   async search(params) {
     return this.searchResource.search(params);
   }
+  async searchWithProof(params) {
+    return this.searchResource.searchWithProof(params);
+  }
   async reason(params) {
     return this.searchResource.reason(params);
   }
@@ -539,6 +578,7 @@ export {
   MemoryToolsResource,
   NotFoundError,
   ProceduralResource,
+  ProofLoopResource,
   RLResource,
   RateLimitError,
   SearchResource,

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "hebbrix",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Advanced Memory API for AI Agents with Reinforcement Learning - TypeScript/JavaScript SDK",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.js"
     }
   },
   "files": [
@@ -47,12 +47,15 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/hebbrix/hebbrix-typescript.git"
+    "url": "git+https://github.com/Hebbrix/hebbrix-typescript.git"
   },
   "bugs": {
     "url": "https://github.com/hebbrix/hebbrix-typescript/issues"
   },
   "homepage": "https://hebbrix.com",
+  "publishConfig": {
+    "access": "public"
+  },
   "devDependencies": {
     "@types/node": "^20.10.0",
     "@typescript-eslint/eslint-plugin": "^6.15.0",