@taiga-ai/mcp-server 0.18.0-dev.450 → 0.19.0-dev.451

package/src/tools/wait.ts

@@ -8,6 +8,8 @@ import { READ_ONLY } from './annotations.js';
 import { isNetworkFailure, runTool, toolResult } from './errors.js';
 import { SETTLED_JOB_STATUSES, jobReport } from './jobs.js';
 import { criteriaCounts, pickFields } from './summarize.js';
+import { situationOf } from './backlogs.js';
+import { readableRun } from './builds.js';
 
 /**
  * Waiting without a timer. A model in an editor has no clock: to learn that
@@ -285,7 +287,9 @@ function judgeItem(until: ItemCondition, gate: GateDefault) {
 /** The initiative as a wait reports it: where it is, whose turn, its latest run and its criteria. */
 function itemReport(item: Item) {
   const run = latestBuildOf(item);
+  const situation = situationOf(item);
   return {
+    ...(situation ? { situation } : {}),
     ...pickFields(
       [item],
       ['id', 'title', 'state', 'planningStatus', 'needsHumanCause', 'needsHumanDetail', 'autoBuild']
@@ -320,6 +324,8 @@ const RUN_REPORT_FIELDS = [
   'prState',
   'prDraft',
   'prMerged',
+  'prNumber',
+  'baseBranch',
   'actions',
 ] as const;
 
@@ -348,7 +354,7 @@ function judgeBuild(until: BuildCondition) {
 export function registerWaitTools(server: McpServer, client: TaigaClient, options: WaitOptions) {
   if (client.hasCapability('backlog:read')) {
     server.registerTool(
-      'taiga_wait_for_backlog_item',
+      'taiga_wait_for_initiative',
       {
         title: 'Wait for an initiative',
         description:
@@ -364,7 +370,7 @@ export function registerWaitTools(server: McpServer, client: TaigaClient, option
           'settled answers run_settled at once; item is null when not even the first read answered in time. ' +
           'Planning takes minutes and a build up to an hour.',
         inputSchema: z.object({
-          itemId: idInput('backlog item', 'taiga_list_backlog_items (query finds one by title) gives it'),
+          initiativeId: idInput('initiative', 'taiga_list_initiatives (query finds one by title) gives it'),
           until: z.enum(ITEM_CONDITIONS).describe('What to wait for'),
           timeoutSeconds,
         }),
@@ -374,7 +380,7 @@ export function registerWaitTools(server: McpServer, client: TaigaClient, option
         runTool(async () => {
           const gate: GateDefault = { product: undefined };
           const read = async (signal: AbortSignal) => {
-            const item = (await client.getBacklogItem(params.itemId, signal)).data;
+            const item = (await client.getBacklogItem(params.initiativeId, signal)).data;
             // The product's default, once, when this initiative has no gate of its own to answer with.
             if (gate.product === undefined && typeof item.autoBuild !== 'boolean') {
               gate.product = client.hasCapability('products:read')
@@ -413,7 +419,7 @@ export function registerWaitTools(server: McpServer, client: TaigaClient, option
 
   if (client.hasCapability('products:read')) {
     server.registerTool(
-      'taiga_wait_for_build',
+      'taiga_wait_for_run',
       {
         title: 'Wait for a run',
         description:
@@ -425,7 +431,7 @@ export function registerWaitTools(server: McpServer, client: TaigaClient, option
           'call again to keep waiting. Conditions are states: a run already settled answers settled at once; run ' +
           'is null when not even the first read answered in time.',
         inputSchema: z.object({
-          buildId: idInput('build run', 'taiga_list_builds gives it'),
+          runId: idInput('run', 'taiga_list_runs gives it'),
           until: z.enum(BUILD_CONDITIONS).describe('What to wait for'),
           timeoutSeconds,
         }),
@@ -434,7 +440,7 @@ export function registerWaitTools(server: McpServer, client: TaigaClient, option
       (params, ctx) =>
         runTool(async () => {
           const result = await waitFor(
-            async (signal) => (await client.getBuildRun(params.buildId, signal)).data,
+            async (signal) => (await client.getBuildRun(params.runId, signal)).data,
             judgeBuild(params.until),
             (params.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS) * 1000,
             options,
@@ -448,7 +454,7 @@ export function registerWaitTools(server: McpServer, client: TaigaClient, option
           return toolResult({
             until: params.until,
             ...outcome,
-            run: now ? pickFields([now], RUN_REPORT_FIELDS)[0] : null,
+            run: now ? readableRun(pickFields([now], RUN_REPORT_FIELDS)[0]!) : null,
           });
         })
     );