@taiga-ai/mcp-server 0.25.0-rc.474 → 0.26.0-dev.479

package/src/config.test.ts

@@ -1,24 +0,0 @@
-import { afterEach, describe, expect, it, vi } from 'vitest';
-
-import { readConfig } from './config.js';
-
-afterEach(() => {
-  vi.unstubAllEnvs();
-});
-
-describe('readConfig', () => {
-  it('needs an API key', () => {
-    vi.stubEnv('TAIGA_API_KEY', undefined);
-    expect(readConfig()).toBeNull();
-    vi.stubEnv('TAIGA_API_KEY', '');
-    expect(readConfig()).toBeNull();
-  });
-
-  it('defaults the API URL', () => {
-    vi.stubEnv('TAIGA_API_KEY', 'taiga_sk_live_test');
-    vi.stubEnv('TAIGA_API_URL', undefined);
-    expect(readConfig()).toEqual({ apiKey: 'taiga_sk_live_test', apiUrl: 'https://api.eu.tai.ga' });
-    vi.stubEnv('TAIGA_API_URL', 'http://localhost:3001');
-    expect(readConfig()?.apiUrl).toBe('http://localhost:3001');
-  });
-});

package/src/config.ts

@@ -1,28 +0,0 @@
-import { z } from 'zod';
-
-/**
- * The one place the MCP server reads its environment (PRO-2511), parsed once
- * at startup.
- */
-
-// The production API behind the custom domain in infra/dns.tf. The old
-// default, api.taiga.app, never resolved, so every install that followed the
-// README without TAIGA_API_URL failed on its first call.
-const DEFAULT_API_URL = 'https://api.eu.tai.ga';
-
-const envSchema = z.object({
-  TAIGA_API_KEY: z.string().min(1),
-  TAIGA_API_URL: z.string().default(DEFAULT_API_URL),
-});
-
-export interface ServerConfig {
-  readonly apiKey: string;
-  readonly apiUrl: string;
-}
-
-/** Null when TAIGA_API_KEY is missing or empty: it is the one setting with no default. */
-export function readConfig(): ServerConfig | null {
-  const parsed = envSchema.safeParse(process.env);
-  if (!parsed.success) return null;
-  return { apiKey: parsed.data.TAIGA_API_KEY, apiUrl: parsed.data.TAIGA_API_URL };
-}

package/src/index.ts

@@ -1,45 +0,0 @@
-#!/usr/bin/env node
-
-import { serveStdio } from '@modelcontextprotocol/server/stdio';
-import { TaigaClient } from './client.js';
-import { readConfig } from './config.js';
-import { createServer } from './server.js';
-
-async function main() {
-  const config = readConfig();
-  if (!config) {
-    console.error('Error: TAIGA_API_KEY environment variable is required.');
-    console.error('Create one at https://eu.tai.ga under Settings > Account > API keys.');
-    process.exit(1);
-  }
-
-  const client = new TaigaClient({ baseUrl: config.apiUrl, apiKey: config.apiKey });
-
-  // Introspect the API key to discover available capabilities
-  const introspection = await client.introspect().catch((error) => {
-    const message = error instanceof Error ? error.message : String(error);
-    console.error(`Error: Failed to validate API key: ${message}`);
-    console.error('Check that your TAIGA_API_KEY is valid and not expired.');
-    process.exit(1);
-  });
-
-  const toolCount = introspection.capabilities.length;
-  console.error(
-    `Taiga MCP server started (${toolCount} capabilities, user: ${introspection.email}, role: ${introspection.role})`
-  );
-
-  // serveStdio owns the protocol revision: a client that opens with
-  // server/discover is served 2026-07-28, one that opens with initialize the
-  // 2025 revision it asks for, from the same instance. Tools are registered
-  // from the key's capabilities, so a key never sees a tool it cannot use.
-  // Errors outside a request (the stream failing, a message that cannot be
-  // read) go to stderr, which the client shows in its server log.
-  serveStdio(() => createServer(client), {
-    onerror: (error) => console.error('Taiga MCP server error:', error),
-  });
-}
-
-main().catch((error) => {
-  console.error('Fatal error:', error);
-  process.exit(1);
-});

