clinch-core 0.3.0 → 0.5.0

package/dist/index.d.ts

@@ -51,6 +51,7 @@ export declare class ClinchCore extends EventEmitter {
     private isSandboxMode;
     private sandboxModelContext;
     private sandboxMaxTurns;
+    get activeNegotiationId(): string | null;
     constructor(config?: ClinchConfig);
     private setStatus;
     initialize(cachedToken?: string): Promise<void>;
@@ -83,6 +84,7 @@ export interface SellerRecord {
     supported_modes: string[];
     categories: string[];
     capabilities: string[];
+    display_name?: string;
 }
 export declare class ClinchSeller extends EventEmitter {
     private config;

package/dist/index.js

@@ -50,7 +50,12 @@ function toHex(arr) {
     return Array.from(arr).map(b => b.toString(16).padStart(2, '0')).join('');
 }
 function fromHex(hex) {
-    return new Uint8Array(hex.match(/.{1,2}/g).map(byte => parseInt(byte, 16)));
+    // Strips all spaces, newlines, and rogue quotes from .env strings
+    const clean = hex.replace(/[^0-9a-fA-F]/g, '');
+    const match = clean.match(/.{1,2}/g);
+    if (!match)
+        return new Uint8Array(0);
+    return new Uint8Array(match.map(byte => parseInt(byte, 16)));
 }
 // ============================================================================
 // THE CLINCH CORE LIBRARY (Buyer)
@@ -66,10 +71,12 @@ class ClinchCore extends events_1.EventEmitter {
     identityPubKey;
     activeSessions = new Map();
     ws = null;
-    // Sandbox Engine Base (Model/Context are global, Sequences are per-session)
     isSandboxMode = false;
     sandboxModelContext = null;
     sandboxMaxTurns = 6;
+    get activeNegotiationId() {
+        return Array.from(this.activeSessions.keys()).pop() || null;
+    }
     constructor(config = {}) {
         super();
         this.config = { timeoutMs: 5000, ...config };
@@ -224,9 +231,6 @@ class ClinchCore extends events_1.EventEmitter {
             this.ws = null;
         }
     }
-    // --------------------------------------------------------------------------
-    // SESSION STATE MANAGEMENT (For Enterprise Horizontal Scaling & Reconnects)
-    // --------------------------------------------------------------------------
     exportSessionState(sessionId) {
         const session = this.activeSessions.get(sessionId);
         if (!session)
@@ -262,9 +266,6 @@ class ClinchCore extends events_1.EventEmitter {
     getSession(sessionId) {
         return this.activeSessions.get(sessionId);
     }
-    // --------------------------------------------------------------------------
-    // UNIVERSAL PROMPT BUILDER
-    // --------------------------------------------------------------------------
     buildAgentPrompt(sessionId, incomingMessage) {
         const session = this.activeSessions.get(sessionId);
         if (!session)
@@ -299,9 +300,6 @@ You MUST respond ONLY in valid JSON matching this exact schema. Do not include m
   "message": "<One concise sentence of negotiation dialogue>"
 }`;
     }
-    // --------------------------------------------------------------------------
-    // PROTOCOL OPERATIONS
-    // --------------------------------------------------------------------------
     async search(query, mode) {
         let url = `/api/discover?category=${encodeURIComponent(query)}`;
         if (mode)
@@ -351,7 +349,6 @@ You MUST respond ONLY in valid JSON matching this exact schema. Do not include m
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify({ ...payload, buyer_sig })
         });
-        // Sync state if deal reached
         if (response.msg_type === 'accept' || response.status === 'COMMITTED') {
             session.status = 'CLOSED';
             session.lastKnownPrice = response.price || price;
@@ -371,9 +368,6 @@ You MUST respond ONLY in valid JSON matching this exact schema. Do not include m
         session.exitTokenHash = res.token_hash;
         return res.token_hash;
     }
-    // --------------------------------------------------------------------------
-    // OUT-OF-THE-BOX SANDBOX (AUTO-TURN ENGINE)
-    // --------------------------------------------------------------------------
     async sandbox(config = {}) {
         this.isSandboxMode = true;
         this.sandboxMaxTurns = config.maxTurns || 6;
@@ -388,7 +382,7 @@ You MUST respond ONLY in valid JSON matching this exact schema. Do not include m
     }
     async setupSandbox(config = {}) {
         if (this.sandboxModelContext)
-            return; // Already initialized
+            return;
         const settings = {
             downloadLLM: true,
             modelUrl: "https://huggingface.co/Qwen/Qwen2.5-1.5B-Instruct-GGUF/resolve/main/qwen2.5-1.5b-instruct-q4_k_m.gguf",
@@ -471,7 +465,6 @@ You MUST respond ONLY in valid JSON matching this exact schema. Do not include m
     async sandboxEvaluate(session, incomingOffer) {
         const { LlamaChatSession, ChatMLChatWrapper } = await Promise.resolve().then(() => __importStar(require('node-llama-cpp')));
         const systemPrompt = this.buildAgentPrompt(session.sessionId, incomingOffer);
-        // State Isolation: Bind sequence to the session, not the global class!
         if (!session.sandboxSequence) {
             session.sandboxSequence = this.sandboxModelContext.getSequence();
             session.sandboxSession = new LlamaChatSession({
@@ -487,9 +480,6 @@ You MUST respond ONLY in valid JSON matching this exact schema. Do not include m
         });
         return responseText;
     }
-    // --------------------------------------------------------------------------
-    // UTILITIES
-    // --------------------------------------------------------------------------
     extractPrice(text, prefix) {
         const regex = new RegExp(`${prefix}\\s*\\:?\\s*\\$?(\\d+(?:\\.\\d{2})?)`, 'i');
         const match = text.match(regex);
@@ -546,10 +536,19 @@ class ClinchSeller extends events_1.EventEmitter {
         super();
         this.config = { timeoutMs: 8000, ...config };
         if (config.privateKeyHex) {
-            this.identityPrivKey = fromHex(config.privateKeyHex);
-            const kp = tweetnacl_1.default.sign.keyPair.fromSecretKey(this.identityPrivKey);
-            this.identityPubKey = toHex(kp.publicKey);
-            this.emit('log', `[Seller] Loaded permanent identity. PubKey: ${this.identityPubKey.substring(0, 12)}...`);
+            try {
+                const cleanHex = config.privateKeyHex.replace(/[^0-9a-fA-F]/g, '');
+                if (cleanHex.length !== 128) {
+                    throw new Error(`Expected 128 hex chars (64 bytes), got ${cleanHex.length}`);
+                }
+                this.identityPrivKey = fromHex(cleanHex);
+                const kp = tweetnacl_1.default.sign.keyPair.fromSecretKey(this.identityPrivKey);
+                this.identityPubKey = toHex(kp.publicKey);
+                this.emit('log', `[Seller] Loaded permanent identity. PubKey: ${this.identityPubKey.substring(0, 12)}...`);
+            }
+            catch (e) {
+                throw new Error(`[Seller] Invalid privateKeyHex in constructor: ${e.message}`);
+            }
         }
         else {
             const kp = tweetnacl_1.default.sign.keyPair();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clinch-core",
-  "version": "0.3.0",
+  "version": "0.5.0",
 
   "description": "Clinch Protocol Edge Client",
   "main": "dist/index.js",

package/src/index.ts

@@ -14,7 +14,11 @@ function toHex(arr: Uint8Array | number[]): string {
 }
 
 function fromHex(hex: string): Uint8Array {
-    return new Uint8Array(hex.match(/.{1,2}/g)!.map(byte => parseInt(byte, 16)));
+    // Strips all spaces, newlines, and rogue quotes from .env strings
+    const clean = hex.replace(/[^0-9a-fA-F]/g, '');
+    const match = clean.match(/.{1,2}/g);
+    if (!match) return new Uint8Array(0);
+    return new Uint8Array(match.map(byte => parseInt(byte, 16)));
 }
 
 // ============================================================================
@@ -56,11 +60,9 @@ export interface SessionState {
     exitTokenHash?: string;
     constraints: ConstraintVector;
     
-    // Isolated State Tracking (Crucial for concurrency)
     currentTurn: number;
     lastKnownPrice: number;
 
-    // Local LLM Context Tracking
     sandboxSequence?: any; 
     sandboxSession?: any;
 }
@@ -95,11 +97,14 @@ export class ClinchCore extends EventEmitter {
     private activeSessions = new Map<string, SessionState>();
     private ws: WebSocket | null = null;
 
-    // Sandbox Engine Base (Model/Context are global, Sequences are per-session)
     private isSandboxMode = false;
     private sandboxModelContext: any = null;
     private sandboxMaxTurns = 6;
 
+    public get activeNegotiationId(): string | null {
+        return Array.from(this.activeSessions.keys()).pop() || null;
+    }
+
     constructor(config: ClinchConfig = {}) {
         super();
         this.config = { timeoutMs: 5000, ...config };
@@ -261,9 +266,6 @@ export class ClinchCore extends EventEmitter {
         if (this.ws) { this.ws.close(); this.ws = null; }
     }
 
-    // --------------------------------------------------------------------------
-    // SESSION STATE MANAGEMENT (For Enterprise Horizontal Scaling & Reconnects)
-    // --------------------------------------------------------------------------
     public exportSessionState(sessionId: string): string {
         const session = this.activeSessions.get(sessionId);
         if (!session) throw new Error("Session not found");
@@ -284,7 +286,6 @@ export class ClinchCore extends EventEmitter {
 
     public importSessionState(serializedData: string): void {
         const data = JSON.parse(serializedData);
-        
         const secretKey = fromHex(data.ephemeralSecretKeyHex);
         const keyPair = nacl.sign.keyPair.fromSecretKey(secretKey);
 
@@ -306,9 +307,6 @@ export class ClinchCore extends EventEmitter {
         return this.activeSessions.get(sessionId);
     }
 
-    // --------------------------------------------------------------------------
-    // UNIVERSAL PROMPT BUILDER
-    // --------------------------------------------------------------------------
     public buildAgentPrompt(sessionId: string, incomingMessage: string): string {
         const session = this.activeSessions.get(sessionId);
         if (!session) throw new Error("Cannot build prompt: Session not found.");
@@ -345,9 +343,6 @@ You MUST respond ONLY in valid JSON matching this exact schema. Do not include m
 }`;
     }
 
-    // --------------------------------------------------------------------------
-    // PROTOCOL OPERATIONS
-    // --------------------------------------------------------------------------
     async search(query: string, mode?: string): Promise<any> {
         let url = `/api/discover?category=${encodeURIComponent(query)}`;
         if (mode) url += `&mode=${encodeURIComponent(mode)}`;
@@ -409,7 +404,6 @@ You MUST respond ONLY in valid JSON matching this exact schema. Do not include m
             body: JSON.stringify({ ...payload, buyer_sig })
         });
 
-        // Sync state if deal reached
         if (response.msg_type === 'accept' || response.status === 'COMMITTED') {
             session.status = 'CLOSED';
             session.lastKnownPrice = response.price || price;
@@ -432,9 +426,6 @@ You MUST respond ONLY in valid JSON matching this exact schema. Do not include m
         return res.token_hash;
     }
 
-    // --------------------------------------------------------------------------
-    // OUT-OF-THE-BOX SANDBOX (AUTO-TURN ENGINE)
-    // --------------------------------------------------------------------------
     async sandbox(config: SandboxConfig = {}): Promise<void> {
         this.isSandboxMode = true;
         this.sandboxMaxTurns = config.maxTurns || 6;
@@ -450,7 +441,7 @@ You MUST respond ONLY in valid JSON matching this exact schema. Do not include m
     }
 
     private async setupSandbox(config: SandboxConfig = {}): Promise<void> {
-        if (this.sandboxModelContext) return; // Already initialized
+        if (this.sandboxModelContext) return; 
 
         const settings = {
             downloadLLM: true,
@@ -541,7 +532,6 @@ You MUST respond ONLY in valid JSON matching this exact schema. Do not include m
 
         const systemPrompt = this.buildAgentPrompt(session.sessionId, incomingOffer);
 
-        // State Isolation: Bind sequence to the session, not the global class!
         if (!session.sandboxSequence) {
             session.sandboxSequence = this.sandboxModelContext.getSequence();
             session.sandboxSession = new LlamaChatSession({
@@ -560,9 +550,6 @@ You MUST respond ONLY in valid JSON matching this exact schema. Do not include m
         return responseText;
     }
 
-    // --------------------------------------------------------------------------
-    // UTILITIES
-    // --------------------------------------------------------------------------
     private extractPrice(text: string, prefix: string): number | null {
         const regex = new RegExp(`${prefix}\\s*\\:?\\s*\\$?(\\d+(?:\\.\\d{2})?)`, 'i');
         const match = text.match(regex);
@@ -618,6 +605,7 @@ export interface SellerRecord {
   supported_modes: string[];
   categories:      string[];
   capabilities:    string[];
+  display_name?:   string; 
 }
 
 export class ClinchSeller extends EventEmitter {
@@ -631,10 +619,18 @@ export class ClinchSeller extends EventEmitter {
     this.config = { timeoutMs: 8000, ...config };
 
     if (config.privateKeyHex) {
-      this.identityPrivKey = fromHex(config.privateKeyHex);
-      const kp = nacl.sign.keyPair.fromSecretKey(this.identityPrivKey);
-      this.identityPubKey = toHex(kp.publicKey);
-      this.emit('log', `[Seller] Loaded permanent identity. PubKey: ${this.identityPubKey.substring(0, 12)}...`);
+      try {
+        const cleanHex = config.privateKeyHex.replace(/[^0-9a-fA-F]/g, '');
+        if (cleanHex.length !== 128) {
+            throw new Error(`Expected 128 hex chars (64 bytes), got ${cleanHex.length}`);
+        }
+        this.identityPrivKey = fromHex(cleanHex);
+        const kp = nacl.sign.keyPair.fromSecretKey(this.identityPrivKey);
+        this.identityPubKey = toHex(kp.publicKey);
+        this.emit('log', `[Seller] Loaded permanent identity. PubKey: ${this.identityPubKey.substring(0, 12)}...`);
+      } catch (e: any) {
+        throw new Error(`[Seller] Invalid privateKeyHex in constructor: ${e.message}`);
+      }
     } else {
       const kp = nacl.sign.keyPair();
       this.identityPrivKey = kp.secretKey;