@taiga-ai/mcp-server 0.14.0-dev.428 → 0.16.0-dev.430

package/src/tools/maintenance.ts

@@ -1,4 +1,4 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer } from '@modelcontextprotocol/server';
 import {
   MAINTENANCE_FINDING_KINDS,
   MAINTENANCE_FINDING_SEVERITIES,
@@ -90,7 +90,7 @@ export function registerMaintenanceTools(server: McpServer, client: TaigaClient)
         'quiet list from a sweep that last ran long ago, or that failed, is not an all-clear; a product never swept ' +
         'says so. Sweeps run on their own after a push and periodically; nothing here starts one. Read the ' +
         'findings with taiga_list_findings and the policy standing with taiga_get_policy_standing.',
-      inputSchema: { productId },
+      inputSchema: z.object({ productId }),
       annotations: READ_ONLY,
     },
     (params) =>
@@ -121,7 +121,7 @@ export function registerMaintenanceTools(server: McpServer, client: TaigaClient)
         'submodule or a dependency with no fixed version), the policy controls it breaches, and the initiative ' +
         'already fixing it (backlogItemId). Omit status for the findings that need action; work from the top tier ' +
         'down. Read one in full with taiga_get_finding.',
-      inputSchema: {
+      inputSchema: z.object({
         productId,
         status: z
           .enum(MAINTENANCE_FINDING_STATUSES)
@@ -130,7 +130,7 @@ export function registerMaintenanceTools(server: McpServer, client: TaigaClient)
         severity: z.enum(MAINTENANCE_FINDING_SEVERITIES).optional().describe('Only this severity'),
         kind: z.enum(MAINTENANCE_FINDING_KINDS).optional().describe('Only this kind of finding'),
         ...pagination,
-      },
+      }),
       annotations: READ_ONLY,
     },
     (params) =>
@@ -153,7 +153,7 @@ export function registerMaintenanceTools(server: McpServer, client: TaigaClient)
         'the advisory and the fixed version, the place in the code, the policy controls it breaches, why it is ' +
         'ranked where it is, its history (reintroduced, previously resolved) and the remediation under way. A ' +
         "secret's value is never stored; the finding names the rule and the location only.",
-      inputSchema: { findingId },
+      inputSchema: z.object({ findingId }),
       annotations: READ_ONLY,
     },
     (params) => runTool(async () => toolResult((await client.getFinding(params.findingId)).data))
@@ -170,13 +170,13 @@ export function registerMaintenanceTools(server: McpServer, client: TaigaClient)
         'awaiting verification), and when the documents were derived and assessed. A control with no violation ' +
         'is not listed, and it is not "passing" either: there is no such state. Pass full: true for every ' +
         "violation's evidence and the resolved ones. Fix a control with taiga_fix_policy_violation.",
-      inputSchema: {
+      inputSchema: z.object({
         productId,
         full: z
           .boolean()
           .optional()
           .describe("Carry each violation's evidence, the policy excerpt and the resolved violations (default false)"),
-      },
+      }),
       annotations: READ_ONLY,
     },
     (params) =>
@@ -217,7 +217,7 @@ export function registerMaintenanceTools(server: McpServer, client: TaigaClient)
         'is only in history, rotate the credential outside Taiga, then ignore it with a reason. Ignoring hides a ' +
         "shared signal and can record the team's acceptance of a risk, which is the person's decision: ask the " +
         'person first.',
-      inputSchema: {
+      inputSchema: z.object({
         findingId,
         ignored: z.boolean().describe('true ignores the finding, false reopens it'),
         reason: z.enum(MAINTENANCE_IGNORE_REASONS).optional().describe('Why it is ignored; required when ignoring'),
@@ -227,7 +227,7 @@ export function registerMaintenanceTools(server: McpServer, client: TaigaClient)
           .datetime({ offset: true })
           .optional()
           .describe('When the ignore lapses and the finding resurfaces if it still exists (ISO 8601, in the future)'),
-      },
+      }),
       annotations: OPERATE,
     },
     (params) =>
@@ -261,14 +261,14 @@ export function registerMaintenanceTools(server: McpServer, client: TaigaClient)
         'code or infrastructure, every location the same rule flagged. Absent for a secret only in history, ' +
         'anything in a submodule, and a dependency with no fixed version (remediableBy says upstream_only); the ' +
         'API refuses those. Starts paid work; ask the person first.',
