adachsoft/packagist-tool

There is no license information available for the latest version (v0.3.0) of this package.

AI ToolCall integration for querying Packagist package information via Packagist API client.

v0.3.0 2026-03-07 08:44 UTC

Requires

• php: >=8.3
• adachsoft/ai-tool-call: ^2.0
• adachsoft/packagist-api-client: ^1.0

Requires (Dev)

• adachsoft/php-code-style: ^0.4.0
• friendsofphp/php-cs-fixer: ^3.89
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^12.4
• rector/rector: ^2.3.3
• symfony/dotenv: ^8.0

Unknown License

• api
• tool
• packagist
• ai-tool-call
• package-info

README

This library provides an AI ToolCall integration for querying Packagist package information using the adachsoft/packagist-api-client.

It exposes SPI tools that can be registered in the adachsoft/ai-tool-call ecosystem and used by higher-level agents to fetch package metadata, download statistics, search for packages and manage package registrations on Packagist.

Features

• SPI tool for retrieving Packagist package data and download statistics (packagist_package_info).
• SPI tool for creating a new Packagist package from a VCS repository URL (packagist_package_create).
• SPI tool for triggering an update of an existing Packagist package by repository URL (packagist_package_update).
• SPI tool for searching Packagist packages by query and optional filters (packagist_package_search).
• Simple configuration via AI ToolCall SPI ConfigMap (Packagist API username and API token).
• Ready-made factories for wiring the tools into an AiToolCallFacade.

Installation

Install via Composer:

composer require adachsoft/packagist-tool

Usage

1. Register the SPI tool factories in your AI ToolCall facade:

use AdachSoft\AiToolCall\PublicApi\Builder\AiToolCallFacadeBuilder;
use AdachSoft\AiToolCall\SPI\Collection\ConfigMap;
use App\PackagistTool\Factory\PackagistPackageInfoToolFactory;
use App\PackagistTool\Factory\PackagistPackageCreateToolFactory;
use App\PackagistTool\Factory\PackagistPackageUpdateToolFactory;
use App\PackagistTool\Factory\PackagistPackageSearchToolFactory;

$facade = AiToolCallFacadeBuilder::new()
    ->withSpiFactories([
        new PackagistPackageInfoToolFactory(),
        new PackagistPackageCreateToolFactory(),
        new PackagistPackageUpdateToolFactory(),
        new PackagistPackageSearchToolFactory(),
    ])
    ->withToolConfigs([
        'packagist_package_info' => new ConfigMap([
            'username' => 'your-packagist-username',
            'api_token' => 'your-api-token',
        ]),
        'packagist_package_create' => new ConfigMap([
            'username' => 'your-packagist-username',
            'api_token' => 'your-api-token',
        ]),
        'packagist_package_update' => new ConfigMap([
            'username' => 'your-packagist-username',
            'api_token' => 'your-api-token',
        ]),
        'packagist_package_search' => new ConfigMap([
            'username' => 'your-packagist-username',
            'api_token' => 'your-api-token',
        ]),
    ])
    ->build();

1. Call the tools from your application:

use AdachSoft\AiToolCall\PublicApi\Dto\ToolCallRequestDto;

// Fetch package info
$infoRequest = new ToolCallRequestDto(
    toolName: 'packagist_package_info',
    parameters: [
        'package_name' => 'vendor/package',
    ],
);

$infoResult = $facade->callTool($infoRequest);

// Create a new package from repository URL
$createRequest = new ToolCallRequestDto(
    toolName: 'packagist_package_create',
    parameters: [
        'repository_url' => 'https://github.com/vendor/package.git',
    ],
);

$createResult = $facade->callTool($createRequest);

// Update an existing package by repository URL
$updateRequest = new ToolCallRequestDto(
    toolName: 'packagist_package_update',
    parameters: [
        'repository_url' => 'https://github.com/vendor/package.git',
    ],
);

$updateResult = $facade->callTool($updateRequest);

// Search for packages
$searchRequest = new ToolCallRequestDto(
    toolName: 'packagist_package_search',
    parameters: [
        'query' => 'symfony',
        'filters' => [
            'type' => 'library',
        ],
    ],
);

$searchResult = $facade->callTool($searchRequest);

// $infoResult->result, $createResult->result, $updateResult->result and $searchResult->result
// contain structured data returned by the Packagist API via the SPI tools

Testing

This library is covered by unit and functional tests. To run the tests locally use:

composer install
vendor/bin/phpunit

For static analysis and code style checks:

composer stan
composer cs:check