Call an integration's API directly

import type { LuaTool } from 'lua-cli';
import { Integrations } from 'lua-cli';
import { z } from 'zod';

type PassthroughFailure = Error & { code?: string; retryAfterSeconds?: number; requestId?: string };

export default class SearchLinearIssuesTool implements LuaTool {
  name = 'search_linear_issues';
  description = 'Full-text search of Linear issues. Use when the user quotes words from an issue title.';
  inputSchema = z.object({
    term: z.string().min(2).describe('Words to search for in issue titles and descriptions'),
  });

  async execute(input: z.infer<typeof this.inputSchema>) {
    try {
      const res = await Integrations.passthrough('linear', {
        method: 'POST',
        path: 'graphql',
        data: {
          query:
            'query Search($term: String!) { searchIssues(term: $term, first: 5) { nodes { identifier title state { name } } } }',
          variables: { term: input.term },
        },
      });
      if (res.status !== 200) throw new Error(`Linear answered ${res.status}`);
      return res.data;
    } catch (err) {
      const failure = err as PassthroughFailure;
      // The relay refused before reaching Linear; `code` says why.
      if (failure.name === 'IntegrationPassthroughError') {
        if (failure.code === 'passthrough_no_connection') {
          return { issues: [], reason: 'Linear is not connected to this agent' };
        }
        if (failure.code === 'VENDOR_UNAVAILABLE' && failure.retryAfterSeconds) {
          return { issues: [], reason: `Retry in ${failure.retryAfterSeconds}s` };
        }
      }
      throw err;
    }
  }
}