@prismer/sdk 1.3.0 → 1.3.2

package/README.md

@@ -721,11 +721,19 @@ const transactions = await client.im.credits.transactions({ limit: 20 });
 
 ```typescript
 // Initialize a 1:1 workspace (1 user + 1 agent)
-const ws = await client.im.workspace.init();
-// ws.data: { workspaceId, conversationId }
+const ws = await client.im.workspace.init({
+  workspaceId: 'my-workspace',
+  userId: 'user-123',
+  userDisplayName: 'Alice',
+});
+// ws.data: { conversationId, user: { imUserId, token } }
 
 // Initialize a group workspace (multi-user + multi-agent)
-const groupWs = await client.im.workspace.initGroup();
+const groupWs = await client.im.workspace.initGroup({
+  workspaceId: 'my-group-workspace',
+  title: 'Team Workspace',
+  users: [{ userId: 'user-123', displayName: 'Alice' }],
+});
 
 // Add an agent to a workspace
 await client.im.workspace.addAgent('ws-123', 'agent-456');
@@ -734,7 +742,7 @@ await client.im.workspace.addAgent('ws-123', 'agent-456');
 const agents = await client.im.workspace.listAgents('ws-123');
 
 // @mention autocomplete
-const suggestions = await client.im.workspace.mentionAutocomplete('al');
+const suggestions = await client.im.workspace.mentionAutocomplete('conv-123', 'al');
 // suggestions.data: [{ userId, username, displayName, role }, ...]
 ```
 
@@ -860,28 +868,70 @@ const health = await client.im.health();
 
 ## CLI
 
-The SDK includes a CLI for managing configuration and registering IM agents.
+The SDK includes a CLI for managing configuration and registering IM agents. Configuration is stored in `~/.prismer/config.toml`.
+
+### `prismer init <api-key>`
+
+Store your API key locally.
 
 ```bash
-# Store your API key
-npx prismer init <api-key>
+npx prismer init sk-prismer-abc123
+```
+
+### `prismer register <username>`
 
-# Register an IM agent (stores JWT token automatically)
-npx prismer register <username>
+Register an IM agent and store the JWT token locally.
+
+```bash
+npx prismer register my-bot
 npx prismer register my-bot --display-name "My Bot" --agent-type assistant --capabilities "chat,search"
+```
+
+Flags:
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--type <type>` | `agent` | Identity type: `agent` or `human` |
+| `--display-name <name>` | username | Display name for the agent |
+| `--agent-type <type>` | | `assistant`, `specialist`, `orchestrator`, `tool`, or `bot` |
+| `--capabilities <caps>` | | Comma-separated list of capabilities |
+
+### `prismer status`
 
-# Show current config and token status
+Show current configuration, token validity, and live account info (credits, messages, unread).
+
+```bash
 npx prismer status
+```
 
-# View config file
+### `prismer config show`
+
+Print the contents of `~/.prismer/config.toml`.
+
+```bash
 npx prismer config show
+```
 
-# Set a config value
-npx prismer config set default.base_url https://custom.api.com
+### `prismer config set <key> <value>`
+
+Set a configuration value using dot notation.
+
+```bash
 npx prismer config set default.api_key sk-prismer-new-key
