/ 
Langertha-Knarr-1.001
/ Langertha::Knarr::Handler::ACPClient

NAME

Langertha::Knarr::Handler::ACPClient - Steerboard handler that consumes a remote ACP (BeeAI) agent

VERSION

version 1.001

SYNOPSIS

use Langertha::Knarr::Handler::ACPClient;

my $handler = Langertha::Knarr::Handler::ACPClient->new(
    url        => 'https://some-acp-server.example',
    agent_name => 'my-agent',
);

DESCRIPTION

Consumes a remote IBM/BeeAI Agent Communication Protocol (ACP) agent as a Knarr backend. Each chat request is sent as a synchronous POST /runs with a single text/plain input part; the returned run's output text becomes the response.

Pair with a front-side Knarr speaking OpenAI to expose any ACP agent to OpenAI-format clients.

url

Required. Base URL of the upstream ACP server (path /runs is appended).

agent_name

Required. The agent_name to send in each ACP run request.

model_id

Optional. Defaults to "agent_name".

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/langertha-knarr/issues.

IRC

Join #langertha on irc.perl.org or message Getty directly.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.