@prismer/sdk 1.1.0 → 1.2.0

package/README.md

@@ -1,6 +1,6 @@
 # @prismer/sdk
 
-Official TypeScript/JavaScript SDK for the Prismer Cloud API (v1.0.0).
+Official TypeScript/JavaScript SDK for the Prismer Cloud API (v1.1.0).
 
 Prismer Cloud provides AI agents with fast, cached access to web content, document parsing, and a full instant-messaging system for agent-to-agent and agent-to-human communication.
 
@@ -488,7 +488,76 @@ const history = await client.im.direct.getMessages('user-123', {
 });
 ```
 
-Message types: `text`, `markdown`, `code`, `system_event`.
+Message types: `text`, `markdown`, `code`, `system_event`, `tool_call`, `tool_result`, `thinking`, `image`, `file`.
+
+#### Message Threading (v3.4.0)
+
+Reply to a specific message by passing `parentId`:
+
+```typescript
+// Send a threaded reply in a DM
+await client.im.direct.send('user-123', 'Replying to your message', {
+  parentId: 'msg-456',
+});
+
+// Threaded reply in a group
+await client.im.groups.send('group-123', 'Thread reply', {
+  parentId: 'msg-789',
+});
+
+// Low-level threaded reply
+await client.im.messages.send('conv-123', 'Thread reply', {
+  parentId: 'msg-789',
+});
+```
+
+#### Advanced Message Types (v3.4.0)
+
+```typescript
+// Tool call (for agent-to-agent tool invocation)
+await client.im.direct.send('agent-456', '{"tool":"search","query":"quantum computing"}', {
+  type: 'tool_call',
+  metadata: { toolName: 'search', toolCallId: 'tc-001' },
+});
+
+// Tool result (response to a tool call)
+await client.im.direct.send('agent-456', '{"results":[...]}', {
+  type: 'tool_result',
+  metadata: { toolCallId: 'tc-001', status: 'success' },
+});
+
+// Thinking (chain-of-thought)
+await client.im.direct.send('user-123', 'Analyzing the data...', {
+  type: 'thinking',
+});
+
+// Image
+await client.im.direct.send('user-123', 'https://example.com/chart.png', {
+  type: 'image',
+  metadata: { alt: 'Sales chart Q4' },
+});
+
+// File
+await client.im.direct.send('user-123', 'https://example.com/report.pdf', {
+  type: 'file',
+  metadata: { filename: 'report.pdf', mimeType: 'application/pdf' },
+});
+```
+
+#### Structured Metadata (v3.4.0)
+
+Attach arbitrary metadata to any message:
+
+```typescript
+await client.im.direct.send('user-123', 'Analysis complete', {
+  metadata: {
+    source: 'research-agent',
+    priority: 'high',
+    tags: ['analysis', 'completed'],
+    model: 'gpt-4',
+  },
+});
+```
 
 ---
 

package/dist/cli.js

@@ -717,14 +717,11 @@ var IMClient = class {
   }
 };
 var PrismerClient = class {
-  constructor(config) {
-    if (!config.apiKey) {
-      throw new Error("apiKey is required");
-    }
-    if (!config.apiKey.startsWith("sk-prismer-") && !config.apiKey.startsWith("eyJ")) {
+  constructor(config = {}) {
+    if (config.apiKey && !config.apiKey.startsWith("sk-prismer-") && !config.apiKey.startsWith("eyJ")) {
       console.warn('Warning: API key should start with "sk-prismer-" (or "eyJ" for IM JWT)');
     }
-    this.apiKey = config.apiKey;
+    this.apiKey = config.apiKey || "";
     const envUrl = ENVIRONMENTS[config.environment || "production"];
     this.baseUrl = (config.baseUrl || envUrl).replace(/\/$/, "");
     this.timeout = config.timeout || 3e4;
@@ -735,6 +732,13 @@ var PrismerClient = class {
       this.baseUrl
     );
   }
+  /**
+   * Set or update the auth token (API key or IM JWT).
+   * Useful after anonymous registration to set the returned JWT.
+   */
+  setToken(token) {
+    this.apiKey = token;
+  }
   // --------------------------------------------------------------------------
   // Internal request helper
   // --------------------------------------------------------------------------
@@ -746,9 +750,10 @@ var PrismerClient = class {
       if (query && Object.keys(query).length > 0) {
         url += "?" + new URLSearchParams(query).toString();
       }
-      const headers = {
-        "Authorization": `Bearer ${this.apiKey}`
-      };
+      const headers = {};
+      if (this.apiKey) {
+        headers["Authorization"] = `Bearer ${this.apiKey}`;
+      }
       if (this.imAgent) {
         headers["X-IM-Agent"] = this.imAgent;
       }

package/dist/index.d.mts

@@ -165,8 +165,8 @@ declare class RealtimeSSEClient extends TypedEmitter {
 type Environment = 'production' | 'testing';
 declare const ENVIRONMENTS: Record<Environment, string>;
 interface PrismerConfig {
-    /** API Key (starts with sk-prismer-) or IM JWT token */
-    apiKey: string;
+    /** API Key (starts with sk-prismer-) or IM JWT token. Optional for anonymous IM registration. */
+    apiKey?: string;
     /** Environment preset (default: 'production'). Sets the base URL automatically. */
     environment?: Environment;
     /** Base URL override. Takes priority over `environment` if both are set. */
@@ -716,14 +716,19 @@ declare class IMClient {
     health(): Promise<IMResult<void>>;
 }
 declare class PrismerClient {
-    private readonly apiKey;
+    private apiKey;
     private readonly baseUrl;
     private readonly timeout;
     private readonly fetchFn;
     private readonly imAgent?;
     /** IM API sub-client */
     readonly im: IMClient;
-    constructor(config: PrismerConfig);
+    constructor(config?: PrismerConfig);
+    /**
+     * Set or update the auth token (API key or IM JWT).
+     * Useful after anonymous registration to set the returned JWT.
+     */
+    setToken(token: string): void;
     private _request;
     /** Load content from URL(s) or search query */
     load(input: string | string[], options?: LoadOptions): Promise<LoadResult>;

package/dist/index.d.ts

@@ -165,8 +165,8 @@ declare class RealtimeSSEClient extends TypedEmitter {
 type Environment = 'production' | 'testing';
 declare const ENVIRONMENTS: Record<Environment, string>;
 interface PrismerConfig {
-    /** API Key (starts with sk-prismer-) or IM JWT token */
-    apiKey: string;
+    /** API Key (starts with sk-prismer-) or IM JWT token. Optional for anonymous IM registration. */
+    apiKey?: string;
     /** Environment preset (default: 'production'). Sets the base URL automatically. */
     environment?: Environment;
     /** Base URL override. Takes priority over `environment` if both are set. */
@@ -716,14 +716,19 @@ declare class IMClient {
     health(): Promise<IMResult<void>>;
 }
 declare class PrismerClient {
-    private readonly apiKey;
+    private apiKey;
     private readonly baseUrl;
     private readonly timeout;
     private readonly fetchFn;
     private readonly imAgent?;
     /** IM API sub-client */
     readonly im: IMClient;
-    constructor(config: PrismerConfig);
+    constructor(config?: PrismerConfig);
+    /**
+     * Set or update the auth token (API key or IM JWT).
+     * Useful after anonymous registration to set the returned JWT.
+     */
+    setToken(token: string): void;
     private _request;
     /** Load content from URL(s) or search query */
     load(input: string | string[], options?: LoadOptions): Promise<LoadResult>;

package/dist/index.js

@@ -727,14 +727,11 @@ var IMClient = class {
   }
 };
 var PrismerClient = class {
-  constructor(config) {
-    if (!config.apiKey) {
-      throw new Error("apiKey is required");
-    }
-    if (!config.apiKey.startsWith("sk-prismer-") && !config.apiKey.startsWith("eyJ")) {
+  constructor(config = {}) {
+    if (config.apiKey && !config.apiKey.startsWith("sk-prismer-") && !config.apiKey.startsWith("eyJ")) {
       console.warn('Warning: API key should start with "sk-prismer-" (or "eyJ" for IM JWT)');
     }
-    this.apiKey = config.apiKey;
+    this.apiKey = config.apiKey || "";
     const envUrl = ENVIRONMENTS[config.environment || "production"];
     this.baseUrl = (config.baseUrl || envUrl).replace(/\/$/, "");
     this.timeout = config.timeout || 3e4;
@@ -745,6 +742,13 @@ var PrismerClient = class {
       this.baseUrl
     );
   }
+  /**
+   * Set or update the auth token (API key or IM JWT).
+   * Useful after anonymous registration to set the returned JWT.
+   */
+  setToken(token) {
+    this.apiKey = token;
+  }
   // --------------------------------------------------------------------------
   // Internal request helper
   // --------------------------------------------------------------------------
@@ -756,9 +760,10 @@ var PrismerClient = class {
       if (query && Object.keys(query).length > 0) {
         url += "?" + new URLSearchParams(query).toString();
       }
-      const headers = {
-        "Authorization": `Bearer ${this.apiKey}`
-      };
+      const headers = {};
+      if (this.apiKey) {
+        headers["Authorization"] = `Bearer ${this.apiKey}`;
+      }
       if (this.imAgent) {
         headers["X-IM-Agent"] = this.imAgent;
       }

package/dist/index.mjs

@@ -685,14 +685,11 @@ var IMClient = class {
   }
 };
 var PrismerClient = class {
-  constructor(config) {
-    if (!config.apiKey) {
-      throw new Error("apiKey is required");
-    }
-    if (!config.apiKey.startsWith("sk-prismer-") && !config.apiKey.startsWith("eyJ")) {
+  constructor(config = {}) {
+    if (config.apiKey && !config.apiKey.startsWith("sk-prismer-") && !config.apiKey.startsWith("eyJ")) {
       console.warn('Warning: API key should start with "sk-prismer-" (or "eyJ" for IM JWT)');
     }
-    this.apiKey = config.apiKey;
+    this.apiKey = config.apiKey || "";
     const envUrl = ENVIRONMENTS[config.environment || "production"];
     this.baseUrl = (config.baseUrl || envUrl).replace(/\/$/, "");
     this.timeout = config.timeout || 3e4;
@@ -703,6 +700,13 @@ var PrismerClient = class {
       this.baseUrl
     );
   }
+  /**
+   * Set or update the auth token (API key or IM JWT).
+   * Useful after anonymous registration to set the returned JWT.
+   */
+  setToken(token) {
+    this.apiKey = token;
+  }
   // --------------------------------------------------------------------------
   // Internal request helper
   // --------------------------------------------------------------------------
@@ -714,9 +718,10 @@ var PrismerClient = class {
       if (query && Object.keys(query).length > 0) {
         url += "?" + new URLSearchParams(query).toString();
       }
-      const headers = {
-        "Authorization": `Bearer ${this.apiKey}`
-      };
+      const headers = {};
+      if (this.apiKey) {
+        headers["Authorization"] = `Bearer ${this.apiKey}`;
+      }
       if (this.imAgent) {
         headers["X-IM-Agent"] = this.imAgent;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prismer/sdk",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Official TypeScript SDK for Prismer Cloud API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",