hiloop-sdk 0.9.0 → 0.9.1

package/dist/client.d.ts

@@ -19,6 +19,13 @@ export interface HiloopClientOptions {
     apiKey: string;
     /** Agent name or UUID. Sent as X-Hiloop header to identify the agent. */
     agentName: string;
+    /**
+     * Space name. If provided, the SDK auto-creates the space on first use
+     * (idempotent — returns existing if slug matches). Requires a key with
+     * "owner" permission. The slug is derived from the name (lowercased,
+     * non-alphanumeric replaced with hyphens).
+     */
+    spaceName?: string;
     baseUrl?: string;
     /** Agent's X25519 secret key (base64). Required for E2E encryption. */
     secretKey?: string;
@@ -42,6 +49,8 @@ export declare class HiloopClient {
     private initialized;
     private initPromise;
     private options;
+    /** Cached spaceId after auto-creation resolves spaceName. */
+    private resolvedSpaceId;
     constructor(options: HiloopClientOptions);
     /**
      * Initialize encryption: derive keypair from API key, register public key,

package/dist/client.js

@@ -14,6 +14,8 @@ export class HiloopClient {
         this.publicKeyB64 = "";
         this.initialized = false;
         this.initPromise = null;
+        /** Cached spaceId after auto-creation resolves spaceName. */
+        this.resolvedSpaceId = null;
         this.apiKey = options.apiKey;
         this.baseUrl = (options.baseUrl ?? "https://api.hi-loop.com").replace(/\/$/, "");
         this.timeout = options.timeout ?? 30000;
@@ -43,6 +45,17 @@ export class HiloopClient {
         await this.initPromise;
     }
     async doInit() {
+        // 0. Auto-create space if spaceName is provided (idempotent)
+        if (this.options.spaceName && !this.resolvedSpaceId) {
+            const slug = this.options.spaceName.toLowerCase().replace(/[^a-z0-9]/g, "-").slice(0, 100);
+            try {
+                const space = await this.rawRequest("POST", "/org/spaces", { body: { name: this.options.spaceName, slug } });
+                this.resolvedSpaceId = space.id;
+            }
+            catch {
+                // Space creation failed — may not have owner permission, continue without
+            }
+        }
         // 1. Derive keypair from API key (or use provided keys)
         let secretKey = this.options.secretKey;
         let publicKey = this.options.publicKey;

package/package.json

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