hiloop-sdk 0.8.6 → 0.9.0

package/dist/client.d.ts

@@ -10,11 +10,15 @@ export interface SendOptions {
     priority?: string;
     deadlineMinutes?: number;
     replyToMessageId?: string;
+    /** Client-supplied correlation key (e.g. tool_use_id). Unique per session. */
+    referenceId?: string;
+    /** Resolve a referenceId to a message and set replyToMessageId automatically. */
+    replyToReferenceId?: string;
 }
 export interface HiloopClientOptions {
     apiKey: string;
-    /** Agent name. Auto-creates the agent if it doesn't exist (space API keys only). */
-    agentName?: string;
+    /** Agent name or UUID. Sent as X-Hiloop header to identify the agent. */
+    agentName: string;
     baseUrl?: string;
     /** Agent's X25519 secret key (base64). Required for E2E encryption. */
     secretKey?: string;

package/dist/client.js

@@ -15,10 +15,6 @@ export class HiloopClient {
         this.initialized = false;
         this.initPromise = null;
         this.apiKey = options.apiKey;
-        if (options.apiKey.startsWith("hlp_prov_")) {
-            throw new Error("Provisioning keys (hlp_prov_*) cannot be used with HiloopClient. " +
-                "Use the agent API key returned by POST /v1/provision/agents instead.");
-        }
         this.baseUrl = (options.baseUrl ?? "https://api.hi-loop.com").replace(/\/$/, "");
         this.timeout = options.timeout ?? 30000;
         this.options = options;
@@ -38,11 +34,7 @@ export class HiloopClient {
      * Initialize encryption: derive keypair from API key, register public key,
      * and fetch space encryption info. Called automatically on first API call.
      */
-    async ensureInitialized(agentName) {
-        // If an agentName is provided and we don't have one yet, store it for init
-        if (agentName && !this.options.agentName) {
-            this.options = { ...this.options, agentName };
-        }
+    async ensureInitialized() {
         if (this.initialized)
             return;
         if (this.initPromise)
@@ -96,14 +88,11 @@ export class HiloopClient {
     }
     /** Raw HTTP request without triggering auto-init (used during init itself). */
     buildHeaders(agentName) {
-        const h = {
+        return {
             "Content-Type": "application/json",
             "X-API-Key": this.apiKey,
+            "X-Hiloop": agentName ?? this.options.agentName,
         };
-        const agent = agentName ?? this.options.agentName;
-        if (agent)
-            h["X-Agent"] = agent;
-        return h;
     }
     async rawRequest(method, path, options) {
         const url = `${this.baseUrl}/v1${path}`;
@@ -319,7 +308,7 @@ export class HiloopClient {
     // -- Unified Message API ----------------------------------------------------
     /** Options for send / sendText. */
     async sendComponents(sessionId, components, opts) {
-        await this.ensureInitialized(opts?.agentName);
+        await this.ensureInitialized();
         const encryptedComponents = await this.crypto.encryptSessionMessage(JSON.stringify(components));
         const body = { encryptedComponents };
         // Extract metadata from components for server-side routing
@@ -335,6 +324,10 @@ export class HiloopClient {
             body.deadlineMinutes = opts.deadlineMinutes;
         if (opts?.replyToMessageId)
             body.replyToMessageId = opts.replyToMessageId;
+        if (opts?.referenceId)
+            body.referenceId = opts.referenceId;
+        if (opts?.replyToReferenceId)
+            body.replyToReferenceId = opts.replyToReferenceId;
         const data = await this.request("POST", `/agent/sessions/${sessionId}/messages`, { body, agentName: opts?.agentName });
         return parseSessionMessage(data);
     }

package/dist/types.d.ts

@@ -139,6 +139,7 @@ export interface SessionMessage {
     priority?: string | null;
     status?: string | null;
     deadlineAt?: string | null;
+    referenceId?: string | null;
     replyToMessageId?: string | null;
     respondedAt?: string | null;
     viewedAt?: string | null;

package/dist/types.js

@@ -100,6 +100,7 @@ export function parseSessionMessage(data) {
         priority: m.priority ?? null,
         status: m.status ?? null,
         deadlineAt: m.deadlineAt ?? null,
+        referenceId: m.referenceId ?? null,
         replyToMessageId: m.replyToMessageId ?? null,
         respondedAt: m.respondedAt ?? null,
         viewedAt: m.viewedAt ?? null,

package/dist/ws.d.ts

@@ -3,7 +3,7 @@
  *
  * Usage:
  *   const ws = new HiloopWsClient({
- *     apiKey: "hlp_space_...",
+ *     apiKey: "hlp_...",
  *     agentName: "my-bot",
  *   });
  *   ws.on("session.message.new", (msg) => console.log(msg.content));
@@ -13,8 +13,8 @@
  */
 export interface HiloopWsClientOptions {
     apiKey: string;
-    /** Agent name (required for space API keys, auto-creates if needed). */
-    agentName?: string;
+    /** Agent name or UUID. Sent as X-Hiloop header and query param. */
+    agentName: string;
     baseUrl?: string;
     /** Auto-reconnect on disconnect (default: true). */
     autoReconnect?: boolean;

package/dist/ws.js

@@ -3,7 +3,7 @@
  *
  * Usage:
  *   const ws = new HiloopWsClient({
- *     apiKey: "hlp_space_...",
+ *     apiKey: "hlp_...",
  *     agentName: "my-bot",
  *   });
  *   ws.on("session.message.new", (msg) => console.log(msg.content));
@@ -41,8 +41,7 @@ export class HiloopWsClient {
             "X-API-Key": this.options.apiKey,
             "Content-Type": "application/json",
         };
-        if (this.options.agentName)
-            headers["X-Agent"] = this.options.agentName;
+        headers["X-Hiloop"] = this.options.agentName;
         // Register public key
         const fingerprint = await computeFingerprint(kp.publicKey);
         try {
@@ -70,9 +69,7 @@ export class HiloopWsClient {
         return new Promise((resolve, reject) => {
             const baseUrl = (this.options.baseUrl ?? "https://api.hi-loop.com").replace(/\/$/, "");
             const wsUrl = baseUrl.replace(/^http/, "ws");
-            const params = new URLSearchParams({ key: this.options.apiKey });
-            if (this.options.agentName)
-                params.set("agent", this.options.agentName);
+            const params = new URLSearchParams({ key: this.options.apiKey, agent: this.options.agentName });
             this.ws = new WebSocket(`${wsUrl}/v1/agent/ws?${params}`);
             this.ws.onopen = () => {
                 this.reconnectAttempts = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hiloop-sdk",
-  "version": "0.8.6",
+  "version": "0.9.0",
   "description": "TypeScript SDK for Hiloop — zero-trust human-AI agent interaction platform",
   "type": "module",
   "main": "dist/index.js",