@taiga-ai/mcp-server 0.12.0-dev.421 → 0.13.0-dev.422

package/src/tools/request-prompt.ts

@@ -0,0 +1,28 @@
+/**
+ * The planner's prompt for an initiative request, built as the web builds it
+ * (apps/web/src/features/loops/delivery/components/planning/generateBacklogJob.ts):
+ * title and description trimmed, the description's inline-image markdown
+ * removed and the blank lines it leaves collapsed, joined by a blank line.
+ * The planner reads `userPrompt` and nothing else of the request, so the same
+ * words must make the same prompt from either surface.
+ *
+ * The image pattern is the web's (inline-image-doc-ids.ts), which keeps it in
+ * lockstep with the API's `extractInlineImageDocIds`: the `![...](...)` form,
+ * an exact UUID, and a terminator after `/image`.
+ */
+const INLINE_IMAGE_RE =
+  /!\[(?:[^\]\\]|\\.)*\]\([^)]*?\/custom-documents\/([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})\/image(?=[)?#\s])[^)]*\)/g;
+
+/** The description without its inline images, as the web strips it. */
+export function stripInlineImages(markdown: string): string {
+  return markdown
+    .replace(INLINE_IMAGE_RE, '')
+    .replace(/\n{3,}/g, '\n\n')
+    .trim();
+}
+
+/** The prompt for a title and a description; undefined when both are empty, which asks for a suggestion. */
+export function requestPrompt(title: string | undefined, description: string | undefined): string | undefined {
+  const body = stripInlineImages((description ?? '').trim());
+  return [(title ?? '').trim(), body].filter(Boolean).join('\n\n') || undefined;
+}

package/src/tools/wait.ts

@@ -4,6 +4,7 @@ import { z } from 'zod';
 import { TaigaApiError, type TaigaClient } from '../client.js';
 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';
 
 /**
@@ -176,6 +177,8 @@ function itemSignature(item: Row): string {
     item.state,
     item.planningStatus,
     item.needsHumanCause,
+    // The review gate decides whose turn a landed plan is, while the lifecycle reads the same either way.
+    item.autoBuild,
     lifecycle.stage,
     lifecycle.turn,
     lifecycle.cta,
@@ -442,4 +445,39 @@ export function registerWaitTools(server: McpServer, client: TaigaClient, option
         })
     );
   }
+
+  if (client.hasCapability('products:read')) {
+    server.registerTool(
+      'taiga_wait_for_job',
+      {
+        title: 'Wait for an agent job',
+        description:
+          'Wait until an agent job finishes (completed, failed or cancelled): an initiative request, a document, ' +
+          'a refresh. Returns the job as taiga_get_job reads it, with what came of an initiative request, as soon ' +
+          'as it settles (reached: true), or at the timeout with reached: false: call again to keep waiting. Most ' +
+          'jobs take a few minutes.',
+        inputSchema: {
+          jobId: z.string().uuid().describe('Agent job ID -- a request tool returns it'),
+          timeoutSeconds,
+        },
+        annotations: READ_ONLY,
+      },
+      (params, extra) =>
+        runTool(async () => {
+          const result = await waitFor(
+            async (signal) => (await client.getAgentJob(params.jobId, signal)).data as Row,
+            (job) => (SETTLED_JOB_STATUSES.has(String(job.status)) ? { reached: true } : null),
+            (params.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS) * 1000,
+            options,
+            {
+              progressToken: extra._meta?.progressToken,
+              sendNotification: extra.sendNotification,
+              signal: extra.signal,
+            }
+          );
+          const { now, ...outcome } = result;
+          return toolResult({ ...outcome, job: now ? jobReport(now) : null });
+        })
+    );
+  }
 }