@prismer/sdk 1.0.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

@@ -490,7 +490,8 @@ var DirectClient = class {
     return this._r("POST", `/api/im/direct/${userId}/messages`, {
       content,
       type: options?.type ?? "text",
-      metadata: options?.metadata
+      metadata: options?.metadata,
+      parentId: options?.parentId
     });
   }
   /** Get direct message history with a user */
@@ -522,7 +523,8 @@ var GroupsClient = class {
     return this._r("POST", `/api/im/groups/${groupId}/messages`, {
       content,
       type: options?.type ?? "text",
-      metadata: options?.metadata
+      metadata: options?.metadata,
+      parentId: options?.parentId
     });
   }
   /** Get group message history */
@@ -574,7 +576,8 @@ var MessagesClient = class {
     return this._r("POST", `/api/im/messages/${conversationId}`, {
       content,
       type: options?.type ?? "text",
-      metadata: options?.metadata
+      metadata: options?.metadata,
+      parentId: options?.parentId
     });
   }
   /** Get message history for a conversation */
@@ -714,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;
@@ -732,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
   // --------------------------------------------------------------------------
@@ -743,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. */
@@ -179,7 +179,7 @@ interface PrismerConfig {
     imAgent?: string;
 }
 interface LoadOptions {
-    inputType?: 'url' | 'urls' | 'query';
+    inputType?: 'auto' | 'url' | 'urls' | 'query';
     processUncached?: boolean;
     search?: {
         topK?: number;
@@ -392,6 +392,8 @@ interface IMMeData {
     agentCard?: IMAgentCard;
     stats: {
         conversationCount: number;
+        directCount?: number;
+        groupCount?: number;
         contactCount: number;
         messagesSent: number;
         unreadCount: number;
@@ -412,11 +414,15 @@ interface IMTokenData {
 }
 interface IMMessage {
     id: string;
+    conversationId?: string;
     content: string;
     type: string;
     senderId: string;
+    parentId?: string | null;
+    status?: string;
     createdAt: string;
-    metadata?: Record<string, any>;
+    updatedAt?: string;
+    metadata?: Record<string, any> | string;
 }
 interface IMRouting {
     mode: string;
@@ -433,6 +439,7 @@ interface IMMessageData {
 interface IMGroupMember {
     userId: string;
     username: string;
+    displayName?: string;
     role: string;
 }
 interface IMGroupData {
@@ -504,7 +511,8 @@ interface IMAutocompleteResult {
 interface IMCreateGroupOptions {
     title: string;
     description?: string;
-    members: string[];
+    members?: string[];
+    metadata?: Record<string, any>;
 }
 interface IMCreateBindingOptions {
     platform: 'telegram' | 'discord' | 'slack' | 'wechat' | 'x' | 'line';
@@ -513,8 +521,9 @@ interface IMCreateBindingOptions {
     channelId?: string;
 }
 interface IMSendOptions {
-    type?: 'text' | 'markdown' | 'code' | 'system_event';
+    type?: 'text' | 'markdown' | 'code' | 'image' | 'file' | 'tool_call' | 'tool_result' | 'system_event' | 'thinking';
     metadata?: Record<string, any>;
+    parentId?: string;
 }
 interface IMPaginationOptions {
     limit?: number;
@@ -707,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. */
@@ -179,7 +179,7 @@ interface PrismerConfig {
     imAgent?: string;
 }
 interface LoadOptions {
-    inputType?: 'url' | 'urls' | 'query';
+    inputType?: 'auto' | 'url' | 'urls' | 'query';
     processUncached?: boolean;
     search?: {
         topK?: number;
@@ -392,6 +392,8 @@ interface IMMeData {
     agentCard?: IMAgentCard;
     stats: {
         conversationCount: number;
+        directCount?: number;
+        groupCount?: number;
         contactCount: number;
         messagesSent: number;
         unreadCount: number;
@@ -412,11 +414,15 @@ interface IMTokenData {
 }
 interface IMMessage {
     id: string;
+    conversationId?: string;
     content: string;
     type: string;
     senderId: string;
+    parentId?: string | null;
+    status?: string;
     createdAt: string;
-    metadata?: Record<string, any>;
+    updatedAt?: string;
+    metadata?: Record<string, any> | string;
 }
 interface IMRouting {
     mode: string;
@@ -433,6 +439,7 @@ interface IMMessageData {
 interface IMGroupMember {
     userId: string;
     username: string;
+    displayName?: string;
     role: string;
 }
 interface IMGroupData {
@@ -504,7 +511,8 @@ interface IMAutocompleteResult {
 interface IMCreateGroupOptions {
     title: string;
     description?: string;
-    members: string[];
+    members?: string[];
+    metadata?: Record<string, any>;
 }
 interface IMCreateBindingOptions {
     platform: 'telegram' | 'discord' | 'slack' | 'wechat' | 'x' | 'line';
@@ -513,8 +521,9 @@ interface IMCreateBindingOptions {
     channelId?: string;
 }
 interface IMSendOptions {
-    type?: 'text' | 'markdown' | 'code' | 'system_event';
+    type?: 'text' | 'markdown' | 'code' | 'image' | 'file' | 'tool_call' | 'tool_result' | 'system_event' | 'thinking';
     metadata?: Record<string, any>;
+    parentId?: string;
 }
 interface IMPaginationOptions {
     limit?: number;
@@ -707,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

@@ -500,7 +500,8 @@ var DirectClient = class {
     return this._r("POST", `/api/im/direct/${userId}/messages`, {
       content,
       type: options?.type ?? "text",
-      metadata: options?.metadata
+      metadata: options?.metadata,
+      parentId: options?.parentId
     });
   }
   /** Get direct message history with a user */
@@ -532,7 +533,8 @@ var GroupsClient = class {
     return this._r("POST", `/api/im/groups/${groupId}/messages`, {
       content,
       type: options?.type ?? "text",
-      metadata: options?.metadata
+      metadata: options?.metadata,
+      parentId: options?.parentId
     });
   }
   /** Get group message history */
@@ -584,7 +586,8 @@ var MessagesClient = class {
     return this._r("POST", `/api/im/messages/${conversationId}`, {
       content,
       type: options?.type ?? "text",
-      metadata: options?.metadata
+      metadata: options?.metadata,
+      parentId: options?.parentId
     });
   }
   /** Get message history for a conversation */
@@ -724,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;
@@ -742,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
   // --------------------------------------------------------------------------
@@ -753,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

@@ -458,7 +458,8 @@ var DirectClient = class {
     return this._r("POST", `/api/im/direct/${userId}/messages`, {
       content,
       type: options?.type ?? "text",
-      metadata: options?.metadata
+      metadata: options?.metadata,
+      parentId: options?.parentId
     });
   }
   /** Get direct message history with a user */
@@ -490,7 +491,8 @@ var GroupsClient = class {
     return this._r("POST", `/api/im/groups/${groupId}/messages`, {
       content,
       type: options?.type ?? "text",
-      metadata: options?.metadata
+      metadata: options?.metadata,
+      parentId: options?.parentId
     });
   }
   /** Get group message history */
@@ -542,7 +544,8 @@ var MessagesClient = class {
     return this._r("POST", `/api/im/messages/${conversationId}`, {
       content,
       type: options?.type ?? "text",
-      metadata: options?.metadata
+      metadata: options?.metadata,
+      parentId: options?.parentId
     });
   }
   /** Get message history for a conversation */
@@ -682,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;
@@ -700,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
   // --------------------------------------------------------------------------
@@ -711,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.0.0",
+  "version": "1.2.0",
   "description": "Official TypeScript SDK for Prismer Cloud API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",