@steuerboard/mcp 0.3.3 → 0.3.4

package/src/mcp-server/server.ts

@@ -23,11 +23,21 @@ import { tool$adminUsersInviteAccountantUser } from "./tools/adminUsersInviteAcc
 import { tool$adminUsersListAccountantUsers } from "./tools/adminUsersListAccountantUsers.js";
 import { tool$adminUsersUpdateAccountantUser } from "./tools/adminUsersUpdateAccountantUser.js";
 import { tool$authMe } from "./tools/authMe.js";
+import { tool$collectSessionsCompleteCollectSession } from "./tools/collectSessionsCompleteCollectSession.js";
+import { tool$collectSessionsDeleteCollectSubmission } from "./tools/collectSessionsDeleteCollectSubmission.js";
+import { tool$collectSessionsGetcollectSessionByToken } from "./tools/collectSessionsGetcollectSessionByToken.js";
+import { tool$collectSessionsPingCollectSession } from "./tools/collectSessionsPingCollectSession.js";
+import { tool$collectSessionsRequestLinkCollectToken } from "./tools/collectSessionsRequestLinkCollectToken.js";
+import { tool$collectSessionsSubmitCollectBulk } from "./tools/collectSessionsSubmitCollectBulk.js";
+import { tool$collectSessionsSubmitCollectFile } from "./tools/collectSessionsSubmitCollectFile.js";
+import { tool$collectSessionsSubmitCollectFormData } from "./tools/collectSessionsSubmitCollectFormData.js";
 import { tool$filesCreateFile } from "./tools/filesCreateFile.js";
 import { tool$filesDeleteFile } from "./tools/filesDeleteFile.js";
+import { tool$filesDownloadFileContent } from "./tools/filesDownloadFileContent.js";
 import { tool$filesGetFile } from "./tools/filesGetFile.js";
 import { tool$filesListFiles } from "./tools/filesListFiles.js";
 import { tool$filesUpdateFile } from "./tools/filesUpdateFile.js";
+import { tool$healthHealth } from "./tools/healthHealth.js";
 import { tool$healthIndex } from "./tools/healthIndex.js";
 import { tool$healthPing } from "./tools/healthPing.js";
 import { tool$tasksCreateTask } from "./tools/tasksCreateTask.js";
