@zaapi/open-api-mcp 1.0.0

package/README.md

@@ -0,0 +1,37 @@
+# Zaapi Open API MCP
+
+MCP server for the [Zaapi Open API](https://openplatform.zaapi.co). It exposes each public `/v1` operation as a tool over stdio.
+
+## Install
+
+```json
+{
+  "mcpServers": {
+    "zaapi": {
+      "command": "npx",
+      "args": ["-y", "@zaapi/open-api-mcp"],
+      "env": {
+        "ZAAPI_BASE_URL": "https://openplatform.zaapi.co",
+        "ZAAPI_API_KEY": "<usage-plan key>"
+      }
+    }
+  }
+}
+```
+
+| Variable | Required | Description |
+| --- | --- | --- |
+| `ZAAPI_API_KEY` | yes | Store API key (`x-api-key`). Keys start with `zaapi_`. |
+| `ZAAPI_BASE_URL` | no | Defaults to `https://openplatform.zaapi.co`. Use `https://openplatform-staging.zaapi.co` for staging. |
+
+Create keys in the Zaapi App under **Settings → Developers**.
+
+## Local development
+
+```bash
+npm install
+npm run build
+ZAAPI_API_KEY=zaapi_… npm start
+```
+
+Point an MCP client at `node` with args `["/path/to/zaapi-open-api-mcp/dist/index.js"]` and the same env vars.

package/dist/client.js

@@ -0,0 +1,59 @@
+import { loadConfig } from './config.js';
+const PAGE_SIZE_HEADER = 'x-pagination-page-size';
+const NEXT_CURSOR_HEADER = 'x-pagination-next-cursor';
+export class ZaapiClient {
+    config;
+    fetchFn;
+    constructor(config, fetchFn = fetch) {
+        this.config = config;
+        this.fetchFn = fetchFn;
+    }
+    static fromEnv(env = process.env, fetchFn = fetch) {
+        return new ZaapiClient(loadConfig(env), fetchFn);
+    }
+    async request(request) {
+        const url = this.buildUrl(request.path, request.query);
+        const headers = {
+            'x-api-key': this.config.apiKey,
+            accept: 'application/json',
+        };
+        const init = { method: request.method, headers };
+        if (request.method !== 'GET' && request.body) {
+            headers['content-type'] = 'application/json';
+            init.body = JSON.stringify(request.body);
+        }
+        const response = await this.fetchFn(url, init);
+        const text = await response.text();
+        let body = text;
+        if (text) {
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                body = text;
+            }
+        }
+        return {
+            status: response.status,
+            body,
+            pagination: {
+                pageSize: response.headers.get(PAGE_SIZE_HEADER) ?? undefined,
+                nextCursor: response.headers.get(NEXT_CURSOR_HEADER) ?? undefined,
+            },
+        };
+    }
+    buildUrl(path, query) {
+        const url = new URL(path, `${this.config.baseUrl}/`);
+        if (!query) {
+            return url.toString();
+        }
+        for (const [key, value] of Object.entries(query)) {
+            if (value === undefined || value === null) {
+                continue;
+            }
+            url.searchParams.set(key, Array.isArray(value) ? value.join(',') : String(value));
+        }
+        return url.toString();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAoB,MAAM,aAAa,CAAC;AAsB3D,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAClD,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAEtD,MAAM,OAAO,WAAW;IAEH;IACA;IAFnB,YACmB,MAAmB,EACnB,UAAmB,KAAK;QADxB,WAAM,GAAN,MAAM,CAAa;QACnB,YAAO,GAAP,OAAO,CAAiB;IACxC,CAAC;IAEJ,MAAM,CAAC,OAAO,CACZ,MAA2B,OAAO,CAAC,GAAG,EACtC,UAAmB,KAAK;QAExB,OAAO,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAqB;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,OAAO,GAA2B;YACtC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC/B,MAAM,EAAE,kBAAkB;SAC3B,CAAC;QAEF,MAAM,IAAI,GAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YAC7C,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;YAC7C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,IAAI,GAAY,IAAI,CAAC;QACzB,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC;gBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,GAAG,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,IAAI;YACJ,UAAU,EAAE;gBACV,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,SAAS;gBAC7D,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,SAAS;aAClE;SACF,CAAC;IACJ,CAAC;IAEO,QAAQ,CAAC,IAAY,EAAE,KAA+B;QAC5D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;QACrD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;QACxB,CAAC;QAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1C,SAAS;YACX,CAAC;YACD,GAAG,CAAC,YAAY,CAAC,GAAG,CAClB,GAAG,EACH,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;QACJ,CAAC;QAED,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/config.js

@@ -0,0 +1,13 @@
+const DEFAULT_BASE_URL = 'https://openplatform.zaapi.co';
+export function loadConfig(env = process.env) {
+    const apiKey = env.ZAAPI_API_KEY?.trim();
+    if (!apiKey) {
+        throw new Error('ZAAPI_API_KEY is required');
+    }
+    const baseUrl = (env.ZAAPI_BASE_URL?.trim() || DEFAULT_BASE_URL).replace(/\/+$/, '');
+    return {
+        baseUrl,
+        apiKey,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,+BAA+B,CAAC;AAOzD,MAAM,UAAU,UAAU,CACxB,MAA2B,OAAO,CAAC,GAAG;IAEtC,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;IACzC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,gBAAgB,CAAC,CAAC,OAAO,CACtE,MAAM,EACN,EAAE,CACH,CAAC;IAEF,OAAO;QACL,OAAO;QACP,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import { serveStdio } from '@modelcontextprotocol/server/stdio';
+import { ZaapiClient } from './client.js';
+import { loadConfig } from './config.js';
+import { createZaapiServer } from './server.js';
+try {
+    const config = loadConfig();
+    const client = new ZaapiClient(config);
+    serveStdio(() => createZaapiServer(client));
+}
+catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`${message}\n`);
+    process.exit(1);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,IAAI,CAAC;IACH,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,UAAU,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9C,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/server.js

@@ -0,0 +1,68 @@
+import { McpServer } from '@modelcontextprotocol/server';
+import { splitInput, tools } from './tools/index.js';
+export function createZaapiServer(client) {
+    const server = new McpServer({
+        name: 'zaapi',
+        version: '1.0.0',
+    });
+    for (const tool of tools) {
+        server.registerTool(tool.name, {
+            title: tool.title,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+            annotations: tool.annotations,
+        }, createToolHandler(client, tool));
+    }
+    return server;
+}
+export function createToolHandler(client, tool) {
+    return async (input) => {
+        const args = input && typeof input === 'object' && !Array.isArray(input)
+            ? input
+            : {};
+        const { query, body } = splitRequest(tool, args);
+        const result = await client.request({
+            method: tool.method,
+            path: tool.path,
+            query,
+            body,
+        });
+        const payload = {
+            status: result.status,
+            data: unwrapOpenApiEnvelope(result.body),
+            ...(result.pagination.pageSize || result.pagination.nextCursor
+                ? { pagination: result.pagination }
+                : {}),
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(payload) }],
+            isError: result.status >= 400,
+        };
+    };
+}
+function unwrapOpenApiEnvelope(body) {
+    if (body === null || typeof body !== 'object' || Array.isArray(body)) {
+        return body;
+    }
+    if ('data' in body) {
+        return body.data;
+    }
+    if ('error' in body) {
+        return body.error;
+    }
+    return body;
+}
+function splitRequest(tool, input) {
+    switch (tool.method) {
+        case 'GET':
+            return splitInput(input, Object.keys(input));
+        case 'POST':
+        case 'PATCH':
+            return splitInput(input, tool.queryKeys);
+        default: {
+            const _exhaustive = tool.method;
+            throw new Error(`Unsupported method: ${_exhaustive}`);
+        }
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/close-ticket.js

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import { expand } from './common.js';
+export const closeTicket = {
+    name: 'closeTicket',
+    title: 'Close a ticket',
+    description: 'Required scope: tickets:write. Close a ticket. You can record who handled it, conversion details, and ticket field values in the same request.',
+    method: 'PATCH',
+    path: '/v1/tickets/close',
+    queryKeys: ['expand'],
+    inputSchema: z.object({
+        expand: expand('Related objects to include on the closed ticket.'),
+        ticketId: z.string(),
+        handledBy: z.string().uuid().optional(),
+        isConverted: z.boolean().optional(),
+        totalRevenue: z.number().min(0).optional(),
+        currency: z.string().optional(),
+        ticketFields: z.record(z.string(), z.any()).optional(),
+    }),
+    annotations: { readOnlyHint: false, destructiveHint: true },
+};
+//# sourceMappingURL=close-ticket.js.map

package/dist/tools/close-ticket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-ticket.js","sourceRoot":"","sources":["../../src/tools/close-ticket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAqB,MAAM,aAAa,CAAC;AAExD,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,gBAAgB;IACvB,WAAW,EACT,gJAAgJ;IAClJ,MAAM,EAAE,OAAO;IACf,IAAI,EAAE,mBAAmB;IACzB,SAAS,EAAE,CAAC,QAAQ,CAAC;IACrB,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC,kDAAkD,CAAC;QAClE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;QACvC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QACnC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;KACvD,CAAC;IACF,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE;CAC5D,CAAC"}

package/dist/tools/common.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+export const pageSize = z
+    .number()
+    .int()
+    .min(1)
+    .max(50)
+    .optional()
+    .describe('Items per page. Defaults to 20. Maximum 50.');
+export const messagePageSize = z
+    .number()
+    .int()
+    .min(1)
+    .max(15)
+    .optional()
+    .describe('Items per page. Maximum 15 on this endpoint.');
+export const cursor = z
+    .string()
+    .optional()
+    .describe('Opaque token from the previous page x-pagination-next-cursor header.');
+export const expand = (description) => z
+    .union([z.string(), z.array(z.string())])
+    .optional()
+    .describe(description);
+export const paginationQueryKeys = ['pageSize', 'cursor', 'expand'];
+export const paginationFields = {
+    pageSize,
+    cursor,
+};
+//# sourceMappingURL=common.js.map

package/dist/tools/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/tools/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC;KACtB,MAAM,EAAE;KACR,GAAG,EAAE;KACL,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,QAAQ,EAAE;KACV,QAAQ,CAAC,6CAA6C,CAAC,CAAC;AAE3D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,EAAE;KACR,GAAG,EAAE;KACL,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,QAAQ,EAAE;KACV,QAAQ,CAAC,8CAA8C,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC;KACpB,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CACP,sEAAsE,CACvE,CAAC;AAEJ,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,WAAmB,EAAE,EAAE,CAC5C,CAAC;KACE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;KACxC,QAAQ,EAAE;KACV,QAAQ,CAAC,WAAW,CAAC,CAAC;AAE3B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAE7E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,QAAQ;IACR,MAAM;CACP,CAAC"}

package/dist/tools/contacts/create-contact.js

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export const createContact = {
+    name: 'createContact',
+    title: 'Create a contact',
+    description: 'Required scope: contacts:write. Create a contact. A contact whose email or phone already exists is rejected with 409.',
+    method: 'POST',
+    path: '/v1/contacts',
+    queryKeys: [],
+    inputSchema: z.object({
+        firstName: z.string().max(50),
+        lastName: z.string().max(50).optional(),
+        email: z.string().email().max(100).optional(),
+        phone: z
+            .string()
+            .max(15)
+            .optional()
+            .describe('Primary phone number in E.164 format.'),
+    }),
+    annotations: { readOnlyHint: false, destructiveHint: false },
+};
+//# sourceMappingURL=create-contact.js.map

package/dist/tools/contacts/create-contact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-contact.js","sourceRoot":"","sources":["../../../src/tools/contacts/create-contact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,aAAa,GAAiB;IACzC,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,kBAAkB;IACzB,WAAW,EACT,uHAAuH;IACzH,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,cAAc;IACpB,SAAS,EAAE,EAAE;IACb,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;QACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;QAC7C,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,CAAC,EAAE,CAAC;aACP,QAAQ,EAAE;aACV,QAAQ,CAAC,uCAAuC,CAAC;KACrD,CAAC;IACF,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE;CAC7D,CAAC"}

package/dist/tools/contacts/get-contact-by-id.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export const getContactById = {
+    name: 'getContactById',
+    title: 'Get a contact by ID',
+    description: 'Required scope: contacts:read. Fetch a single contact, including custom field values.',
+    method: 'GET',
+    path: '/v1/contacts',
+    queryKeys: ['contactId'],
+    inputSchema: z.object({
+        contactId: z.string(),
+    }),
+    annotations: { readOnlyHint: true },
+};
+//# sourceMappingURL=get-contact-by-id.js.map

package/dist/tools/contacts/get-contact-by-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-contact-by-id.js","sourceRoot":"","sources":["../../../src/tools/contacts/get-contact-by-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC1C,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EACT,uFAAuF;IACzF,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,cAAc;IACpB,SAAS,EAAE,CAAC,WAAW,CAAC;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;IACF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;CACpC,CAAC"}

package/dist/tools/contacts/list-contact-fields.js

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export const listContactFields = {
+    name: 'listContactFields',
+    title: 'List contact fields',
+    description: 'Required scope: contacts:read. Fetch contact field definitions for the store.',
+    method: 'GET',
+    path: '/v1/contacts/fields',
+    queryKeys: [],
+    inputSchema: z.object({}),
+    annotations: { readOnlyHint: true },
+};
+//# sourceMappingURL=list-contact-fields.js.map

package/dist/tools/contacts/list-contact-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-contact-fields.js","sourceRoot":"","sources":["../../../src/tools/contacts/list-contact-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,iBAAiB,GAAiB;IAC7C,IAAI,EAAE,mBAAmB;IACzB,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EACT,+EAA+E;IACjF,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,qBAAqB;IAC3B,SAAS,EAAE,EAAE;IACb,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACzB,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;CACpC,CAAC"}

package/dist/tools/contacts/list-contacts.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { paginationFields } from '../common.js';
+export const listContacts = {
+    name: 'listContacts',
+    title: 'List contacts',
+    description: 'Required scope: contacts:read. Search and page through contacts, most recently updated first.',
+    method: 'POST',
+    path: '/v1/contacts/list',
+    queryKeys: ['pageSize', 'cursor'],
+    inputSchema: z.object({
+        ...paginationFields,
+        search: z
+            .string()
+            .max(100)
+            .optional()
+            .describe('Free-text search across name, email, and phone.'),
+        updatedAfter: z.string().optional(),
+        updatedBefore: z.string().optional(),
+    }),
+    annotations: { readOnlyHint: true },
+};
+//# sourceMappingURL=list-contacts.js.map

package/dist/tools/contacts/list-contacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-contacts.js","sourceRoot":"","sources":["../../../src/tools/contacts/list-contacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAqB,MAAM,cAAc,CAAC;AAEnE,MAAM,CAAC,MAAM,YAAY,GAAiB;IACxC,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,eAAe;IACtB,WAAW,EACT,+FAA+F;IACjG,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,mBAAmB;IACzB,SAAS,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,GAAG,gBAAgB;QACnB,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,CAAC,GAAG,CAAC;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,iDAAiD,CAAC;QAC9D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACnC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACrC,CAAC;IACF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;CACpC,CAAC"}

package/dist/tools/contacts/update-contact-field.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export const updateContactField = {
+    name: 'updateContactField',
+    title: 'Update a contact field value',
+    description: 'Required scope: contacts:write. Set or clear a custom field. Pass the customFieldsUpdatedAt you last read as updatedAt; a mismatch is rejected.',
+    method: 'PATCH',
+    path: '/v1/contacts/fields',
+    queryKeys: [],
+    inputSchema: z.object({
+        contactId: z.string(),
+        contactFieldId: z.string(),
+        value: z.any().nullable(),
+        updatedAt: z.string(),
+    }),
+    annotations: { readOnlyHint: false, destructiveHint: false },
+};
+//# sourceMappingURL=update-contact-field.js.map

package/dist/tools/contacts/update-contact-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-contact-field.js","sourceRoot":"","sources":["../../../src/tools/contacts/update-contact-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,kBAAkB,GAAiB;IAC9C,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,8BAA8B;IACrC,WAAW,EACT,iJAAiJ;IACnJ,MAAM,EAAE,OAAO;IACf,IAAI,EAAE,qBAAqB;IAC3B,SAAS,EAAE,EAAE;IACb,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1B,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QACzB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;IACF,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE;CAC7D,CAAC"}

package/dist/tools/conversations/filter-conversations.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { expand, paginationFields, paginationQueryKeys, } from '../common.js';
+const filterConversationsExpand = expand('Pass account to replace accountId with { id, name, channel }.');
+export const filterConversations = {
+    name: 'filterConversations',
+    title: 'Filter conversations by ID or contact',
+    description: 'Required scope: conversations:read. Send conversationId and/or contactId — at least one is required. Paginate with pageSize and cursor. Pass expand=account to replace accountId.',
+    method: 'GET',
+    path: '/v1/conversations',
+    queryKeys: ['conversationId', 'contactId', ...paginationQueryKeys],
+    inputSchema: z.union([
+        z.object({
+            conversationId: z.string().min(1),
+            contactId: z.string().min(1).optional(),
+            ...paginationFields,
+            expand: filterConversationsExpand,
+        }),
+        z.object({
+            contactId: z.string().min(1),
+            conversationId: z.string().min(1).optional(),
+            ...paginationFields,
+            expand: filterConversationsExpand,
+        }),
+    ]),
+    annotations: { readOnlyHint: true },
+};
+//# sourceMappingURL=filter-conversations.js.map

package/dist/tools/conversations/filter-conversations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-conversations.js","sourceRoot":"","sources":["../../../src/tools/conversations/filter-conversations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,MAAM,EACN,gBAAgB,EAChB,mBAAmB,GAEpB,MAAM,cAAc,CAAC;AAEtB,MAAM,yBAAyB,GAAG,MAAM,CACtC,+DAA+D,CAChE,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAiB;IAC/C,IAAI,EAAE,qBAAqB;IAC3B,KAAK,EAAE,uCAAuC;IAC9C,WAAW,EACT,mLAAmL;IACrL,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,mBAAmB;IACzB,SAAS,EAAE,CAAC,gBAAgB,EAAE,WAAW,EAAE,GAAG,mBAAmB,CAAC;IAClE,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC;QACnB,CAAC,CAAC,MAAM,CAAC;YACP,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YACvC,GAAG,gBAAgB;YACnB,MAAM,EAAE,yBAAyB;SAClC,CAAC;QACF,CAAC,CAAC,MAAM,CAAC;YACP,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YAC5C,GAAG,gBAAgB;YACnB,MAAM,EAAE,yBAAyB;SAClC,CAAC;KACH,CAAC;IACF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;CACpC,CAAC"}

package/dist/tools/conversations/mark-conversation-read.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export const markConversationRead = {
+    name: 'markConversationRead',
+    title: 'Mark a conversation as read',
+    description: "Required scope: conversations:write. Clears the unread count on the conversation's open ticket. Idempotent. A conversation with no open ticket returns 404.",
+    method: 'PATCH',
+    path: '/v1/conversations/read',
+    queryKeys: [],
+    inputSchema: z.object({
+        conversationId: z.string(),
+    }),
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    },
+};
+//# sourceMappingURL=mark-conversation-read.js.map

package/dist/tools/conversations/mark-conversation-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-conversation-read.js","sourceRoot":"","sources":["../../../src/tools/conversations/mark-conversation-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,oBAAoB,GAAiB;IAChD,IAAI,EAAE,sBAAsB;IAC5B,KAAK,EAAE,6BAA6B;IACpC,WAAW,EACT,6JAA6J;IAC/J,MAAM,EAAE,OAAO;IACf,IAAI,EAAE,wBAAwB;IAC9B,SAAS,EAAE,EAAE;IACb,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;KAC3B,CAAC;IACF,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB;CACF,CAAC"}

package/dist/tools/conversations/update-conversation-labels.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+export const updateConversationLabels = {
+    name: 'updateConversationLabels',
+    title: 'Update conversation labels',
+    description: 'Required scope: conversations:write. Add and/or remove up to 10 labels. At least one of addLabels or removeLabels is required.',
+    method: 'PATCH',
+    path: '/v1/conversations/labels',
+    queryKeys: [],
+    inputSchema: z.union([
+        z.object({
+            conversationId: z.string().min(1),
+            addLabels: z.array(z.string()).min(1).max(10),
+            removeLabels: z.array(z.string()).max(10).optional(),
+        }),
+        z.object({
+            conversationId: z.string().min(1),
+            removeLabels: z.array(z.string()).min(1).max(10),
+            addLabels: z.array(z.string()).max(10).optional(),
+        }),
+    ]),
+    annotations: { readOnlyHint: false, destructiveHint: false },
+};
+//# sourceMappingURL=update-conversation-labels.js.map

package/dist/tools/conversations/update-conversation-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-conversation-labels.js","sourceRoot":"","sources":["../../../src/tools/conversations/update-conversation-labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,wBAAwB,GAAiB;IACpD,IAAI,EAAE,0BAA0B;IAChC,KAAK,EAAE,4BAA4B;IACnC,WAAW,EACT,gIAAgI;IAClI,MAAM,EAAE,OAAO;IACf,IAAI,EAAE,0BAA0B;IAChC,SAAS,EAAE,EAAE;IACb,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC;QACnB,CAAC,CAAC,MAAM,CAAC;YACP,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACjC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;SACrD,CAAC;QACF,CAAC,CAAC,MAAM,CAAC;YACP,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACjC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAChD,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;SAClD,CAAC;KACH,CAAC;IACF,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE;CAC7D,CAAC"}

package/dist/tools/create-contact.js

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export const createContact = {
+    name: 'createContact',
+    title: 'Create a contact',
+    description: 'Required scope: contacts:write. Create a contact. A contact whose email or phone already exists is rejected with 409.',
+    method: 'POST',
+    path: '/v1/contacts',
+    queryKeys: [],
+    inputSchema: z.object({
+        firstName: z.string().max(50),
+        lastName: z.string().max(50).optional(),
+        email: z.string().email().max(100).optional(),
+        phone: z
+            .string()
+            .max(15)
+            .optional()
+            .describe('Primary phone number in E.164 format.'),
+    }),
+    annotations: { readOnlyHint: false, destructiveHint: false },
+};
+//# sourceMappingURL=create-contact.js.map

package/dist/tools/create-contact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-contact.js","sourceRoot":"","sources":["../../src/tools/create-contact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,aAAa,GAAiB;IACzC,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,kBAAkB;IACzB,WAAW,EACT,uHAAuH;IACzH,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,cAAc;IACpB,SAAS,EAAE,EAAE;IACb,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;QACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;QAC7C,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,CAAC,EAAE,CAAC;aACP,QAAQ,EAAE;aACV,QAAQ,CAAC,uCAAuC,CAAC;KACrD,CAAC;IACF,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE;CAC7D,CAAC"}

package/dist/tools/create-internal-comment.js

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+export const createInternalComment = {
+    name: 'createInternalComment',
+    title: 'Add an internal comment',
+    description: 'Required scope: messages:write. Add a seller-private note. Not sent to the customer.',
+    method: 'POST',
+    path: '/v1/messages/internal-comments',
+    queryKeys: [],
+    inputSchema: z.object({
+        conversationId: z.string(),
+        text: z.string(),
+    }),
+    annotations: { readOnlyHint: false, destructiveHint: false },
+};
+//# sourceMappingURL=create-internal-comment.js.map

package/dist/tools/create-internal-comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-internal-comment.js","sourceRoot":"","sources":["../../src/tools/create-internal-comment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,IAAI,EAAE,uBAAuB;IAC7B,KAAK,EAAE,yBAAyB;IAChC,WAAW,EACT,sFAAsF;IACxF,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,gCAAgC;IACtC,SAAS,EAAE,EAAE;IACb,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;IACF,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE;CAC7D,CAAC"}

package/dist/tools/filter-conversations.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { expand, paginationFields, paginationQueryKeys, } from './common.js';
+export const filterConversations = {
+    name: 'filterConversations',
+    title: 'Filter conversations by ID or contact',
+    description: 'Required scope: conversations:read. Send conversationId and/or contactId — at least one is required. Paginate with pageSize and cursor. Pass expand=account to replace accountId.',
+    method: 'GET',
+    path: '/v1/conversations',
+    queryKeys: ['conversationId', 'contactId', ...paginationQueryKeys],
+    inputSchema: z.object({
+        conversationId: z.string().optional(),
+        contactId: z.string().optional(),
+        ...paginationFields,
+        expand: expand('Pass account to replace accountId with { id, name, channel }.'),
+    }),
+    annotations: { readOnlyHint: true },
+};
+//# sourceMappingURL=filter-conversations.js.map

package/dist/tools/filter-conversations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-conversations.js","sourceRoot":"","sources":["../../src/tools/filter-conversations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,MAAM,EACN,gBAAgB,EAChB,mBAAmB,GAEpB,MAAM,aAAa,CAAC;AAErB,MAAM,CAAC,MAAM,mBAAmB,GAAiB;IAC/C,IAAI,EAAE,qBAAqB;IAC3B,KAAK,EAAE,uCAAuC;IAC9C,WAAW,EACT,mLAAmL;IACrL,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,mBAAmB;IACzB,SAAS,EAAE,CAAC,gBAAgB,EAAE,WAAW,EAAE,GAAG,mBAAmB,CAAC;IAClE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,GAAG,gBAAgB;QACnB,MAAM,EAAE,MAAM,CACZ,+DAA+D,CAChE;KACF,CAAC;IACF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;CACpC,CAAC"}

package/dist/tools/get-contact-by-id.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export const getContactById = {
+    name: 'getContactById',
+    title: 'Get a contact by ID',
+    description: 'Required scope: contacts:read. Fetch a single contact, including custom field values.',
+    method: 'GET',
+    path: '/v1/contacts',
+    queryKeys: ['contactId'],
+    inputSchema: z.object({
+        contactId: z.string(),
+    }),
+    annotations: { readOnlyHint: true },
+};
+//# sourceMappingURL=get-contact-by-id.js.map

package/dist/tools/get-contact-by-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-contact-by-id.js","sourceRoot":"","sources":["../../src/tools/get-contact-by-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC1C,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EACT,uFAAuF;IACzF,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,cAAc;IACpB,SAAS,EAAE,CAAC,WAAW,CAAC;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;IACF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;CACpC,CAAC"}

package/dist/tools/get-messages.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { cursor, expand, messagePageSize, } from './common.js';
+export const getMessages = {
+    name: 'getMessages',
+    title: 'List messages',
+    description: 'Required scope: messages:read. Customer-facing messages, newest first. Send conversationId and/or ticketId — at least one is required. pageSize max 15.',
+    method: 'GET',
+    path: '/v1/messages',
+    queryKeys: ['conversationId', 'ticketId', 'pageSize', 'cursor', 'expand'],
+    inputSchema: z.object({
+        conversationId: z.string().optional(),
+        ticketId: z.string().optional(),
+        pageSize: messagePageSize,
+        cursor,
+        expand: expand('Pass sentBy,conversation,account to add related names.'),
+    }),
+    annotations: { readOnlyHint: true },
+};
+//# sourceMappingURL=get-messages.js.map

package/dist/tools/get-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-messages.js","sourceRoot":"","sources":["../../src/tools/get-messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,MAAM,EACN,MAAM,EACN,eAAe,GAEhB,MAAM,aAAa,CAAC;AAErB,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,eAAe;IACtB,WAAW,EACT,yJAAyJ;IAC3J,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,cAAc;IACpB,SAAS,EAAE,CAAC,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC;IACzE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,QAAQ,EAAE,eAAe;QACzB,MAAM;QACN,MAAM,EAAE,MAAM,CAAC,wDAAwD,CAAC;KACzE,CAAC;IACF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;CACpC,CAAC"}

package/dist/tools/get-ticket-by-id.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import { expand } from './common.js';
+export const getTicketById = {
+    name: 'getTicketById',
+    title: 'Get a ticket by ID',
+    description: 'Required scope: tickets:read. Fetch a single ticket. Pass expand=account,conversation,assignee,handledBy to replace those ids with names.',
+    method: 'GET',
+    path: '/v1/tickets',
+    queryKeys: ['ticketId', 'expand'],
+    inputSchema: z.object({
+        ticketId: z.string().describe('The ID of the ticket'),
+        expand: expand('Comma-separated related objects to include.'),
+    }),
+    annotations: { readOnlyHint: true },
+};
+//# sourceMappingURL=get-ticket-by-id.js.map

package/dist/tools/get-ticket-by-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-ticket-by-id.js","sourceRoot":"","sources":["../../src/tools/get-ticket-by-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAqB,MAAM,aAAa,CAAC;AAExD,MAAM,CAAC,MAAM,aAAa,GAAiB;IACzC,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EACT,2IAA2I;IAC7I,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,aAAa;IACnB,SAAS,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACrD,MAAM,EAAE,MAAM,CAAC,6CAA6C,CAAC;KAC9D,CAAC;IACF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;CACpC,CAAC"}