hiloop-sdk 0.2.0 → 0.3.0

package/dist/client.d.ts

@@ -7,6 +7,8 @@ export declare class HiloopError extends Error {
 }
 export interface HiloopClientOptions {
     apiKey: string;
+    /** Agent name. Auto-creates the agent if it doesn't exist (space API keys only). */
+    agentName?: string;
     baseUrl?: string;
     /** Agent's X25519 secret key (base64). Required for E2E encryption. */
     secretKey?: string;
@@ -38,6 +40,7 @@ export declare class HiloopClient {
     private ensureInitialized;
     private doInit;
     /** Raw HTTP request without triggering auto-init (used during init itself). */
+    private buildHeaders;
     private rawRequest;
     private encryptField;
     /**

package/dist/client.js

@@ -87,15 +87,20 @@ export class HiloopClient {
         this.initialized = true;
     }
     /** Raw HTTP request without triggering auto-init (used during init itself). */
-    async rawRequest(method, path, options) {
-        const url = `${this.baseUrl}/v1${path}`;
-        const headers = {
+    buildHeaders() {
+        const h = {
             "Content-Type": "application/json",
             "X-API-Key": this.apiKey,
         };
+        if (this.options.agentName)
+            h["X-Agent"] = this.options.agentName;
+        return h;
+    }
+    async rawRequest(method, path, options) {
+        const url = `${this.baseUrl}/v1${path}`;
         const res = await fetch(url, {
             method,
-            headers,
+            headers: this.buildHeaders(),
             body: options?.body ? JSON.stringify(options.body) : undefined,
         });
         if (!res.ok) {
@@ -115,6 +120,7 @@ export class HiloopClient {
      * with the same (scope, recipientKeyId) are silently dropped.
      */
     async encryptFields(fields) {
+        await this.ensureInitialized();
         const encrypted = {};
         const entries = Object.entries(fields).filter(([, v]) => v !== undefined);
         if (entries.length === 0)
@@ -158,10 +164,7 @@ export class HiloopClient {
         try {
             const res = await fetch(url, {
                 method,
-                headers: {
-                    "X-API-Key": this.apiKey,
-                    "Content-Type": "application/json",
-                },
+                headers: this.buildHeaders(),
                 body: options?.body !== undefined ? JSON.stringify(options.body) : undefined,
                 signal: controller.signal,
             });
@@ -184,7 +187,7 @@ export class HiloopClient {
         try {
             const res = await fetch(url, {
                 method: "GET",
-                headers: { "X-API-Key": this.apiKey },
+                headers: this.buildHeaders(),
                 signal: controller.signal,
             });
             if (!res.ok) {
@@ -358,6 +361,7 @@ export class HiloopClient {
     }
     /** Push content blocks to an interaction. */
     async pushContentBlocks(interactionId, blocks) {
+        await this.ensureInitialized();
         const encryptedBlocks = await Promise.all(blocks.map(async (block) => {
             const plaintext = JSON.stringify(block.data);
             const wrapped = await this.crypto.encryptWithWrapping(plaintext);
@@ -488,6 +492,7 @@ export class HiloopClient {
     }
     // -- Conversation Sessions -------------------------------------------------
     async createConvSession(opts) {
+        await this.ensureInitialized();
         const body = {
             sessionType: opts.sessionType ?? "direct",
             isPublic: opts.isPublic ?? false,
@@ -547,6 +552,7 @@ export class HiloopClient {
      * using the session message key (`{agentPub}:{AES-GCM ciphertext}` format).
      */
     async sendConvSessionMessage(sessionId, content) {
+        await this.ensureInitialized();
         const encryptedContent = await this.crypto.encryptSessionMessage(content);
         const data = await this.request("POST", `/agent/sessions/${sessionId}/messages`, { body: { encryptedContent } });
         return parseConvSessionMessage(data);
@@ -1039,6 +1045,7 @@ export class HiloopClient {
     // -- Channels ---------------------------------------------------------------
     /** Create a new agent-to-agent channel. */
     async createChannel(opts) {
+        await this.ensureInitialized();
         const body = {};
         if (opts.name !== undefined) {
             const w = await this.crypto.encryptWithWrapping(opts.name);
@@ -1095,6 +1102,7 @@ export class HiloopClient {
     }
     /** Send a message in a channel. */
     async sendChannelMessage(channelId, content) {
+        await this.ensureInitialized();
         const wrapped = await this.crypto.encryptWithWrapping(content);
         const body = {
             encryptedContent: wrapped.ciphertext,

package/package.json

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