Integrations API

import { Integrations } from 'lua-cli';

// Any GitHub REST endpoint, through the agent's GitHub connection
const res = await Integrations.passthrough('github', {
  method: 'GET',
  path: 'repos/acme/app/pulls/42/files',
});

if (res.status === 200) {
  console.log(res.data); // parsed JSON: the PR's files, each with its patch
}

import { Integrations } from 'lua-cli';

import type {
  IntegrationPassthroughRequest,
  IntegrationPassthroughResponse,
  IntegrationPassthroughMethod,
} from 'lua-cli';

const res = await Integrations.passthrough('github', {
  method: 'GET',
  path: 'repos/acme/private-repo/pulls/42/files',
});

if (res.status === 403) {
  // The GitHub connection lacks a scope for this call — the body is
  // GitHub's own error message. Reconnect with wider scopes to fix.
  return { success: false, error: 'GitHub denied the call', detail: res.data };
}

try {
  const res = await Integrations.passthrough('github', { method: 'GET', path: 'user' });
  return { status: res.status, user: res.data };
} catch (error) {
  // Route-level only: disabled, no connection, rate limited, transport, …
  return { success: false, error: error instanceof Error ? error.message : 'passthrough failed' };
}

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

export default class OneDriveRecentTool implements LuaTool {
  name = 'onedrive_recent';
  description = "List the connected user's OneDrive root folder";

  inputSchema = z.object({});

  async execute() {
    // Who is connected?
    const me = await Integrations.passthrough('microsoft', {
      method: 'GET',
      path: 'v1.0/me',
    });
    if (me.status !== 200) {
      return { success: false, status: me.status, error: me.data };
    }

    // List files in the OneDrive root
    const files = await Integrations.passthrough('microsoft', {
      method: 'GET',
      path: 'v1.0/me/drive/root/children',
      query: { $top: 25, $orderby: 'lastModifiedDateTime desc' },
    });
    if (files.status !== 200) {
      return { success: false, status: files.status, error: files.data };
    }

    const items = (files.data as any).value ?? [];
    return {
      success: true,
      user: (me.data as any).displayName,
      files: items.map((f: any) => ({ name: f.name, modified: f.lastModifiedDateTime })),
    };
  }
}

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

export default class ReviewPrTool implements LuaTool {
  name = 'review_pr';
  description = 'Read a pull request diff and post a review';

  inputSchema = z.object({
    owner: z.string(),
    repo: z.string(),
    pullNumber: z.number(),
    comment: z.string(),
    approve: z.boolean().default(false),
  });

  async execute(input: z.infer<typeof this.inputSchema>) {
    const base = `repos/${input.owner}/${input.repo}/pulls/${input.pullNumber}`;

    // 1. The diff, JSON-natively: each file entry includes its `patch`
    const files = await Integrations.passthrough('github', {
      method: 'GET',
      path: `${base}/files`,
      query: { per_page: 100 },
    });
    if (files.status !== 200) {
      // Provider error relayed in the envelope — e.g. 403 on a missing scope
      return { success: false, status: files.status, error: files.data };
    }

    const patches = (files.data as any[]).map((f) => ({
      filename: f.filename,
      additions: f.additions,
      deletions: f.deletions,
      patch: f.patch, // per-file unified diff
    }));

    // 2. Post the review (JSON body POSTs through as-is)
    const review = await Integrations.passthrough('github', {
      method: 'POST',
      path: `${base}/reviews`,
      data: {
        event: input.approve ? 'APPROVE' : 'COMMENT',
        body: input.comment,
      },
    });

    return {
      success: review.status === 200,
      reviewStatus: review.status,
      filesReviewed: patches.length,
      patches,
    };
  }
}