-      inputSchema: {
+      inputSchema: z.object({
         productId,
         findingId,
         wholeGroup: z
           .boolean()
           .optional()
           .describe("Fix every finding in this finding's group (its package and version, or its rule) together"),
-      },
+      }),
       annotations: OPERATE,
     },
     (params) =>
@@ -312,11 +312,11 @@ export function registerMaintenanceTools(server: McpServer, client: TaigaClient)
         "than one. Taiga raises one initiative and adds it to the end of the product's queue, exactly as a " +
         'finding fix does. The violation stays listed while the work is under way: only the next assessment ' +
         'can record that the documents no longer show it. Starts paid work; ask the person first.',
-      inputSchema: {
+      inputSchema: z.object({
         productId,
         controlId: z.string().min(1).max(40).optional().describe("The control's identifier, e.g. SEC-3.4"),
         violationId: z.string().uuid().optional().describe('One violation -- taiga_get_policy_standing gives it'),
-      },
+      }),
       annotations: OPERATE,
     },
     (params) =>

package/src/tools/observe.ts

@@ -1,4 +1,4 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer } from '@modelcontextprotocol/server';
 import { ENVIRONMENT_TYPES } from '@taiga/types';
 import { z } from 'zod';
 import { TaigaApiError, type TaigaClient } from '../client.js';
@@ -88,7 +88,7 @@ export function registerObserveTools(server: McpServer, client: TaigaClient) {
         'history is mirrored from the provider, including deployments made outside Taiga; syncStatus says when ' +
         "it last synced. Pass environmentId for one environment's history. Taiga observes deployments and " +
         'never performs them.',
-      inputSchema: { productId, environmentId: environmentId.optional(), ...pagination },
+      inputSchema: z.object({ productId, environmentId: environmentId.optional(), ...pagination }),
       annotations: READ_ONLY,
     },
     (params) =>
@@ -129,7 +129,7 @@ export function registerObserveTools(server: McpServer, client: TaigaClient) {
         'rework rate, which DORA has published none for. Failures and recoveries are read from deployments, not ' +
         'incidents. A trend built on fewer than ten deployments is approximate; a metric no deployment fed says ' +
         'so instead of showing a number. Previews and checks do not count.',
-      inputSchema: { productId, environmentId, windowDays: windowDays('30, 60 or 90') },
+      inputSchema: z.object({ productId, environmentId, windowDays: windowDays('30, 60 or 90') }),
       annotations: READ_ONLY,
     },
     (params) =>
@@ -154,7 +154,11 @@ export function registerObserveTools(server: McpServer, client: TaigaClient) {
         'signals the beacon reports (Core Web Vitals, JavaScript errors, client-observed API health) where it is ' +
         'installed; until then they read as not set up, which means no data, not good data. Setting up the ' +
         "beacon raises an initiative from the environment's settings in the web.",
-      inputSchema: { productId, environmentId: environmentId.optional(), windowDays: windowDays('30, 60 or 90') },
+      inputSchema: z.object({
+        productId,
+        environmentId: environmentId.optional(),
+        windowDays: windowDays('30, 60 or 90'),
+      }),
       annotations: READ_ONLY,
     },
     (params) =>
@@ -196,11 +200,11 @@ export function registerObserveTools(server: McpServer, client: TaigaClient) {
         'learns what happened from source control. Member-level work. Give it its App URL afterwards with ' +
         'taiga_update_environment, which is all monitoring needs to start checking. Changes the ' +
         "product's setup for everybody; ask the person first.",
-      inputSchema: {
+      inputSchema: z.object({
         productId,
         name: z.string().trim().min(1).max(100).describe('What the team calls it, e.g. staging'),
         type: z.enum(ENVIRONMENT_TYPES).describe('Its kind; production is the one delivery metrics report on'),
-      },
+      }),
       annotations: OPERATE,
     },
     (params) =>
@@ -220,12 +224,12 @@ export function registerObserveTools(server: McpServer, client: TaigaClient) {
         "monitoring needs: once it is saved, Taiga checks the app's availability every few minutes on its own. " +
         'Marking an environment production makes it the one delivery metrics report on. Changes the ' +
         "product's setup for everybody; ask the person first.",
-      inputSchema: {
+      inputSchema: z.object({
         environmentId,
         name: z.string().trim().min(1).max(100).optional().describe('A new name'),
         type: z.enum(ENVIRONMENT_TYPES).optional().describe('A new kind'),
         url: z.string().trim().max(500).url().nullable().optional().describe('The public App URL; null clears it'),
-      },
+      }),
       annotations: OPERATE_SETTING,
     },
     (params) =>

