adachsoft / playbooks-tool
AI SPI tools for playbooks: read-only PlaybooksTool and admin PlaybooksAdminTool.
Requires
- php: >=8.3
- adachsoft/ai-tool-call: ^2.0
- adachsoft/collection: ^3.0
- adachsoft/playbooks-lib: ^0.1
- psr/clock: ^1.0
Requires (Dev)
- adachsoft/php-code-style: ^0.7.1
- friendsofphp/php-cs-fixer: ^3.89
- phpstan/phpstan: ^2.1
- phpunit/phpunit: ^12.4
- rector/rector: ^2.3
- symplify/phpstan-rules: ^14.19
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is not auto-updated.
Last update: 2026-10-22 01:35:46 UTC
README
Playbooks Tool provides AI tool-calling interfaces for querying and managing playbooks and groups.
Features
AdachSoft\PlaybooksTool\Playbooks\Tool\PlaybooksToolexposes read-onlylistandgetoperations.AdachSoft\PlaybooksTool\Admin\Tool\PlaybooksAdminToolexposes CRUD operations for playbooks and groups.- Both tools implement
AdachSoft\AiToolCall\SPI\ToolInterfaceand provide a tool definition for AI integrations.
Requirements
- PHP 8.3 or later
- Composer
Installation
composer require adachsoft/playbooks-tool
Integration
Register each tool's getDefinition() result with your AI tool-calling integration. Construct the tool through your application's dependency injection container with its operation-handler registry and parameter validator, then pass incoming calls to callTool().
The read-only tool and administrative tool have separate handlers and operation schemas. Only expose the administrative tool to trusted callers because it can create, update, and delete playbooks and groups.
See the read-only tool example and administrative tool example for request examples.