@scalekit-sdk/node 2.1.9 → 2.2.0-beta.0

package/src/pkg/grpc/scalekit/v1/users/users_connect.ts

@@ -3,7 +3,7 @@
 /* eslint-disable */
 // @ts-nocheck
 
-import { AssignUserRolesRequest, AssignUserRolesResponse, CreateMembershipRequest, CreateMembershipResponse, CreateUserAndMembershipRequest, CreateUserAndMembershipResponse, DeleteMembershipRequest, DeleteUserRequest, GetUserRequest, GetUserResponse, ListOrganizationUsersRequest, ListOrganizationUsersResponse, ListUserPermissionsRequest, ListUserPermissionsResponse, ListUserRolesRequest, ListUserRolesResponse, ListUsersRequest, ListUsersResponse, RemoveUserRoleRequest, ResendInviteRequest, ResendInviteResponse, SearchOrganizationUsersRequest, SearchOrganizationUsersResponse, SearchUsersRequest, SearchUsersResponse, UpdateMembershipRequest, UpdateMembershipResponse, UpdateUserRequest, UpdateUserResponse } from "./users_pb.js";
+import { AssignUserRolesRequest, AssignUserRolesResponse, CreateMembershipRequest, CreateMembershipResponse, CreateUserAndMembershipRequest, CreateUserAndMembershipResponse, DeleteMembershipRequest, DeleteUserRequest, GetCurrentUserRequest, GetCurrentUserResponse, GetUserRequest, GetUserResponse, ListOrganizationUsersRequest, ListOrganizationUsersResponse, ListUserPermissionsRequest, ListUserPermissionsResponse, ListUserRolesRequest, ListUserRolesResponse, ListUsersRequest, ListUsersResponse, RemoveUserRoleRequest, ResendInviteRequest, ResendInviteResponse, SearchOrganizationUsersRequest, SearchOrganizationUsersResponse, SearchUsersRequest, SearchUsersResponse, UpdateMembershipRequest, UpdateMembershipResponse, UpdateUserRequest, UpdateUserResponse } from "./users_pb.js";
 import { Empty, MethodKind } from "@bufbuild/protobuf";
 
 /**
@@ -23,6 +23,15 @@ export const UserService = {
       O: GetUserResponse,
       kind: MethodKind.Unary,
     },
+    /**
+     * @generated from rpc scalekit.v1.users.UserService.GetCurrentUser
+     */
+    getCurrentUser: {
+      name: "GetCurrentUser",
+      I: GetCurrentUserRequest,
+      O: GetCurrentUserResponse,
+      kind: MethodKind.Unary,
+    },
     /**
      * @generated from rpc scalekit.v1.users.UserService.ListUsers
      */

package/src/pkg/grpc/scalekit/v1/users/users_pb.ts

@@ -413,6 +413,82 @@ export class GetUserResponse extends Message<GetUserResponse> {
   }
 }
 
+/**
+ * @generated from message scalekit.v1.users.GetCurrentUserResponse
+ */
+export class GetCurrentUserResponse extends Message<GetCurrentUserResponse> {
+  /**
+   * @generated from field: scalekit.v1.users.User user = 1;
+   */
+  user?: User;
+
+  /**
+   * @generated from field: string current_session_id = 2;
+   */
+  currentSessionId = "";
+
+  constructor(data?: PartialMessage<GetCurrentUserResponse>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "scalekit.v1.users.GetCurrentUserResponse";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "user", kind: "message", T: User },
+    { no: 2, name: "current_session_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): GetCurrentUserResponse {
+    return new GetCurrentUserResponse().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): GetCurrentUserResponse {
+    return new GetCurrentUserResponse().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): GetCurrentUserResponse {
+    return new GetCurrentUserResponse().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: GetCurrentUserResponse | PlainMessage<GetCurrentUserResponse> | undefined, b: GetCurrentUserResponse | PlainMessage<GetCurrentUserResponse> | undefined): boolean {
+    return proto3.util.equals(GetCurrentUserResponse, a, b);
+  }
+}
+
+/**
+ * Empty message - user ID extracted from authentication context
+ *
+ * @generated from message scalekit.v1.users.GetCurrentUserRequest
+ */
+export class GetCurrentUserRequest extends Message<GetCurrentUserRequest> {
+  constructor(data?: PartialMessage<GetCurrentUserRequest>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "scalekit.v1.users.GetCurrentUserRequest";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): GetCurrentUserRequest {
+    return new GetCurrentUserRequest().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): GetCurrentUserRequest {
+    return new GetCurrentUserRequest().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): GetCurrentUserRequest {
+    return new GetCurrentUserRequest().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: GetCurrentUserRequest | PlainMessage<GetCurrentUserRequest> | undefined, b: GetCurrentUserRequest | PlainMessage<GetCurrentUserRequest> | undefined): boolean {
+    return proto3.util.equals(GetCurrentUserRequest, a, b);
+  }
+}
+
 /**
  * @generated from message scalekit.v1.users.ListOrganizationUsersRequest
  */