package/src/tools/product-documents.ts

@@ -1,4 +1,4 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer } from '@modelcontextprotocol/server';
 import {
   DOCUMENT_INPUTS,
   type GeneratedDocumentType,
@@ -72,12 +72,12 @@ export function registerProductDocumentWrites(server: McpServer, client: TaigaCl
           'until the draft is published (taiga_publish_product_document). Refused once Discovery is finished and ' +
           'the set is locked: reopening Discovery is done in the web. Reality documents are derived from the code ' +
           'and not edited.',
-        inputSchema: {
+        inputSchema: z.object({
           productId,
           type: documentType,
           sectionId: sectionIdFrom('taiga_get_product_document (the plan timeline)'),
           content: sectionContentInput,
-        },
+        }),
         annotations: WRITE,
       },
       (params) =>
@@ -96,7 +96,7 @@ export function registerProductDocumentWrites(server: McpServer, client: TaigaCl
         'from it are not rewritten: each is marked outdated, and is regenerated when someone chooses to ' +
         '(taiga_regenerate_product_document, or taiga_generate_product_documents for every outdated and missing ' +
         'one). Ask the person before publishing.',
-      inputSchema: { productId, type: documentType },
+      inputSchema: z.object({ productId, type: documentType }),
       annotations: OPERATE,
     },
     (params) => runTool(() => publishDraft(productScope(params.productId, params.type)))
@@ -111,7 +111,7 @@ export function registerProductDocumentWrites(server: McpServer, client: TaigaCl
         "shows it beside each version; once every published document is reviewed, the product's review item in " +
         'Action Required resolves. The mark says a human read it, so make it only when the person tells you they ' +
         'have: reading it yourself is not a review.',
-      inputSchema: { productId, type: reviewableType },
+      inputSchema: z.object({ productId, type: reviewableType }),
       annotations: WRITE,
     },
     (params) =>
@@ -131,7 +131,7 @@ export function registerProductDocumentWrites(server: McpServer, client: TaigaCl
           'the web. The optional Service Blueprint can be generated whenever someone wants one. The result is published as the new version, and ' +
           'the documents generated from it are marked outdated in turn. Runs an agent in the background: this ' +
           'returns the job; taiga_wait_for_job says when it is done. Ask the person first.',
-        inputSchema: { productId, type: generatedType },
+        inputSchema: z.object({ productId, type: generatedType }),
         annotations: OPERATE,
       },
       (params) =>
@@ -171,7 +171,7 @@ export function registerProductDocumentWrites(server: McpServer, client: TaigaCl
         'published). Refused (CONFLICT) while a document is already being generated. On an imported product, ' +
         'it queues every unpublished document. Runs agents in the background: this returns the jobs it started ' +
         '(jobIds); taiga_stop_generating_documents stops the run. Ask the person first.',
-      inputSchema: { productId },
+      inputSchema: z.object({ productId }),
       annotations: OPERATE,
     },
     (params) => runTool(async () => toolResult((await client.generateRemainingDocuments(params.productId)).data))
@@ -185,7 +185,7 @@ export function registerProductDocumentWrites(server: McpServer, client: TaigaCl
         'Stop a Generate remaining run: every document of it still being generated is cancelled and nothing ' +
         'after them starts; published documents stay. An empty list means no run was going. Interrupts agent ' +
         'work; ask the person first.',
-      inputSchema: { productId },
+      inputSchema: z.object({ productId }),
       annotations: OPERATE,
     },
     (params) => runTool(async () => toolResult((await client.stopGeneratingDocuments(params.productId)).data))

package/src/tools/products.ts

@@ -1,4 +1,4 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer } from '@modelcontextprotocol/server';
 import { z } from 'zod';
 import { TaigaApiError, type TaigaClient } from '../client.js';
 import { READ_ONLY } from './annotations.js';