@@ -59,7 +69,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Steuerboard",
-    version: "0.3.3",
+    version: "0.3.4",
   });
 
   const getClient = deps.getSDK || (() =>
@@ -103,6 +113,7 @@ export function createMCPServer(deps: {
   void register; // suppress unused warnings
 
   tool(tool$healthIndex);
+  tool(tool$healthHealth);
   tool(tool$healthPing);
   tool(tool$authMe);
   tool(tool$adminClientsListClients);
@@ -114,6 +125,14 @@ export function createMCPServer(deps: {
   tool(tool$adminUsersGetAccountantUser);
   tool(tool$adminUsersUpdateAccountantUser);
   tool(tool$adminUsersDeleteAccountantUser);
+  tool(tool$collectSessionsGetcollectSessionByToken);
+  tool(tool$collectSessionsPingCollectSession);
+  tool(tool$collectSessionsCompleteCollectSession);
+  tool(tool$collectSessionsRequestLinkCollectToken);
+  tool(tool$collectSessionsSubmitCollectFile);
+  tool(tool$collectSessionsSubmitCollectFormData);
+  tool(tool$collectSessionsSubmitCollectBulk);
+  tool(tool$collectSessionsDeleteCollectSubmission);
   tool(tool$workspacesListWorkspaces);
   tool(tool$workspacesCreateWorkspace);
   tool(tool$workspacesGetWorkspace);
@@ -126,6 +145,7 @@ export function createMCPServer(deps: {
   tool(tool$filesGetFile);
   tool(tool$filesUpdateFile);
   tool(tool$filesDeleteFile);
+  tool(tool$filesDownloadFileContent);
   tool(tool$tasksListTasks);
   tool(tool$tasksCreateTask);
   tool(tool$tasksGetTask);

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

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { collectSessionsCompleteCollectSession } from "../../funcs/collectSessionsCompleteCollectSession.js";
+import { CompleteCollectSessionRequest$zodSchema } from "../../models/completecollectsessionop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: CompleteCollectSessionRequest$zodSchema,
+};
+
+export const tool$collectSessionsCompleteCollectSession: ToolDefinition<
+  typeof args
+> = {
+  name: "collect-sessions-complete-collect-session",
+  description: `Complete collect session
+
+Marks the session as completed by the client, optionally with a note about missing documents.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await collectSessionsCompleteCollectSession(
+      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/collectSessionsDeleteCollectSubmission.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { collectSessionsDeleteCollectSubmission } from "../../funcs/collectSessionsDeleteCollectSubmission.js";
+import { DeleteCollectSubmissionRequest$zodSchema } from "../../models/deletecollectsubmissionop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: DeleteCollectSubmissionRequest$zodSchema,
+};
+
+export const tool$collectSessionsDeleteCollectSubmission: ToolDefinition<
+  typeof args
+> = {
+  name: "collect-sessions-delete-collect-submission",
+  description: `Delete a collect submission
+
+Deletes a pending submission and its associated file from storage.`,
+  annotations: {
+    "destructiveHint": true,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await collectSessionsDeleteCollectSubmission(
+      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/collectSessionsGetcollectSessionByToken.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { collectSessionsGetcollectSessionByToken } from "../../funcs/collectSessionsGetcollectSessionByToken.js";
+import { GetcollectSessionByTokenRequest$zodSchema } from "../../models/getcollectsessionbytokenop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: GetcollectSessionByTokenRequest$zodSchema,
+};
+
+export const tool$collectSessionsGetcollectSessionByToken: ToolDefinition<
+  typeof args
+> = {
+  name: "collect-sessions-getcollect-session-by-token",
+  description: `Get collect session by token
+
+Validates the token and returns the Collect-UI session payload if valid.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await collectSessionsGetcollectSessionByToken(
+      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/collectSessionsPingCollectSession.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { collectSessionsPingCollectSession } from "../../funcs/collectSessionsPingCollectSession.js";
+import { PingCollectSessionRequest$zodSchema } from "../../models/pingcollectsessionop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: PingCollectSessionRequest$zodSchema,
+};
+
+export const tool$collectSessionsPingCollectSession: ToolDefinition<
+  typeof args
+> = {
+  name: "collect-sessions-ping-collect-session",
+  description: `Ping collect session
+
+Fires a session-opened tracking event. Thin, fire-and-forget.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await collectSessionsPingCollectSession(
+      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/collectSessionsRequestLinkCollectToken.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { collectSessionsRequestLinkCollectToken } from "../../funcs/collectSessionsRequestLinkCollectToken.js";
+import { RequestLinkCollectTokenRequest$zodSchema } from "../../models/requestlinkcollecttokenop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: RequestLinkCollectTokenRequest$zodSchema,
+};
+
+export const tool$collectSessionsRequestLinkCollectToken: ToolDefinition<
+  typeof args
+> = {
+  name: "collect-sessions-request-link-collect-token",
+  description: `Request a new collect session link
+
+Sends the current active link when possible, or creates a new session for an expired token. Always returns 202 to prevent enumeration.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await collectSessionsRequestLinkCollectToken(
+      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/collectSessionsSubmitCollectBulk.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { collectSessionsSubmitCollectBulk } from "../../funcs/collectSessionsSubmitCollectBulk.js";
+import { SubmitCollectBulkRequest$zodSchema } from "../../models/submitcollectbulkop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: SubmitCollectBulkRequest$zodSchema,
+};
+
+export const tool$collectSessionsSubmitCollectBulk: ToolDefinition<
+  typeof args
+> = {
+  name: "collect-sessions-submit-collect-bulk",
+  description: `Bulk upload files to a BULK_MATCH group
+
+Uploads multiple files for a BULK_MATCH group. Files are stored without item assignment — server-side matching happens asynchronously.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await collectSessionsSubmitCollectBulk(
+      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/collectSessionsSubmitCollectFile.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { collectSessionsSubmitCollectFile } from "../../funcs/collectSessionsSubmitCollectFile.js";
+import { SubmitCollectFileRequest$zodSchema } from "../../models/submitcollectfileop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: SubmitCollectFileRequest$zodSchema,
+};
+
+export const tool$collectSessionsSubmitCollectFile: ToolDefinition<
+  typeof args
+> = {
+  name: "collect-sessions-submit-collect-file",
+  description: `Submit a file to a collect session
+
+Uploads a file submission for a collect item via a public token.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await collectSessionsSubmitCollectFile(
+      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/collectSessionsSubmitCollectFormData.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { collectSessionsSubmitCollectFormData } from "../../funcs/collectSessionsSubmitCollectFormData.js";
+import { SubmitCollectFormDataRequest$zodSchema } from "../../models/submitcollectformdataop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: SubmitCollectFormDataRequest$zodSchema,
+};
+
+export const tool$collectSessionsSubmitCollectFormData: ToolDefinition<
+  typeof args
+> = {
+  name: "collect-sessions-submit-collect-form-data",
+  description: `Submit form data to a collect session
+
+Submits a form field value for a collect item via a public token.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await collectSessionsSubmitCollectFormData(
+      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/filesDownloadFileContent.ts

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { filesDownloadFileContent } from "../../funcs/filesDownloadFileContent.js";
+import { DownloadFileContentRequest$zodSchema } from "../../models/downloadfilecontentop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: DownloadFileContentRequest$zodSchema,
+};
+
+export const tool$filesDownloadFileContent: ToolDefinition<typeof args> = {
+  name: "files-download-file-content",
+  description: `Download file content
+
+Returns a temporary presigned URL to download the file. The URL expires after 10 minutes.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await filesDownloadFileContent(
+      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/healthHealth.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { healthHealth } from "../../funcs/healthHealth.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+export const tool$healthHealth: ToolDefinition = {
+  name: "health-health",
+  description: `Health Check
+
+Returns service health status for monitoring and container orchestration.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
+  tool: async (client, ctx) => {
+    const [result, apiCall] = await healthHealth(
+      client,
+      { 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/models/badrequest.ts

@@ -4,7 +4,7 @@
 
 import * as z from "zod";
 
-export const BadRequestStatusCode$zodSchema = z.literal(400);
+export const BadRequestStatusCode$zodSchema = z.literal(410);
 
 export type BadRequestStatusCode = z.infer<
   typeof BadRequestStatusCode$zodSchema
@@ -17,7 +17,7 @@ export const BadRequestType$zodSchema = z.enum([
 export type BadRequestType = z.infer<typeof BadRequestType$zodSchema>;
 
 export const BadRequestCode$zodSchema = z.enum([
-  "missing_client_id",
+  "collect_token_expired",
 ]);
 
 export type BadRequestCode = z.infer<typeof BadRequestCode$zodSchema>;

package/src/models/collectbulksubmission.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type CollectBulkSubmissionSubmission = {
+  id: string;
+  status: string;
+  fileName: string | null;
+  fileSize: number | null;
+  fileMimeType: string | null;
+  createdAt: string;
+};
+
+export const CollectBulkSubmissionSubmission$zodSchema: z.ZodType<
+  CollectBulkSubmissionSubmission,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  createdAt: z.string().datetime({ offset: true }),
+  fileMimeType: z.string().nullable(),
+  fileName: z.string().nullable(),
+  fileSize: z.number().nullable(),
+  id: z.string(),
+  status: z.string(),
+});
+
+export type CollectBulkSubmission = {
+  submissions: Array<CollectBulkSubmissionSubmission>;
+};
+
+export const CollectBulkSubmission$zodSchema: z.ZodType<
+  CollectBulkSubmission,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  submissions: z.array(z.lazy(() => CollectBulkSubmissionSubmission$zodSchema)),
+});

package/src/models/collectbulksubmitform.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type CollectBulkSubmitFormFile = {
+  fileName: string;
+  content: Uint8Array | string;
+};
+
+export const CollectBulkSubmitFormFile$zodSchema: z.ZodType<
+  CollectBulkSubmitFormFile,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  content: z.string().base64(),
+  fileName: z.string(),
+});
+
+export type CollectBulkSubmitForm = {
+  files: Array<CollectBulkSubmitFormFile>;
+  groupId: string;
+};
+
+export const CollectBulkSubmitForm$zodSchema: z.ZodType<
+  CollectBulkSubmitForm,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  files: z.array(z.lazy(() => CollectBulkSubmitFormFile$zodSchema)),
+  groupId: z.string(),
+});

package/src/models/collectfilesubmission.ts

@@ -0,0 +1,29 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type CollectFileSubmission = {
+  id: string;
+  status: string;
+  fileName: string | null;
+  fileSize: number | null;
+  fileMimeType: string | null;
+  collectItemId: string;
+  createdAt: string;
+};
+
+export const CollectFileSubmission$zodSchema: z.ZodType<
+  CollectFileSubmission,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  collectItemId: z.string(),
+  createdAt: z.string().datetime({ offset: true }),
+  fileMimeType: z.string().nullable(),
+  fileName: z.string().nullable(),
+  fileSize: z.number().nullable(),
+  id: z.string(),
+  status: z.string(),
+});

package/src/models/collectfilesubmitform.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type CollectFileSubmitFormFile = {
+  fileName: string;
+  content: Uint8Array | string;
+};
+
+export const CollectFileSubmitFormFile$zodSchema: z.ZodType<
+  CollectFileSubmitFormFile,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  content: z.string().base64(),
+  fileName: z.string(),
+});
+
+export type CollectFileSubmitForm = {
+  file: CollectFileSubmitFormFile | Blob;
+  collectItemId: string;
+};
+
+export const CollectFileSubmitForm$zodSchema: z.ZodType<
+  CollectFileSubmitForm,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  collectItemId: z.string(),
+  file: z.lazy(() => CollectFileSubmitFormFile$zodSchema),
+});