@toolplex/client 0.1.39 → 0.1.40

package/dist/mcp-server/clientContext.d.ts

@@ -14,6 +14,7 @@ export declare class ClientContext {
     private _flags;
     private _isOrgUser;
     private _clientName;
+    private _userId;
     get sessionId(): string;
     set sessionId(id: string);
     get dev(): boolean;
@@ -34,5 +35,12 @@ export declare class ClientContext {
     set flags(consts: ClientFlags);
     get isOrgUser(): boolean;
     set isOrgUser(isOrgUser: boolean);
+    /**
+     * Optional user ID for system API keys to specify user context.
+     * Used for per-user telemetry tracking in cloud sessions.
+     * Returns null if not set (which is fine for regular client usage).
+     */
+    get userId(): string | null;
+    set userId(id: string | null);
     isInitialized(): boolean;
 }

package/dist/mcp-server/clientContext.js

@@ -13,6 +13,7 @@ export class ClientContext {
         this._flags = null;
         this._isOrgUser = null;
         this._clientName = null;
+        this._userId = null; // For system keys to specify user context
     }
     get sessionId() {
         if (!this._sessionId) {
@@ -104,6 +105,17 @@ export class ClientContext {
     set isOrgUser(isOrgUser) {
         this._isOrgUser = isOrgUser;
     }
+    /**
+     * Optional user ID for system API keys to specify user context.
+     * Used for per-user telemetry tracking in cloud sessions.
+     * Returns null if not set (which is fine for regular client usage).
+     */
+    get userId() {
+        return this._userId;
+    }
+    set userId(id) {
+        this._userId = id;
+    }
     isInitialized() {
         return !!(this._sessionId &&
             this._apiKey &&

package/dist/mcp-server/index.js

@@ -9,6 +9,8 @@ const apiKey = process.env.TOOLPLEX_API_KEY;
 const clientMode = process.env.TOOLPLEX_CLIENT_MODE || "standard";
 const clientName = process.env.CLIENT_NAME || "unknown";
 const logLevel = process.env.LOG_LEVEL || "info";
+// Optional user ID for per-user telemetry (system API keys only)
+const userId = process.env.TOOLPLEX_USER_ID;
 // Read bundled dependency paths from environment variables
 // These are provided by the host application (e.g., Electron desktop)
 const bundledDependencies = {
@@ -48,6 +50,7 @@ const config = {
     logLevel,
     bundledDependencies,
     sessionResumeHistory,
+    userId,
 };
 serve(config).catch(() => {
     process.exit(1);

package/dist/mcp-server/toolplexApi/service.js

@@ -30,7 +30,7 @@ export class ToolplexApiService {
         return response.json();
     }
     getBaseHeaders() {
-        return {
+        const headers = {
             "Content-Type": "application/json",
             Accept: "application/json",
             "x-api-key": this.clientContext.apiKey,
@@ -40,6 +40,12 @@ export class ToolplexApiService {
             "x-client-platform": os.platform(),
             "x-client-arch": os.arch(),
         };
+        // For system API keys (cloud-agent), include user ID for per-user telemetry
+        const userId = this.clientContext.userId;
+        if (userId) {
+            headers["x-user-id"] = userId;
+        }
+        return headers;
     }
     getHeadersWithSession() {
         return {

package/dist/mcp-server/toolplexServer.js

@@ -33,6 +33,9 @@ export async function serve(config) {
     clientContext.clientMode = config.clientMode;
     clientContext.clientName = config.clientName;
     clientContext.clientVersion = clientVersion;
+    if (config.userId) {
+        clientContext.userId = config.userId;
+    }
     await Registry.init(clientContext);
     // Store bundled dependencies in Registry for use throughout the application
     if (config.bundledDependencies) {

package/dist/shared/mcpServerTypes.d.ts

@@ -38,6 +38,8 @@ export interface ToolplexServerConfig {
             server_id: string;
         }>;
     };
+    /** Optional user ID for system API keys to specify user context (per-user telemetry) */
+    userId?: string;
 }
 export declare const TransportTypeSchema: z.ZodEnum<["stdio", "sse"]>;
 export type TransportType = z.infer<typeof TransportTypeSchema>;

package/dist/src/mcp-server/clientContext.js

@@ -13,6 +13,7 @@ export class ClientContext {
         this._flags = null;
         this._isOrgUser = null;
         this._clientName = null;
+        this._userId = null; // For system keys to specify user context
     }
     get sessionId() {
         if (!this._sessionId) {
@@ -104,6 +105,17 @@ export class ClientContext {
     set isOrgUser(isOrgUser) {
         this._isOrgUser = isOrgUser;
     }
+    /**
+     * Optional user ID for system API keys to specify user context.
+     * Used for per-user telemetry tracking in cloud sessions.
+     * Returns null if not set (which is fine for regular client usage).
+     */
+    get userId() {
+        return this._userId;
+    }
+    set userId(id) {
+        this._userId = id;
+    }
     isInitialized() {
         return !!(this._sessionId &&
             this._apiKey &&

package/dist/src/mcp-server/toolplexApi/service.js

@@ -30,7 +30,7 @@ export class ToolplexApiService {
         return response.json();
     }
     getBaseHeaders() {
-        return {
+        const headers = {
             "Content-Type": "application/json",
             Accept: "application/json",
             "x-api-key": this.clientContext.apiKey,
@@ -40,6 +40,12 @@ export class ToolplexApiService {
             "x-client-platform": os.platform(),
             "x-client-arch": os.arch(),
         };
+        // For system API keys (cloud-agent), include user ID for per-user telemetry
+        const userId = this.clientContext.userId;
+        if (userId) {
+            headers["x-user-id"] = userId;
+        }
+        return headers;
     }
     getHeadersWithSession() {
         return {

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "0.1.39";
+export declare const version = "0.1.40";

package/dist/version.js

@@ -1 +1 @@
-export const version = '0.1.39';
+export const version = '0.1.40';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolplex/client",
-  "version": "0.1.39",
+  "version": "0.1.40",
   "author": "ToolPlex LLC",
   "license": "SEE LICENSE IN LICENSE",
   "description": "The official ToolPlex client for AI agent tool discovery and execution",