@@ -280,9 +280,9 @@ export function registerProductTools(server: McpServer, client: TaigaClient) {
           'Use this to find factory IDs for reading factory instructions. ' +
           "Factory instructions carry the factory's standing guidance: domain context, tech preferences, " +
           'and the conventions its products follow.',
-        inputSchema: {
+        inputSchema: z.object({
           ...pagination,
-        },
+        }),
         annotations: READ_ONLY,
       },
       (params) =>
@@ -302,7 +302,7 @@ export function registerProductTools(server: McpServer, client: TaigaClient) {
           'List products in the organization, as summaries (id, name, slug, status, factory, kind). ' +
           'Use this to find a product by name; inside a git checkout, taiga_resolve_product finds it from ' +
           'the remote URL instead. taiga_get_product reads one in full.',
-        inputSchema: {
+        inputSchema: z.object({
           factoryId: z
             .string()
             .uuid()
@@ -316,7 +316,7 @@ export function registerProductTools(server: McpServer, client: TaigaClient) {
                 'archived when retired.'
             ),
           ...pagination,
-        },
+        }),
         annotations: READ_ONLY,
       },
       (params) =>
@@ -337,10 +337,10 @@ export function registerProductTools(server: McpServer, client: TaigaClient) {
           '(application, infrastructure, deployment) and its settings; the list and resolve tools carry ' +
           'summaries. Use taiga_list_product_documents for its specification and design, ' +
           'taiga_list_backlog_items for its work and taiga_list_builds for what the coding agent did.',
-        inputSchema: {
+        inputSchema: z.object({
           productId: productId.optional(),
           slug: slug.optional(),
-        },
+        }),
         annotations: READ_ONLY,
       },
       (params) =>
@@ -362,9 +362,9 @@ export function registerProductTools(server: McpServer, client: TaigaClient) {
           'context at once; use this when you only need the ID. Returns every product the repository is linked to (several ' +
           `when the organization shares repositories; \`truncated\` is true past ${PAGE_SIZE * RESOLVE_PAGE_LIMIT}); ` +
           'NOT_FOUND means nobody linked it, or the key cannot see the product.',
-        inputSchema: {
+        inputSchema: z.object({
           remoteUrl,
-        },
+        }),
         annotations: READ_ONLY,
       },
       (params) =>
@@ -403,7 +403,7 @@ export function registerProductTools(server: McpServer, client: TaigaClient) {
           `Two timelines: ${ORIGIN_MEANING.plan} ${ORIGIN_MEANING.reality} ` +
           'An empty side comes with a note saying why; a side the API could not list is null, with a note. ' +
           'Use taiga_get_product_document with the type and origin to read one in full.',
-        inputSchema: { productId },
+        inputSchema: z.object({ productId }),
         annotations: READ_ONLY,
       },
       (params) =>