package/src/modern.integration.test.ts

@@ -1,153 +0,0 @@
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import { Client, InMemoryTransport } from '@modelcontextprotocol/client';
-import { serveStdio } from '@modelcontextprotocol/server/stdio';
-import { TaigaClient } from './client.js';
-import { createServer } from './server.js';
-
-/**
- * The same server over the 2026-07-28 revision. serveStdio picks the
- * revision from the client's opening exchange, so a client pinned to
- * 2026-07-28 opens with server/discover and every call after it carries the
- * modern envelope. server.integration.test.ts covers the tools in depth over
- * the 2025 handshake; this proves the catalogue, a read, a write, the server
- * instructions, and a wait's progress and cancellation on the new revision.
- */
-
-const ITEM_ID = '0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5e';
-const PRODUCT_ID = '0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5c';
-const JOB_ID = '0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4b10';
-
-let close: (() => Promise<void>) | undefined;
-
-const json = (body: unknown, status = 200) =>
-  new Response(JSON.stringify(body), { status, headers: { 'Content-Type': 'application/json' } });
-
-async function bootModern(capabilities: string[], routes: Record<string, (url: string, init: RequestInit) => unknown>) {
-  vi.stubGlobal(
-    'fetch',
-    vi.fn(async (url: string, init: RequestInit = {}) => {
-      const { pathname } = new URL(url);
-      if (pathname === '/v1/auth/introspect') {
-        return json({ data: { userId: 'u', tenantId: 't', email: 'dev@test.com', role: 'member', capabilities } });
-      }
-      const route = routes[`${init.method ?? 'GET'} ${pathname}`];
-      return route ? route(url, init) : json({ code: 'NOT_FOUND', message: 'No route' }, 404);
-    })
-  );
-  const taiga = new TaigaClient({ baseUrl: 'https://api.test.com', apiKey: 'taiga_sk_live_test' });
-  await taiga.introspect();
-
-  const [clientSide, serverSide] = InMemoryTransport.createLinkedPair();
-  const handle = serveStdio(() => createServer(taiga, { wait: { pollIntervalMs: 5 } }), { transport: serverSide });
-  const client = new Client(
-    { name: 'modern-test', version: '0.0.1' },
-    { versionNegotiation: { mode: { pin: '2026-07-28' } } }
-  );
-  await client.connect(clientSide);
-  close = async () => {
-    await client.close();
-    await handle.close();
-  };
-  return { client };
-}
-afterEach(async () => {
-  await close?.();
-  close = undefined;
-  vi.unstubAllGlobals();
-});
-
-describe('the server on the 2026-07-28 revision', () => {
-  it('negotiates 2026-07-28 and lists the same catalogue, with the server instructions', async () => {
-    const { client } = await bootModern(['products:read', 'backlog:read', 'backlog:write', 'products:write'], {});
-
-    expect(client.getProtocolEra()).toBe('modern');
-    expect(client.getInstructions()).toContain('Taiga');
-    const names = (await client.listTools()).tools.map((t) => t.name);
-    expect(names).toContain('taiga_get_product');
-    expect(names).toContain('taiga_request_initiatives');
-  });
-
-  it('reads, writes and refuses an unknown argument as it does on the 2025 revision', async () => {
-    let posted: unknown;
-    const { client } = await bootModern(['products:read', 'products:write'], {
-      [`GET /v1/products/${PRODUCT_ID}`]: () => json({ data: { id: PRODUCT_ID, name: 'Web', slug: 'web' } }),
-      'POST /v1/agent-jobs': (_url, init) => {
-        posted = JSON.parse(init.body as string);
-        return json({ data: { id: JOB_ID, type: 'generate_backlog', status: 'pending' } });
-      },
-    });
-
-    const product = await client.callTool({ name: 'taiga_get_product', arguments: { productId: PRODUCT_ID } });
-    const requested = await client.callTool({
-      name: 'taiga_request_initiatives',
-      arguments: { productId: PRODUCT_ID, title: 'Health endpoint' },
-    });
-    const stray = await client.callTool({
-      name: 'taiga_get_product',
-      arguments: { productId: PRODUCT_ID, note: 'not an argument' },
-    });
-
-    expect(JSON.parse((product.content as { text: string }[])[0]!.text)).toMatchObject({ id: PRODUCT_ID, name: 'Web' });
-    expect(posted).toMatchObject({ scope: 'product', type: 'generate_backlog', targetId: PRODUCT_ID });
-    expect(JSON.parse((requested.content as { text: string }[])[0]!.text)).toMatchObject({ id: JOB_ID });
-    expect(stray.isError).toBe(true);
-    expect((stray.content as { text: string }[])[0]!.text).toMatch(/Unrecognized key/);
-  });
-
-  it('reports progress while a wait runs, and ends the read in flight when the call is cancelled', async () => {
-    let reads = 0;
-    let hung: AbortSignal | undefined;
-    const job = (status: string) => json({ data: { id: JOB_ID, type: 'refresh_reality', status } });
-    const { client } = await bootModern(['products:read', 'backlog:read'], {
-      [`GET /v1/agent-jobs/${JOB_ID}`]: () => job(++reads < 3 ? 'processing' : 'completed'),
-      [`GET /v1/backlog/${ITEM_ID}`]: (_url, init) => {
-        hung = init.signal!;
-        return new Promise((_resolve, reject) =>
-          init.signal!.addEventListener('abort', () => reject(init.signal!.reason))
-        );
-      },
-    });
-    const onprogress = vi.fn();
-
-    const waited = await client.callTool({ name: 'taiga_wait_for_job', arguments: { jobId: JOB_ID } }, { onprogress });
-    expect(JSON.parse((waited.content as { text: string }[])[0]!.text)).toMatchObject({ reached: true });
-    expect(onprogress).toHaveBeenCalledWith(expect.objectContaining({ message: 'Still waiting' }));
-
-    const controller = new AbortController();
-    const pending = client.callTool(
-      { name: 'taiga_wait_for_initiative', arguments: { initiativeId: ITEM_ID, until: 'planned', timeoutSeconds: 60 } },
-      { signal: controller.signal }
-    );
-    await vi.waitFor(() => expect(hung).toBeDefined());
-    controller.abort();
-    await expect(pending).rejects.toThrow();
-    await vi.waitFor(() => expect(hung!.aborted).toBe(true));
-  });
-
-  it('reads a resource, gets a prompt and refuses a missing document with invalid params', async () => {
-    const policy = {
-      id: 'doc-1',
-      type: 'policy_security',
-      name: 'Security Policy',
-      version: 3,
-      isDraft: false,
-      data: { version: '1.0.0', sections: { summary: { source: 'template', priority: 'core', content: 'Encrypt' } } },
-    };
-    const { client } = await bootModern(['tenant:documents:read'], {
-      'GET /v1/tenants/current/documents/policy_security': () => json({ data: policy }),
-      'GET /v1/tenants/current/documents': () => json({ data: [policy], nextCursor: null }),
-    });
-
-    const { contents } = await client.readResource({ uri: 'taiga://documents/policy_security' });
-    const prompt = await client.getPrompt({
-      name: 'taiga_review_against_policies',
-      arguments: { policyType: 'policy_security' },
-    });
-    const missing = await client.readResource({ uri: 'taiga://documents/tone_of_voice' }).catch((e: unknown) => e);
-
-    expect((contents[0] as { text: string }).text).toContain('# Security Policy');
-    expect((prompt.messages[0]!.content as { text: string }).text).toContain('# Security Policy');
-    expect(missing).toMatchObject({ code: -32602 });
-    expect(String((missing as Error).message)).toMatch(/^No published tone_of_voice/);
-  });
-});