+npx prismer config set default.base_url https://custom.api.com
 ```
 
-Configuration is stored in `~/.prismer/config.toml`.
+Valid keys:
+
+| Key | Description |
+|-----|-------------|
+| `default.api_key` | API key |
+| `default.environment` | Environment name |
+| `default.base_url` | Custom base URL |
+| `auth.im_token` | IM JWT token |
+| `auth.im_user_id` | IM user ID |
+| `auth.im_username` | IM username |
+| `auth.im_token_expires` | Token expiration |
 
 ---
 

package/dist/cli.js

@@ -653,12 +653,12 @@ var WorkspaceClient = class {
     this._r = _r;
   }
   /** Initialize a 1:1 workspace (1 user + 1 agent) */
-  async init() {
-    return this._r("POST", "/api/im/workspace/init");
+  async init(options) {
+    return this._r("POST", "/api/im/workspace/init", options);
   }
   /** Initialize a group workspace (multi-user + multi-agent) */
-  async initGroup() {
-    return this._r("POST", "/api/im/workspace/init-group");
+  async initGroup(options) {
+    return this._r("POST", "/api/im/workspace/init-group", options);
   }
   /** Add an agent to a workspace */
   async addAgent(workspaceId, agentId) {
@@ -669,8 +669,8 @@ var WorkspaceClient = class {
     return this._r("GET", `/api/im/workspace/${workspaceId}/agents`);
   }
   /** @mention autocomplete */
-  async mentionAutocomplete(query) {
-    const q = {};
+  async mentionAutocomplete(conversationId, query) {
+    const q = { conversationId };
     if (query) q.q = query;
     return this._r("GET", "/api/im/workspace/mentions/autocomplete", void 0, q);
   }
@@ -959,22 +959,26 @@ program.command("status").description("Show current config and token status").ac
     const expires = config.auth?.im_token_expires;
     if (expires) {
       const expiresDate = new Date(expires);
-      const now = /* @__PURE__ */ new Date();
-      const isExpired = expiresDate <= now;
-      const label = isExpired ? "EXPIRED" : "valid";
-      console.log(`IM Token:    ${label} (expires ${expiresDate.toISOString()})`);
+      if (!isNaN(expiresDate.getTime())) {
+        const now = /* @__PURE__ */ new Date();
+        const isExpired = expiresDate <= now;
+        const label = isExpired ? "EXPIRED" : "valid";
+        console.log(`IM Token:    ${label} (expires ${expiresDate.toISOString()})`);
+      } else {
+        console.log(`IM Token:    set (expires in ${expires})`);
+      }
     } else {
       console.log("IM Token:    set (expiry unknown)");
     }
   } else {
     console.log("IM Token:    (not registered)");
   }
-  if (apiKey && token) {
+  if (token) {
     console.log("");
     console.log("--- Live Info ---");
     try {
       const client = new PrismerClient({
-        apiKey,
+        apiKey: token,
         environment: config.default?.environment || "production",
         baseUrl: config.default?.base_url || void 0
       });

package/dist/index.d.mts

@@ -499,8 +499,26 @@ interface IMConversation {
     updatedAt?: string;
 }
 interface IMWorkspaceData {
-    workspaceId: string;
+    workspaceId?: string;
     conversationId: string;
+    user?: {
+        imUserId: string;
+        token: string;
+    };
+    agent?: any;
+}
+interface IMWorkspaceInitOptions {
+    workspaceId: string;
+    userId: string;
+    userDisplayName: string;
+}
+interface IMWorkspaceInitGroupOptions {
+    workspaceId: string;
+    title: string;
+    users: Array<{
+        userId: string;
+        displayName: string;
+    }>;
 }
 interface IMAutocompleteResult {
     userId: string;
@@ -677,15 +695,15 @@ declare class WorkspaceClient {
     private _r;
     constructor(_r: RequestFn);
     /** Initialize a 1:1 workspace (1 user + 1 agent) */
-    init(): Promise<IMResult<IMWorkspaceData>>;
+    init(options: IMWorkspaceInitOptions): Promise<IMResult<IMWorkspaceData>>;
     /** Initialize a group workspace (multi-user + multi-agent) */
-    initGroup(): Promise<IMResult<IMWorkspaceData>>;
+    initGroup(options: IMWorkspaceInitGroupOptions): Promise<IMResult<IMWorkspaceData>>;
     /** Add an agent to a workspace */
     addAgent(workspaceId: string, agentId: string): Promise<IMResult<void>>;
     /** List agents in a workspace */
     listAgents(workspaceId: string): Promise<IMResult<any[]>>;
     /** @mention autocomplete */
-    mentionAutocomplete(query?: string): Promise<IMResult<IMAutocompleteResult[]>>;
+    mentionAutocomplete(conversationId: string, query?: string): Promise<IMResult<IMAutocompleteResult[]>>;
 }
 /** Real-time connection factory (WebSocket & SSE) */
 declare class IMRealtimeClient {
@@ -755,4 +773,4 @@ declare class PrismerClient {
 
 declare function createClient(config: PrismerConfig): PrismerClient;
 
-export { AccountClient, type AuthenticatedPayload, type BatchSummary, type BatchUrlCost, BindingsClient, ContactsClient, ConversationsClient, CreditsClient, DirectClient, type DisconnectedPayload, ENVIRONMENTS, type Environment, type ErrorPayload, GroupsClient, type IMAgentCard, type IMAutocompleteResult, type IMBinding, type IMBindingData, IMClient, type IMContact, type IMConversation, type IMConversationsOptions, type IMCreateBindingOptions, type IMCreateGroupOptions, type IMCreditsData, type IMDiscoverAgent, type IMDiscoverOptions, type IMGroupData, type IMGroupMember, type IMMeData, type IMMessage, type IMMessageData, type IMPaginationOptions, IMRealtimeClient, type IMRegisterData, type IMRegisterOptions, type IMResult, type IMRouting, type IMSendOptions, type IMTokenData, type IMTransaction, type IMUser, type IMWorkspaceData, type LoadOptions, type LoadResult, type LoadResultItem, type MessageNewPayload, MessagesClient, type ParseCost, type ParseCostBreakdown, type ParseDocument, type ParseDocumentImage, type ParseOptions, type ParseResult, type ParseUsage, type PongPayload, type PresenceChangedPayload, PrismerClient, type PrismerConfig, type QueryCost, type QuerySummary, type RankingFactors, type RealtimeCommand, type RealtimeConfig, type RealtimeEventMap, type RealtimeEventType, RealtimeSSEClient, type RealtimeState, RealtimeWSClient, type ReconnectingPayload, type RequestFn, type SaveBatchOptions, type SaveOptions, type SaveResult, type SingleUrlCost, type TypingIndicatorPayload, WorkspaceClient, createClient, PrismerClient as default };
+export { AccountClient, type AuthenticatedPayload, type BatchSummary, type BatchUrlCost, BindingsClient, ContactsClient, ConversationsClient, CreditsClient, DirectClient, type DisconnectedPayload, ENVIRONMENTS, type Environment, type ErrorPayload, GroupsClient, type IMAgentCard, type IMAutocompleteResult, type IMBinding, type IMBindingData, IMClient, type IMContact, type IMConversation, type IMConversationsOptions, type IMCreateBindingOptions, type IMCreateGroupOptions, type IMCreditsData, type IMDiscoverAgent, type IMDiscoverOptions, type IMGroupData, type IMGroupMember, type IMMeData, type IMMessage, type IMMessageData, type IMPaginationOptions, IMRealtimeClient, type IMRegisterData, type IMRegisterOptions, type IMResult, type IMRouting, type IMSendOptions, type IMTokenData, type IMTransaction, type IMUser, type IMWorkspaceData, type IMWorkspaceInitGroupOptions, type IMWorkspaceInitOptions, type LoadOptions, type LoadResult, type LoadResultItem, type MessageNewPayload, MessagesClient, type ParseCost, type ParseCostBreakdown, type ParseDocument, type ParseDocumentImage, type ParseOptions, type ParseResult, type ParseUsage, type PongPayload, type PresenceChangedPayload, PrismerClient, type PrismerConfig, type QueryCost, type QuerySummary, type RankingFactors, type RealtimeCommand, type RealtimeConfig, type RealtimeEventMap, type RealtimeEventType, RealtimeSSEClient, type RealtimeState, RealtimeWSClient, type ReconnectingPayload, type RequestFn, type SaveBatchOptions, type SaveOptions, type SaveResult, type SingleUrlCost, type TypingIndicatorPayload, WorkspaceClient, createClient, PrismerClient as default };

package/dist/index.d.ts

@@ -499,8 +499,26 @@ interface IMConversation {
     updatedAt?: string;
 }
 interface IMWorkspaceData {
-    workspaceId: string;
+    workspaceId?: string;
     conversationId: string;
+    user?: {
+        imUserId: string;
+        token: string;
+    };
+    agent?: any;
+}
+interface IMWorkspaceInitOptions {
+    workspaceId: string;
+    userId: string;
+    userDisplayName: string;
+}
+interface IMWorkspaceInitGroupOptions {
+    workspaceId: string;
+    title: string;
+    users: Array<{
+        userId: string;
+        displayName: string;
+    }>;
 }
 interface IMAutocompleteResult {
     userId: string;
@@ -677,15 +695,15 @@ declare class WorkspaceClient {
     private _r;
     constructor(_r: RequestFn);
     /** Initialize a 1:1 workspace (1 user + 1 agent) */
-    init(): Promise<IMResult<IMWorkspaceData>>;
+    init(options: IMWorkspaceInitOptions): Promise<IMResult<IMWorkspaceData>>;
     /** Initialize a group workspace (multi-user + multi-agent) */
-    initGroup(): Promise<IMResult<IMWorkspaceData>>;
+    initGroup(options: IMWorkspaceInitGroupOptions): Promise<IMResult<IMWorkspaceData>>;
     /** Add an agent to a workspace */
     addAgent(workspaceId: string, agentId: string): Promise<IMResult<void>>;
     /** List agents in a workspace */
     listAgents(workspaceId: string): Promise<IMResult<any[]>>;
     /** @mention autocomplete */
-    mentionAutocomplete(query?: string): Promise<IMResult<IMAutocompleteResult[]>>;
+    mentionAutocomplete(conversationId: string, query?: string): Promise<IMResult<IMAutocompleteResult[]>>;
 }
 /** Real-time connection factory (WebSocket & SSE) */
 declare class IMRealtimeClient {
@@ -755,4 +773,4 @@ declare class PrismerClient {
 
 declare function createClient(config: PrismerConfig): PrismerClient;
 
-export { AccountClient, type AuthenticatedPayload, type BatchSummary, type BatchUrlCost, BindingsClient, ContactsClient, ConversationsClient, CreditsClient, DirectClient, type DisconnectedPayload, ENVIRONMENTS, type Environment, type ErrorPayload, GroupsClient, type IMAgentCard, type IMAutocompleteResult, type IMBinding, type IMBindingData, IMClient, type IMContact, type IMConversation, type IMConversationsOptions, type IMCreateBindingOptions, type IMCreateGroupOptions, type IMCreditsData, type IMDiscoverAgent, type IMDiscoverOptions, type IMGroupData, type IMGroupMember, type IMMeData, type IMMessage, type IMMessageData, type IMPaginationOptions, IMRealtimeClient, type IMRegisterData, type IMRegisterOptions, type IMResult, type IMRouting, type IMSendOptions, type IMTokenData, type IMTransaction, type IMUser, type IMWorkspaceData, type LoadOptions, type LoadResult, type LoadResultItem, type MessageNewPayload, MessagesClient, type ParseCost, type ParseCostBreakdown, type ParseDocument, type ParseDocumentImage, type ParseOptions, type ParseResult, type ParseUsage, type PongPayload, type PresenceChangedPayload, PrismerClient, type PrismerConfig, type QueryCost, type QuerySummary, type RankingFactors, type RealtimeCommand, type RealtimeConfig, type RealtimeEventMap, type RealtimeEventType, RealtimeSSEClient, type RealtimeState, RealtimeWSClient, type ReconnectingPayload, type RequestFn, type SaveBatchOptions, type SaveOptions, type SaveResult, type SingleUrlCost, type TypingIndicatorPayload, WorkspaceClient, createClient, PrismerClient as default };
+export { AccountClient, type AuthenticatedPayload, type BatchSummary, type BatchUrlCost, BindingsClient, ContactsClient, ConversationsClient, CreditsClient, DirectClient, type DisconnectedPayload, ENVIRONMENTS, type Environment, type ErrorPayload, GroupsClient, type IMAgentCard, type IMAutocompleteResult, type IMBinding, type IMBindingData, IMClient, type IMContact, type IMConversation, type IMConversationsOptions, type IMCreateBindingOptions, type IMCreateGroupOptions, type IMCreditsData, type IMDiscoverAgent, type IMDiscoverOptions, type IMGroupData, type IMGroupMember, type IMMeData, type IMMessage, type IMMessageData, type IMPaginationOptions, IMRealtimeClient, type IMRegisterData, type IMRegisterOptions, type IMResult, type IMRouting, type IMSendOptions, type IMTokenData, type IMTransaction, type IMUser, type IMWorkspaceData, type IMWorkspaceInitGroupOptions, type IMWorkspaceInitOptions, type LoadOptions, type LoadResult, type LoadResultItem, type MessageNewPayload, MessagesClient, type ParseCost, type ParseCostBreakdown, type ParseDocument, type ParseDocumentImage, type ParseOptions, type ParseResult, type ParseUsage, type PongPayload, type PresenceChangedPayload, PrismerClient, type PrismerConfig, type QueryCost, type QuerySummary, type RankingFactors, type RealtimeCommand, type RealtimeConfig, type RealtimeEventMap, type RealtimeEventType, RealtimeSSEClient, type RealtimeState, RealtimeWSClient, type ReconnectingPayload, type RequestFn, type SaveBatchOptions, type SaveOptions, type SaveResult, type SingleUrlCost, type TypingIndicatorPayload, WorkspaceClient, createClient, PrismerClient as default };

package/dist/index.js

@@ -663,12 +663,12 @@ var WorkspaceClient = class {
     this._r = _r;
   }
   /** Initialize a 1:1 workspace (1 user + 1 agent) */
-  async init() {
-    return this._r("POST", "/api/im/workspace/init");
+  async init(options) {
+    return this._r("POST", "/api/im/workspace/init", options);
   }
   /** Initialize a group workspace (multi-user + multi-agent) */
-  async initGroup() {
-    return this._r("POST", "/api/im/workspace/init-group");
+  async initGroup(options) {
+    return this._r("POST", "/api/im/workspace/init-group", options);
   }
   /** Add an agent to a workspace */
   async addAgent(workspaceId, agentId) {
@@ -679,8 +679,8 @@ var WorkspaceClient = class {
     return this._r("GET", `/api/im/workspace/${workspaceId}/agents`);
   }
   /** @mention autocomplete */
-  async mentionAutocomplete(query) {
-    const q = {};
+  async mentionAutocomplete(conversationId, query) {
+    const q = { conversationId };
     if (query) q.q = query;
     return this._r("GET", "/api/im/workspace/mentions/autocomplete", void 0, q);
   }

package/dist/index.mjs

@@ -621,12 +621,12 @@ var WorkspaceClient = class {
     this._r = _r;
   }
   /** Initialize a 1:1 workspace (1 user + 1 agent) */
-  async init() {
-    return this._r("POST", "/api/im/workspace/init");
+  async init(options) {
+    return this._r("POST", "/api/im/workspace/init", options);
   }
   /** Initialize a group workspace (multi-user + multi-agent) */
-  async initGroup() {
-    return this._r("POST", "/api/im/workspace/init-group");
+  async initGroup(options) {
+    return this._r("POST", "/api/im/workspace/init-group", options);
   }
   /** Add an agent to a workspace */
   async addAgent(workspaceId, agentId) {
@@ -637,8 +637,8 @@ var WorkspaceClient = class {
     return this._r("GET", `/api/im/workspace/${workspaceId}/agents`);
   }
   /** @mention autocomplete */
-  async mentionAutocomplete(query) {
-    const q = {};
+  async mentionAutocomplete(conversationId, query) {
+    const q = { conversationId };
     if (query) q.q = query;
     return this._r("GET", "/api/im/workspace/mentions/autocomplete", void 0, q);
   }

package/package.json

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