@@ -427,7 +427,7 @@ export function registerProductTools(server: McpServer, client: TaigaClient) {
           'A large document runs to tens of thousands of characters: name the sections you need (the ids ' +
           'taiga_get_product_context lists) and the read carries only those, listing the rest with their sizes. ' +
           'A read that finds nothing says which documents and timelines the product does have.',
-        inputSchema: {
+        inputSchema: z.object({
           productId,
           type: z
             .enum(PRODUCT_DOCUMENT_TYPES)
@@ -439,7 +439,7 @@ export function registerProductTools(server: McpServer, client: TaigaClient) {
             .max(50)
             .optional()
             .describe('Only these sections, by id; omit for the whole document'),
-        },
+        }),
         annotations: READ_ONLY,
       },
       (params) =>

package/src/tools/prompts.ts

@@ -1,17 +1,9 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { ErrorCode, type GetPromptResult } from '@modelcontextprotocol/sdk/types.js';
+import { type GetPromptResult, type McpServer, ProtocolError, ProtocolErrorCode } from '@modelcontextprotocol/server';
 import { z } from 'zod';
 import { TaigaApiError, type TaigaClient } from '../client.js';
 import { POLICY_TYPES, defaultOriginFor, type ProductSettingsView } from './catalogue.js';
 import { productContext } from './context.js';
-import {
-  RequestError,
-  apiFailureCode,
-  apiFailureText,
-  isMissOrRefusal,
-  isNetworkFailure,
-  networkFailureDetail,
-} from './errors.js';
+import { apiFailureCode, apiFailureText, isMissOrRefusal, isNetworkFailure, networkFailureDetail } from './errors.js';
 import { productId as idInput, remoteUrl, slug } from './inputs.js';
 import { fence as fenced, renderDocument } from './markdown.js';
 import { resolveProductRef } from './products.js';
@@ -51,7 +43,7 @@ function unreadable(what: string, error: unknown): string {
 
 /** A refusal, as the error the prompt protocol has: the arguments named something that is not there. */
 function refuse(refusal: { code: string; message: string }): never {
-  throw new RequestError(ErrorCode.InvalidParams, `${refusal.code}: ${refusal.message}`);
+  throw new ProtocolError(ProtocolErrorCode.InvalidParams, `${refusal.code}: ${refusal.message}`);
 }
 
 /** A direct read a prompt starts from, with a miss or refusal turned into that error. */
@@ -78,11 +70,11 @@ export function registerPrompts(server: McpServer, client: TaigaClient) {
         // any request, as it is on the tools. The slug first: a client that
         // takes the arguments positionally (/server:prompt <arg>) fills the
         // first one, and the slug is the name a person knows from the URL.
-        argsSchema: {
+        argsSchema: z.object({
           slug: slug.optional(),
           productId: idInput.optional(),
           remoteUrl: remoteUrl.optional(),
-        },
+        }),
       },
       async (args) => {
         const resolved = await resolveProductRef(
@@ -124,7 +116,7 @@ export function registerPrompts(server: McpServer, client: TaigaClient) {
           'Implement one initiative: its description and acceptance criteria, the architecture of the product ' +
           "from its own timeline, the factory's instructions and the policy sections to check against. " +
           'taiga_list_backlog_items gives the item ID.',
-        argsSchema: { itemId: idInput.describe('The backlog item ID') },
+        argsSchema: z.object({ itemId: idInput.describe('The backlog item ID') }),
       },
       async (args) => {
         const item = (
@@ -224,14 +216,16 @@ export function registerPrompts(server: McpServer, client: TaigaClient) {
           'Review the current diff against the organization policies: one policy by type, or by default the ' +
           `three a code review most often needs (${CODE_REVIEW_POLICIES.join(', ')}). Each finding names the ` +
           'policy section it rests on; the "core sections" line of each policy names the ones every organization keeps.',
-        argsSchema: { policyType: optional(`One of ${POLICY_TYPES.join(', ')}; omit for the code-review three`) },
+        argsSchema: z.object({
+          policyType: optional(`One of ${POLICY_TYPES.join(', ')}; omit for the code-review three`),
+        }),
       },
       async (args) => {
         const types = args.policyType ? [args.policyType] : [...CODE_REVIEW_POLICIES];
         for (const type of types) {
           if (!(POLICY_TYPES as readonly string[]).includes(type)) {
-            throw new RequestError(
-              ErrorCode.InvalidParams,
+            throw new ProtocolError(
+              ProtocolErrorCode.InvalidParams,
               `Policy type "${type}" is not one of: ${POLICY_TYPES.join(', ')}`
             );
           }

package/src/tools/queue.ts

@@ -1,4 +1,4 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer } from '@modelcontextprotocol/server';
 import { HALT_CAUSES, canResumeHalt, haltClearsItself, renderHalt, type Halt, type HaltCause } from '@taiga/types';
 import { TaigaApiError, type TaigaClient } from '../client.js';
 import { z } from 'zod';
@@ -187,7 +187,7 @@ export function registerQueueTools(server: McpServer, client: TaigaClient) {
         'sentence saying what the line is waiting for. The ' +
         "line advances only when the active entry's pull request merges, so an entry waiting on a review holds " +
         'everything behind it. Use this when a queued initiative is not moving.',
-      inputSchema: { productId },
+      inputSchema: z.object({ productId }),
       annotations: READ_ONLY,
     },
     (params) => runTool(async () => toolResult(await queueView(client, params.productId)))
@@ -206,10 +206,10 @@ export function registerQueueTools(server: McpServer, client: TaigaClient) {
         'build on from its first incomplete step, and the line picks up where it was; a build you had stopped ' +
         'yourself before pausing stays stopped. Idempotent. Pausing interrupts work and resuming starts it: read ' +
         'taiga_get_queue first to see what it would interrupt, and ask the person.',
-      inputSchema: {
+      inputSchema: z.object({
         productId,
         paused: z.boolean().describe('true pauses the line, false resumes it'),
-      },
+      }),
       annotations: OPERATE_SETTING,
     },
     (params) =>