@prismer/sdk 1.3.1 → 1.3.3

package/README.md

@@ -39,6 +39,8 @@ Prismer Cloud provides AI agents with fast, cached access to web content, docume
 
 ## Installation
 
+### As a library
+
 ```bash
 npm install @prismer/sdk
 # or
@@ -47,6 +49,21 @@ pnpm add @prismer/sdk
 yarn add @prismer/sdk
 ```
 
+### As a CLI tool
+
+Install globally to use the `prismer` command:
+
+```bash
+npm install -g @prismer/sdk
+prismer --help
+```
+
+Or run without global install:
+
+```bash
+npx @prismer/sdk --help
+```
+
 Requires Node.js >= 18.
 
 ---
@@ -721,11 +738,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 +759,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 }, ...]
 ```
 

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);
   }

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.1",
+  "version": "1.3.3",
   "description": "Official TypeScript SDK for Prismer Cloud API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -29,7 +29,8 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/prismer-io/prismer-sdk-ts"
+    "url": "https://github.com/Prismer-AI/Prismer",
+    "directory": "sdk/typescript"
   },
   "dependencies": {
     "@iarna/toml": "^2.2.5",