@steuerboard/mcp 0.1.2 → 0.3.0

package/src/mcp-server/tools/workspaceMembersListWorkspaceMembers.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { workspaceMembersListWorkspaceMembers } from "../../funcs/workspaceMembersListWorkspaceMembers.js";
+import { ListWorkspaceMembersRequest$zodSchema } from "../../models/listworkspacemembersop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: ListWorkspaceMembersRequest$zodSchema,
+};
+
+export const tool$workspaceMembersListWorkspaceMembers: ToolDefinition<
+  typeof args
+> = {
+  name: "workspace-members-list-workspace-members",
+  description: `List workspace members
+
+Returns workspace members for a workspace.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await workspaceMembersListWorkspaceMembers(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/workspaceMembersRemoveWorkspaceMember.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { workspaceMembersRemoveWorkspaceMember } from "../../funcs/workspaceMembersRemoveWorkspaceMember.js";
+import { RemoveWorkspaceMemberRequest$zodSchema } from "../../models/removeworkspacememberop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: RemoveWorkspaceMemberRequest$zodSchema,
+};
+
+export const tool$workspaceMembersRemoveWorkspaceMember: ToolDefinition<
+  typeof args
+> = {
+  name: "workspace-members-remove-workspace-member",
+  description: `Remove a workspace member
+
+Removes a workspace member from a workspace.`,
+  annotations: {
+    "destructiveHint": true,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await workspaceMembersRemoveWorkspaceMember(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/workspacesCreateWorkspace.ts

@@ -14,7 +14,13 @@ export const tool$workspacesCreateWorkspace: ToolDefinition<typeof args> = {
   name: "workspaces-create-workspace",
   description: `Create a workspace
 
-Creates a new workspace and returns the created workspace object.`,
+Creates a new workspace and returns the created workspace.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await workspacesCreateWorkspace(

package/src/mcp-server/tools/workspacesGetWorkspace.ts

@@ -14,7 +14,13 @@ export const tool$workspacesGetWorkspace: ToolDefinition<typeof args> = {
   name: "workspaces-get-workspace",
   description: `Get a workspace
 
-Returns a single workspace object by ID.`,
+Returns a single workspace by ID.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await workspacesGetWorkspace(

package/src/mcp-server/tools/workspacesListWorkspaces.ts

@@ -15,6 +15,12 @@ export const tool$workspacesListWorkspaces: ToolDefinition<typeof args> = {
   description: `List workspaces
 
 Returns a paginated list of workspaces.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await workspacesListWorkspaces(

package/src/mcp-server/tools/workspacesUpdateWorkspace.ts

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { workspacesUpdateWorkspace } from "../../funcs/workspacesUpdateWorkspace.js";
+import { UpdateWorkspaceRequest$zodSchema } from "../../models/updateworkspaceop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: UpdateWorkspaceRequest$zodSchema,
+};
+
+export const tool$workspacesUpdateWorkspace: ToolDefinition<typeof args> = {
+  name: "workspaces-update-workspace",
+  description: `Update a workspace
+
+Updates a workspace by ID.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await workspacesUpdateWorkspace(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools.ts

@@ -21,6 +21,12 @@ export type ToolDefinition<Args extends undefined | ZodRawShape = undefined> =
       description: string;
       scopes?: MCPScope[];
       args: Args;
+      annotations: {
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+        readOnlyHint: boolean;
+      };
       tool: (
         client: SteuerboardCore,
         args: objectOutputType<Args, ZodTypeAny>,
@@ -32,6 +38,12 @@ export type ToolDefinition<Args extends undefined | ZodRawShape = undefined> =
       description: string;
       scopes?: MCPScope[];
       args?: undefined;
+      annotations: {
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+        readOnlyHint: boolean;
+      };
       tool: (
         client: SteuerboardCore,
         extra: RequestHandlerExtra<ServerRequest, ServerNotification>,
@@ -119,13 +131,24 @@ export function createRegisterTool(
     }
 
     if (tool.args) {
-      server.tool(tool.name, tool.description, tool.args, async (args, ctx) => {
-        return tool.tool(getSDK(), args, ctx);
-      });
+      server.tool(
+        tool.name,
+        tool.description,
+        tool.args,
+        tool.annotations,
+        async (args, ctx) => {
+          return tool.tool(getSDK(), args, ctx);
+        },
+      );
     } else {
-      server.tool(tool.name, tool.description, async (ctx) => {
-        return tool.tool(getSDK(), ctx);
-      });
+      server.tool(
+        tool.name,
+        tool.description,
+        tool.annotations,
+        async (_, ctx) => {
+          return tool.tool(getSDK(), ctx);
+        },
+      );
     }
 
     logger.debug("Registered tool", { name: tool.name });

package/src/models/accountantuser.ts

@@ -0,0 +1,31 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  AccountantUserRole,
+  AccountantUserRole$zodSchema,
+} from "./accountantuserrole.js";
+
+export type AccountantUser = {
+  id: string;
+  createdAt: string;
+  email: string;
+  firstName: string | null;
+  lastName: string | null;
+  roles: Array<AccountantUserRole>;
+};
+
+export const AccountantUser$zodSchema: z.ZodType<
+  AccountantUser,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  createdAt: z.string().datetime({ offset: true }),
+  email: z.string(),
+  firstName: z.string().nullable(),
+  id: z.string(),
+  lastName: z.string().nullable(),
+  roles: z.array(AccountantUserRole$zodSchema),
+});

package/src/models/accountantuserrole.ts

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type AccountantUserRole = {
+  id: string;
+  name: string | null;
+  customName: string | null;
+};
+
+export const AccountantUserRole$zodSchema: z.ZodType<
+  AccountantUserRole,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  customName: z.string().nullable(),
+  id: z.string(),
+  name: z.string().nullable(),
+});

package/src/models/autherror.ts

@@ -4,6 +4,10 @@
 
 import * as z from "zod";
 
+export const AuthErrorStatusCode$zodSchema = z.literal(401);
+
+export type AuthErrorStatusCode = z.infer<typeof AuthErrorStatusCode$zodSchema>;
+
 export const AuthErrorType$zodSchema = z.enum([
   "auth_error",
 ]);
@@ -17,7 +21,7 @@ export const AuthErrorCode$zodSchema = z.enum([
 export type AuthErrorCode = z.infer<typeof AuthErrorCode$zodSchema>;
 
 export type AuthError = {
-  status_code: number;
+  status_code: AuthErrorStatusCode;
   type: AuthErrorType;
   code: AuthErrorCode;
   message: string;
@@ -27,6 +31,6 @@ export const AuthError$zodSchema: z.ZodType<AuthError, z.ZodTypeDef, unknown> =
   z.object({
     code: AuthErrorCode$zodSchema,
     message: z.string(),
-    status_code: z.number(),
+    status_code: AuthErrorStatusCode$zodSchema,
     type: AuthErrorType$zodSchema,
   });

package/src/models/badrequest.ts

@@ -4,6 +4,12 @@
 
 import * as z from "zod";
 
+export const BadRequestStatusCode$zodSchema = z.literal(400);
+
+export type BadRequestStatusCode = z.infer<
+  typeof BadRequestStatusCode$zodSchema
+>;
+
 export const BadRequestType$zodSchema = z.enum([
   "bad_request",
 ]);
@@ -17,7 +23,7 @@ export const BadRequestCode$zodSchema = z.enum([
 export type BadRequestCode = z.infer<typeof BadRequestCode$zodSchema>;
 
 export type BadRequest = {
-  status_code: number;
+  status_code: BadRequestStatusCode;
   type: BadRequestType;
   code: BadRequestCode;
   message: string;
@@ -30,6 +36,6 @@ export const BadRequest$zodSchema: z.ZodType<
 > = z.object({
   code: BadRequestCode$zodSchema,
   message: z.string(),
-  status_code: z.number(),
+  status_code: BadRequestStatusCode$zodSchema,
   type: BadRequestType$zodSchema,
 });

package/src/models/clientcreate.ts

@@ -22,7 +22,7 @@ export type ClientCreateClientType = z.infer<
 /**
  * The address of the client
  */
-export type Address = {
+export type ClientCreateAddress = {
   line1: string;
   line2?: string | undefined;
   city: string;
@@ -30,20 +30,23 @@ export type Address = {
   countryCode?: string | undefined;
 };
 
-export const Address$zodSchema: z.ZodType<Address, z.ZodTypeDef, unknown> = z
-  .object({
-    city: z.string(),
-    countryCode: z.string().default("DE"),
-    line1: z.string(),
-    line2: z.string().optional(),
-    postalCode: z.string(),
-  }).describe("The address of the client");
+export const ClientCreateAddress$zodSchema: z.ZodType<
+  ClientCreateAddress,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  city: z.string(),
+  countryCode: z.string().default("DE"),
+  line1: z.string(),
+  line2: z.string().optional(),
+  postalCode: z.string(),
+}).describe("The address of the client");
 
 export type ClientCreate = {
   name: string;
   type: ClientCreateClientType;
   customId?: string | undefined;
-  address?: Address | undefined;
+  address?: ClientCreateAddress | undefined;
 };
 
 export const ClientCreate$zodSchema: z.ZodType<
@@ -51,7 +54,7 @@ export const ClientCreate$zodSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  address: z.lazy(() => Address$zodSchema).optional(),
+  address: z.lazy(() => ClientCreateAddress$zodSchema).optional(),
   customId: z.string().optional(),
   name: z.string(),
   type: ClientCreateClientType$zodSchema,

package/src/models/clientupdate.ts

@@ -0,0 +1,63 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+/**
+ * The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.
+ */
+export const ClientUpdateClientType$zodSchema = z.enum([
+  "natural_person",
+  "individual_enterprise",
+  "legal_person",
+]).describe(
+  "The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.",
+);
+
+export type ClientUpdateClientType = z.infer<
+  typeof ClientUpdateClientType$zodSchema
+>;
+
+/**
+ * The address of the client
+ */
+export type ClientUpdateAddress = {
+  line1: string;
+  line2?: string | undefined;
+  city: string;
+  postalCode: string;
+  countryCode?: string | undefined;
+};
+
+export const ClientUpdateAddress$zodSchema: z.ZodType<
+  ClientUpdateAddress,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  city: z.string(),
+  countryCode: z.string().default("DE"),
+  line1: z.string(),
+  line2: z.string().optional(),
+  postalCode: z.string(),
+}).describe("The address of the client");
+
+export type ClientUpdate = {
+  name?: string | undefined;
+  type?: ClientUpdateClientType | undefined;
+  customId?: string | null | undefined;
+  legalName?: string | null | undefined;
+  address?: ClientUpdateAddress | null | undefined;
+};
+
+export const ClientUpdate$zodSchema: z.ZodType<
+  ClientUpdate,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  address: z.lazy(() => ClientUpdateAddress$zodSchema).nullable().optional(),
+  customId: z.string().nullable().optional(),
+  legalName: z.string().nullable().optional(),
+  name: z.string().optional(),
+  type: ClientUpdateClientType$zodSchema.optional(),
+});

package/src/models/clientuser.ts

@@ -0,0 +1,27 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type ClientUser = {
+  id: string;
+  createdAt: string;
+  email: string;
+  firstName: string | null;
+  lastName: string | null;
+  roles: Array<string>;
+};
+
+export const ClientUser$zodSchema: z.ZodType<
+  ClientUser,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  createdAt: z.string().datetime({ offset: true }),
+  email: z.string(),
+  firstName: z.string().nullable(),
+  id: z.string(),
+  lastName: z.string().nullable(),
+  roles: z.array(z.string()),
+});

package/src/models/clientuserinvite.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+/**
+ * Role to assign to the invited user.
+ */
+export const ClientUserInviteRole$zodSchema = z.enum([
+  "client_admin",
+  "client_user",
+]).describe("Role to assign to the invited user.");
+
+export type ClientUserInviteRole = z.infer<
+  typeof ClientUserInviteRole$zodSchema
+>;
+
+export type ClientUserInvite = {
+  email: string;
+  role: ClientUserInviteRole;
+  workspaceIds?: Array<string> | undefined;
+};
+
+export const ClientUserInvite$zodSchema: z.ZodType<
+  ClientUserInvite,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  email: z.string(),
+  role: ClientUserInviteRole$zodSchema,
+  workspaceIds: z.array(z.string()).optional(),
+});

package/src/models/clientuserupdate.ts

@@ -0,0 +1,27 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+/**
+ * Role that should replace the user's current role.
+ */
+export const ClientUserUpdateRole$zodSchema = z.enum([
+  "client_admin",
+  "client_user",
+]).describe("Role that should replace the user's current role.");
+
+export type ClientUserUpdateRole = z.infer<
+  typeof ClientUserUpdateRole$zodSchema
+>;
+
+export type ClientUserUpdate = { role: ClientUserUpdateRole };
+
+export const ClientUserUpdate$zodSchema: z.ZodType<
+  ClientUserUpdate,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  role: ClientUserUpdateRole$zodSchema,
+});

package/src/models/conflict.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export const ConflictStatusCode$zodSchema = z.literal(409);
+
+export type ConflictStatusCode = z.infer<typeof ConflictStatusCode$zodSchema>;
+
+export const ConflictType$zodSchema = z.enum([
+  "conflict",
+]);
+
+export type ConflictType = z.infer<typeof ConflictType$zodSchema>;
+
+export const ConflictCode$zodSchema = z.enum([
+  "conflict",
+]);
+
+export type ConflictCode = z.infer<typeof ConflictCode$zodSchema>;
+
+export type Conflict = {
+  status_code: ConflictStatusCode;
+  type: ConflictType;
+  code: ConflictCode;
+  message: string;
+};
+
+export const Conflict$zodSchema: z.ZodType<Conflict, z.ZodTypeDef, unknown> = z
+  .object({
+    code: ConflictCode$zodSchema,
+    message: z.string(),
+    status_code: ConflictStatusCode$zodSchema,
+    type: ConflictType$zodSchema,
+  });

package/src/models/createclientop.ts

@@ -68,6 +68,12 @@ export const CreateClientUnprocessableEntityResponseBody$zodSchema: z.ZodType<
   success: z.boolean(),
 }).describe("The validation error(s)");
 
+export const CreateClientStatusCode$zodSchema = z.literal(403);
+
+export type CreateClientStatusCode = z.infer<
+  typeof CreateClientStatusCode$zodSchema
+>;
+
 export const CreateClientType$zodSchema = z.enum([
   "auth_error",
 ]);
@@ -84,7 +90,7 @@ export type CreateClientCode = z.infer<typeof CreateClientCode$zodSchema>;
  * Missing scope
  */
 export type CreateClientForbiddenResponseBody = {
-  status_code: number;
+  status_code: CreateClientStatusCode;
   type: CreateClientType;
   code: CreateClientCode;
   message: string;
@@ -97,7 +103,7 @@ export const CreateClientForbiddenResponseBody$zodSchema: z.ZodType<
 > = z.object({
   code: CreateClientCode$zodSchema,
   message: z.string(),
-  status_code: z.number(),
+  status_code: CreateClientStatusCode$zodSchema,
   type: CreateClientType$zodSchema,
 }).describe("Missing scope");
 

package/src/models/createfileop.ts

@@ -78,6 +78,12 @@ export const CreateFileUnprocessableEntityResponseBody$zodSchema: z.ZodType<
   success: z.boolean(),
 }).describe("The validation error(s)");
 
+export const RequestEntityTooLargeStatusCode$zodSchema = z.literal(413);
+
+export type RequestEntityTooLargeStatusCode = z.infer<
+  typeof RequestEntityTooLargeStatusCode$zodSchema
+>;
+
 export const RequestEntityTooLargeType$zodSchema = z.enum([
   "bad_request",
 ]);
@@ -98,7 +104,7 @@ export type RequestEntityTooLargeCode = z.infer<
  * Payload too large
  */
 export type CreateFileRequestEntityTooLargeResponseBody = {
-  status_code: number;
+  status_code: RequestEntityTooLargeStatusCode;
   type: RequestEntityTooLargeType;
   code: RequestEntityTooLargeCode;
   message: string;
@@ -111,10 +117,16 @@ export const CreateFileRequestEntityTooLargeResponseBody$zodSchema: z.ZodType<
 > = z.object({
   code: RequestEntityTooLargeCode$zodSchema,
   message: z.string(),
-  status_code: z.number(),
+  status_code: RequestEntityTooLargeStatusCode$zodSchema,
   type: RequestEntityTooLargeType$zodSchema,
 }).describe("Payload too large");
 
+export const CreateFileForbiddenStatusCode$zodSchema = z.literal(403);
+
+export type CreateFileForbiddenStatusCode = z.infer<
+  typeof CreateFileForbiddenStatusCode$zodSchema
+>;
+
 export const CreateFileForbiddenType$zodSchema = z.enum([
   "auth_error",
 ]);
@@ -135,7 +147,7 @@ export type CreateFileForbiddenCode = z.infer<
  * Missing scope
  */
 export type CreateFileForbiddenResponseBody = {
-  status_code: number;
+  status_code: CreateFileForbiddenStatusCode;
   type: CreateFileForbiddenType;
   code: CreateFileForbiddenCode;
   message: string;
@@ -148,7 +160,7 @@ export const CreateFileForbiddenResponseBody$zodSchema: z.ZodType<
 > = z.object({
   code: CreateFileForbiddenCode$zodSchema,
   message: z.string(),
-  status_code: z.number(),
+  status_code: CreateFileForbiddenStatusCode$zodSchema,
   type: CreateFileForbiddenType$zodSchema,
 }).describe("Missing scope");