servicem8 0.8.0 → 0.9.0

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { inboxArchiveInboxMessage } from "../../funcs/inboxArchiveInboxMessage.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ArchiveInboxMessageRequest$inboundSchema,
+};
+
+export const tool$inboxArchiveInboxMessage: ToolDefinition<typeof args> = {
+  name: "inbox-archive-inbox-message",
+  description: `Archive or unarchive message
+
+Archives or unarchives an inbox message`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await inboxArchiveInboxMessage(
+      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/inboxAttachInboxMessageToJob.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { inboxAttachInboxMessageToJob } from "../../funcs/inboxAttachInboxMessageToJob.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.AttachInboxMessageToJobRequest$inboundSchema,
+};
+
+export const tool$inboxAttachInboxMessageToJob: ToolDefinition<typeof args> = {
+  name: "inbox-attach-inbox-message-to-job",
+  description: `Attach message to existing job
+
+Attaches an inbox message to an existing job`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await inboxAttachInboxMessageToJob(
+      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/inboxConvertInboxMessageToJob.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { inboxConvertInboxMessageToJob } from "../../funcs/inboxConvertInboxMessageToJob.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ConvertInboxMessageToJobRequest$inboundSchema,
+};
+
+export const tool$inboxConvertInboxMessageToJob: ToolDefinition<typeof args> = {
+  name: "inbox-convert-inbox-message-to-job",
+  description: `Convert message to job
+
+Converts an inbox message into a new job, optionally using a job template`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await inboxConvertInboxMessageToJob(
+      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/inboxGetInboxMessage.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { inboxGetInboxMessage } from "../../funcs/inboxGetInboxMessage.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetInboxMessageRequest$inboundSchema,
+};
+
+export const tool$inboxGetInboxMessage: ToolDefinition<typeof args> = {
+  name: "inbox-get-inbox-message",
+  description: `Get inbox message details
+
+Retrieves detailed information about a specific inbox message including attachments and conversation history`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await inboxGetInboxMessage(
+      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/inboxListInboxMessages.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { inboxListInboxMessages } from "../../funcs/inboxListInboxMessages.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ListInboxMessagesRequest$inboundSchema,
+};
+
+export const tool$inboxListInboxMessages: ToolDefinition<typeof args> = {
+  name: "inbox-list-inbox-messages",
+  description: `List inbox messages
+
+Retrieves a paginated list of inbox messages with optional filtering`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await inboxListInboxMessages(
+      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/inboxMarkInboxMessageAsRead.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { inboxMarkInboxMessageAsRead } from "../../funcs/inboxMarkInboxMessageAsRead.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.MarkInboxMessageAsReadRequest$inboundSchema,
+};
+
+export const tool$inboxMarkInboxMessageAsRead: ToolDefinition<typeof args> = {
+  name: "inbox-mark-inbox-message-as-read",
+  description: `Mark message as read
+
+Marks an inbox message as read`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await inboxMarkInboxMessageAsRead(
+      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/inboxSnoozeInboxMessage.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { inboxSnoozeInboxMessage } from "../../funcs/inboxSnoozeInboxMessage.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.SnoozeInboxMessageRequest$inboundSchema,
+};
+
+export const tool$inboxSnoozeInboxMessage: ToolDefinition<typeof args> = {
+  name: "inbox-snooze-inbox-message",
+  description: `Snooze or unsnooze message
+
+Snoozes a message until a specified date/time or unsnoozes it`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await inboxSnoozeInboxMessage(
+      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/jobTemplatesCreateJobFromTemplate.ts

@@ -0,0 +1,50 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { jobTemplatesCreateJobFromTemplate } from "../../funcs/jobTemplatesCreateJobFromTemplate.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.CreateJobFromTemplateRequest$inboundSchema,
+};
+
+export const tool$jobTemplatesCreateJobFromTemplate: ToolDefinition<
+  typeof args
+> = {
+  name: "job-templates-create-job-from-template",
+  description: `Create a job from a template
+
+Creates a new job by cloning an existing job template. All template entities (tasks, materials, checklists, quotes, custom fields) are cloned to the new job.
+
+#### Field Overrides
+Only the following fields can be overridden when creating a job from a template:
+- \`job_description\` - Job description
+- \`company_uuid\` - UUID of the company/client
+- \`job_address\` - Street address for the job
+
+Any other fields in the request body will be ignored.
+
+#### OAuth Scope
+This endpoint requires the following OAuth scope **manage_jobs**.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await jobTemplatesCreateJobFromTemplate(
+      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.result;
+
+    return formatResult(value, apiCall);
+  },
+};

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { searchGeneralSearch } from "../../funcs/searchGeneralSearch.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GeneralSearchRequest$inboundSchema,
+};
+
+export const tool$searchGeneralSearch: ToolDefinition<typeof args> = {
+  name: "search-general-search",
+  description: `Search across multiple object types
+
+Performs a text search across jobs, companies, and materials. Returns combined results sorted by relevance.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await searchGeneralSearch(
+      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/searchJobEmbeddingSearch.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { searchJobEmbeddingSearch } from "../../funcs/searchJobEmbeddingSearch.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.JobEmbeddingSearchRequest$inboundSchema,
+};
+
+export const tool$searchJobEmbeddingSearch: ToolDefinition<typeof args> = {
+  name: "search-job-embedding-search",
+  description: `Semantic search for jobs
+
+Performs semantic/embedding-based search on job content. This uses AI to find jobs with similar meaning, not just exact text matches.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await searchJobEmbeddingSearch(
+      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/searchObjectSearch.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { searchObjectSearch } from "../../funcs/searchObjectSearch.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ObjectSearchRequest$inboundSchema,
+};
+
+export const tool$searchObjectSearch: ToolDefinition<typeof args> = {
+  name: "search-object-search",
+  description: `Search within a specific object type
+
+Performs a text search within a specific object type. Supported types: job, company, material, knowledgearticle, attachment, formresponse, asset, materialbundle`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await searchObjectSearch(
+      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/models/components/addnoterequest.ts

@@ -0,0 +1,62 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type AddNoteRequest = {
+  note: string;
+};
+
+/** @internal */
+export const AddNoteRequest$inboundSchema: z.ZodType<
+  AddNoteRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  note: z.string(),
+});
+
+/** @internal */
+export type AddNoteRequest$Outbound = {
+  note: string;
+};
+
+/** @internal */
+export const AddNoteRequest$outboundSchema: z.ZodType<
+  AddNoteRequest$Outbound,
+  z.ZodTypeDef,
+  AddNoteRequest
+> = z.object({
+  note: z.string(),
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace AddNoteRequest$ {
+  /** @deprecated use `AddNoteRequest$inboundSchema` instead. */
+  export const inboundSchema = AddNoteRequest$inboundSchema;
+  /** @deprecated use `AddNoteRequest$outboundSchema` instead. */
+  export const outboundSchema = AddNoteRequest$outboundSchema;
+  /** @deprecated use `AddNoteRequest$Outbound` instead. */
+  export type Outbound = AddNoteRequest$Outbound;
+}
+
+export function addNoteRequestToJSON(addNoteRequest: AddNoteRequest): string {
+  return JSON.stringify(AddNoteRequest$outboundSchema.parse(addNoteRequest));
+}
+
+export function addNoteRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<AddNoteRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AddNoteRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AddNoteRequest' from JSON`,
+  );
+}

package/src/models/components/archiverequest.ts

@@ -0,0 +1,66 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type ArchiveRequest = {
+  archived?: boolean | undefined;
+  reason?: string | null | undefined;
+};
+
+/** @internal */
+export const ArchiveRequest$inboundSchema: z.ZodType<
+  ArchiveRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  archived: z.boolean().default(true),
+  reason: z.nullable(z.string()).optional(),
+});
+
+/** @internal */
+export type ArchiveRequest$Outbound = {
+  archived: boolean;
+  reason?: string | null | undefined;
+};
+
+/** @internal */
+export const ArchiveRequest$outboundSchema: z.ZodType<
+  ArchiveRequest$Outbound,
+  z.ZodTypeDef,
+  ArchiveRequest
+> = z.object({
+  archived: z.boolean().default(true),
+  reason: z.nullable(z.string()).optional(),
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace ArchiveRequest$ {
+  /** @deprecated use `ArchiveRequest$inboundSchema` instead. */
+  export const inboundSchema = ArchiveRequest$inboundSchema;
+  /** @deprecated use `ArchiveRequest$outboundSchema` instead. */
+  export const outboundSchema = ArchiveRequest$outboundSchema;
+  /** @deprecated use `ArchiveRequest$Outbound` instead. */
+  export type Outbound = ArchiveRequest$Outbound;
+}
+
+export function archiveRequestToJSON(archiveRequest: ArchiveRequest): string {
+  return JSON.stringify(ArchiveRequest$outboundSchema.parse(archiveRequest));
+}
+
+export function archiveRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<ArchiveRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ArchiveRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ArchiveRequest' from JSON`,
+  );
+}

package/src/models/components/attachtojobrequest.ts

@@ -0,0 +1,75 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type AttachToJobRequest = {
+  jobUuid: string;
+};
+
+/** @internal */
+export const AttachToJobRequest$inboundSchema: z.ZodType<
+  AttachToJobRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  job_uuid: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "job_uuid": "jobUuid",
+  });
+});
+
+/** @internal */
+export type AttachToJobRequest$Outbound = {
+  job_uuid: string;
+};
+
+/** @internal */
+export const AttachToJobRequest$outboundSchema: z.ZodType<
+  AttachToJobRequest$Outbound,
+  z.ZodTypeDef,
+  AttachToJobRequest
+> = z.object({
+  jobUuid: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    jobUuid: "job_uuid",
+  });
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace AttachToJobRequest$ {
+  /** @deprecated use `AttachToJobRequest$inboundSchema` instead. */
+  export const inboundSchema = AttachToJobRequest$inboundSchema;
+  /** @deprecated use `AttachToJobRequest$outboundSchema` instead. */
+  export const outboundSchema = AttachToJobRequest$outboundSchema;
+  /** @deprecated use `AttachToJobRequest$Outbound` instead. */
+  export type Outbound = AttachToJobRequest$Outbound;
+}
+
+export function attachToJobRequestToJSON(
+  attachToJobRequest: AttachToJobRequest,
+): string {
+  return JSON.stringify(
+    AttachToJobRequest$outboundSchema.parse(attachToJobRequest),
+  );
+}
+
+export function attachToJobRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<AttachToJobRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AttachToJobRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AttachToJobRequest' from JSON`,
+  );
+}