@burdenoff/mcp-libs 2026.626.1 → 2026.627.2

package/dist/modules/proserviceworld/index.cjs

@@ -0,0 +1,1404 @@
+'use strict';
+
+var zod = require('zod');
+require('graphql-request');
+require('cross-fetch');
+require('@modelcontextprotocol/sdk/server/mcp.js');
+require('@modelcontextprotocol/sdk/types.js');
+
+// src/modules/proserviceworld/tools/clients.ts
+
+// src/core/errors.ts
+var McpInternalError = class extends Error {
+  cause;
+  constructor(message, cause) {
+    super(message);
+    this.name = "McpInternalError";
+    this.cause = cause;
+  }
+};
+
+// src/core/result.ts
+function jsonResult(data, structured) {
+  const result = {
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+  };
+  return result;
+}
+function errorResult(message, hint) {
+  const text = hint ? `${message}
+
+Hint: ${hint}` : message;
+  return { content: [{ type: "text", text }], isError: true };
+}
+
+// src/core/tool-name.ts
+var MAX_TOOL_NAME_LENGTH = 63;
+function assertSafeName(name, kind) {
+  if (name.length > MAX_TOOL_NAME_LENGTH) {
+    throw new McpInternalError(
+      `Tool name '${name}' exceeds ${MAX_TOOL_NAME_LENGTH} characters (some MCP clients truncate at 64).`
+    );
+  }
+  return name;
+}
+function mcpToolName(productName, ...parts) {
+  if (!productName) {
+    throw new McpInternalError("mcpToolName: productName is required");
+  }
+  const name = [productName, ...parts].filter(Boolean).join("_");
+  return assertSafeName(name);
+}
+function mcpResourceUri(productName, ...parts) {
+  if (!productName) {
+    throw new McpInternalError("mcpResourceUri: productName is required");
+  }
+  return `${productName}://${parts.filter(Boolean).join("/")}`;
+}
+function mcpPromptName(productName, ...parts) {
+  if (!productName) {
+    throw new McpInternalError("mcpPromptName: productName is required");
+  }
+  return [productName, ...parts].filter(Boolean).join("-");
+}
+
+// src/modules/proserviceworld/operations.ts
+var CLIENT_FIELDS = `
+  id name type status industry contactName contactEmail contactPhone address
+  notes tags relationshipOwnerId workspaceId createdAt updatedAt
+`;
+var ENGAGEMENT_FIELDS = `
+  id clientId name description status feeArrangement feeAmount currency
+  practiceAreaId responsiblePartnerId startDate endDate tags workspaceId
+  createdAt updatedAt
+`;
+var MATTER_FIELDS = `
+  id clientId engagementId title reference description status priority
+  isPrivileged leadPractitionerId practiceAreaId dueDate closedAt tags
+  workspaceId createdAt updatedAt
+`;
+var INVOICE_FIELDS = `
+  id clientId engagementId number status issueDate dueDate paidAt subtotal
+  taxAmount total currency lineItems notes workspaceId createdAt updatedAt
+`;
+var TIME_ENTRY_FIELDS = `
+  id matterId engagementId practitionerId date minutes rate billable narrative
+  status invoiceId workspaceId createdAt updatedAt
+`;
+var COMPLIANCE_FIELDS = `
+  id type status title details subjectType subjectId reviewerId dueDate
+  resolvedAt evidenceFileId workspaceId createdAt updatedAt
+`;
+var CONFLICT_FIELDS = `
+  id clientId matterId status searchedParties findings waiverReason
+  clearedById resolvedAt workspaceId createdAt updatedAt
+`;
+var PRACTICE_AREA_FIELDS = `
+  id name code description isActive workspaceId createdAt updatedAt
+`;
+var MILESTONE_FIELDS = `
+  id engagementId name description status triggersInvoice triggerAmount
+  dueDate completedAt workspaceId createdAt updatedAt
+`;
+var DELIVERABLE_FIELDS = `
+  id engagementId name description status version acceptanceCriteria
+  acceptedAt dueDate workspaceId createdAt updatedAt
+`;
+var PAGE_INFO = `pageInfo { cursor hasMore }`;
+var GET_CLIENT = `
+  query PswGetClient($id: ID!) {
+    pswClient(id: $id) {
+      ${CLIENT_FIELDS}
+      engagements { id name status feeArrangement feeAmount currency }
+      matters { id title status priority }
+    }
+  }
+`;
+var LIST_CLIENTS = `
+  query PswListClients($pagination: PaginationInput, $status: PswClientStatus) {
+    pswListClients(pagination: $pagination, status: $status) {
+      items { ${CLIENT_FIELDS} }
+      ${PAGE_INFO}
+    }
+  }
+`;
+var CREATE_CLIENT = `
+  mutation PswCreateClient($input: PswCreateClientInput!) {
+    pswCreateClient(input: $input) {
+      ${CLIENT_FIELDS}
+    }
+  }
+`;
+var UPDATE_CLIENT = `
+  mutation PswUpdateClient($id: ID!, $input: PswUpdateClientInput!) {
+    pswUpdateClient(id: $id, input: $input) {
+      ${CLIENT_FIELDS}
+    }
+  }
+`;
+var ARCHIVE_CLIENT = `
+  mutation PswArchiveClient($id: ID!) {
+    pswArchiveClient(id: $id)
+  }
+`;
+var GET_ENGAGEMENT = `
+  query PswGetEngagement($id: ID!) {
+    pswEngagement(id: $id) {
+      ${ENGAGEMENT_FIELDS}
+      client { id name status }
+      milestones { ${MILESTONE_FIELDS} }
+      deliverables { ${DELIVERABLE_FIELDS} }
+    }
+  }
+`;
+var LIST_ENGAGEMENTS = `
+  query PswListEngagements(
+    $clientId: ID
+    $status: PswEngagementStatus
+    $pagination: PaginationInput
+  ) {
+    pswListEngagements(clientId: $clientId, status: $status, pagination: $pagination) {
+      items { ${ENGAGEMENT_FIELDS} }
+      ${PAGE_INFO}
+    }
+  }
+`;
+var CREATE_ENGAGEMENT = `
+  mutation PswCreateEngagement($input: PswCreateEngagementInput!) {
+    pswCreateEngagement(input: $input) {
+      ${ENGAGEMENT_FIELDS}
+    }
+  }
+`;
+var UPDATE_ENGAGEMENT = `
+  mutation PswUpdateEngagement($id: ID!, $input: PswUpdateEngagementInput!) {
+    pswUpdateEngagement(id: $id, input: $input) {
+      ${ENGAGEMENT_FIELDS}
+    }
+  }
+`;
+var TRANSITION_ENGAGEMENT = `
+  mutation PswTransitionEngagement($id: ID!, $status: PswEngagementStatus!) {
+    pswTransitionEngagement(id: $id, status: $status) {
+      ${ENGAGEMENT_FIELDS}
+    }
+  }
+`;
+var GET_MATTER = `
+  query PswGetMatter($id: ID!) {
+    pswMatter(id: $id) {
+      ${MATTER_FIELDS}
+      client { id name status }
+    }
+  }
+`;
+var LIST_MATTERS = `
+  query PswListMatters(
+    $clientId: ID
+    $engagementId: ID
+    $status: PswMatterStatus
+    $pagination: PaginationInput
+  ) {
+    pswListMatters(
+      clientId: $clientId
+      engagementId: $engagementId
+      status: $status
+      pagination: $pagination
+    ) {
+      items { ${MATTER_FIELDS} }
+      ${PAGE_INFO}
+    }
+  }
+`;
+var CREATE_MATTER = `
+  mutation PswCreateMatter($input: PswCreateMatterInput!) {
+    pswCreateMatter(input: $input) {
+      ${MATTER_FIELDS}
+    }
+  }
+`;
+var UPDATE_MATTER = `
+  mutation PswUpdateMatter($id: ID!, $input: PswUpdateMatterInput!) {
+    pswUpdateMatter(id: $id, input: $input) {
+      ${MATTER_FIELDS}
+    }
+  }
+`;
+var CLOSE_MATTER = `
+  mutation PswCloseMatter($id: ID!) {
+    pswCloseMatter(id: $id) {
+      ${MATTER_FIELDS}
+    }
+  }
+`;
+var LIST_INVOICES = `
+  query PswListInvoices(
+    $clientId: ID
+    $status: PswInvoiceStatus
+    $pagination: PaginationInput
+  ) {
+    pswListInvoices(clientId: $clientId, status: $status, pagination: $pagination) {
+      items { ${INVOICE_FIELDS} }
+      ${PAGE_INFO}
+    }
+  }
+`;
+var CREATE_INVOICE = `
+  mutation PswCreateInvoice($input: PswCreateInvoiceInput!) {
+    pswCreateInvoice(input: $input) {
+      ${INVOICE_FIELDS}
+    }
+  }
+`;
+var MARK_INVOICE_PAID = `
+  mutation PswMarkInvoicePaid($id: ID!) {
+    pswMarkInvoicePaid(id: $id) {
+      ${INVOICE_FIELDS}
+    }
+  }
+`;
+var LOG_TIME_ENTRY = `
+  mutation PswLogTimeEntry($input: PswCreateTimeEntryInput!) {
+    pswLogTimeEntry(input: $input) {
+      ${TIME_ENTRY_FIELDS}
+    }
+  }
+`;
+var LIST_COMPLIANCE_CHECKS = `
+  query PswListComplianceChecks(
+    $status: PswComplianceStatus
+    $subjectId: ID
+    $subjectType: String
+    $pagination: PaginationInput
+  ) {
+    pswListComplianceChecks(
+      status: $status
+      subjectId: $subjectId
+      subjectType: $subjectType
+      pagination: $pagination
+    ) {
+      ${COMPLIANCE_FIELDS}
+    }
+  }
+`;
+var LIST_CONFLICT_CHECKS = `
+  query PswListConflictChecks($clientId: ID, $pagination: PaginationInput) {
+    pswListConflictChecks(clientId: $clientId, pagination: $pagination) {
+      ${CONFLICT_FIELDS}
+    }
+  }
+`;
+var LIST_PRACTICE_AREAS = `
+  query PswListPracticeAreas($pagination: PaginationInput) {
+    pswListPracticeAreas(pagination: $pagination) {
+      ${PRACTICE_AREA_FIELDS}
+    }
+  }
+`;
+var HEALTH = `
+  query PswHealth {
+    pswHealth
+  }
+`;
+var ClientStatusEnum = zod.z.enum(["ACTIVE", "ARCHIVED", "INACTIVE", "PROSPECT"]).describe("Lifecycle status of a client relationship");
+var ClientTypeEnum = zod.z.enum(["INDIVIDUAL", "ORGANIZATION"]).describe("Whether the client is an INDIVIDUAL or an ORGANIZATION");
+var EngagementStatusEnum = zod.z.enum([
+  "ACCEPTED",
+  "CANCELLED",
+  "CLOSED",
+  "DELIVERED",
+  "INVOICED",
+  "IN_PROGRESS",
+  "PROPOSAL",
+  "REVIEW"
+]).describe("Delivery-lifecycle status of an engagement");
+var FeeArrangementEnum = zod.z.enum(["FIXED", "HOURLY", "RETAINER", "VALUE_BASED"]).describe("Fee arrangement for an engagement");
+var MatterStatusEnum = zod.z.enum(["ARCHIVED", "CLOSED", "ON_HOLD", "OPEN"]).describe("Lifecycle status of a matter");
+var MatterPriorityEnum = zod.z.enum(["CRITICAL", "HIGH", "LOW", "MEDIUM"]).describe("Priority of a matter");
+var InvoiceStatusEnum = zod.z.enum(["CANCELLED", "DRAFT", "OVERDUE", "PAID", "SENT"]).describe("Status of an invoice");
+var ComplianceStatusEnum = zod.z.enum(["FAILED", "IN_REVIEW", "PASSED", "PENDING", "WAIVED"]).describe("Status of a compliance check");
+var JsonObject = zod.z.record(zod.z.string(), zod.z.unknown());
+var LineItems = zod.z.union([zod.z.array(zod.z.unknown()), JsonObject]);
+
+// src/modules/proserviceworld/tools/clients.ts
+function registerClientTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "clients_get")),
+    {
+      title: "Get Client",
+      description: "Fetch a single ProServiceWorld client by ID, including its engagements and matters.",
+      inputSchema: { id: zod.z.string().describe("Client ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_CLIENT, { id });
+        if (!data.pswClient) return errorResult(`Client ${id} not found`);
+        return jsonResult(data.pswClient);
+      } catch (error) {
+        ctx.logger.error("proserviceworld clients_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get client: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "clients_list")),
+    {
+      title: "List Clients",
+      description: "List clients in the bound workspace, optionally filtered by status, with limit/offset pagination.",
+      inputSchema: {
+        status: ClientStatusEnum.optional().describe("Filter by client status"),
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ status, limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_CLIENTS, {
+          status,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.pswListClients);
+      } catch (error) {
+        ctx.logger.error("proserviceworld clients_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list clients: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "clients_create")),
+    {
+      title: "Create Client",
+      description: "Onboard a new client. Only `name` is required; `type` defaults to ORGANIZATION and `status` to PROSPECT.",
+      inputSchema: {
+        name: zod.z.string().min(1).describe("Client display name"),
+        type: ClientTypeEnum.optional().describe("Client type (default ORGANIZATION)"),
+        status: ClientStatusEnum.optional().describe("Initial status (default PROSPECT)"),
+        industry: zod.z.string().optional().describe("Industry / sector"),
+        contactName: zod.z.string().optional().describe("Primary contact name"),
+        contactEmail: zod.z.string().optional().describe("Primary contact email"),
+        contactPhone: zod.z.string().optional().describe("Primary contact phone"),
+        address: zod.z.string().optional().describe("Postal address"),
+        notes: zod.z.string().optional().describe("Free-text notes"),
+        tags: zod.z.array(zod.z.string()).optional().describe("Tag labels"),
+        relationshipOwnerId: zod.z.string().optional().describe("User ID of the relationship owner")
+      }
+    },
+    async ({
+      name,
+      type,
+      status,
+      industry,
+      contactName,
+      contactEmail,
+      contactPhone,
+      address,
+      notes,
+      tags,
+      relationshipOwnerId
+    }) => {
+      try {
+        const input = { name };
+        if (type !== void 0) input.type = type;
+        if (status !== void 0) input.status = status;
+        if (industry !== void 0) input.industry = industry;
+        if (contactName !== void 0) input.contactName = contactName;
+        if (contactEmail !== void 0) input.contactEmail = contactEmail;
+        if (contactPhone !== void 0) input.contactPhone = contactPhone;
+        if (address !== void 0) input.address = address;
+        if (notes !== void 0) input.notes = notes;
+        if (tags !== void 0) input.tags = tags;
+        if (relationshipOwnerId !== void 0) input.relationshipOwnerId = relationshipOwnerId;
+        const data = await ctx.gql.workspace.request(CREATE_CLIENT, { input });
+        return jsonResult(data.pswCreateClient);
+      } catch (error) {
+        ctx.logger.error("proserviceworld clients_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create client: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "clients_update")),
+    {
+      title: "Update Client",
+      description: "Update a client. At least one mutable field must be provided. Use `status` to move a client through ACTIVE/INACTIVE/etc.",
+      inputSchema: {
+        id: zod.z.string().describe("Client ID"),
+        name: zod.z.string().optional().describe("Updated display name"),
+        type: ClientTypeEnum.optional().describe("Updated client type"),
+        status: ClientStatusEnum.optional().describe("Updated status"),
+        industry: zod.z.string().optional().describe("Updated industry"),
+        contactName: zod.z.string().optional().describe("Updated primary contact name"),
+        contactEmail: zod.z.string().optional().describe("Updated primary contact email"),
+        contactPhone: zod.z.string().optional().describe("Updated primary contact phone"),
+        address: zod.z.string().optional().describe("Updated postal address"),
+        notes: zod.z.string().optional().describe("Updated notes"),
+        tags: zod.z.array(zod.z.string()).optional().describe("Updated tag labels"),
+        relationshipOwnerId: zod.z.string().optional().describe("Updated relationship owner user ID")
+      }
+    },
+    async ({
+      id,
+      name,
+      type,
+      status,
+      industry,
+      contactName,
+      contactEmail,
+      contactPhone,
+      address,
+      notes,
+      tags,
+      relationshipOwnerId
+    }) => {
+      try {
+        const input = {};
+        if (name !== void 0) input.name = name;
+        if (type !== void 0) input.type = type;
+        if (status !== void 0) input.status = status;
+        if (industry !== void 0) input.industry = industry;
+        if (contactName !== void 0) input.contactName = contactName;
+        if (contactEmail !== void 0) input.contactEmail = contactEmail;
+        if (contactPhone !== void 0) input.contactPhone = contactPhone;
+        if (address !== void 0) input.address = address;
+        if (notes !== void 0) input.notes = notes;
+        if (tags !== void 0) input.tags = tags;
+        if (relationshipOwnerId !== void 0) input.relationshipOwnerId = relationshipOwnerId;
+        if (Object.keys(input).length === 0) {
+          return errorResult(
+            "No updates specified \u2014 provide at least one of name/type/status/industry/contactName/contactEmail/contactPhone/address/notes/tags/relationshipOwnerId"
+          );
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_CLIENT, { id, input });
+        return jsonResult(data.pswUpdateClient);
+      } catch (error) {
+        ctx.logger.error("proserviceworld clients_update failed", { error: String(error) });
+        return errorResult(
+          `Failed to update client: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "clients_archive")),
+    {
+      title: "Archive Client",
+      description: "Archive (soft-delete) a client by ID. Returns true on success.",
+      inputSchema: { id: zod.z.string().describe("Client ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(
+          ARCHIVE_CLIENT,
+          { id }
+        );
+        return jsonResult({ archived: data.pswArchiveClient, id });
+      } catch (error) {
+        ctx.logger.error("proserviceworld clients_archive failed", { error: String(error) });
+        return errorResult(
+          `Failed to archive client: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerEngagementTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "engagements_get")),
+    {
+      title: "Get Engagement",
+      description: "Fetch a single engagement by ID, including its client, milestones, and deliverables.",
+      inputSchema: { id: zod.z.string().describe("Engagement ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_ENGAGEMENT, { id });
+        if (!data.pswEngagement) return errorResult(`Engagement ${id} not found`);
+        return jsonResult(data.pswEngagement);
+      } catch (error) {
+        ctx.logger.error("proserviceworld engagements_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get engagement: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "engagements_list")),
+    {
+      title: "List Engagements",
+      description: "List engagements, optionally filtered by client and/or status, with limit/offset pagination.",
+      inputSchema: {
+        clientId: zod.z.string().optional().describe("Filter by client ID"),
+        status: EngagementStatusEnum.optional().describe("Filter by engagement status"),
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ clientId, status, limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_ENGAGEMENTS, {
+          clientId,
+          status,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.pswListEngagements);
+      } catch (error) {
+        ctx.logger.error("proserviceworld engagements_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list engagements: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "engagements_create")),
+    {
+      title: "Create Engagement",
+      description: "Open a new engagement for a client. `clientId` and `name` are required; `feeArrangement` defaults to FIXED.",
+      inputSchema: {
+        clientId: zod.z.string().min(1).describe("Owning client ID"),
+        name: zod.z.string().min(1).describe("Engagement name"),
+        description: zod.z.string().optional().describe("Scope / description"),
+        feeArrangement: FeeArrangementEnum.optional().describe("Fee arrangement (default FIXED)"),
+        feeAmount: zod.z.number().optional().describe("Fee amount"),
+        currency: zod.z.string().optional().describe('ISO currency code (e.g. "USD")'),
+        practiceAreaId: zod.z.string().optional().describe("Practice-area ID"),
+        responsiblePartnerId: zod.z.string().optional().describe("Responsible partner user ID"),
+        startDate: zod.z.string().optional().describe("Start date (ISO-8601 DateTime)"),
+        endDate: zod.z.string().optional().describe("End date (ISO-8601 DateTime)"),
+        tags: zod.z.array(zod.z.string()).optional().describe("Tag labels")
+      }
+    },
+    async ({
+      clientId,
+      name,
+      description,
+      feeArrangement,
+      feeAmount,
+      currency,
+      practiceAreaId,
+      responsiblePartnerId,
+      startDate,
+      endDate,
+      tags
+    }) => {
+      try {
+        const input = { clientId, name };
+        if (description !== void 0) input.description = description;
+        if (feeArrangement !== void 0) input.feeArrangement = feeArrangement;
+        if (feeAmount !== void 0) input.feeAmount = feeAmount;
+        if (currency !== void 0) input.currency = currency;
+        if (practiceAreaId !== void 0) input.practiceAreaId = practiceAreaId;
+        if (responsiblePartnerId !== void 0) input.responsiblePartnerId = responsiblePartnerId;
+        if (startDate !== void 0) input.startDate = startDate;
+        if (endDate !== void 0) input.endDate = endDate;
+        if (tags !== void 0) input.tags = tags;
+        const data = await ctx.gql.workspace.request(CREATE_ENGAGEMENT, { input });
+        return jsonResult(data.pswCreateEngagement);
+      } catch (error) {
+        ctx.logger.error("proserviceworld engagements_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create engagement: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "engagements_update")),
+    {
+      title: "Update Engagement",
+      description: "Update an engagement. At least one mutable field must be provided. Use `engagements_transition` to change lifecycle status.",
+      inputSchema: {
+        id: zod.z.string().describe("Engagement ID"),
+        name: zod.z.string().optional().describe("Updated name"),
+        description: zod.z.string().optional().describe("Updated scope / description"),
+        feeArrangement: FeeArrangementEnum.optional().describe("Updated fee arrangement"),
+        feeAmount: zod.z.number().optional().describe("Updated fee amount"),
+        currency: zod.z.string().optional().describe("Updated ISO currency code"),
+        practiceAreaId: zod.z.string().optional().describe("Updated practice-area ID"),
+        responsiblePartnerId: zod.z.string().optional().describe("Updated responsible partner user ID"),
+        startDate: zod.z.string().optional().describe("Updated start date (ISO-8601 DateTime)"),
+        endDate: zod.z.string().optional().describe("Updated end date (ISO-8601 DateTime)"),
+        tags: zod.z.array(zod.z.string()).optional().describe("Updated tag labels")
+      }
+    },
+    async ({
+      id,
+      name,
+      description,
+      feeArrangement,
+      feeAmount,
+      currency,
+      practiceAreaId,
+      responsiblePartnerId,
+      startDate,
+      endDate,
+      tags
+    }) => {
+      try {
+        const input = {};
+        if (name !== void 0) input.name = name;
+        if (description !== void 0) input.description = description;
+        if (feeArrangement !== void 0) input.feeArrangement = feeArrangement;
+        if (feeAmount !== void 0) input.feeAmount = feeAmount;
+        if (currency !== void 0) input.currency = currency;
+        if (practiceAreaId !== void 0) input.practiceAreaId = practiceAreaId;
+        if (responsiblePartnerId !== void 0) input.responsiblePartnerId = responsiblePartnerId;
+        if (startDate !== void 0) input.startDate = startDate;
+        if (endDate !== void 0) input.endDate = endDate;
+        if (tags !== void 0) input.tags = tags;
+        if (Object.keys(input).length === 0) {
+          return errorResult(
+            "No updates specified \u2014 provide at least one of name/description/feeArrangement/feeAmount/currency/practiceAreaId/responsiblePartnerId/startDate/endDate/tags"
+          );
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_ENGAGEMENT, { id, input });
+        return jsonResult(data.pswUpdateEngagement);
+      } catch (error) {
+        ctx.logger.error("proserviceworld engagements_update failed", { error: String(error) });
+        return errorResult(
+          `Failed to update engagement: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "engagements_transition")),
+    {
+      title: "Transition Engagement",
+      description: "Advance an engagement through its delivery lifecycle (validated transitions), e.g. PROPOSAL \u2192 ACCEPTED \u2192 IN_PROGRESS \u2192 REVIEW \u2192 DELIVERED \u2192 INVOICED \u2192 CLOSED, or CANCELLED.",
+      inputSchema: {
+        id: zod.z.string().describe("Engagement ID"),
+        status: EngagementStatusEnum.describe("Target engagement status")
+      }
+    },
+    async ({ id, status }) => {
+      try {
+        const data = await ctx.gql.workspace.request(TRANSITION_ENGAGEMENT, { id, status });
+        return jsonResult(data.pswTransitionEngagement);
+      } catch (error) {
+        ctx.logger.error("proserviceworld engagements_transition failed", { error: String(error) });
+        return errorResult(
+          `Failed to transition engagement: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerMatterTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "matters_get")),
+    {
+      title: "Get Matter",
+      description: "Fetch a single matter by ID, including its client.",
+      inputSchema: { id: zod.z.string().describe("Matter ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_MATTER, { id });
+        if (!data.pswMatter) return errorResult(`Matter ${id} not found`);
+        return jsonResult(data.pswMatter);
+      } catch (error) {
+        ctx.logger.error("proserviceworld matters_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get matter: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "matters_list")),
+    {
+      title: "List Matters",
+      description: "List matters, optionally filtered by client, engagement, and/or status, with limit/offset pagination.",
+      inputSchema: {
+        clientId: zod.z.string().optional().describe("Filter by client ID"),
+        engagementId: zod.z.string().optional().describe("Filter by engagement ID"),
+        status: MatterStatusEnum.optional().describe("Filter by matter status"),
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ clientId, engagementId, status, limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_MATTERS, {
+          clientId,
+          engagementId,
+          status,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.pswListMatters);
+      } catch (error) {
+        ctx.logger.error("proserviceworld matters_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list matters: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "matters_create")),
+    {
+      title: "Create Matter",
+      description: "Open a new matter for a client. `clientId` and `title` are required; `priority` defaults to MEDIUM and `isPrivileged` to false.",
+      inputSchema: {
+        clientId: zod.z.string().min(1).describe("Owning client ID"),
+        title: zod.z.string().min(1).describe("Matter title"),
+        reference: zod.z.string().optional().describe("External matter reference / number"),
+        description: zod.z.string().optional().describe("Description"),
+        engagementId: zod.z.string().optional().describe("Parent engagement ID"),
+        practiceAreaId: zod.z.string().optional().describe("Practice-area ID"),
+        leadPractitionerId: zod.z.string().optional().describe("Lead practitioner user ID"),
+        priority: MatterPriorityEnum.optional().describe("Priority (default MEDIUM)"),
+        isPrivileged: zod.z.boolean().optional().describe("Whether the matter is privileged (default false)"),
+        dueDate: zod.z.string().optional().describe("Due date (ISO-8601 DateTime)"),
+        tags: zod.z.array(zod.z.string()).optional().describe("Tag labels")
+      }
+    },
+    async ({
+      clientId,
+      title,
+      reference,
+      description,
+      engagementId,
+      practiceAreaId,
+      leadPractitionerId,
+      priority,
+      isPrivileged,
+      dueDate,
+      tags
+    }) => {
+      try {
+        const input = { clientId, title };
+        if (reference !== void 0) input.reference = reference;
+        if (description !== void 0) input.description = description;
+        if (engagementId !== void 0) input.engagementId = engagementId;
+        if (practiceAreaId !== void 0) input.practiceAreaId = practiceAreaId;
+        if (leadPractitionerId !== void 0) input.leadPractitionerId = leadPractitionerId;
+        if (priority !== void 0) input.priority = priority;
+        if (isPrivileged !== void 0) input.isPrivileged = isPrivileged;
+        if (dueDate !== void 0) input.dueDate = dueDate;
+        if (tags !== void 0) input.tags = tags;
+        const data = await ctx.gql.workspace.request(CREATE_MATTER, { input });
+        return jsonResult(data.pswCreateMatter);
+      } catch (error) {
+        ctx.logger.error("proserviceworld matters_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create matter: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "matters_update")),
+    {
+      title: "Update Matter",
+      description: "Update a matter. At least one mutable field must be provided. Use `matters_close` to close a matter.",
+      inputSchema: {
+        id: zod.z.string().describe("Matter ID"),
+        title: zod.z.string().optional().describe("Updated title"),
+        description: zod.z.string().optional().describe("Updated description"),
+        engagementId: zod.z.string().optional().describe("Updated parent engagement ID"),
+        practiceAreaId: zod.z.string().optional().describe("Updated practice-area ID"),
+        leadPractitionerId: zod.z.string().optional().describe("Updated lead practitioner user ID"),
+        priority: MatterPriorityEnum.optional().describe("Updated priority"),
+        isPrivileged: zod.z.boolean().optional().describe("Updated privileged flag"),
+        dueDate: zod.z.string().optional().describe("Updated due date (ISO-8601 DateTime)"),
+        tags: zod.z.array(zod.z.string()).optional().describe("Updated tag labels")
+      }
+    },
+    async ({
+      id,
+      title,
+      description,
+      engagementId,
+      practiceAreaId,
+      leadPractitionerId,
+      priority,
+      isPrivileged,
+      dueDate,
+      tags
+    }) => {
+      try {
+        const input = {};
+        if (title !== void 0) input.title = title;
+        if (description !== void 0) input.description = description;
+        if (engagementId !== void 0) input.engagementId = engagementId;
+        if (practiceAreaId !== void 0) input.practiceAreaId = practiceAreaId;
+        if (leadPractitionerId !== void 0) input.leadPractitionerId = leadPractitionerId;
+        if (priority !== void 0) input.priority = priority;
+        if (isPrivileged !== void 0) input.isPrivileged = isPrivileged;
+        if (dueDate !== void 0) input.dueDate = dueDate;
+        if (tags !== void 0) input.tags = tags;
+        if (Object.keys(input).length === 0) {
+          return errorResult(
+            "No updates specified \u2014 provide at least one of title/description/engagementId/practiceAreaId/leadPractitionerId/priority/isPrivileged/dueDate/tags"
+          );
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_MATTER, { id, input });
+        return jsonResult(data.pswUpdateMatter);
+      } catch (error) {
+        ctx.logger.error("proserviceworld matters_update failed", { error: String(error) });
+        return errorResult(
+          `Failed to update matter: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "matters_close")),
+    {
+      title: "Close Matter",
+      description: "Close a matter by ID. Returns the closed matter (status=CLOSED, closedAt set).",
+      inputSchema: { id: zod.z.string().describe("Matter ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(CLOSE_MATTER, { id });
+        return jsonResult(data.pswCloseMatter);
+      } catch (error) {
+        ctx.logger.error("proserviceworld matters_close failed", { error: String(error) });
+        return errorResult(
+          `Failed to close matter: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerInvoiceTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "invoices_list")),
+    {
+      title: "List Invoices",
+      description: "List invoices, optionally filtered by client and/or status, with limit/offset pagination.",
+      inputSchema: {
+        clientId: zod.z.string().optional().describe("Filter by client ID"),
+        status: InvoiceStatusEnum.optional().describe("Filter by invoice status"),
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ clientId, status, limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_INVOICES, {
+          clientId,
+          status,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.pswListInvoices);
+      } catch (error) {
+        ctx.logger.error("proserviceworld invoices_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list invoices: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "invoices_create")),
+    {
+      title: "Create Invoice",
+      description: "Raise a new invoice for a client. `clientId` and `number` are required; amounts and line items are optional JSON/numbers.",
+      inputSchema: {
+        clientId: zod.z.string().min(1).describe("Billed client ID"),
+        number: zod.z.string().min(1).describe("Invoice number (unique within the workspace)"),
+        engagementId: zod.z.string().optional().describe("Related engagement ID"),
+        issueDate: zod.z.string().optional().describe("Issue date (ISO-8601 DateTime)"),
+        dueDate: zod.z.string().optional().describe("Due date (ISO-8601 DateTime)"),
+        subtotal: zod.z.number().optional().describe("Subtotal amount"),
+        taxAmount: zod.z.number().optional().describe("Tax amount"),
+        total: zod.z.number().optional().describe("Total amount"),
+        currency: zod.z.string().optional().describe('ISO currency code (e.g. "USD")'),
+        lineItems: LineItems.optional().describe("Line items JSON (array of line-item objects)"),
+        notes: zod.z.string().optional().describe("Invoice notes")
+      }
+    },
+    async ({
+      clientId,
+      number,
+      engagementId,
+      issueDate,
+      dueDate,
+      subtotal,
+      taxAmount,
+      total,
+      currency,
+      lineItems,
+      notes
+    }) => {
+      try {
+        const input = { clientId, number };
+        if (engagementId !== void 0) input.engagementId = engagementId;
+        if (issueDate !== void 0) input.issueDate = issueDate;
+        if (dueDate !== void 0) input.dueDate = dueDate;
+        if (subtotal !== void 0) input.subtotal = subtotal;
+        if (taxAmount !== void 0) input.taxAmount = taxAmount;
+        if (total !== void 0) input.total = total;
+        if (currency !== void 0) input.currency = currency;
+        if (lineItems !== void 0) input.lineItems = lineItems;
+        if (notes !== void 0) input.notes = notes;
+        const data = await ctx.gql.workspace.request(CREATE_INVOICE, { input });
+        return jsonResult(data.pswCreateInvoice);
+      } catch (error) {
+        ctx.logger.error("proserviceworld invoices_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create invoice: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "invoices_mark_paid")),
+    {
+      title: "Mark Invoice Paid",
+      description: "Mark an invoice as paid by ID (sets status=PAID, paidAt set).",
+      inputSchema: { id: zod.z.string().describe("Invoice ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(MARK_INVOICE_PAID, { id });
+        return jsonResult(data.pswMarkInvoicePaid);
+      } catch (error) {
+        ctx.logger.error("proserviceworld invoices_mark_paid failed", { error: String(error) });
+        return errorResult(
+          `Failed to mark invoice paid: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerTimeTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "time_log")),
+    {
+      title: "Log Time Entry",
+      description: "Record a time entry against a matter and/or engagement. `date` and `minutes` are required; `billable` defaults to true.",
+      inputSchema: {
+        date: zod.z.string().describe("Work date (ISO-8601 DateTime)"),
+        minutes: zod.z.number().int().describe("Duration in minutes"),
+        matterId: zod.z.string().optional().describe("Matter the time is logged against"),
+        engagementId: zod.z.string().optional().describe("Engagement the time is logged against"),
+        rate: zod.z.number().optional().describe("Hourly rate applied"),
+        billable: zod.z.boolean().optional().describe("Whether the time is billable (default true)"),
+        narrative: zod.z.string().optional().describe("Narrative / description of the work")
+      }
+    },
+    async ({ date, minutes, matterId, engagementId, rate, billable, narrative }) => {
+      try {
+        const input = { date, minutes };
+        if (matterId !== void 0) input.matterId = matterId;
+        if (engagementId !== void 0) input.engagementId = engagementId;
+        if (rate !== void 0) input.rate = rate;
+        if (billable !== void 0) input.billable = billable;
+        if (narrative !== void 0) input.narrative = narrative;
+        const data = await ctx.gql.workspace.request(LOG_TIME_ENTRY, { input });
+        return jsonResult(data.pswLogTimeEntry);
+      } catch (error) {
+        ctx.logger.error("proserviceworld time_log failed", { error: String(error) });
+        return errorResult(
+          `Failed to log time entry: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerComplianceTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "compliance_list")),
+    {
+      title: "List Compliance Checks",
+      description: "List compliance checks (licensing, independence, data retention, legal hold, etc.), optionally filtered by status and/or subject.",
+      inputSchema: {
+        status: ComplianceStatusEnum.optional().describe("Filter by compliance status"),
+        subjectId: zod.z.string().optional().describe("Filter by subject ID"),
+        subjectType: zod.z.string().optional().describe('Filter by subject type (e.g. "client", "engagement", "matter")'),
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ status, subjectId, subjectType, limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_COMPLIANCE_CHECKS, {
+          status,
+          subjectId,
+          subjectType,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.pswListComplianceChecks);
+      } catch (error) {
+        ctx.logger.error("proserviceworld compliance_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list compliance checks: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "conflicts_list")),
+    {
+      title: "List Conflict Checks",
+      description: "List conflict-of-interest checks, optionally filtered by client, with limit/offset pagination.",
+      inputSchema: {
+        clientId: zod.z.string().optional().describe("Filter by client ID"),
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ clientId, limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_CONFLICT_CHECKS, {
+          clientId,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.pswListConflictChecks);
+      } catch (error) {
+        ctx.logger.error("proserviceworld conflicts_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list conflict checks: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerPracticeTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "practice_areas_list")),
+    {
+      title: "List Practice Areas",
+      description: "List the firm's practice areas (e.g. tax, audit, litigation, advisory) in the bound workspace.",
+      inputSchema: {
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_PRACTICE_AREAS, {
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.pswListPracticeAreas);
+      } catch (error) {
+        ctx.logger.error("proserviceworld practice_areas_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list practice areas: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+
+// src/modules/proserviceworld/tools/health.ts
+function registerHealthTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "health")),
+    {
+      title: "ProServiceWorld Health Check",
+      description: "Public health probe for the ProServiceWorld subgraph (pswHealth). Requires no authentication.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        const data = await ctx.gql.workspace.request(HEALTH, {});
+        return jsonResult({ ok: true, status: data.pswHealth });
+      } catch (error) {
+        ctx.logger.error("proserviceworld health failed", { error: String(error) });
+        return errorResult(
+          `ProServiceWorld health check failed: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+
+// src/modules/proserviceworld/resources.ts
+function registerProserviceworldResources(server, ctx, track) {
+  const schemaUri = track(mcpResourceUri(ctx.productName, "schema"));
+  const clientsUri = track(mcpResourceUri(ctx.productName, "clients"));
+  const mattersUri = track(mcpResourceUri(ctx.productName, "matters"));
+  const practiceAreasUri = track(mcpResourceUri(ctx.productName, "practice-areas"));
+  server.registerResource(
+    "proserviceworld-schema",
+    schemaUri,
+    {
+      title: "ProServiceWorld Domain Schema",
+      description: "Overview of the ProServiceWorld professional-services domain \u2014 entities, enums, and the per-entity tool surface.",
+      mimeType: "text/plain"
+    },
+    async () => {
+      ctx.logger.debug(`Resource ${schemaUri} requested`);
+      const schema = `# ProServiceWorld Domain (Overview)
+
+The Professional-Services Operating System \u2014 system of record for clients,
+engagements, matters, time, billing, and compliance across professional-services
+firms (finance, insurance, legal, accounting, tax, advisory, consulting).
+
+## Entities
+- PswClient \u2014 a client/relationship (has engagements + matters)
+- PswEngagement \u2014 proposal\u2192delivery engagement (has milestones + deliverables)
+- PswMatter \u2014 a unit of professional work for a client
+- PswInvoice \u2014 a billing document
+- PswTimeEntry \u2014 logged billable/non-billable time
+- PswComplianceCheck \u2014 a governance/compliance check
+- PswConflictCheck \u2014 a conflict-of-interest check
+- PswPracticeArea \u2014 the firm's practice-area catalog
+- PswMilestone / PswDeliverable / PswTeamAssignment \u2014 engagement sub-records
+
+## Enums
+- PswClientStatus: ACTIVE, ARCHIVED, INACTIVE, PROSPECT
+- PswClientType: INDIVIDUAL, ORGANIZATION
+- PswEngagementStatus: PROPOSAL, ACCEPTED, IN_PROGRESS, REVIEW, DELIVERED, INVOICED, CLOSED, CANCELLED
+- PswFeeArrangement: FIXED, HOURLY, RETAINER, VALUE_BASED
+- PswMatterStatus: OPEN, ON_HOLD, CLOSED, ARCHIVED
+- PswMatterPriority: LOW, MEDIUM, HIGH, CRITICAL
+- PswInvoiceStatus: DRAFT, SENT, PAID, OVERDUE, CANCELLED
+- PswComplianceStatus: PENDING, IN_REVIEW, PASSED, FAILED, WAIVED
+
+## Tool groups
+clients, engagements, matters, invoices, time, compliance (compliance + conflict
+checks), practice (practice areas), health. All run against the WORKSPACE gateway
+(workspace-scoped) except the public health probe.
+`;
+      return {
+        contents: [{ uri: schemaUri, text: schema, mimeType: "text/plain" }]
+      };
+    }
+  );
+  server.registerResource(
+    "proserviceworld-clients",
+    clientsUri,
+    {
+      title: "ProServiceWorld Client Directory",
+      description: "The first 50 clients in the bound workspace.",
+      mimeType: "application/json"
+    },
+    async () => {
+      ctx.logger.debug(`Resource ${clientsUri} requested`);
+      try {
+        const data = await ctx.gql.workspace.request(LIST_CLIENTS, {
+          pagination: { limit: 50, offset: 0 }
+        });
+        return {
+          contents: [
+            {
+              uri: clientsUri,
+              text: JSON.stringify(data.pswListClients, null, 2),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      } catch (error) {
+        return {
+          contents: [
+            {
+              uri: clientsUri,
+              text: JSON.stringify({
+                error: error instanceof Error ? error.message : String(error)
+              }),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      }
+    }
+  );
+  server.registerResource(
+    "proserviceworld-matters",
+    mattersUri,
+    {
+      title: "ProServiceWorld Matters",
+      description: "The first 50 matters in the bound workspace.",
+      mimeType: "application/json"
+    },
+    async () => {
+      ctx.logger.debug(`Resource ${mattersUri} requested`);
+      try {
+        const data = await ctx.gql.workspace.request(LIST_MATTERS, {
+          pagination: { limit: 50, offset: 0 }
+        });
+        return {
+          contents: [
+            {
+              uri: mattersUri,
+              text: JSON.stringify(data.pswListMatters, null, 2),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      } catch (error) {
+        return {
+          contents: [
+            {
+              uri: mattersUri,
+              text: JSON.stringify({
+                error: error instanceof Error ? error.message : String(error)
+              }),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      }
+    }
+  );
+  server.registerResource(
+    "proserviceworld-practice-areas",
+    practiceAreasUri,
+    {
+      title: "ProServiceWorld Practice Areas",
+      description: "The firm's practice-area catalog in the bound workspace.",
+      mimeType: "application/json"
+    },
+    async () => {
+      ctx.logger.debug(`Resource ${practiceAreasUri} requested`);
+      try {
+        const data = await ctx.gql.workspace.request(
+          LIST_PRACTICE_AREAS,
+          { pagination: { limit: 50, offset: 0 } }
+        );
+        return {
+          contents: [
+            {
+              uri: practiceAreasUri,
+              text: JSON.stringify(data.pswListPracticeAreas, null, 2),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      } catch (error) {
+        return {
+          contents: [
+            {
+              uri: practiceAreasUri,
+              text: JSON.stringify({
+                error: error instanceof Error ? error.message : String(error)
+              }),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      }
+    }
+  );
+}
+function registerProserviceworldPrompts(server, ctx, track) {
+  const p = ctx.productName;
+  const onboardingName = track(mcpPromptName(p, "client-onboarding"));
+  const deliveryName = track(mcpPromptName(p, "engagement-delivery"));
+  server.registerPrompt(
+    onboardingName,
+    {
+      title: "Client Onboarding",
+      description: "Guide for onboarding a new ProServiceWorld client end to end: create the client, open an engagement, run a conflict check, and open the first matter.",
+      argsSchema: {
+        name: zod.z.string().optional().describe("Client / organization name"),
+        industry: zod.z.string().optional().describe("Client industry / sector")
+      }
+    },
+    ({ name, industry }) => {
+      ctx.logger.debug(`Prompt ${onboardingName} called`, { name, industry });
+      const nameNote = name ? `Use the client name "${name}".` : "Ask the user for the client name.";
+      const industryNote = industry ? `Industry is ${industry}.` : "Ask the user for the industry.";
+      return {
+        messages: [
+          {
+            role: "user",
+            content: {
+              type: "text",
+              text: `Help me onboard a new ProServiceWorld client.
+
+1. **Create Client**: Use ${p}_clients_create. ${nameNote} ${industryNote} Set type (INDIVIDUAL/ORGANIZATION) and capture contact details.
+2. **Conflict Check**: Use ${p}_conflicts_list filtered by the new clientId to confirm there are no unresolved conflicts of interest before engaging.
+3. **Pick Practice Area**: Use ${p}_practice_areas_list and choose the relevant practiceAreaId.
+4. **Open Engagement**: Use ${p}_engagements_create with the clientId, a name, a feeArrangement (FIXED/HOURLY/RETAINER/VALUE_BASED), and the practiceAreaId.
+5. **Open First Matter**: Use ${p}_matters_create for the initial unit of work (clientId, title, priority, optional engagementId).
+6. **Activate**: Use ${p}_clients_update with status=ACTIVE once engaged.
+
+Show results at each step and confirm before activation.`
+            }
+          }
+        ]
+      };
+    }
+  );
+  server.registerPrompt(
+    deliveryName,
+    {
+      title: "Engagement Delivery",
+      description: "Workflow to drive an engagement through delivery: advance its lifecycle, log time, check compliance, raise an invoice, and mark it paid.",
+      argsSchema: {
+        engagementId: zod.z.string().optional().describe("Engagement ID to operate")
+      }
+    },
+    ({ engagementId }) => {
+      ctx.logger.debug(`Prompt ${deliveryName} called`, { engagementId });
+      const engagementNote = engagementId ? `Operate engagement "${engagementId}".` : `First list engagements with ${p}_engagements_list and pick one.`;
+      return {
+        messages: [
+          {
+            role: "user",
+            content: {
+              type: "text",
+              text: `Run ProServiceWorld engagement delivery. ${engagementNote}
+
+1. **Review**: Use ${p}_engagements_get to inspect milestones and deliverables.
+2. **Advance**: Use ${p}_engagements_transition to move the engagement (e.g. ACCEPTED \u2192 IN_PROGRESS \u2192 REVIEW \u2192 DELIVERED).
+3. **Log Time**: Use ${p}_time_log to record billable time against the engagement and/or its matters.
+4. **Compliance**: Use ${p}_compliance_list (subjectId=engagementId, subjectType="engagement") to confirm no PENDING/IN_REVIEW checks block invoicing.
+5. **Invoice**: When DELIVERED, use ${p}_invoices_create (clientId, number, amounts/line items), then ${p}_engagements_transition to INVOICED.
+6. **Collect**: Once paid, use ${p}_invoices_mark_paid and ${p}_engagements_transition to CLOSED.
+
+Summarize what needs attention after each step.`
+            }
+          }
+        ]
+      };
+    }
+  );
+}
+
+// src/modules/proserviceworld/index.ts
+var proserviceworldModule = {
+  id: "proserviceworld",
+  version: "0.0.1",
+  displayName: "ProServiceWorld",
+  dependsOn: ["auth"],
+  capabilities: { tools: {}, resources: {}, prompts: {} },
+  register(server, ctx) {
+    const tools = [];
+    const resources = [];
+    const prompts = [];
+    const trackTool = (n) => {
+      tools.push(n);
+      return n;
+    };
+    const trackResource = (uri) => {
+      resources.push(uri);
+      return uri;
+    };
+    const trackPrompt = (n) => {
+      prompts.push(n);
+      return n;
+    };
+    registerClientTools(server, ctx, trackTool);
+    registerEngagementTools(server, ctx, trackTool);
+    registerMatterTools(server, ctx, trackTool);
+    registerInvoiceTools(server, ctx, trackTool);
+    registerTimeTools(server, ctx, trackTool);
+    registerComplianceTools(server, ctx, trackTool);
+    registerPracticeTools(server, ctx, trackTool);
+    registerHealthTools(server, ctx, trackTool);
+    registerProserviceworldResources(server, ctx, trackResource);
+    registerProserviceworldPrompts(server, ctx, trackPrompt);
+    return { tools, resources, prompts };
+  }
+};
+var proserviceworld_default = proserviceworldModule;
+
+module.exports = proserviceworld_default;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map