@openpets/quo 1.0.0

package/openapi-tools.ts

@@ -0,0 +1,2079 @@
+/**
+ * Auto-generated OpenAPI tools
+ *
+ * Source: https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json
+ * API: OpenPhone Public API v1.0.0
+ *
+ * This file contains tool definitions that import client utilities from ./openapi-client.ts.
+ * Custom tools can also import { getBaseUrl, getAuthHeaders, fetchAPI } from "./openapi-client".
+ *
+ * Tools by category:
+ *   Calls: 6 tools (CORE)
+ *   Contact Custom Fields: 1 tools (CORE)
+ *   Contacts: 5 tools (CORE)
+ *   Conversations: 1 tools (CORE)
+ *   Messages: 3 tools (CORE)
+ *   Phone Numbers: 2 tools (CORE)
+ *   Users: 2 tools (CORE)
+ *   Webhooks: 7 tools (CORE)
+ *
+ * Total: 27 tools (18 read-only, 9 write)
+ * Tools: 27 generated endpoint tools (always loaded)
+
+ *
+ * DO NOT EDIT MANUALLY - Regenerate with: pets generate-openapi
+ */
+
+import { config as loadDotenv } from "dotenv"
+import { z, type ToolDefinition, createLogger, isReadOnly } from "openpets-sdk"
+
+loadDotenv()
+
+import { getBaseUrl, getAuthHeaders, fetchAPI } from "./openapi-client"
+
+const logger = createLogger("quo-client")
+
+
+// Tools marked as write operations (filtered in read-only mode)
+// Based on HTTP method: POST, PUT, PATCH, DELETE are write operations
+const writeToolNames = new Set([
+  "quo-create-contact-v1",
+  "quo-update-contact-by-id-v1",
+  "quo-delete-contact-v1",
+  "quo-send-message-v1",
+  "quo-delete-webhook-by-id-v1",
+  "quo-create-message-webhook-v1",
+  "quo-create-call-webhook-v1",
+  "quo-create-call-summary-webhook-v1",
+  "quo-create-call-transcript-webhook-v1"
+])
+
+// ============================================================================
+// CORE TOOLS - Always loaded (27 tools)
+// ============================================================================
+const coreTools: ToolDefinition[] = [
+  {
+    name: "quo-get-call-recordings-v1",
+    description: "Get recordings for a call",
+    schema: z.object({
+      callId: z.string().describe("The unique identifier of the call for which recordings are being retrieved.")
+    }),
+    search: {
+      capabilities: ["quo-get-call-recordings-v1","getcallrecordings","get","recordings","for","call","call-recordings","callid","calls"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/call-recordings/${args.callId}`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "GET",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-list-calls-v1",
+    description: "List calls",
+    schema: z.object({
+      phoneNumberId: z.string().describe("The unique identifier of the OpenPhone number associated with the call."),
+      userId: z.string().describe("The unique identifier of the OpenPhone user who either placed or received the call. Defaults to the workspace owner.").optional(),
+      participants: z.array(z.string()).describe("The phone numbers of participants involved in the call conversation, excluding your OpenPhone number. Each number should contain the country code and conform to the E.164 format. Currently limited to one-to-one (1:1) conversations only."),
+      since: z.string().describe("ISO 8601 datetime: DEPRECATED, use \"createdAfter\" or \"createdBefore\" instead. \"since\" incorrectly behaves as \"createdBefore\" and will be removed in an upcoming release.").optional(),
+      createdAfter: z.string().describe("ISO 8601 datetime: Filter results to only include calls created after the specified date and time, in ISO 8601 format.").optional(),
+      createdBefore: z.string().describe("ISO 8601 datetime: Filter results to only include calls created before the specified date and time, in ISO 8601 format.").optional(),
+      maxResults: z.number().describe("Maximum number of results to return per page."),
+      pageToken: z.string().optional()
+    }),
+    search: {
+      capabilities: ["quo-list-calls-v1","listcalls","list","calls"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/calls`
+      const params = new URLSearchParams()
+      if (args.phoneNumberId !== undefined) params.append("phoneNumberId", String(args.phoneNumberId))
+      if (args.userId !== undefined) params.append("userId", String(args.userId))
+      if (args.participants !== undefined) params.append("participants", String(args.participants))
+      if (args.since !== undefined) params.append("since", String(args.since))
+      if (args.createdAfter !== undefined) params.append("createdAfter", String(args.createdAfter))
+      if (args.createdBefore !== undefined) params.append("createdBefore", String(args.createdBefore))
+      if (args.maxResults !== undefined) params.append("maxResults", String(args.maxResults))
+      if (args.pageToken !== undefined) params.append("pageToken", String(args.pageToken))
+      const queryString = params.toString()
+      let fullUrl = queryString ? `${url}?${queryString}` : url
+
+      const options: RequestInit = {
+        method: "GET",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-get-call-by-id-v1",
+    description: "Get a call by ID",
+    schema: z.object({
+      callId: z.string().describe("Unique identifier of the call.")
+    }),
+    search: {
+      capabilities: ["quo-get-call-by-id-v1","getcallbyid","get","call","calls","callid"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/calls/${args.callId}`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "GET",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-get-call-summary-v1",
+    description: "Get a summary for a call",
+    schema: z.object({
+      callId: z.string().describe("The unique identifier of the call associated with the summary.")
+    }),
+    search: {
+      capabilities: ["quo-get-call-summary-v1","getcallsummary","get","summary","for","call","call-summaries","callid","calls"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/call-summaries/${args.callId}`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "GET",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-get-call-transcript-v1",
+    description: "Get a transcription for a call",
+    schema: z.object({
+      id: z.string().describe("Unique identifier of the call associated with this transcript.")
+    }),
+    search: {
+      capabilities: ["quo-get-call-transcript-v1","getcalltranscript","get","transcription","for","call","call-transcripts","calls"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/call-transcripts/${args.id}`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "GET",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-get-call-voicemails-v1",
+    description: "Get a voicemail for a call",
+    schema: z.object({
+      callId: z.string().describe("The unique identifier of the call for which a voicemail is being retrieved.")
+    }),
+    search: {
+      capabilities: ["quo-get-call-voicemails-v1","getcallvoicemails","get","voicemail","for","call","call-voicemails","callid","calls"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/call-voicemails/${args.callId}`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "GET",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-get-contact-custom-fields-v1",
+    description: "Get contact custom fields",
+    schema: z.object({}),
+    search: {
+      capabilities: ["quo-get-contact-custom-fields-v1","getcontactcustomfields","get","contact","custom","fields","contact-custom-fields"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/contact-custom-fields`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "GET",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-list-contacts-v1",
+    description: "List contacts",
+    schema: z.object({
+      externalIds: z.array(z.string()).describe("Optional list of unique identifiers from an external system used to retrieve specific contacts. When provided, the result set is limited to contacts associated with the provided `externalIds`. These IDs must match those supplied during contact creation via the \"Create Contacts\" endpoint. When omitted, returns all contacts for the organization. Use this parameter to cross-reference and fetch contacts linked to external systems.").optional(),
+      sources: z.array(z.string()).optional(),
+      maxResults: z.number().describe("Maximum number of results to return per page."),
+      pageToken: z.string().optional()
+    }),
+    search: {
+      capabilities: ["quo-list-contacts-v1","listcontacts","list","contacts"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/contacts`
+      const params = new URLSearchParams()
+      if (args.externalIds !== undefined) params.append("externalIds", String(args.externalIds))
+      if (args.sources !== undefined) params.append("sources", String(args.sources))
+      if (args.maxResults !== undefined) params.append("maxResults", String(args.maxResults))
+      if (args.pageToken !== undefined) params.append("pageToken", String(args.pageToken))
+      const queryString = params.toString()
+      let fullUrl = queryString ? `${url}?${queryString}` : url
+
+      const options: RequestInit = {
+        method: "GET",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-create-contact-v1",
+    description: "Create a contact",
+    schema: z.object({
+      defaultFields: z.object({
+    company: z.string().optional(),
+    emails: z.string().describe("JSON array").optional(),
+    firstName: z.string(),
+    lastName: z.string().optional(),
+    phoneNumbers: z.string().describe("JSON array").optional(),
+    role: z.string().optional()
+  }),
+      customFields: z.string().describe("JSON array").optional(),
+      createdByUserId: z.string().describe("The unique identifier of the user who created the contact.").optional(),
+      source: z.string().describe("The contact's source. Defaults to `null` for contacts created in the UI. Defaults to `public-api` for contacts created via the public API. Cannot be one of the following reserved words: `openphone`, `device`, `csv`, `zapier`, `google-people`, `other` or start with one of the following reserved prefixes: `openphone`, `csv`.").optional(),
+      sourceUrl: z.string().describe("A link to the contact in the source system.").optional(),
+      externalId: z.string().optional()
+    }),
+    search: {
+      capabilities: ["quo-create-contact-v1","createcontact","create","contact","contacts"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/contacts`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "POST",
+        headers: {},
+        body: JSON.stringify({
+          ...(args.defaultFields !== undefined ? { defaultFields: args.defaultFields } : {}),
+          ...(args.customFields !== undefined ? { customFields: args.customFields } : {}),
+          ...(args.createdByUserId !== undefined ? { createdByUserId: args.createdByUserId } : {}),
+          ...(args.source !== undefined ? { source: args.source } : {}),
+          ...(args.sourceUrl !== undefined ? { sourceUrl: args.sourceUrl } : {}),
+          ...(args.externalId !== undefined ? { externalId: args.externalId } : {})
+        })
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-get-contact-by-id-v1",
+    description: "Get a contact by ID",
+    schema: z.object({
+      id: z.string().describe("The unique identifier of the contact.")
+    }),
+    search: {
+      capabilities: ["quo-get-contact-by-id-v1","getcontactbyid","get","contact","contacts"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/contacts/${args.id}`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "GET",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-update-contact-by-id-v1",
+    description: "Update a contact by ID",
+    schema: z.object({
+      id: z.string().describe("The unique identifier of the contact."),
+      externalId: z.string().optional(),
+      source: z.string().optional(),
+      sourceUrl: z.string().optional(),
+      defaultFields: z.object({
+    company: z.string().optional(),
+    emails: z.string().describe("JSON array").optional(),
+    firstName: z.string().optional(),
+    lastName: z.string().optional(),
+    phoneNumbers: z.string().describe("JSON array").optional(),
+    role: z.string().optional()
+  }),
+      customFields: z.string().describe("JSON array").optional()
+    }),
+    search: {
+      capabilities: ["quo-update-contact-by-id-v1","updatecontactbyid","update","contact","contacts"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/contacts/${args.id}`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "PATCH",
+        headers: {},
+        body: JSON.stringify({
+          ...(args.externalId !== undefined ? { externalId: args.externalId } : {}),
+          ...(args.source !== undefined ? { source: args.source } : {}),
+          ...(args.sourceUrl !== undefined ? { sourceUrl: args.sourceUrl } : {}),
+          ...(args.defaultFields !== undefined ? { defaultFields: args.defaultFields } : {}),
+          ...(args.customFields !== undefined ? { customFields: args.customFields } : {})
+        })
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-delete-contact-v1",
+    description: "Delete a contact",
+    schema: z.object({
+      id: z.string().describe("The unique identifier of the contact.")
+    }),
+    search: {
+      capabilities: ["quo-delete-contact-v1","deletecontact","delete","contact","contacts"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/contacts/${args.id}`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "DELETE",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-list-conversations-v1",
+    description: "List Conversations",
+    schema: z.object({
+      phoneNumber: z.any().describe("DEPRECATED, use `phoneNumbers` instead. If both `phoneNumber` and `phoneNumbers` are provided, `phoneNumbers` will be used. Filters results to only include conversations with the specified OpenPhone phone number. Can be either your OpenPhone phone number ID or the full phone number in E.164 format.").optional(),
+      phoneNumbers: z.string().describe("JSON array: Filters results to only include conversations with the specified OpenPhone phone numbers. Each item can be either an OpenPhone phone number ID or a full phone number in E.164 format.").optional(),
+      userId: z.string().describe("The unique identifier of the user the making the request. Used to filter results to only include the user's conversations.").optional(),
+      createdAfter: z.string().describe("ISO 8601 datetime: Filter results to only include conversations created after the specified date and time, in ISO_8601 format.").optional(),
+      createdBefore: z.string().describe("ISO 8601 datetime: Filter results to only include conversations created before the specified date and time, in ISO_8601 format.").optional(),
+      excludeInactive: z.boolean().describe("Exclude inactive conversations from the results.").optional(),
+      updatedAfter: z.string().describe("ISO 8601 datetime: Filter results to only include conversations updated after the specified date and time, in ISO_8601 format.").optional(),
+      updatedBefore: z.string().describe("ISO 8601 datetime: Filter results to only include conversations updated before the specified date and time, in ISO_8601 format.").optional(),
+      maxResults: z.number().describe("Maximum number of results to return per page."),
+      pageToken: z.string().optional()
+    }),
+    search: {
+      capabilities: ["quo-list-conversations-v1","listconversations","list","conversations"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/conversations`
+      const params = new URLSearchParams()
+      if (args.phoneNumber !== undefined) params.append("phoneNumber", String(args.phoneNumber))
+      if (args.phoneNumbers !== undefined) params.append("phoneNumbers", String(args.phoneNumbers))
+      if (args.userId !== undefined) params.append("userId", String(args.userId))
+      if (args.createdAfter !== undefined) params.append("createdAfter", String(args.createdAfter))
+      if (args.createdBefore !== undefined) params.append("createdBefore", String(args.createdBefore))
+      if (args.excludeInactive !== undefined) params.append("excludeInactive", String(args.excludeInactive))
+      if (args.updatedAfter !== undefined) params.append("updatedAfter", String(args.updatedAfter))
+      if (args.updatedBefore !== undefined) params.append("updatedBefore", String(args.updatedBefore))
+      if (args.maxResults !== undefined) params.append("maxResults", String(args.maxResults))
+      if (args.pageToken !== undefined) params.append("pageToken", String(args.pageToken))
+      const queryString = params.toString()
+      let fullUrl = queryString ? `${url}?${queryString}` : url
+
+      const options: RequestInit = {
+        method: "GET",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-list-messages-v1",
+    description: "List messages",
+    schema: z.object({
+      phoneNumberId: z.string().describe("The unique identifier of the OpenPhone number used to send or receive the messages. PhoneNumberID can be retrieved via the Get Phone Numbers endpoint."),
+      userId: z.string().describe("The unique identifier of the user the message was sent from.").optional(),
+      participants: z.array(z.string()).describe("Array of phone numbers involved in the conversation, excluding your OpenPhone number, in E.164 format."),
+      since: z.string().describe("ISO 8601 datetime: DEPRECATED, use \"createdAfter\" or \"createdBefore\" instead. \"since\" currently behaves as \"createdBefore\" and will be removed in an upcoming release.").optional(),
+      createdAfter: z.string().describe("ISO 8601 datetime: Filter results to only include messages created after the specified date and time, in ISO_8601 format.").optional(),
+      createdBefore: z.string().describe("ISO 8601 datetime: Filter results to only include messages created before the specified date and time, in ISO_8601 format.").optional(),
+      maxResults: z.number().describe("Maximum number of results to return per page."),
+      pageToken: z.string().optional()
+    }),
+    search: {
+      capabilities: ["quo-list-messages-v1","listmessages","list","messages"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/messages`
+      const params = new URLSearchParams()
+      if (args.phoneNumberId !== undefined) params.append("phoneNumberId", String(args.phoneNumberId))
+      if (args.userId !== undefined) params.append("userId", String(args.userId))
+      if (args.participants !== undefined) params.append("participants", String(args.participants))
+      if (args.since !== undefined) params.append("since", String(args.since))
+      if (args.createdAfter !== undefined) params.append("createdAfter", String(args.createdAfter))
+      if (args.createdBefore !== undefined) params.append("createdBefore", String(args.createdBefore))
+      if (args.maxResults !== undefined) params.append("maxResults", String(args.maxResults))
+      if (args.pageToken !== undefined) params.append("pageToken", String(args.pageToken))
+      const queryString = params.toString()
+      let fullUrl = queryString ? `${url}?${queryString}` : url
+
+      const options: RequestInit = {
+        method: "GET",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-send-message-v1",
+    description: "Send a text message",
+    schema: z.object({
+      content: z.string().describe("The text content of the message to be sent."),
+      phoneNumberId: z.string().describe("DEPRECATED, use \"from\" instead. OpenPhone phone number ID to send a message from").optional(),
+      from: z.any(),
+      to: z.string().describe("JSON array"),
+      userId: z.string().describe("The unique identifier of the OpenPhone user sending the message. If not provided, defaults to the phone number owner.").optional(),
+      setInboxStatus: z.enum(["done"]).describe("Used to set the status of the related OpenPhone inbox conversation. The default behavior without setting this parameter will be for the message sent to show up as an open conversation in the user's inbox. Setting the parameter to `'done'` would move the conversation to the Done inbox view.").optional()
+    }),
+    search: {
+      capabilities: ["quo-send-message-v1","sendmessage","send","text","message","messages"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/messages`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "POST",
+        headers: {},
+        body: JSON.stringify({
+          ...(args.content !== undefined ? { content: args.content } : {}),
+          ...(args.phoneNumberId !== undefined ? { phoneNumberId: args.phoneNumberId } : {}),
+          ...(args.from !== undefined ? { from: args.from } : {}),
+          ...(args.to !== undefined ? { to: args.to } : {}),
+          ...(args.userId !== undefined ? { userId: args.userId } : {}),
+          ...(args.setInboxStatus !== undefined ? { setInboxStatus: args.setInboxStatus } : {})
+        })
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-get-message-by-id-v1",
+    description: "Get a message by ID",
+    schema: z.object({
+      id: z.string().describe("The unique identifier of a message")
+    }),
+    search: {
+      capabilities: ["quo-get-message-by-id-v1","getmessagebyid","get","message","messages"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/messages/${args.id}`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "GET",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-list-phone-numbers-v1",
+    description: "List phone numbers",
+    schema: z.object({
+      userId: z.string().describe("Filter results to return only phone numbers associated with the specified user\"s unique identifier.").optional()
+    }),
+    search: {
+      capabilities: ["quo-list-phone-numbers-v1","listphonenumbers","list","phone","numbers","phone-numbers"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/phone-numbers`
+      const params = new URLSearchParams()
+      if (args.userId !== undefined) params.append("userId", String(args.userId))
+      const queryString = params.toString()
+      let fullUrl = queryString ? `${url}?${queryString}` : url
+
+      const options: RequestInit = {
+        method: "GET",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-get-phone-number-by-id-v1",
+    description: "Get a phone number by ID",
+    schema: z.object({
+      phoneNumberId: z.string().describe("Unique identifier of the phone number.")
+    }),
+    search: {
+      capabilities: ["quo-get-phone-number-by-id-v1","getphonenumberbyid","get","phone","number","phone-numbers","phonenumberid","numbers"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/phone-numbers/${args.phoneNumberId}`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "GET",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-list-users-v1",
+    description: "List users",
+    schema: z.object({
+      maxResults: z.number().describe("Maximum number of results to return per page."),
+      pageToken: z.string().optional()
+    }),
+    search: {
+      capabilities: ["quo-list-users-v1","listusers","list","users"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/users`
+      const params = new URLSearchParams()
+      if (args.maxResults !== undefined) params.append("maxResults", String(args.maxResults))
+      if (args.pageToken !== undefined) params.append("pageToken", String(args.pageToken))
+      const queryString = params.toString()
+      let fullUrl = queryString ? `${url}?${queryString}` : url
+
+      const options: RequestInit = {
+        method: "GET",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-get-user-by-id-v1",
+    description: "Get a user by ID",
+    schema: z.object({
+      userId: z.string().describe("The unique identifier of the user being retrieved.")
+    }),
+    search: {
+      capabilities: ["quo-get-user-by-id-v1","getuserbyid","get","user","users","userid"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/users/${args.userId}`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "GET",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-list-webhooks-v1",
+    description: "Lists all webhooks",
+    schema: z.object({
+      userId: z.string().describe("The unique identifier the user. Defaults to the workspace owner.").optional()
+    }),
+    search: {
+      capabilities: ["quo-list-webhooks-v1","listwebhooks","lists","all","webhooks"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/webhooks`
+      const params = new URLSearchParams()
+      if (args.userId !== undefined) params.append("userId", String(args.userId))
+      const queryString = params.toString()
+      let fullUrl = queryString ? `${url}?${queryString}` : url
+
+      const options: RequestInit = {
+        method: "GET",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-get-webhook-by-id-v1",
+    description: "Get a webhook by ID",
+    schema: z.object({
+      id: z.string().describe("The unique identifier of a webhook")
+    }),
+    search: {
+      capabilities: ["quo-get-webhook-by-id-v1","getwebhookbyid","get","webhook","webhooks"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/webhooks/${args.id}`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "GET",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-delete-webhook-by-id-v1",
+    description: "Delete a webhook by ID",
+    schema: z.object({
+      id: z.string().describe("The unique identifier of a webhook")
+    }),
+    search: {
+      capabilities: ["quo-delete-webhook-by-id-v1","deletewebhookbyid","delete","webhook","webhooks"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/webhooks/${args.id}`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "DELETE",
+        headers: {}
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-create-message-webhook-v1",
+    description: "Create a new webhook for messages",
+    schema: z.object({
+      events: z.array(z.string()),
+      label: z.string().describe("Webhook's label").optional(),
+      resourceIds: z.any().optional(),
+      status: z.enum(["enabled", "disabled"]).describe("The status of the webhook.").optional(),
+      url: z.string().describe("The endpoint that receives events from the webhook."),
+      userId: z.string().describe("The unique identifier of the user that creates the webhook. If not provided, default to workspace owner.").optional()
+    }),
+    search: {
+      capabilities: ["quo-create-message-webhook-v1","createmessagewebhook","create","new","webhook","for","messages","webhooks"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/webhooks/messages`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "POST",
+        headers: {},
+        body: JSON.stringify({
+          ...(args.events !== undefined ? { events: args.events } : {}),
+          ...(args.label !== undefined ? { label: args.label } : {}),
+          ...(args.resourceIds !== undefined ? { resourceIds: args.resourceIds } : {}),
+          ...(args.status !== undefined ? { status: args.status } : {}),
+          ...(args.url !== undefined ? { url: args.url } : {}),
+          ...(args.userId !== undefined ? { userId: args.userId } : {})
+        })
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-create-call-webhook-v1",
+    description: "Create a new webhook for calls",
+    schema: z.object({
+      url: z.string().describe("The endpoint that receives events from the webhook."),
+      events: z.array(z.string()),
+      resourceIds: z.any().optional(),
+      userId: z.string().describe("The unique identifier of the user that creates the webhook. If not provided, default to workspace owner.").optional(),
+      label: z.string().describe("Webhook's label").optional(),
+      status: z.enum(["enabled", "disabled"]).describe("The status of the webhook.").optional()
+    }),
+    search: {
+      capabilities: ["quo-create-call-webhook-v1","createcallwebhook","create","new","webhook","for","calls","webhooks"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/webhooks/calls`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "POST",
+        headers: {},
+        body: JSON.stringify({
+          ...(args.url !== undefined ? { url: args.url } : {}),
+          ...(args.events !== undefined ? { events: args.events } : {}),
+          ...(args.resourceIds !== undefined ? { resourceIds: args.resourceIds } : {}),
+          ...(args.userId !== undefined ? { userId: args.userId } : {}),
+          ...(args.label !== undefined ? { label: args.label } : {}),
+          ...(args.status !== undefined ? { status: args.status } : {})
+        })
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-create-call-summary-webhook-v1",
+    description: "Create a new webhook for call summaries",
+    schema: z.object({
+      events: z.array(z.string()),
+      label: z.string().describe("Webhook's label").optional(),
+      resourceIds: z.any().optional(),
+      status: z.enum(["enabled", "disabled"]).describe("The status of the webhook.").optional(),
+      url: z.string().describe("The endpoint that receives events from the webhook."),
+      userId: z.string().describe("The unique identifier of the user that creates the webhook. If not provided, default to workspace owner.").optional()
+    }),
+    search: {
+      capabilities: ["quo-create-call-summary-webhook-v1","createcallsummarywebhook","create","new","webhook","for","call","summaries","webhooks","call-summaries"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/webhooks/call-summaries`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "POST",
+        headers: {},
+        body: JSON.stringify({
+          ...(args.events !== undefined ? { events: args.events } : {}),
+          ...(args.label !== undefined ? { label: args.label } : {}),
+          ...(args.resourceIds !== undefined ? { resourceIds: args.resourceIds } : {}),
+          ...(args.status !== undefined ? { status: args.status } : {}),
+          ...(args.url !== undefined ? { url: args.url } : {}),
+          ...(args.userId !== undefined ? { userId: args.userId } : {})
+        })
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  },
+
+  {
+    name: "quo-create-call-transcript-webhook-v1",
+    description: "Create a new webhook for call transcripts",
+    schema: z.object({
+      events: z.array(z.string()),
+      label: z.string().describe("The webhook's label.").optional(),
+      resourceIds: z.any().optional(),
+      status: z.enum(["enabled", "disabled"]).describe("The status of the webhook.").optional(),
+      url: z.string().describe("The endpoint that receives events from the webhook."),
+      userId: z.string().describe("The ID of the user that creates the webhook. If not provided, default to workspace owner.").optional()
+    }),
+    search: {
+      capabilities: ["quo-create-call-transcript-webhook-v1","createcalltranscriptwebhook","create","new","webhook","for","call","transcripts","webhooks","call-transcripts"],
+      intents: []
+    },
+    async execute(args: any, context?: any) {
+      const url = `${getBaseUrl()}/v1/webhooks/call-transcripts`
+      let fullUrl = url
+
+      const options: RequestInit = {
+        method: "POST",
+        headers: {},
+        body: JSON.stringify({
+          ...(args.events !== undefined ? { events: args.events } : {}),
+          ...(args.label !== undefined ? { label: args.label } : {}),
+          ...(args.resourceIds !== undefined ? { resourceIds: args.resourceIds } : {}),
+          ...(args.status !== undefined ? { status: args.status } : {}),
+          ...(args.url !== undefined ? { url: args.url } : {}),
+          ...(args.userId !== undefined ? { userId: args.userId } : {})
+        })
+      }
+
+      return fetchAPI(fullUrl, options, context)
+    }
+  }
+]
+
+
+
+/**
+ * Build the OpenAPI tool list lazily.
+ * Pass explicit env/readOnly values to override defaults (useful for composite pets).
+ */
+export function createOpenAPITools(options?: {
+  readOnlyMode?: boolean
+}): ToolDefinition[] {
+  const readOnlyMode = options?.readOnlyMode ?? isReadOnly("quo")
+
+  if (readOnlyMode) {
+    logger.info("READ-ONLY MODE - write operations disabled")
+  }
+
+  const allTools: ToolDefinition[] = [
+    ...coreTools
+  ]
+
+
+// ============================================================================
+// TEST CONNECTION TOOL - Auto-generated for API health check
+// ============================================================================
+const testConnectionTool: ToolDefinition =   {
+    name: "quo-test-connection",
+    description: "Test API connection and verify credentials are configured",
+    schema: z.object({}),
+    async execute(_args: any, context?: any) {
+      try {
+        const currentBaseUrl = getBaseUrl()
+        const testUrl = `${currentBaseUrl}/v1/call-recordings/{callId}`
+        context?.debugLog?.("openapi api request", {
+          method: "GET",
+          url: testUrl
+        })
+        const response = await fetch(testUrl, {
+          method: "GET",
+          headers: getAuthHeaders()
+        })
+        const responseText = await response.text()
+        context?.debugLog?.("openapi api response", {
+          method: "GET",
+          url: testUrl,
+          status: response.status,
+          ok: response.ok,
+          body: responseText
+        })
+
+        if (response.ok) {
+          return JSON.stringify({
+            success: true,
+            status: "connected",
+            api: "OpenPhone Public API",
+            version: "1.0.0",
+            baseUrl: currentBaseUrl
+          }, null, 2)
+        }
+
+        return JSON.stringify({
+          success: false,
+          status: "error",
+          error: `HTTP ${response.status}: ${responseText}`,
+          api: "OpenPhone Public API",
+          baseUrl: currentBaseUrl
+        }, null, 2)
+      } catch (error: any) {
+        return JSON.stringify({
+          success: false,
+          status: "connection_failed",
+          error: error.message,
+          api: "OpenPhone Public API",
+          baseUrl: getBaseUrl()
+        }, null, 2)
+      }
+    }
+  }
+
+
+
+/**
+ * Filter tools by read-only mode using HTTP method classification
+ */
+  function filterByReadOnlyMode(tools: ToolDefinition[]): ToolDefinition[] {
+  if (!readOnlyMode) return tools
+
+  const filtered = tools.filter(t => !writeToolNames.has(t.name))
+  const excluded = tools.length - filtered.length
+
+  if (excluded > 0) {
+    logger.info(`Filtered ${excluded} write tools in read-only mode`)
+  }
+
+  return filtered
+}
+
+  // Final combined tools array
+  const finalTools: ToolDefinition[] = [
+  ...allTools,
+  testConnectionTool
+]
+
+  logger.info(`Loaded ${finalTools.length} tools`)
+
+  return filterByReadOnlyMode(finalTools)
+}
+
+let cachedOpenAPITools: ToolDefinition[] | null = null
+
+function getCachedOpenAPITools(): ToolDefinition[] {
+  if (!cachedOpenAPITools) {
+    cachedOpenAPITools = createOpenAPITools()
+  }
+  return cachedOpenAPITools
+}
+
+// Backward-compatible default export: behaves like ToolDefinition[] while loading lazily.
+export const openAPITools: ToolDefinition[] = new Proxy([] as ToolDefinition[], {
+  get(_target, prop) {
+    const tools = getCachedOpenAPITools() as any
+    const value = tools[prop as keyof typeof tools]
+    return typeof value === "function" ? value.bind(tools) : value
+  },
+  has(_target, prop) {
+    return prop in getCachedOpenAPITools()
+  },
+  ownKeys() {
+    return Reflect.ownKeys(getCachedOpenAPITools())
+  },
+  getOwnPropertyDescriptor(_target, prop) {
+    return Object.getOwnPropertyDescriptor(getCachedOpenAPITools(), prop)
+  }
+})
+
+export const toolsMetadata = [
+  {
+    "name": "quo-get-call-recordings-v1",
+    "description": "Get recordings for a call",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "callId": {
+          "type": "string",
+          "description": "The unique identifier of the call for which recordings are being retrieved.",
+          "optional": false
+        }
+      },
+      "required": [
+        "callId"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-get-call-recordings-v1",
+        "getcallrecordings",
+        "get",
+        "recordings",
+        "for",
+        "call",
+        "call-recordings",
+        "callid",
+        "calls"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-list-calls-v1",
+    "description": "List calls",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "phoneNumberId": {
+          "type": "string",
+          "description": "The unique identifier of the OpenPhone number associated with the call.",
+          "optional": false
+        },
+        "userId": {
+          "type": "string",
+          "description": "The unique identifier of the OpenPhone user who either placed or received the call. Defaults to the workspace owner.",
+          "optional": false
+        },
+        "participants": {
+          "type": "string",
+          "description": "The phone numbers of participants involved in the call conversation, excluding your OpenPhone number. Each number should contain the country code and conform to the E.164 format. Currently limited to one-to-one (1:1) conversations only.",
+          "optional": false
+        },
+        "since": {
+          "type": "string",
+          "description": "DEPRECATED, use \"createdAfter\" or \"createdBefore\" instead. \"since\" incorrectly behaves as \"createdBefore\" and will be removed in an upcoming release.",
+          "optional": false
+        },
+        "createdAfter": {
+          "type": "string",
+          "description": "Filter results to only include calls created after the specified date and time, in ISO 8601 format.",
+          "optional": false
+        },
+        "createdBefore": {
+          "type": "string",
+          "description": "Filter results to only include calls created before the specified date and time, in ISO 8601 format.",
+          "optional": false
+        },
+        "maxResults": {
+          "type": "number",
+          "description": "Maximum number of results to return per page.",
+          "optional": false
+        },
+        "pageToken": {
+          "type": "string",
+          "optional": false
+        }
+      },
+      "required": [
+        "phoneNumberId",
+        "participants",
+        "maxResults"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-list-calls-v1",
+        "listcalls",
+        "list",
+        "calls"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-get-call-by-id-v1",
+    "description": "Get a call by ID",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "callId": {
+          "type": "string",
+          "description": "Unique identifier of the call.",
+          "optional": false
+        }
+      },
+      "required": [
+        "callId"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-get-call-by-id-v1",
+        "getcallbyid",
+        "get",
+        "call",
+        "calls",
+        "callid"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-get-call-summary-v1",
+    "description": "Get a summary for a call",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "callId": {
+          "type": "string",
+          "description": "The unique identifier of the call associated with the summary.",
+          "optional": false
+        }
+      },
+      "required": [
+        "callId"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-get-call-summary-v1",
+        "getcallsummary",
+        "get",
+        "summary",
+        "for",
+        "call",
+        "call-summaries",
+        "callid",
+        "calls"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-get-call-transcript-v1",
+    "description": "Get a transcription for a call",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique identifier of the call associated with this transcript.",
+          "optional": false
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-get-call-transcript-v1",
+        "getcalltranscript",
+        "get",
+        "transcription",
+        "for",
+        "call",
+        "call-transcripts",
+        "calls"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-get-call-voicemails-v1",
+    "description": "Get a voicemail for a call",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "callId": {
+          "type": "string",
+          "description": "The unique identifier of the call for which a voicemail is being retrieved.",
+          "optional": false
+        }
+      },
+      "required": [
+        "callId"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-get-call-voicemails-v1",
+        "getcallvoicemails",
+        "get",
+        "voicemail",
+        "for",
+        "call",
+        "call-voicemails",
+        "callid",
+        "calls"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-get-contact-custom-fields-v1",
+    "description": "Get contact custom fields",
+    "schema": {
+      "type": "object",
+      "properties": {}
+    },
+    "search": {
+      "capabilities": [
+        "quo-get-contact-custom-fields-v1",
+        "getcontactcustomfields",
+        "get",
+        "contact",
+        "custom",
+        "fields",
+        "contact-custom-fields"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-list-contacts-v1",
+    "description": "List contacts",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "externalIds": {
+          "type": "string",
+          "description": "Optional list of unique identifiers from an external system used to retrieve specific contacts. When provided, the result set is limited to contacts associated with the provided `externalIds`. These IDs must match those supplied during contact creation via the \"Create Contacts\" endpoint. When omitted, returns all contacts for the organization. Use this parameter to cross-reference and fetch contacts linked to external systems.",
+          "optional": false
+        },
+        "sources": {
+          "type": "string",
+          "optional": false
+        },
+        "maxResults": {
+          "type": "number",
+          "description": "Maximum number of results to return per page.",
+          "optional": false
+        },
+        "pageToken": {
+          "type": "string",
+          "optional": false
+        }
+      },
+      "required": [
+        "maxResults"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-list-contacts-v1",
+        "listcontacts",
+        "list",
+        "contacts"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-create-contact-v1",
+    "description": "Create a contact",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "defaultFields": {
+          "type": "string",
+          "description": "JSON array",
+          "optional": true
+        },
+        "customFields": {
+          "type": "string",
+          "description": "JSON array",
+          "optional": false
+        },
+        "createdByUserId": {
+          "type": "string",
+          "description": "The unique identifier of the user who created the contact.",
+          "optional": false
+        },
+        "source": {
+          "type": "string",
+          "description": "The contact's source. Defaults to `null` for contacts created in the UI. Defaults to `public-api` for contacts created via the public API. Cannot be one of the following reserved words: `openphone`, `device`, `csv`, `zapier`, `google-people`, `other` or start with one of the following reserved prefixes: `openphone`, `csv`.",
+          "optional": false
+        },
+        "sourceUrl": {
+          "type": "string",
+          "description": "A link to the contact in the source system.",
+          "optional": false
+        },
+        "externalId": {
+          "type": "string",
+          "optional": false
+        }
+      },
+      "required": [
+        "defaultFields"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-create-contact-v1",
+        "createcontact",
+        "create",
+        "contact",
+        "contacts"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-get-contact-by-id-v1",
+    "description": "Get a contact by ID",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "The unique identifier of the contact.",
+          "optional": false
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-get-contact-by-id-v1",
+        "getcontactbyid",
+        "get",
+        "contact",
+        "contacts"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-update-contact-by-id-v1",
+    "description": "Update a contact by ID",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "The unique identifier of the contact.",
+          "optional": false
+        },
+        "externalId": {
+          "type": "string",
+          "optional": false
+        },
+        "source": {
+          "type": "string",
+          "optional": false
+        },
+        "sourceUrl": {
+          "type": "string",
+          "optional": false
+        },
+        "defaultFields": {
+          "type": "string",
+          "description": "JSON array",
+          "optional": true
+        },
+        "customFields": {
+          "type": "string",
+          "description": "JSON array",
+          "optional": false
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-update-contact-by-id-v1",
+        "updatecontactbyid",
+        "update",
+        "contact",
+        "contacts"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-delete-contact-v1",
+    "description": "Delete a contact",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "The unique identifier of the contact.",
+          "optional": false
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-delete-contact-v1",
+        "deletecontact",
+        "delete",
+        "contact",
+        "contacts"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-list-conversations-v1",
+    "description": "List Conversations",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "phoneNumber": {
+          "type": "string",
+          "description": "DEPRECATED, use `phoneNumbers` instead. If both `phoneNumber` and `phoneNumbers` are provided, `phoneNumbers` will be used. Filters results to only include conversations with the specified OpenPhone phone number. Can be either your OpenPhone phone number ID or the full phone number in E.164 format.",
+          "optional": false
+        },
+        "phoneNumbers": {
+          "type": "string",
+          "description": "Filters results to only include conversations with the specified OpenPhone phone numbers. Each item can be either an OpenPhone phone number ID or a full phone number in E.164 format.",
+          "optional": false
+        },
+        "userId": {
+          "type": "string",
+          "description": "The unique identifier of the user the making the request. Used to filter results to only include the user's conversations.",
+          "optional": false
+        },
+        "createdAfter": {
+          "type": "string",
+          "description": "Filter results to only include conversations created after the specified date and time, in ISO_8601 format.",
+          "optional": false
+        },
+        "createdBefore": {
+          "type": "string",
+          "description": "Filter results to only include conversations created before the specified date and time, in ISO_8601 format.",
+          "optional": false
+        },
+        "excludeInactive": {
+          "type": "boolean",
+          "description": "Exclude inactive conversations from the results.",
+          "optional": false
+        },
+        "updatedAfter": {
+          "type": "string",
+          "description": "Filter results to only include conversations updated after the specified date and time, in ISO_8601 format.",
+          "optional": false
+        },
+        "updatedBefore": {
+          "type": "string",
+          "description": "Filter results to only include conversations updated before the specified date and time, in ISO_8601 format.",
+          "optional": false
+        },
+        "maxResults": {
+          "type": "number",
+          "description": "Maximum number of results to return per page.",
+          "optional": false
+        },
+        "pageToken": {
+          "type": "string",
+          "optional": false
+        }
+      },
+      "required": [
+        "maxResults"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-list-conversations-v1",
+        "listconversations",
+        "list",
+        "conversations"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-list-messages-v1",
+    "description": "List messages",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "phoneNumberId": {
+          "type": "string",
+          "description": "The unique identifier of the OpenPhone number used to send or receive the messages. PhoneNumberID can be retrieved via the Get Phone Numbers endpoint.",
+          "optional": false
+        },
+        "userId": {
+          "type": "string",
+          "description": "The unique identifier of the user the message was sent from.",
+          "optional": false
+        },
+        "participants": {
+          "type": "string",
+          "description": "Array of phone numbers involved in the conversation, excluding your OpenPhone number, in E.164 format.",
+          "optional": false
+        },
+        "since": {
+          "type": "string",
+          "description": "DEPRECATED, use \"createdAfter\" or \"createdBefore\" instead. \"since\" currently behaves as \"createdBefore\" and will be removed in an upcoming release.",
+          "optional": false
+        },
+        "createdAfter": {
+          "type": "string",
+          "description": "Filter results to only include messages created after the specified date and time, in ISO_8601 format.",
+          "optional": false
+        },
+        "createdBefore": {
+          "type": "string",
+          "description": "Filter results to only include messages created before the specified date and time, in ISO_8601 format.",
+          "optional": false
+        },
+        "maxResults": {
+          "type": "number",
+          "description": "Maximum number of results to return per page.",
+          "optional": false
+        },
+        "pageToken": {
+          "type": "string",
+          "optional": false
+        }
+      },
+      "required": [
+        "phoneNumberId",
+        "participants",
+        "maxResults"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-list-messages-v1",
+        "listmessages",
+        "list",
+        "messages"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-send-message-v1",
+    "description": "Send a text message",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "content": {
+          "type": "string",
+          "description": "The text content of the message to be sent.",
+          "optional": false
+        },
+        "phoneNumberId": {
+          "type": "string",
+          "description": "DEPRECATED, use \"from\" instead. OpenPhone phone number ID to send a message from",
+          "optional": false
+        },
+        "from": {
+          "type": "string",
+          "optional": false
+        },
+        "to": {
+          "type": "string",
+          "description": "JSON array",
+          "optional": false
+        },
+        "userId": {
+          "type": "string",
+          "description": "The unique identifier of the OpenPhone user sending the message. If not provided, defaults to the phone number owner.",
+          "optional": false
+        },
+        "setInboxStatus": {
+          "type": "string",
+          "enum": [
+            "done"
+          ],
+          "description": "Used to set the status of the related OpenPhone inbox conversation. The default behavior without setting this parameter will be for the message sent to show up as an open conversation in the user's inbox. Setting the parameter to `'done'` would move the conversation to the Done inbox view.",
+          "optional": false
+        }
+      },
+      "required": [
+        "content",
+        "from",
+        "to"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-send-message-v1",
+        "sendmessage",
+        "send",
+        "text",
+        "message",
+        "messages"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-get-message-by-id-v1",
+    "description": "Get a message by ID",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "The unique identifier of a message",
+          "optional": false
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-get-message-by-id-v1",
+        "getmessagebyid",
+        "get",
+        "message",
+        "messages"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-list-phone-numbers-v1",
+    "description": "List phone numbers",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "userId": {
+          "type": "string",
+          "description": "Filter results to return only phone numbers associated with the specified user\"s unique identifier.",
+          "optional": false
+        }
+      }
+    },
+    "search": {
+      "capabilities": [
+        "quo-list-phone-numbers-v1",
+        "listphonenumbers",
+        "list",
+        "phone",
+        "numbers",
+        "phone-numbers"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-get-phone-number-by-id-v1",
+    "description": "Get a phone number by ID",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "phoneNumberId": {
+          "type": "string",
+          "description": "Unique identifier of the phone number.",
+          "optional": false
+        }
+      },
+      "required": [
+        "phoneNumberId"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-get-phone-number-by-id-v1",
+        "getphonenumberbyid",
+        "get",
+        "phone",
+        "number",
+        "phone-numbers",
+        "phonenumberid",
+        "numbers"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-list-users-v1",
+    "description": "List users",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "maxResults": {
+          "type": "number",
+          "description": "Maximum number of results to return per page.",
+          "optional": false
+        },
+        "pageToken": {
+          "type": "string",
+          "optional": false
+        }
+      },
+      "required": [
+        "maxResults"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-list-users-v1",
+        "listusers",
+        "list",
+        "users"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-get-user-by-id-v1",
+    "description": "Get a user by ID",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "userId": {
+          "type": "string",
+          "description": "The unique identifier of the user being retrieved.",
+          "optional": false
+        }
+      },
+      "required": [
+        "userId"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-get-user-by-id-v1",
+        "getuserbyid",
+        "get",
+        "user",
+        "users",
+        "userid"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-list-webhooks-v1",
+    "description": "Lists all webhooks",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "userId": {
+          "type": "string",
+          "description": "The unique identifier the user. Defaults to the workspace owner.",
+          "optional": false
+        }
+      }
+    },
+    "search": {
+      "capabilities": [
+        "quo-list-webhooks-v1",
+        "listwebhooks",
+        "lists",
+        "all",
+        "webhooks"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-get-webhook-by-id-v1",
+    "description": "Get a webhook by ID",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "The unique identifier of a webhook",
+          "optional": false
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-get-webhook-by-id-v1",
+        "getwebhookbyid",
+        "get",
+        "webhook",
+        "webhooks"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-delete-webhook-by-id-v1",
+    "description": "Delete a webhook by ID",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "The unique identifier of a webhook",
+          "optional": false
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-delete-webhook-by-id-v1",
+        "deletewebhookbyid",
+        "delete",
+        "webhook",
+        "webhooks"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-create-message-webhook-v1",
+    "description": "Create a new webhook for messages",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "events": {
+          "type": "string",
+          "optional": false
+        },
+        "label": {
+          "type": "string",
+          "description": "Webhook's label",
+          "optional": false
+        },
+        "resourceIds": {
+          "type": "string",
+          "optional": false
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "enabled",
+            "disabled"
+          ],
+          "description": "The status of the webhook.",
+          "optional": false
+        },
+        "url": {
+          "type": "string",
+          "description": "The endpoint that receives events from the webhook.",
+          "optional": false
+        },
+        "userId": {
+          "type": "string",
+          "description": "The unique identifier of the user that creates the webhook. If not provided, default to workspace owner.",
+          "optional": false
+        }
+      },
+      "required": [
+        "events",
+        "url"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-create-message-webhook-v1",
+        "createmessagewebhook",
+        "create",
+        "new",
+        "webhook",
+        "for",
+        "messages",
+        "webhooks"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-create-call-webhook-v1",
+    "description": "Create a new webhook for calls",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "url": {
+          "type": "string",
+          "description": "The endpoint that receives events from the webhook.",
+          "optional": false
+        },
+        "events": {
+          "type": "string",
+          "optional": false
+        },
+        "resourceIds": {
+          "type": "string",
+          "optional": false
+        },
+        "userId": {
+          "type": "string",
+          "description": "The unique identifier of the user that creates the webhook. If not provided, default to workspace owner.",
+          "optional": false
+        },
+        "label": {
+          "type": "string",
+          "description": "Webhook's label",
+          "optional": false
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "enabled",
+            "disabled"
+          ],
+          "description": "The status of the webhook.",
+          "optional": false
+        }
+      },
+      "required": [
+        "url",
+        "events"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-create-call-webhook-v1",
+        "createcallwebhook",
+        "create",
+        "new",
+        "webhook",
+        "for",
+        "calls",
+        "webhooks"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-create-call-summary-webhook-v1",
+    "description": "Create a new webhook for call summaries",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "events": {
+          "type": "string",
+          "optional": false
+        },
+        "label": {
+          "type": "string",
+          "description": "Webhook's label",
+          "optional": false
+        },
+        "resourceIds": {
+          "type": "string",
+          "optional": false
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "enabled",
+            "disabled"
+          ],
+          "description": "The status of the webhook.",
+          "optional": false
+        },
+        "url": {
+          "type": "string",
+          "description": "The endpoint that receives events from the webhook.",
+          "optional": false
+        },
+        "userId": {
+          "type": "string",
+          "description": "The unique identifier of the user that creates the webhook. If not provided, default to workspace owner.",
+          "optional": false
+        }
+      },
+      "required": [
+        "events",
+        "url"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-create-call-summary-webhook-v1",
+        "createcallsummarywebhook",
+        "create",
+        "new",
+        "webhook",
+        "for",
+        "call",
+        "summaries",
+        "webhooks",
+        "call-summaries"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-create-call-transcript-webhook-v1",
+    "description": "Create a new webhook for call transcripts",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "events": {
+          "type": "string",
+          "optional": false
+        },
+        "label": {
+          "type": "string",
+          "description": "The webhook's label.",
+          "optional": false
+        },
+        "resourceIds": {
+          "type": "string",
+          "optional": false
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "enabled",
+            "disabled"
+          ],
+          "description": "The status of the webhook.",
+          "optional": false
+        },
+        "url": {
+          "type": "string",
+          "description": "The endpoint that receives events from the webhook.",
+          "optional": false
+        },
+        "userId": {
+          "type": "string",
+          "description": "The ID of the user that creates the webhook. If not provided, default to workspace owner.",
+          "optional": false
+        }
+      },
+      "required": [
+        "events",
+        "url"
+      ]
+    },
+    "search": {
+      "capabilities": [
+        "quo-create-call-transcript-webhook-v1",
+        "createcalltranscriptwebhook",
+        "create",
+        "new",
+        "webhook",
+        "for",
+        "call",
+        "transcripts",
+        "webhooks",
+        "call-transcripts"
+      ],
+      "intents": []
+    }
+  },
+  {
+    "name": "quo-test-connection",
+    "description": "Test API connection and verify credentials are configured",
+    "schema": {
+      "type": "object",
+      "properties": {}
+    },
+    "search": {
+      "capabilities": [
+        "quo",
+        "test",
+        "connection",
+        "health"
+      ],
+      "intents": [
+        "connection"
+      ]
+    }
+  }
+]
+
+
+export default openAPITools