package/src/scalekit.ts

@@ -5,6 +5,8 @@ import GrpcConnect from './connect';
 import ConnectionClient from './connection';
 import { IdTokenClaimToUserMap } from './constants/user';
 import CoreClient from './core';
+import ToolsClient from './tools';
+import ConnectedAccountsClient from './connected-accounts';
 import DirectoryClient from './directory';
 import DomainClient from './domain';
 import AuthClient from './auth';
@@ -60,6 +62,8 @@ export default class ScalekitClient {
   readonly organization: OrganizationClient;
   readonly connection: ConnectionClient;
   readonly domain: DomainClient;
+  readonly tools: ToolsClient;
+  readonly connectedAccounts: ConnectedAccountsClient;
   readonly directory: DirectoryClient;
   readonly passwordless: PasswordlessClient;
   readonly user: UserClient;
@@ -88,6 +92,11 @@ export default class ScalekitClient {
     );
     this.connection = new ConnectionClient(this.grpcConnect, this.coreClient);
     this.domain = new DomainClient(this.grpcConnect, this.coreClient);
+    this.tools = new ToolsClient(this.grpcConnect, this.coreClient);
+    this.connectedAccounts = new ConnectedAccountsClient(
+      this.grpcConnect,
+      this.coreClient
+    );
     this.directory = new DirectoryClient(this.grpcConnect, this.coreClient);
     this.passwordless = new PasswordlessClient(
       this.grpcConnect,

package/src/tools.ts

@@ -0,0 +1,166 @@
+import { PartialMessage } from "@bufbuild/protobuf";
+import { PromiseClient } from "@connectrpc/connect";
+import GrpcConnect from "./connect";
+import CoreClient from "./core";
+import { ToolService } from "./pkg/grpc/scalekit/v1/tools/tools_connect";
+import {
+  ExecuteToolRequest,
+  ExecuteToolResponse,
+  Filter,
+  ListScopedToolsRequest,
+  ListScopedToolsResponse,
+  ListToolsRequest,
+  ListToolsResponse,
+  ScopedToolFilter,
+} from "./pkg/grpc/scalekit/v1/tools/tools_pb";
+
+/**
+ * Client for listing and executing tools.
+ *
+ * This client provides convenient helpers around the `ToolService` for:
+ * - listing all tools available in your workspace
+ * - listing tools scoped to a specific connected account identifier
+ * - executing tools using connected account credentials
+ *
+ * It mirrors the capabilities of the Python SDK `ToolsClient` while following
+ * the idioms and patterns used across the Node SDK.
+ */
+export default class ToolsClient {
+  private client: PromiseClient<typeof ToolService>;
+
+  constructor(
+    private readonly grpcConnect: GrpcConnect,
+    private readonly coreClient: CoreClient
+  ) {
+    this.client = this.grpcConnect.createClient(ToolService);
+  }
+
+  /**
+   * Lists tools available in your workspace with optional filtering and pagination.
+   *
+   * @param options Optional filter and pagination parameters
+   * @param options.filter Filter configuration matching the `Filter` proto message.
+   *                       Use this to filter by provider, identifier, or tool names.
+   * @param options.pageSize Maximum number of tools to return per page.
+   * @param options.pageToken Token from a previous `listTools` response for pagination.
+   */
+  async listTools(options?: {
+    filter?: PartialMessage<Filter>;
+    pageSize?: number;
+    pageToken?: string;
+  }): Promise<ListToolsResponse> {
+    const request: PartialMessage<ListToolsRequest> = {};
+
+    if (options?.filter) {
+      request.filter = options.filter as Filter;
+    }
+    if (options?.pageSize !== undefined) {
+      request.pageSize = options.pageSize;
+    }
+    if (options?.pageToken) {
+      request.pageToken = options.pageToken;
+    }
+
+    return this.coreClient.connectExec(this.client.listTools, request);
+  }
+
+  /**
+   * Lists tools that are scoped to a specific connected account identifier.
+   *
+   * @param identifier Connected account identifier to scope the tools list (for example,
+   *                   a workspace identifier or email).
+   * @param options Optional filter and pagination parameters
+   * @param options.filter Filter configuration for scoped tools (providers, tool names, connection names).
+   * @param options.pageSize Maximum number of tools to return per page.
+   * @param options.pageToken Token from a previous `listScopedTools` response for pagination.
+   */
+  async listScopedTools(
+    identifier: string,
+    options?: {
+      filter?: PartialMessage<ScopedToolFilter>;
+      pageSize?: number;
+      pageToken?: string;
+    }
+  ): Promise<ListScopedToolsResponse> {
+    const request: PartialMessage<ListScopedToolsRequest> = {
+      identifier,
+    };
+
+    if (options?.filter) {
+      request.filter = options.filter as ScopedToolFilter;
+    }
+    if (options?.pageSize !== undefined) {
+      request.pageSize = options.pageSize;
+    }
+    if (options?.pageToken) {
+      request.pageToken = options.pageToken;
+    }
+
+    return this.coreClient.connectExec(this.client.listScopedTools, request);
+  }
+
+  /**
+   * Executes a tool using credentials from a connected account.
+   *
+   * You can either:
+   * - reference the connected account directly via `connectedAccountId`, or
+   * - identify it using a combination of `identifier`, `connector`, `organizationId`, and `userId`.
+   *
+   * @param params Execution configuration
+   * @param params.toolName Name of the tool to execute.
+   * @param params.identifier Optional connected account identifier (for example, email or workspace ID).
+   * @param params.params JSON parameters required by the tool. These will be sent as a structured payload.
+   * @param params.connectedAccountId Optional direct ID of the connected account (`ca_...`).
+   * @param params.connector Optional connector/provider name when using identifier-based lookup.
+   * @param params.organizationId Optional organization ID to scope the connected account lookup.
+   * @param params.userId Optional user ID to scope the connected account lookup.
+   */
+  async executeTool(params: {
+    toolName: string;
+    identifier?: string;
+    params?: Record<string, unknown>;
+    connectedAccountId?: string;
+    connector?: string;
+    organizationId?: string;
+    userId?: string;
+  }): Promise<ExecuteToolResponse> {
+    const {
+      toolName,
+      identifier,
+      params: toolParams,
+      connectedAccountId,
+      connector,
+      organizationId,
+      userId,
+    } = params;
+
+    const request: PartialMessage<ExecuteToolRequest> = {
+      toolName,
+    };
+
+    if (identifier) {
+      request.identifier = identifier;
+    }
+
+    if (toolParams) {
+      // `google.protobuf.Struct` messages in bufbuild accept plain JSON objects.
+      request.params = toolParams as any;
+    }
+
+    if (connectedAccountId) {
+      request.connectedAccountId = connectedAccountId;
+    }
+    if (connector) {
+      request.connector = connector;
+    }
+    if (organizationId) {
+      request.organizationId = organizationId;
+    }
+    if (userId) {
+      request.userId = userId;
+    }
+
+    return this.coreClient.connectExec(this.client.executeTool, request);
+  }
+}
+