// Get a specific toolkit
const githubToolkit = await composio.toolkits.get('github');
console.log(githubToolkit.name); // GitHub
console.log(githubToolkit.authConfigDetails); // Authentication configuration details

// Get all toolkits
const allToolkits = await composio.toolkits.get({});

// Get toolkits by category
const devToolkits = await composio.toolkits.get({
  category: 'developer-tools',
});

// Get local toolkits
const localToolkits = await composio.toolkits.get({
  isLocal: true,
});

// Get all toolkit categories
const categories = await composio.toolkits.listCategories();
console.log(categories.items); // Array of category objects

// Authorize a user to use GitHub
const connectionRequest = await composio.toolkits.authorize('user123', 'github');

// Use the connection request to complete the authorization process
console.log(connectionRequest.redirectUrl); // URL to redirect the user for authorization

// Get all fields for creating an auth config
const fields = await composio.toolkits.getAuthConfigCreationFields('github', 'OAUTH2');

// Get only required fields for a specific auth scheme
const requiredFields = await composio.toolkits.getAuthConfigCreationFields('github', 'OAUTH2', {
  requiredOnly: true,
});

[
    {
      "name": "client_id",
      "displayName": "Client id",
      "type": "string",
      "required": true
    },
    {
      "name": "client_secret",
      "displayName": "Client secret",
      "type": "string",
      "required": true
    },
    {
      "name": "oauth_redirect_uri",
      "displayName": "Redirect URI",
      "type": "string",
      "default": "https://backend.composio.dev/api/v1/auth-apps/add",
      "required": false
    },
    {
      "name": "scopes",
      "displayName": "Scopes",
      "type": "string",
      "default": "read_products,write_products,read_orders,write_orders",
      "required": false
    }
]

// Get all fields for initiating a connected account
const fields = await composio.toolkits.getConnectedAccountInitiationFields('github', 'OAUTH2');

// Get only required fields for a specific auth scheme
const requiredFields = await composio.toolkits.getConnectedAccountInitiationFields(
  'github',
  'OAUTH2',
  {
    requiredOnly: true,
  }
);

[
    {
      "name": "shop",
      "displayName": "Store Subdomain",
      "type": "string",
      "default": null,
      "required": true
    }
]

interface ToolkitListParams {
  category?: string; // Filter by category
  isLocal?: boolean; // Filter for local toolkits
  managedBy?: string; // Filter by manager
  sortBy?: string; // Sort results by this field
}

interface ToolKitListResponse {
  items: ToolKitItem[]; // List of toolkits
  nextCursor?: string | null; // Pagination cursor
  totalPages: number; // Total number of pages
}

interface ToolKitItem {
  name: string; // Name of the toolkit
  slug: string; // Unique slug identifier
  meta: {
    // Metadata about the toolkit
    createdAt: string; // When the toolkit was created
    updatedAt: string; // When the toolkit was last updated
    toolsCount: number; // Number of tools in the toolkit
    triggersCount: number; // Number of triggers in the toolkit
  };
  isLocalToolkit: boolean; // Whether this is a local toolkit
  authSchemes: string[]; // Available authentication schemes
  composioManagedAuthSchemes: string[]; // Managed auth schemes
  noAuth: boolean; // Whether authentication is required
}

interface ToolkitRetrieveResponse {
  name: string; // Name of the toolkit
  slug: string; // Unique slug identifier
  meta: {
    // Metadata about the toolkit
    createdAt: string; // When the toolkit was created
    updatedAt: string; // When the toolkit was last updated
    toolsCount: number; // Number of tools in the toolkit
    triggersCount: number; // Number of triggers in the toolkit
  };
  isLocalToolkit: boolean; // Whether this is a local toolkit
  composioManagedAuthSchemes: string[]; // Managed auth schemes
  authConfigDetails: {
    // Authentication configuration details
    name: string; // Name of the auth configuration
    mode: string; // Auth mode (e.g., "OAUTH2")
    fields: {
      // Required fields
      authConfigCreation: Record<string, unknown>; // Fields for creating auth config
      connectedAccountInitiation: Record<string, unknown>; // Fields for initiating connection
    };
    proxy?: {
      // Proxy configuration (if any)
      baseUrl: string; // Base URL for proxied requests
    };
  }[];
  baseUrl?: string; // Base URL for the toolkit API
  getCurrentUserEndpoint?: string; // Endpoint to get the current user
  getCurrentUserEndpointMethod?: string; // HTTP method for get current user endpoint (e.g., GET, POST)
}

interface ToolkitRetrieveCategoriesResponse {
  items: ToolkitCategory[]; // List of categories
  nextCursor?: string | null; // Pagination cursor
  totalPages: number; // Total number of pages
}

interface ToolkitCategory {
  id: string; // Category ID
  name: string; // Category name
}